Provides runtime support of legacy applications.
dtterm [Flags...]
The dtterm client provides runtime support of legacy applications written for ANSI X3.64-1979 and ISO 6429:1992(E) conformant character terminals.
Item | Description |
---|---|
-132 | Causes the DECCOLM escape sequence to be recognized, and the dtterm window will resize appropriately. Normally the DECCOLM escape sequence that switches between 80 and 132 column mode is ignored. Associated resource: c132. |
+132 | Causes the DECCOLM escape sequence to be ignored. This is the default behavior. Associated resource: c132. |
-aw | Indicates that auto-wraparound should be allowed. This 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. Associated resource: autoWrap. |
+aw | Indicates that auto-wraparound should not be allowed. Associated resource: autoWrap. |
-background background_color | Specifies the background of the terminal window as well as the default background used for the scroll bar and the X11 pointer cursor. Under CDE, this flag defaults to the primary colorset select pixel or background pixel, see -bs. Without CDE, this flag defaults to *background/*Background with an ultimate fallback color of black. background_color describes the background color to use. Associated resource: background. |
-bd border_color | Specifies the border color for all windows. The shell widget's border may not be visible when reparenting window managers such as dtwm and mwm are used. The default color is black. border_color describes the border color to use. Associated resource: borderColor. |
-bg background_color | Identical to -background. background_color describes the background color to use. Associated resource: background. |
-bordercolor border_color | Identical to -bd above. border_color describes the border color to use. Associated resource: borderColor. |
-borderwidth border_width | Specifies the border width of the shell widget's window. This value may be overridden by reparenting window managers such as dtwm and mwm. The default is 0. border_width specifies the width of the window border in pixels. Associated resource: borderWidth. |
-bs | Specifies that the terminal window should use the Motif select color instead of the background color for the terminal window's background color. This is the default behavior. Associated resource: backgroundIsSelect. |
+bs | Specifies that the terminal window should not use the Motif select color instead of the background color for the terminal window's background color. Associated resource: backgroundIsSelect. |
-bw border_width | Identical to -borderwidth. Associated resource: borderWidth. |
-C | Specifies that output directed at /dev/console should be directed instead to the terminal window. It is provided as a way to prevent output that would normally be displayed on the 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. |
Item | Description |
---|---|
-display display_name | Specifies the X11 display server to be used by dtterm. This defaults to the value in the $DISPLAY environment variable. display_name specifies the X11 server to connect to. |
-e program_argument... | Specifies an executable program to be invoked as a subprocess when dtterm is started. This flag must be the last flag on the command line. program_argument specifies the program and command line arguments to run. |
-fb fontset | Specifies an XFontSet to be used when displaying bold terminal text. It should be specified as a Motif XmFontList. Only character or mono spaced fonts are supported. The behavior when using proportional fonts is undefined. A default bold font will be generated based on the XLFD name of the userFont. If that font is not available, bold text will be generated by overstriking (with a one pixel offset) the userFont. fontset specifies the bold terminal XFontSet to use. Associated resource: userFont. |
-fg foreground_color | Specifies the foreground color of the terminal window as well as the default foreground color used for the scroll bar and for the X11 pointer cursor. Under CDE, this resource will default to the primary color set foreground pixel. Without CDE, this resource will default to *foreground or *Foreground with an ultimate fallback color of white. foreground_color specifies the foreground color to use. Associated resource: foreground. |
-fn fontset | Specifies an XFontSet to be used when displaying terminal text. It should be specified as a Motif XmFontList. Only character or mono spaced fonts are supported. The behavior when using proportional fonts is undefined. This font will not be used to display non-terminal text (menu bar, popup menus, dialogs, etc.). The default is to use the XmNtextFontList value of the parent bulletin board (see XmBulletinBoard) in the same manner as the XmText widget. fontset specifies the terminal XFontSet to use. Associated resource: userFont. |
-font fontset | Identical to -fn. fontset specifies the terminal XFontSet to use. Associated resource: userFont. |
-foreground foreground | Identical to -fg. foreground specifies the foreground color to use. Associated resource: foreground. |
-geometry geometry_string | Specifies the preferred size and position of the terminal window. The default size is 24 lines of 80 characters each. There is no default position. geometry_string specifies the terminal geometry to use. Associated resource: geometry. |
-help | Displays a message summarizing the usage of dtterm. |
-iconic | Specifies that the terminal emulator should initially be placed on the display iconified. Associated resource: iconic. |
+iconic | Specifies that the terminal emulator should initially be placed on the display as a normal window. This is the default behavior. Associated resource: iconic. |
-j | Specifies that jump scrolling should be used. Under 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 being 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. All lines are displayed. This is the default behavior. Associated resource: jumpScroll. |
+j | Specifies that jump scrolling should not be used. For a description of jump scrolling, see -j. Associated resource: jumpScroll. |
-kshMode | Specifies that ksh mode should be enabled. Under ksh mode, a key pressed with the extend modifier bit set will generate an escape character followed by the character generated by the un-extended keystroke. This flag is provided for use with emacs and the emacs command line editor mode of ksh or ied. It conflicts with \ the normal use of the meta key for generating extended single byte characters, and for generating multi-byte Asian characters. Associated resource: kshMode. |
+kshMode | Specifies that the ksh mode should not be enabled. This is the default behavior. Associated resource: kshMode. |
-l | 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 -If flag). Since the data is being logged directly from the subprocess, it includes all escape characters and carriage return/newline pairs sent by the terminal line discipline. Output may be enabled and disabled via escape sequences. Associated resource: logging. |
+l | Disables output logging. For a description of output logging, see -l. This flag is the default. Associated resource: logging. |
-lf file_name | Specifies the name of the file to which the output log described in the -l flag. If file_name begins with a pipe symbol (|), the rest of the string is assumed to be a command to be used as the endpoint of a pipe. The default filename is DttermLogXXXXX (where XXXXX is the process id of dtterm) and is created in the directory from which dtterm was started. If the last five characters are XXXXX, they are replaced by the process ID. file_name specifies the log file name to use. Associated resource: logFile. |
-ls | Indicates that the shell that is started should be a login shell (i.e. the first character of argv[0] will be a dash, indicating to the shell that it should read the system's profile and the user's $HOME/.profile (for ksh and sh) or the system's csh.login and the user's $HOME.login (for csh). Associated resource: loginShell. |
+ls | Specifies that a normal (non-login) shell should be started. This is the default behavior. Associated resource: loginShell. |
-map | Indicates that dtterm should map (de-iconify) itself upon subprocess output if it is unmapped (iconified). An initial period of time during which dtterm will not map itself upon subprocess output may be specified via the mapOnOutputDelay resource. Associated resource: mapOnOutput. |
+map | Specifies that there should be no special mapping behavior. This is the default behavior. Associated resource: mapOnOutput. |
-mb | Indicates that dtterm should ring a margin bell when the user types near the right margin. The actual distance involved is specified by the -nb flag. Associated resource: marginBell. |
+mb | Indicates that margin bell should not be rung when the user types near the right margin. This is the default. Associated resource: marginBell. |
-ms pointer_color | Specifies the foreground color to use for the terminal window's (X11) pointer cursor. The default is to use the terminal window's foreground color. See foreground. pointer_color specifies the pointer foreground color to use. Associated resource: pointerColor. |
Item | Description |
---|---|
-name prog_name | Specifies the X11 name of the dtterm window. prog_name the name to use. |
-nb number | Specifies the number of characters from the right margin at which the margin bell will ring, if enabled. The default is 10. Associated resource: nMarginBell. |
-r | Causes the dtterm window to be displayed with the foreground and background colors reversed. This is identical to the -rv and -reverse flags. |
+r | Causes the dtterm window to be displayed with the normal foreground and background colors. This is the default, and is also identical to the +rv flag. |
-reverse | Causes the dtterm window to be displayed with the foreground and background colors reversed. This is identical to the -r and -rv flag. |
-rv | Causes the dtterm window to be displayed with the foreground and background colors reversed. This is identical to choosing Options | Global Options, and then changing the ``windowBackground'' options menu to ``Inverse.'' A dtterm window started with this flag has the`` Window Background'' options menu set to ``Inverse.'' See ``Global Options''. |
+rv | Causes the dtterm window to be displayed with the normal foreground and background colors. This is the default. |
-rw | Specifies that reverse-wraparound should be enabled. Associated resource: reverseWrap. |
+rw | Indicates that reverse-wraparound should not be enabled. This is the default. Associated resource: reverseWrap. |
-Sccn | Specifies that the terminal emulator should be run against a pre-opened pty or STREAMS device. This flag is provided for use where the pty or STREAMS device's slave name is of the form tty?? (i.e., exactly two characters following the tty). This flag is intended for use when dtterm is invoked programmatically from another application. cc specifies the last two characters of the pty or STREAMS device's slave name, where the slave name is of the form tty??. This value is ignored, but must be exactly two characters in length. n specifies the number of the file descriptor that corresponds to the pty or STREAMS device's already-opened master side. |
-Sc.n | This flag is identical to -Sccn above, but is provided for systems with a larger pty name space. c specifies the last component of the pty slave name. This values is ignored and may be empty. n specifies the number of the file descriptor that corresponds to the pty's already-opened master side. |
-sb | Indicates that a scrollbar should be displayed. This is the default. Associated resource: scrollBar. |
+sb | Indicates that a scrollbar should not be displayed. Associated resource: scrollBar. |
-sf | Indicates that Sun Function Key escape codes should be generated for function keys instead of standard VT220 escape sequences. Associated resource: sunFunctionKeys. |
+sf | Indicates that the standard escape sequences should be generated for function keys instead of the Sun Function Key escape codes. This is the default behavior. Associated resource: sunFunctionKeys. |
-sl screens[s|l] | Specifies the number of lines in the terminal buffer beyond the length of the window. The flag 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 will be screens plus the length of the terminal window. If the suffix is s (ess), the total length of the terminal buffer will be (screens plus one) times the length of the terminal window. dtterm will try to maintain the same buffer-to-window ratio when the window is resized larger. The default is 4s. screens specifies the number of screens or lines to save. Associated resource: saveLines. |
-ti term_id | Supplies the name used to select the correct response to terminal ID queries. Valid values are vt100, vt101, vt102, and vt220. The default is vt220. term_id specifies the terminal ID to use. |
-title title_string | Specifies the window title. If the -e flag is used, the default will be the last component of the program's path. If the -e flag is not used, the default will be the last component of the name used to run dtterm (i.e., argv[0]). title_string specifies the title to use. Associated resource: title. |
-tm term_modes | Specifies a string containing terminal-setting keywords and the characters to which they may be bound. Allowable keywords include intr, quit, erase, kill, eof, eol, swtch, start, stop, brk, susp, dsusp, rprnt, flush, weras, and lnext. Keywords that do not apply to a specific architecture will be correctly parsed and ignored. Control characters may be specified as ^ followed by char (e.g. ^c or ^u), and ^? may be used to indicate delete. This is useful for overridding the default terminal settings without having to do an stty every time a terminal process is started. The default is NULL. term_modes specifies the terminal mode string. Associated resource: ttyModes. |
-tn term_name | Specifies a name to set the $TERM environment variable to. The default is vt220. term_name specifies the terminal name to use. Associated resource: termName. |
-usage | Prints a usage message on the screen. |
-vb | 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 will be flashed. Associated resource: visualBell. |
+vb | Indicates that an audio bell is preferred over a visual one. This is the default behavior. Associated resource: visualBell. |
-w border_width | Identical to -borderwidth. border_width specifies the width of the window border in pixels. |
-xrm resource_string | Allows X11 Resource Manager-style resources to be specified on the command line. resource_string specifies an X11 resource string. |
Item | Description |
---|---|
allowSendEvents | Specifies that the terminal emulator should allow synthetic events (generated and sent by another application). Enabling this resource opens up a possible security risk. The default is False. |
appCursorDefault | If True, the cursor keys are initially in application mode. If False, they are initially in cursor mode. The default is False. |
appKeypadDefault | If True, the keypad keys are initially in application mode. If False, they are initially in numeric mode. The default is False. |
autoWrap | Specifies whether or not auto-wraparound is initially enabled. The default is True. |
background | Specifies the background color of the terminal window as well as the default background color used for the scrollbar. Under CDE, this resource defaults to either the primary color set select pixel or the primary color set background pixe, see backgroundIsSelect. The default is the primary color set background pixel. Without CDE, this resource defaults to black. |
backgroundIsSelect | When True, this resource specifies that the terminal window should use the Motif select color instead of the background color for the terminal window's background color. The default is False. |
blinkRate | Specifies the number of milliseconds the cursor is in the on and off states while blinking. A value of 250 will blink the cursor two times per second. A value of 0 will turn blinking off. The default is 250. |
borderColor | Defines the border color for the window. The window border may not be visible when reparenting window managers such as dtwm and mwm are used. The default is ``black''. |
borderWidth | Specifies the border width of the shell widget's window. This value may be overridden by reparenting window managers such as dtwm and mwm. The default is 0. |
c132 | Specifies whether or not the DECCOLM escape sequence that switches to window with between 80 and 132 columns should be honored. The default is False. |
charCursorStyle | Specifies the shape of the text cursor. A value of char_cursor_box specifies a cursor with the width and height of the base font's bounding box. A value of char_cursor_bar specifies a cursor with the width of the base font's bounding box, a height of two pixels, and drawn with it's top on the baseline. The default is char_cursor_box. |
consoleMode | Specifies that output directed at /dev/console should be directed instead to the terminal window. It is provided as a way to prevent output that would normally be displayed on the 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. Note that you must have ownership of and read/write access to /dev/console for this flag to work. The default is False. |
foreground | Specifies the foreground color of the terminal window as well as the default foreground color used for the scrollbar and the color used for the pointer cursor. Under CDE, this resource will default to the primary colorset foreground. Otherwise, it defaults to ``white''. |
geometry | Specifies the preferred size and position of the terminal window. 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 | If true, specifies that the terminal emulator should initially be placed on the display iconified. Window managers (including dtwm and mwm may ignore this value. The default is False. |
iconicName | Specifies the name for the icon. If the -e flag is used, the default will be the last component of the program's path. If the -e flag is not used, the default will be the base name of the name used to run dtterm (i.e., argv[0]). |
jumpScroll | Specifies that jump scrolling should be used. Under 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 being sent to the terminal. The maximum number of lines that may be jump scrolled is limited to the number of lines in the display. It is guaranteed that all lines will be displayed. The default is True. |
kshMode | Specifies that ksh mode should be enabled. Under ksh mode, a key pressed with the extend modifier bit set will generate an escape character followed by the character generated by the un- extended keystroke. This flag is provided for use with emacs and emacs command line editor mode of ksh or ied. It conflicts with the normal use of the meta key for generating extended single byte characters and for generating multi-byte Asian characters. The default is False. |
logFile | Specifies the name of the file to which the output log described below is written. If the filename begins with a pipe symbol (|), the rest of the string is assumed to be a command to be used as the endpoint of a pipe. The default filename is DttermLogXXXXX (where XXXXX is a unique character string) and is created in the directory from which the subprocess was started. If the last five characters are XXXXX, they are replaced by a unique character string. |
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 flag). Since the data is being logged directly from the subprocess, it includes all escape characters and carriage return/newline pairs sent by the terminal line discipline. Output may be enabled and disabled via escape sequences. The default is False. |
logInhibit | Specifies that device and file logging should be inhibited. The default is False. |
loginShell | Specifies that the shell that is started should be a login shell (i.e. the first character of argv[0] will be a dash, indicating to the shell that it should read the system's profile and the user's $HOME/.profile (for ksh and sh) or the system's csh.login and the user's $HOME/.login (for csh). The default is False. |
Item | Description |
---|---|
mapOnOutput | Indicates that the terminal emulator should map (de-iconify) itself upon subprocess output if it is unmapped (iconified). An initial period of time during which it will not map itself upon subprocess output may be specified via the mapOnOutputDelay resource. The default is False. |
mapOnOutputDelay | Specifies the number of seconds after start-up that dtterm will not honor the mapOnOutput resource. This allows for initial output (e.g., shell prompts) to be sent to the terminal without auto mapping the window. The default is 0 (no delay) |
marginBell | Specifies whether or not the bell should be run when the user types near the right margin. The default is False. |
menuBar | Specifies that a pulldown menu should be displayed. The default is True. |
menuPopup | Specifies that a popup menu should be enabled. The default is True. |
nMarginBell | Specifies the number of characters from the right margin at which the margin bell should be rung, when enabled. The default is 10. |
pointerBlank | Specifies that the pointer cursor should be put into blanking mode. In this mode, the cursor will turn on when the pointer is moved, and will be blanked either after a selectable number of seconds or after keyboard input has occurred. The delay is set via the pointerBlankDelay resource. The default is False. |
pointerBlankDelay | Defines the number of seconds to wait before blanking the pointer cursor after the pointer has been moved. A value of 0 invokes pointer blanking only on keyboard input. The default is 2 seconds. |
pointerColor | Specifies the foreground color to use for the terminal window's pointer (X11) cursor. The default is to use the terminal window's foreground color. See foreground. |
pointerColorBackground | Specifies the background color to use for the terminal windows pointer (X11) cursor. The default is to use the terminal windows background color See background. |
pointerShape | Specifies the X cursor font character to use as the pointer cursor. It should be specified as a string from the include file with the leading XC_ removed. The default is xterm. |
reverseVideo | Specifies whether or not reverse video should be used. The default is False. |
reverseWrap | Specifies whether or not reverse-wraparound should be enabled. The default is False. |
saveLines | Specifies the number of lines in the terminal buffer beyond length of the window. The 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 will be screens plus the length of the terminal window. If the suffix is s (ess), the total length of the terminal buffer will be (screens plus one) times the length of the terminal window. dtterm will try to maintain the same buffer-to-window ratio when the window is resized larger. The default is 4s. |
scrollBar | Specifies whether or not the scrollbar should be visible. The default is True. |
sunFunctionKeys | Specifies whether or not Sun Function Key escape codes should be generated for function keys instead of standard VT220 escape sequences. The default is False. |
termId | Supplies the name used to select the correct response to terminal ID queries. Valid values are vt100, vt101, vt102, and vt220. The default is vt220. |
termName | Defines the name for the $TERM environment variable. The default is vt220. |
title | Specifies the window title. If the -e flag is used, the default will be the last component of the program's path. If the -e flag is not used, the default will be the last component of the name used to run dtterm (i.e., argv[0]). |
ttyModes | Specifies a string containing terminal-setting keywords and the characters to which they may be bound. Allowable keywords include: intr, quit, erase, kill, eof, eol, swtch, start, stop, brk, susp, dsusp, rprnt, flush, weras, and Inext. Keywords that do not apply to a specific architecture will be correctly parsed and ignored. Control characters may be specified as ^ followed by char (e.g. ^c or ^u), and ^? may be used to indicate delete. This is very useful for overriding the default terminal settings without having to do an stty every time a terminal process is started. The default is NULL. |
userBoldFont | Specifies an XFontSet to be used when displaying bold terminal text. It should be specified as a Motif XmFontList. Only character or mono spaced fonts are supported. The behavior when using proportional fonts is undefined. A default bold font will be generated based on the XLFD name of the userFont. If that font is not available, bold text will be generated by overstriking (with a one pixel offset) the userFont. |
userFont | Specifies an XFontSet to be used when displaying terminal text. It should be specified as a Motif XmFontList. Only character or mono spaced fonts are supported. The behavior when using proportional fonts is undefined. This font will not be used to display non-terminal text (menu bar, popup menu, dialog, etc.). The default is to use the XmNtextFontList value of the parent bulletin board (see XmBulletinBoard(3X)) in the same manner as the XmText widget. |
visualBell | Specifies that a visual bell is preferred over an audible one. Instead of ringing the terminal bell whenever a CTRL-G is received, the windows will be flashed. The default is False. |
Item | Description |
---|---|
select | The left button is used to select the text to be copied. Move the pointer to the beginning of the text to copy, press and hold the left button, move the cursor to the end of the text to copy, and release the button. Any currently selected text can be deselected by clicking the left button once without moving the mouse. |
insert | The middle button pastes the text from the primary selection, treating it as keyboard input. |
Item | Description |
---|---|
bell ([Percentage]) | This action rings the keyboard bell at the specified percentage above or below the base volume. |
break ( ) | This action send a break signal to the child process. |
cancel ( ) | This action sends a CAN (cancel) character to the child process. |
do ( ) | This action sends the escape sequence associated with the Do key to the child process. |
edit-key (string) | This action sends the escape sequence associated with the corresponding edit key to the child process. The interpretation of these keys is application specific. Valid values for string are find, insert, next, prior, remove, and select. |
extend-start ( ) | Start the extension of the currently selected text. extend-end
( ) Note: Extends the current selection. The amount of text selected
depends on the number of mouse clicks.
|
function-key-execute (num [,type]) | This action sends the escape sequence associated with the corresponding function key num to the child process. Valid values for num are 1 through 35. If type is set to function (or not set at all), the escape sequence associated with function key num is sent to the child process. If type is set to UDK, then the string associated with user defined key num is sent to the child process. |
grab-focus ( ) | This action performs one of the following depending on the number of multiple mouse clicks. One click will deselect any selected text and set the selection anchor at the pointer position, two clicks will select a word, three clicks will select a line of text, and four clicks will select all text. |
hard-reset ( ) | This action will perform a hard reset on the terminal emulator. |
help ( ) | This action sends the escape sequence associated with the DEC VT220 Help key to the child process. The interpretation of this key is application specific. |
keymap (name) | This action dynamically defines a new translation table whose resource name is name with the suffix Keymap (case is significant). The name "None" restores the original translation table. |
keypad-key-execute (string) | This action sends the escape sequence associated with the corresponding keypad key to the child process. The interpretation of these keys are application specific. Valid values for string include: f1-f4, space, tab, enter, equal, multiply, add, separator, subtract, decimal, divide, and 0 - 9. |
move-cursor (direction) | This action sends the escape sequence associated with the corresponding cursor motion to the child process. The interpretation of these keys are application specific. Valid values for direction include: up, down, backward, and forward. |
redraw-display ( ) | This action redraws the contents of the text window. |
scroll (count [,units]) | This action will scroll the display memory down if count is less than zero, or up if count is greater than zero. The number of lines scrolled is based on count and units. Valid values for units are page, halfpage, or line. The default for units is line. |
select-adjust ( ) | This action extends the selection. The amount of text selected
depends on the number of mouse clicks:
|
select-all ( ) | This action selects all text. |
select-page ( ) | This action selects all text on the screen. |
self-insert ( ) | This action sends the character associated with the key pressed to the child process. |
soft-reset ( ) | This action perform a soft reset of the terminal. |
stop (state) | This action either toggles, starts, or stops the process of reading data from the child process. Valid values for state are toggle, on, and off. |
string (string) | This action inserts the specified text string as if it had been typed. The string must be quoted if it contains whitespace or non-alphanumeric characters. The string is interpreted as a hex character constant if it begins with the characters 0x. |
tab ( ) | This action sends a tab to the child process. |
visual-bell ( ) | This action flashes the window quickly. |
Virtual Bindings | The bindings for virtual keys are vendor specific. Virtual bindings do not apply when the dtterm widget has input focus. For information about bindings for virtual buttons and keys, see VirtualBindings. |
Item | Description |
---|---|
/usr/bin/diff | Contains the diff command. |