dtterm man page on UnixWare

Man page or keyword search:  
man Server   3616 pages
apropos Keyword Search (all sections)
Output format
UnixWare logo
[printable version]



dtterm(1)		 USER COMMANDS			dtterm(1)

NAME
     dtterm - emulate a terminal window

SYNOPSIS
     dtterm [+/-132] [+/-aw] [+/-anw]
     [-background background_color] [-bg background_color]
     [+/-bs] [-C] [-display display_name]
     [-e program_argument ...]	[-fb fontset]
     [-fg foreground_color] [-fn fontset] [-font fontset]
     [-foreground foreground_color] [-geometry geometry_string]
     [-help] [+/-iconic] [+/-j] [+/-kshMode] [+/-l]
     [-lf file_name] [+/-ls] [+/-map] [+/-mb] [-ms pointer_color]
     [-name prog_name] [-nb number] [+/-rw] [-S ccn] [-S c.n]
     [+/-sb] [+/-sf] [-sl screens[s|l]] [-ti term_id]
     [-title title_string] [-tm term_modes] [-tn term_name]
     [-usage] [+/-vb] [-xrm resource_string]

DESCRIPTION
     The dtterm utility provides runtime support of legacy appli-
     cations written for terminals conforming to ANSI X3.64-1979
     and ISO 6429:1992(E), such as the DEC VT220.

OPTIONS
     The following options are available:

	-132  Recognize the DECCOLM escape sequence and resize
	      the window appropriately.	 Normally, dtterm ignores
	      the DECCOLM escape sequence, which switches between
	      80- and 132-column mode.

	+132  Ignore the DECCOLM escape sequence.  This is the
	      default behavior.

	-aw   Allow auto-wraparound.  This option allows the cur-
	      sor to automatically wrap to the beginning of the
	      next line when it is at the right-most position of
	      a line and text is output.  This is the default
	      behavior.

	-anw  Dis-allow the New command on the Window menu.

	+anw  Allow the New command on the Window menu.

	+aw   Do not allow auto-wraparound.

	-background background_color
	      Specify the terminal window background and the
	      default background for the scroll bar and the X11
	      pointer cursor.  This option defaults to either the
	      primary colorset background (default) or select
	      pixel (see -bs).	The background_color argument
	      describes the background color.

Unix System LaboratoLast change: 1 August 1995			1

dtterm(1)		 USER COMMANDS			dtterm(1)

	-bg background_color
	      Equivalent to -background.  The background_color
	      argument describes the background color.

	-bs   Use the Motif select color instead of the back-
	      ground color for the terminal window's background
	      color.

	+bs   Do not use the Motif select color instead of the
	      background color for the terminal window's back-
	      ground color.  This is the default behavior.

	-C    Specify that output directed to /dev/console be
	      directed instead to the terminal window.	It is
	      provided as a way to prevent output, which would
	      normally be displayed on the internal terminal emu-
	      lator (ITE), from overwriting the X server's
	      display.	It is not provided as a general purpose
	      mechanism to direct the output from an arbitrary
	      system's /dev/console to an arbitrary X server.
	      Ownership of, and read-write permission for,
	      /dev/console is required in order to redirect con-
	      sole output.

	-display display_name
	      Specify the X11 display server.  This defaults to
	      the DISPLAY environment variable.	 The display_name
	      argument specifies the X11 display to which dtterm
	      connects.

	-e program_argument ...
	      Specify an executable program and any command-line
	      arguments dtterm invokes as a subprocess when
	      dtterm is started.  It must be the last option on
	      the command line.	 The program_argument arguments
	      specify the program and any command-line arguments
	      to be invoked by dtterm.

	-fb fontset
	      Specify an XFontSet used by dtterm when displaying
	      bold terminal text.  The XFontSet should be speci-
	      fied as a Motif XmFontList3X.  The terminal emula-
	      tor supports only character or mono-spaced fonts.
	      When using proportional fonts, the behavior is
	      undefined.  The terminal emulator generates a
	      default bold font based on the XLFD name of the
	      userFont.	 If that font is not available, the ter-
	      minal emulator generates bold text by overstriking
	      (with a one pixel offset) the userFont.  The
	      fontset argument specifies the bold terminal
	      XFontSet used by dtterm.

Unix System LaboratoLast change: 1 August 1995			2

dtterm(1)		 USER COMMANDS			dtterm(1)

	-fg foreground_color
	      Specify the foreground color of the terminal window
	      as well as the default foreground color used by
	      dtterm for the scroll bar and the for the X11
	      pointer cursor.  This option defaults to either the
	      primary colorset foreground (default) or select
	      pixel.  The foreground_color argument specifies the
	      foreground color.

	-fn fontset
	      Specify an XFontSet used by dtterm when displaying
	      terminal text.  It should be specified as a Motif
	      XmFontList3X.  Only character or mono-spaced fonts
	      are supported.  When using proportional fonts, the
	      behavior is undefined.  This font is not used to
	      display non-terminal text (such as menu bar, popup
	      menus or dialogs).  The default uses the
	      XmNtextFontList value of the parent bulletin board
	      (see the XmBulletinBoard widget) in the same manner
	      as the XmText widget.  The fontset argument speci-
	      fies the terminal XFontSet.

	-font fontset
	      Equivalent to -fn.  The fontset argument specifies
	      the terminal XFontSet.

	-foreground foreground_color
	      Equivalent to -fg.  The foreground_color argument
	      specifies the foreground color used by dtterm.

	-geometry geometry_string
	      Specify the terminal window's preferred size and
	      position.	 Width and height are expressed in char-
	      acters.  The default size is 24 lines of 80 charac-
	      ters each.  There is no default position.	 The
	      geometry_string argument specifies the terminal
	      geometry used by dtterm.

	-help
	      Display a message summarizing dtterm usage.

	-iconic
	      Display the terminal emulator initially in an icon-
	      ified state.

	+iconic
	      Display the terminal emulator initially as a normal
	      window.  This is the default behavior.

	-j    Use jump scrolling.  With jump scrolling, the
	      screen may be scrolled more than one line at a
	      time.  This provides for faster screen updates when

Unix System LaboratoLast change: 1 August 1995			3

dtterm(1)		 USER COMMANDS			dtterm(1)

	      multiple lines of text are sent to the terminal.
	      The maximum number of lines that may be jump
	      scrolled is limited to the number of lines in the
	      terminal window.	The dtterm terminal emulator
	      guarantees that all lines are displayed.	This is
	      the default behavior.

	+j    Do not use jump scrolling.

	-kshMode
	      Enable ksh mode.	In ksh mode, a key pressed with
	      the extend modifier bit set generates an escape
	      character followed by the character generated by
	      the un-extended keystroke.  This option is provided
	      for use with emacs command-line editor mode of
	      ksh(1).  It conflicts with the normal meta key use
	      for generating extended single byte characters and
	      for generating multi-byte Asian characters.

	+kshMode
	      Do not enable ksh(1) mode.  This is the default
	      behavior.

	-l    Enables output logging.  When dtterm enables log-
	      ging, all output received from the subprocess is
	      logged either to a file or to a command pipeline
	      (as specified via the -lf option described in the
	      following paragraph).  Since data are logged
	      directly from the subprocess, the log file includes
	      all escape characters and carriage-return and new-
	      line pairs the terminal line discipline sends.  The
	      application may enable and disable logging via
	      escape sequences.

	+l    Disable output logging.  This is the default
	      behavior.

	-lf file_name
	      Name the file to which dtterm writes the output
	      log.  If the file_name argument begins with a pipe
	      symbol (|), dtterm assumes the rest of the string
	      to be a command to be used as the endpoint of a
	      pipe.  The default file name is DttermLog XXXXX
	      (where XXXXX is a unique value) and is created in
	      the directory from which the subprocess was
	      started.	The file_name argument specifies the log
	      file name used by dtterm for logging.

	-ls   Start a login shell (the first character of argv[0]
	      is a dash), indicating to the shell that it should
	      read the system's profile and the user's .profile
	      files (for ksh(1) and sh(1)), or the system's

Unix System LaboratoLast change: 1 August 1995			4

dtterm(1)		 USER COMMANDS			dtterm(1)

	      csh.login and the user's .login (for csh(1)).

	+ls   Start a normal (non-login) shell.	 This is the
	      default behavior.

	-map  Map (de-iconify) dtterm upon subprocess output if
	      dtterm is unmapped (iconified).  The user can
	      specify, via the mapOnOutputDelay resource, an ini-
	      tial period of time during which dtterm does not
	      map itself upon subprocess output.

	+map  Indicate there is no special mapping behavior.
	      This is the default behavior.

	-mb   Ring a bell when the user types at a specified dis-
	      tance from the right margin.  The distance from the
	      right margin is specified by the -nb option.

	+mb   Do not ring a bell when the user types near the
	      right margin.  This is the default behavior.

	-ms pointer_color
	      Specify the foreground color used by dtterm for the
	      terminal window's (X11) pointer cursor.  The
	      default is the terminal window's foreground color
	      (see -foreground).  The pointer_color argument
	      specifies the pointer foreground color used by
	      dtterm.

	-name prog_name
	      Specify the X11 name of the dtterm window.  The
	      prog_name argument specifies the name to use.

	-nb number
	      Ring the bell this number of characters from the
	      right margin when enabled.  The default is 10.  The
	      number argument specifies the number of characters.

	-rw   Enable reverse-wraparound.

	+rw   Do not enable reverse-wraparound.	 This is the
	      default behavior.

	-Sccn
	      Run the terminal emulator against a pre-opened pty
	      or STREAMS pseudo-terminal device.  The terminal
	      emulator provides this option to use when the
	      pseudo-terminal device name is of the form tty??
	      (that is, exactly two characters following the
	      tty).  This option is intended for use when dtterm
	      is programmatically invoked from within another
	      application.  The cc argument specifies the last

Unix System LaboratoLast change: 1 August 1995			5

dtterm(1)		 USER COMMANDS			dtterm(1)

	      two characters of the pseudo-terminal device's
	      slave name where the pseudo-terminal device slave
	      name is of the form tty??.  This value is ignored,
	      but must be exactly two characters in length.  The
	      n argument specifies the file descriptor number
	      that corresponds to the pseudo-terminal device's
	      already opened master side.

	-Sc.n
	      Equivalent to -Sccn, but provided for systems with
	      a larger pseudo-terminal device name space.  The c
	      argument specifies the last component of the
	      pseudo-terminal device slave name.  The terminal
	      emulator ignores this value and the value may be
	      empty.  The n argument specifies the number of the
	      file descriptor that corresponds to the pseudo-
	      terminal device's already opened master side.

	-sb   Display a scroll bar.  This is the default
	      behavior.

	+sb   Do not display a scroll bar.

	-sf   Generate Sun Function Key escape sequences instead
	      of standard ANSI escape sequences for the
	      terminal's function keys.

	+sf   Generate standard ANSI escape sequences instead of
	      Sun Function Key escape sequences for the
	      terminal's function keys.	 This is the default
	      behavior.

	-sl screens[s|l]
	      Specify the number of lines in the terminal buffer
	      beyond the length of the window.	The option value
	      consists of a number followed by an optional suf-
	      fix.  If no suffix is included or the suffix is
	      ``l'' (ell), the total length of the terminal
	      buffer is screens plus the length of the terminal
	      window.  If the suffix is ``s'' (ess) the total
	      length of the terminal buffer is (screens+1) times
	      the length of the terminal window.  The dtterm
	      utility attempts to maintain the same buffer-to-
	      window ratio when the window is resized larger.
	      The default is 4s.  The screens argument specifies
	      the number of screens or lines to save.

	-ti term_id
	      Specify the name used by dtterm to select the
	      correct response to terminal ID queries.	Valid
	      values are vt100, vt101, vt102, and vt220.  The
	      default is vt220.	 The term_id argument specifies

Unix System LaboratoLast change: 1 August 1995			6

dtterm(1)		 USER COMMANDS			dtterm(1)

	      the terminal ID to use.

	-title title_string
	      Specify the window title.	 When used with the -e
	      option, the default is the last component of the
	      program's path; otherwise, the default is the last
	      component of the name used to execute dtterm (that
	      is, argv[0]).  The title_string argument specifies
	      the title used by dterm.

	-tm term_modes
	      Specify a string containing terminal-setting key-
	      words and the characters to which they can be
	      bound.  Allowable keywords include:  intr, quit,
	      erase, kill, eof, eol, swtch, start, stop, brk,
	      susp, dsusp, rprnt, flush, weras and lnext.  The
	      terminal emulator correctly parses and silently
	      ignores keywords that do not apply to a specific
	      architecture.  Control characters can be specified
	      as ^char (for example, ^c or ^u), and ^? can be
	      used to indicate Delete.	This is useful for over-
	      riding the default terminal settings without having
	      to do an stty(1) every time a DtTerm widget is
	      created.	The default is NULL.  The term_modes
	      argument specifies the terminal mode string.

	-tn term_name
	      Specify a name to which dtterm sets the TERM
	      environment variable.  The default is dtterm.  The
	      term_name argument specifies the terminal name used
	      by dtterm.

	-usage
	      Display a usage message on the screen.

	-vb   Use a visual bell instead of an audible one.  Flash
	      the window instead of ringing the terminal bell
	      whenever a <control>-G is received.

	+vb   Use an audio bell instead of a visual one.  This is
	      the default behavior.

	-xrm resource_string
	      Allow the user to specify the X11 Resource
	      Manager-style resources on the command line.  The
	      resource_string argument specifies an X11 resource
	      string.  (See XrmParseCommand(3X) and
	      XGetDefault(3X) for more information.)

OPERANDS
     None.

Unix System LaboratoLast change: 1 August 1995			7

dtterm(1)		 USER COMMANDS			dtterm(1)

STDIN
     Not used.

INPUT FILES
     None.

ENVIRONMENT VARIABLES
     The following environment variables affect the execution of
     dtterm:

	DISPLAY	       Specify the default X Windows display to
		       connect to (see -display).  The terminal
		       emulator sets the subprocess's DISPLAY
		       environment variable to the connected X11
		       display name.

	HOME	       Determine the user's home directory, the
		       location of configuration files.

	LANG	       Provide a default value for the interna-
		       tionalization variables that are unset or
		       null.  If LANG is unset or null, the
		       corresponding value from the
		       implementation-specific default locale
		       will be used.  If any of the internation-
		       alization variables contains an invalid
		       setting, the utility behaves as if none of
		       the variables had been defined.

	LC_ALL	       If set to a non-empty string value, over-
		       ride the values of all the other interna-
		       tionalization variables.

	LC_MESSAGES    Determine the locale that is used to
		       affect the format and contents of diagnos-
		       tic messages written to standard error and
		       informative messages written to standard
		       output.

	NLSPATH	       Determine the location of message catalo-
		       gues for the processing of LC_MESSAGES.

	SHELL	       Determine the default application to run.

	XAPPLRESDIR    Specify the name of a directory that con-
		       tains application-specific resources.  If
		       this environment variable is defined, and
		       is set to an existing directory, then it
		       is searched (in addition to the standard
		       locations) for files containing
		       application-specific resource specifica-
		       tions.

Unix System LaboratoLast change: 1 August 1995			8

dtterm(1)		 USER COMMANDS			dtterm(1)

	XENVIRONMENT
		       Specify the name of a resource file with
		       user- or machine-specific resources.  If
		       this variable is not defined, dtterm looks
		       for a file named $HOME/.Xdefaults-hostname
		       instead, where hostname is the name of the
		       host where the application is executing.

	XFILESEARCHPATH
		       Define a language-dependent location of
		       app-defaults.

	XMODIFIER      Specify which input method to use.

	XUSERFILESEARCHPATH
		       Control where X applications look for
		       their app-defaults resource files.  The
		       default is located in the directory
		       /usr/dt/app-defaults.  The user must set
		       XUSERFILESEARCHPATH if the user's resource
		       files are not in this location.

     The terminal emulator creates the following variable when it
     invokes another process:

	TERM	       The terminal emulator sets the
		       subprocess's TERM environment variable to
		       the termName resource value.  Applications
		       use this variable to determine the type of
		       escape sequences to use when driving the
		       terminal emulator.

	TERMINAL_EMULATOR
		       The terminal emulator sets the
		       subprocess's TERMINAL_EMULATOR environment
		       variable to dtterm to indicate that the
		       process is running from a dtterm terminal
		       emulator.

	WINDOWID       The terminal emulator sets the
		       subprocess's WINDOWID environment variable
		       to the window number of the window in
		       which text is rendered.

RESOURCES
     The dtterm utility allows the user to specify behavior
     through X11 resources as well as the command-line interface.
     The following is a list of the defined resources:

Unix System LaboratoLast change: 1 August 1995			9

dtterm(1)		 USER COMMANDS			dtterm(1)

			      The dtterm Client Resource Set
     _________________________________________________________________________________
     Name		    Class	       Type	  Default
     _________________________________________________________________________________
     allowNewWindow	    AllowNewWindow     Boolean	  True
     allowSendEvents	    AllowSendEvents    Boolean	  False
     appCursorDefault	    AppCursorDefault   Boolean	  False
     appKeypadDefault	    AppKeypadDefault   Boolean	  False
     autoWrap		    AutoWrap	       Boolean	  True
     background		    Background	       String
     backgroundIsSelect	    BackgroundIsSelect Boolean	  False
     blinkRate		    BlinkRate	       int	  250
     c132		    C132	       Boolean	  False
     charCursorStyle	    CharCursorStyle    String	  ``char_cursor_box''
     consoleMode	    ConsoleMode	       Boolean	  False
     foreground		    Foreground	       String
     geometry		    Geometry	       String	  NULL
     iconic		    Iconic	       Boolean	  False
     iconName		    IconName	       String	  ``dtterm''
     jumpScroll		    JumpScroll	       Boolean	  True
     kshMode		    KshMode	       Boolean	  False
     logging		    Logging	       Boolean	  False
     logFile		    LogFile	       String	  ``DttermLogXXXXX'' (where
							     XXXXX is a unique value)
     logInhibit		    LogInhibit	       Boolean	  False
     loginShell		    LoginShell	       Boolean	  False
     mapOnOutput	    AutoMap	       Boolean	  False
     mapOnOutputDelay	    MapDelay	       int	  0
     marginBell		    MarginBell	       Boolean	  False
     menuBar		    MenuBar	       Boolean	  True
     menuPopup		    MenuPopup	       Boolean	  True
     nMarginBell	    NMarginBell	       int	  10
     pointerBlank	    PointerBlank       Boolean	  False
     pointerBlankDelay	    PointerBlankDelay  int	  2
     pointerColor	    Foreground	       String	  foreground color
     pointerColorBackground Background	       String	  background color
     pointerShape	    PointerShape       String	  ``xterm''
     reverseWrap	    ReverseWrap	       Boolean	  False
     saveLines		    SaveLines	       String	  4s
     scrollBar		    ScrollBar	       Boolean	  True
     sunFunctionKeys	    SunFunctionKeys    Boolean	  False
     termId		    TermId	       String	  ``vt220''
     termName		    TermName	       String	  ``dtterm''
     title		    Title	       String	  ``dtterm''
     ttyModes		    TtyModes	       String	  NULL
     userBoldFont	    UserBoldFont       XmFontList dynamic
     userFont		    UserFont	       XmFontList dynamic
     visualBell		    VisualBell	       Boolean	  False
     _________________________________________________________________________________

	allowNewWindow
	      Specifies whether or not the New command appears on

Unix System LaboratoLast change: 1 August 1995		       10

dtterm(1)		 USER COMMANDS			dtterm(1)

	      the Window menu.

	allowSendEvents
	      Specifies that the terminal emulator allow syn-
	      thetic events (generated and sent by another appli-
	      cation).	Enabling this resource opens up a possi-
	      ble security hole.

	appCursorDefault
	      If True, the cursor keys are initially in applica-
	      tion mode.  If False, the cursor keys are initially
	      in cursor mode.

	appKeypadDefault
	      If True, the keypad keys are initially in applica-
	      tion mode.  If False, the keypad keys are initially
	      in numeric mode.

	autoWrap
	      Specifies whether or not auto-wraparound is ini-
	      tially enabled.

	background
	      Specifies the background color of the terminal win-
	      dow as well as the default background color for the
	      scroll bar.  This resource defaults to either the
	      primary colorset background or select pixel (see
	      backgroundIsSelect).

	backgroundIsSelect
	      Specifies that the terminal window should use the
	      Motif select color instead of the background color
	      for the terminal window's background color.

	blinkRate
	      Specifies the number of milliseconds the cursor is
	      in the on and off states while blinking.	A value
	      of 250 blinks the cursor two times per second.  A
	      value of zero turns blinking off.

	c132  Specifies whether or not the DECCOLM escape
	      sequence, which switches between a 132- and 80-
	      column window, is honored.

	charCursorStyle
	      This resource specifies the shape of the text cur-
	      sor.  A char_cursor_box value specifies a cursor
	      the width and height of the base font's bounding
	      box.  A char_cursor_bar value specifies a cursor
	      the width of the base font's bounding box, 2 pixels
	      high, and drawn with its top on the baseline.

Unix System LaboratoLast change: 1 August 1995		       11

dtterm(1)		 USER COMMANDS			dtterm(1)

	consoleMode
	      Specifies that output directed at /dev/console be
	      directed instead to the terminal window.	It is
	      provided as a way to prevent output, that would
	      normally be displayed on the internal terminal emu-
	      lator (ITE), from overwriting the X server's
	      display.	It is not provided as a general mechanism
	      to direct the output from an arbitrary system's
	      /dev/console to an arbitrary X server.  Ownership
	      of, and read-write permission for, /dev/console is
	      required in order to redirect console output.

	foreground
	      Specifies the foreground of the terminal window as
	      well as the default used by dtterm for the scroll
	      bar and the color used for the pointer cursor.
	      This resource defaults to the primary colorset
	      foreground pixel.

	geometry
	      Specifies the terminal window's preferred size and
	      position.	 The default size is 24 lines of 80 char-
	      acters each.  There is no default position.

	iconGeometry
	      Specifies the preferred position of the terminal
	      emulator's icon.	Window managers may ignore this
	      value.  There is no default.

	iconic
	      Specifies whether or not the terminal emulator is
	      initially displayed in an iconified state.

	iconName
	      Specifies the name for the icon.	When used with
	      the -e option, the default is the last component of
	      the program's path; otherwise, the default is the
	      last component of the name used to execute dtterm
	      (that is, argv[0]).

	jumpScroll
	      Specifies that dtterm use jump scrolling.	 With
	      jump scrolling, the screen may be scrolled more
	      than one line at a time.	This provides for faster
	      screen updates when multiple lines of text are sent
	      to the terminal.	The maximum number of lines that
	      may be jump scrolled is limited to the number of
	      lines in the terminal window.  The dtterm terminal
	      emulator guarantees that all lines are displayed.

	kshMode
	      Enables ksh mode.	 With ksh mode, a key pressed

Unix System LaboratoLast change: 1 August 1995		       12

dtterm(1)		 USER COMMANDS			dtterm(1)

	      with the extend modifier bit set generates an
	      escape character followed by the character gen-
	      erated by the un-extended keystroke.  This option
	      is provided for use with the emacs command-line
	      editor mode of ksh(1).  It conflicts with the nor-
	      mal meta key use for generating extended single
	      byte characters and for generating multi-byte Asian
	      characters.

	logging
	      Enables output logging.  When logging is enabled,
	      all output received from the subprocess is logged
	      either to a file or to a command pipeline (as
	      specified via the logFile option).  Since the data
	      is logged directly from the subprocess, it includes
	      all escape characters and carriage-returns and new-
	      line pairs the terminal line discipline sends.
	      Logging may be enabled and disabled via escape
	      sequences.

	logFile
	      Specifies the filename to which dtterm writes the
	      output log.  If the filename begins with a pipe
	      symbol (|), dtterm assumes the rest of the string
	      is a command to be used as the endpoint of a pipe.
	      The default filename is DttermLog XXXXX (where
	      XXXXX is a unique value) and is created in the
	      directory from which the subprocess was started.

	logInhibit
	      Indicates that dtterm inhibit device and file log-
	      ging.

	loginShell
	      Indicates that the shell that is started be a login
	      shell (that is, the first character of argv[0] is a
	      dash), indicating that the shell should read the
	      system's profile and the user's .profile files (for
	      ksh(1) and sh(1)) or the system csh.login and the
	      user's .login (for csh(1)).

	mapOnOutput
	      Indicates that the terminal emulator map (de-
	      iconify) itself upon subprocess output if it is
	      unmapped (iconified).  The user can specify, via
	      the mapOnOutputDelay resource, an initial period of
	      time during which dtterm does not map itself upon
	      subprocess output.

	mapOnOutputDelay
	      Specifies the number of seconds after start-up that
	      dtterm does not honor the mapOnOutput resource.

Unix System LaboratoLast change: 1 August 1995		       13

dtterm(1)		 USER COMMANDS			dtterm(1)

	      This allows the application to send initial output
	      (for example, shell prompts) to the terminal
	      without auto mapping the window.	The default is
	      zero (no delay).

	marginBell
	      Specifies whether or not the bell rings when the
	      user types near the right margin.	 The distance
	      from the right margin is specified by the nMargin-
	      Bell resource.

	menuBar
	      Indicates that dtterm displays a pulldown menu bar.
	      The default is True.

	menuPopup
	      Indicates that dtterm displays a popup menu.  The
	      default is True.

	nMarginBell
	      Specifies the number of characters from the right
	      margin at which the margin bell rings, when
	      enabled.

	pointerBlank
	      Specifies that dtterm puts the pointer cursor into
	      blanking mode.  In this mode, the cursor turns on
	      when the pointer is moved, and is blanked after a
	      selectable number of seconds or after keyboard
	      input.  The pointerBlankDelay resource sets the
	      delay.

	pointerBlankDelay
	      Specifies the number of seconds to wait after the
	      pointer has stopped moving before blanking the
	      pointer (see pointerBlank).  A value of zero delays
	      pointer blanking until a key is pressed.

	pointerColor
	      Specifies the foreground color used by dtterm for
	      the terminal window's pointer (X11) cursor.  The
	      default is the terminal window's foreground color
	      (see foreground).

	pointerColorBackground
	      Specifies the background color used by dtterm for
	      the terminal window's pointer (X11) cursor.  The
	      default is the terminal window's background color
	      (see background).

	pointerShape
	      Specifies the X cursor font character used by

Unix System LaboratoLast change: 1 August 1995		       14

dtterm(1)		 USER COMMANDS			dtterm(1)

	      dtterm as the pointer cursor.  The font character
	      must be specified as a string from the
	      <X11/cursorfont.h> header with the leading XC_
	      removed.	The default is xterm(1X).

	reverseWrap
	      Specifies whether or not reverse-wraparound is
	      enabled.

	saveLines
	      Specifies the number of lines in the terminal
	      buffer beyond the length of the window.  The option
	      value consists of a number followed by an optional
	      suffix.  If no suffix is included or the suffix is
	      ``l'' (ell), the total length of the terminal
	      buffer is screens plus the length of the terminal
	      window.  If the suffix is ``s'' (ess) the total
	      length of the terminal buffer is (screens+1) times
	      the length of the terminal window.  The dtterm
	      utility attempts to maintain the same buffer-to-
	      window ratio when the window is resized larger.

	scrollBar
	      Specifies that dtterm displays a scroll bar.

	sunFunctionKeys
	      Specifies whether dtterm generates Sun Function Key
	      escape sequences instead of standard ANSI escape
	      sequences for the terminal's function keys.

	termId
	      Supplies the name used to select the correct
	      response to terminal ID queries.	Valid values are
	      vt100, vt101, vt102, and vt220.

	termName
	      Specifies a name to which dtterm sets the TERM
	      environment variable.  The default is dtterm.

	title
	      Specifies the window title.  When used with the -e
	      option, the default is the last component of the
	      program's path; otherwise, the default is the last
	      component of the name used to execute dtterm (that
	      is, argv[0]).

	ttyModes
	      Specifies a string containing terminal-setting key-
	      words and the characters to which they can be
	      bound.  Allowable keywords include:  intr, quit,
	      erase, kill, eof, eol, swtch, start, stop, brk,
	      susp, dsusp, rprnt, flush, weras and lnext.  The

Unix System LaboratoLast change: 1 August 1995		       15

dtterm(1)		 USER COMMANDS			dtterm(1)

	      terminal emulator correctly parses and silently
	      ignores keywords that do not apply to a specific
	      architecture.  Control characters can be specified
	      as ^char (for example, ^c or ^u), and ^? can be
	      used to indicate Delete.	This is useful for over-
	      riding the default terminal settings without having
	      to do an stty(1) every time a DtTerm widget is
	      created.

	userBoldFont
	      Specifies an XFontSet used by dtterm when display-
	      ing bold terminal text.  The XFontSet should be
	      specified as a Motif XmFontList3X.  The terminal
	      emulator supports only character or mono-spaced
	      fonts.  When using proportional fonts, the behavior
	      is undefined.  The terminal emulator generates a
	      default bold font based on the XLFD name of the
	      userFont.	 If that font is not available, dtterm
	      generates bold text by overstriking (with a one
	      pixel offset) the userFont.

	userFont
	      Specifies an XFontSet used by dtterm when display-
	      ing terminal text.  XFontSet should be specified as
	      a Motif XmFontList3X.  The terminal emulator sup-
	      ports only character or mono-spaced fonts.  When
	      using proportional fonts, the behavior is unde-
	      fined.  This font is not used to display non-
	      terminal text (such as menu bar, popup menu and
	      dialog).	The default is the XmNtextFontList value
	      of the parent bulletin board (see the XmBulletin-
	      Board widget) in the same manner as the XmText
	      widget.

	visualBell
	      Indicates that a visual bell is preferred over an
	      audible one.  Instead of ringing the terminal bell
	      whenever a <control>-G is received, the window is
	      flashed.

  Resource/Option Correspondence
     Many of the preceding resources correspond to the command-
     line arguments.  The following table describes the relation-
     ship between the two:
      Command-line option		  Resource Setting
  _________________________________________________________________
  -132				 *c132: True
  +132				 *c132: False
  -aw				 *autoWrap: True
  +aw				 *autoWrap: False
  -anw				 *allowNewWindow: False
  +anw				 *allowNewWindow: True

Unix System LaboratoLast change: 1 August 1995		       16

dtterm(1)		 USER COMMANDS			dtterm(1)

  -background background_color	 *background: background_color
  -bg background_color		 *background: background_color
  -bs				 *backgroundIsSelect: True
  +bs				 *backgroundIsSelect: False
  -C				 *consoleMode: True
  -display display_name		 .display: display_name
  -e program_argument...
  -fb fontset			 *userBoldFont: fontset
  -fg foreground_color		 *foreground: foreground_color
  -fn fontset			 *userFont: fontset
  -font fontset			 *userFont: fontset
  -foreground foreground_color	 *foreground: foreground_color
  -geometry geometry_string	 .geometry: geometry_string
  -iconic			 .iconic: True
  +iconic			 .iconic: False
  -j				 *jumpScroll: True
  +j				 *jumpScroll: False
  -kshMode			 *kshMode: True
  +kshMode			 *kshMode: False
  -l				 *logging: True
  +l				 *logging: False
  -lf file_name			 *logFile: file_name
  -ls				 *loginShell: True
  +ls				 *loginShell: False
  -map				 *mapOnOutput: True
  +map				 *mapOnOutput: False
  -mb				 *marginBell: True
  +mb				 *marginBell: False
  -ms pointer_color		 *pointerColor: pointer_color
  -name prog_name		 .name: prog_name
  -nb number			 *nMarginBell: number
  -rw				 *reverseWrap: True
  +rw				 *reverseWrap: False
  -sb				 *scrollBar: True
  +sb				 *scrollBar: False
  -sf				 *sunFunctionKeys: True
  +sf				 *sunFunctionKeys: False
  -sl screenss			 *saveLines: screens * lines/screen
  -sl lines			 *saveLines: lines
  -ti term_id			 *termId: term_id
  -title title_string		 .title: title_string
  -tm term_modes		 *ttyModes: term_modes
  -tn term_name			 *termName: term_name
  -vb				 *visualBell: True
  +vb				 *visualBell: False
  _________________________________________________________________

ASYNCHRONOUS EVENTS
     The dtterm utility takes the standard action for all sig-
     nals.

Unix System LaboratoLast change: 1 August 1995		       17

dtterm(1)		 USER COMMANDS			dtterm(1)

STDOUT
     Not used.

STDERR
     Used only for diagnostic messages.

OUTPUT FILES
     None.

EXTENDED DESCRIPTION
     None.

EXIT STATUS
	 0  successful completion

	>0  an error occurred

CONSEQUENCES OF ERRORS
     Default.

APPLICATION USAGE
     None.

EXAMPLES
     None.

SEE ALSO
     DtTerm(5), stty(1), dtterm(5), X(1X), XmFontList(3X),
     XmText(3X), pty(7), tty(7).

Unix System LaboratoLast change: 1 August 1995		       18

[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server UnixWare

List of man pages available for UnixWare

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net