dtterm man page on IRIX

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



     dtterm(1)	       UNIX System V (1 August 1995)	     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
	  applications 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
		   cursor 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.

     Page 1					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     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
		   background 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
		   background 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
		   emulator (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
		   console 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
		   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, the
		   terminal emulator generates bold text by
		   overstriking (with a one pixel offset) the
		   userFont.  The fontset argument specifies the bold
		   terminal XFontSet used by dtterm.

     Page 2					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     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
		   specifies 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
		   characters.	The default size is 24 lines of 80
		   characters 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
		   iconified 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

     Page 3					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     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
		   logging, 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
		   newline 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

     Page 4					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     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
		   initial 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
		   distance 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

     Page 5					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     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
		   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.
		   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

     Page 6					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     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
		   keywords 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
		   overriding 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.

     Page 7					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     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
			    internationalization 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
			    internationalization 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,
			    override the values of all the other
			    internationalization variables.

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

	     NLSPATH	    Determine the location of message
			    catalogues for the processing of
			    LC_MESSAGES.

	     SHELL	    Determine the default application to run.

	     XAPPLRESDIR    Specify the name of a directory that
			    contains 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

     Page 8					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     dtterm(1)

			    specifications.

	     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:

     Page 9					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     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
		   the Window menu.

     Page 10					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     dtterm(1)

	     allowSendEvents
		   Specifies that the terminal emulator allow
		   synthetic events (generated and sent by another
		   application).  Enabling this resource opens up a
		   possible security hole.

	     appCursorDefault
		   If True, the cursor keys are initially in
		   application mode.  If False, the cursor keys are
		   initially in cursor mode.

	     appKeypadDefault
		   If True, the keypad keys are initially in
		   application mode.  If False, the keypad keys are
		   initially in numeric mode.

	     autoWrap
		   Specifies whether or not auto-wraparound is
		   initially enabled.

	     background
		   Specifies the background color of the terminal
		   window 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
		   cursor.  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.

	     consoleMode
		   Specifies that output directed at /dev/console be

     Page 11					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     dtterm(1)

		   directed instead to the terminal window.  It is
		   provided as a way to prevent output, that would
		   normally be displayed on the internal terminal
		   emulator (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
		   characters 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
		   with the extend modifier bit set generates an
		   escape character followed by the character

     Page 12					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     dtterm(1)

		   generated 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
		   normal 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
		   newline 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
		   logging.

	     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.
		   This allows the application to send initial output
		   (for example, shell prompts) to the terminal

     Page 13					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     dtterm(1)

		   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
		   nMarginBell 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
		   dtterm as the pointer cursor.  The font character
		   must be specified as a string from the

     Page 14					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     dtterm(1)

		   <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
		   keywords 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

     Page 15					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     dtterm(1)

		   architecture.  Control characters can be specified
		   as ^char (for example, ^c or ^u), and ^? can be
		   used to indicate Delete.  This is useful for
		   overriding 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
		   displaying 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
		   displaying terminal text.  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.  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
		   XmBulletinBoard 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
	  relationship 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

     Page 16					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     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
	  signals.

     STDOUT
	  Not used.

     Page 17					      (printed 9/3/04)

     dtterm(1)	       UNIX System V (1 August 1995)	     dtterm(1)

     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).

     Page 18					      (printed 9/3/04)

[top]

List of man pages available for IRIX

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