dtterm(1) — Commands
CDE
NAME
dtterm − emulate a terminal window
SYNOPSIS
dtterm [+/−132] [+/−aw] [−background background_color] [−bd border_color] [−bg background_color] [−bordercolor border_color] [−borderwidth border_width] [+/−bs] [−bw border_width] [−C] [−display display_name] [−e program_argument...] [−fb fontset] [−fg foreground_color] [−fn fontset] [−font fontset] [−foreground foreground_color] [−geometry geometry_string] [−help] [+/−miconic] [+/−mj] [+/−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]
OPTIONS
The following options are available:
−132
Recognizes the DECCOLM escape sequence and resize the window appropriately. Usually, dtterm ignores the DECCOLM escape sequence, which switches between 80- and 132-column mode.
+132
Ignores the DECCOLM escape sequence. This is the default behavior.
−aw
Permits 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.
+aw
Does not allow auto-wraparound.
−background background_color
Specifies 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.
−bd border_color
Specifies the border color for all windows. The shell widget’s window border need not be visible when re-parenting window managers, such as dtwm(1), are used. The default is the color black. The border_color argument describes the border color.
−bg background_color
Equivalent to −background. The background_color argument describes the background color.
−bordercolor border_color
Equivalent to −bd. The border_color argument describes the border color.
−borderwidth border_width
Specifies the border width of the shell widget’s window. This value may be overridden by re-parenting window managers. The default is zero. The border_width argument specifies the width of the window border in pixels.
−bs
Uses the Motif select color instead of the background color for the terminal window’s background color.
+bs
Does not use the Motif select color instead of the background color for the terminal window’s background color. This is the default behavior.
−bw border_width
Equivalent to −borderwidth. The border_width argument specifies the width of the window border in pixels.
−CSpecifies that output directed to /dev/console be directed instead to the terminal window. It is provided as a way to prevent output, which would usually 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
Specifies 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 ...
Specifies 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
Specifies an XFontSet used by dtterm when displaying bold terminal text. The XFontSet should be specified as a Motif XmFontList(3X). 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.
−fg foreground_color
Specifies 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
Specifies an XFontSet used by dtterm when displaying terminal text. It should be specified as a Motif XmFontList(3X). 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
Specifies 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
Displays a message summarizing dtterm usage.
−iconic
Displays the terminal emulator initially in an minimized state.
+iconic
Displays the terminal emulator initially as a normal window. This is the default behavior.
−jUses 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. This is the default behavior.
+jDoes not use jump scrolling.
−kshMode
Enables 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
Does not enable ksh(1) mode. This is the default behavior.
−lEnables 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 with 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 with escape sequences.
+lDisables output logging. This is the default behavior.
−lf file_name
Names 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 DttermLogXXXXX; (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.
−lsStarts 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 csh.login and the user’s .login (for csh(1)).
+lsStarts a normal (non-login) shell. This is the default behavior.
−map
Maps (regularizes) dtterm upon subprocess output if dtterm is unmapped (minimized). The user can specify, with the mapOnOutputDelay resource, an initial period of time during which dtterm does not map itself upon subprocess output.
+map
Indicates there is no special mapping behavior. This is the default behavior.
−mb
Rings 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
Does not ring a bell when the user types near the right margin. This is the default behavior.
−ms pointer_color
Specifies 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
Specifies the X11 name of the dtterm window. The prog_name argument specifies the name to use.
−nb number
Rings 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
Enables reverse-wraparound.
+rw
Does not enable reverse-wraparound. This is the default behavior.
−Sccn
Runs the terminal emulator against a preopened 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 invoked programmatically from within another application. The cc argument specifies the last 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
Displays a scroll bar. This is the default behavior.
+sb
Does not display a scroll bar.
−sfGenerates Sun Function Key escape sequences instead of standard ANSI escape sequences for the terminal’s function keys.
+sfGenerates 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]
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. The default is 4s. The screens argument specifies the number of screens or lines to save.
−ti term_id
Specifies 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 the terminal ID to use.
−title title_string
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]). The title_string argument specifies the title used by dterm.
−tm term_modes
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 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
Specifies 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
Displays a usage message on the screen.
−vb
Uses a visual bell instead of an audible one. Flashes the window instead of ringing the terminal bell whenever a <control>-G is received.
+vb
Uses an audio bell instead of a visual one. This is the default behavior.
−xrm resource_string
Permits 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(3X11) for more information.)
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.
EXIT STATUS
0successful completion
>0an error occurred
OPERANDS
None
STDIN
Not used
INPUT FILES
None
RESOURCES
The dtterm utility lets the user specify behavior through X11 resources as well as the command-line interface. The following is a list of the defined resources:
| Name | Class | Type | Default |
| allowSendEvents | AllowSendEvents | Boolean | False |
| appCursorDefault | AppCursorDefault | Boolean | False |
| appKeypadDefault | AppKeypadDefault | Boolean | False |
| autoWrap | AutoWrap | Boolean | True |
| background | Background | String | |
| backgroundIsSelect | BackgroundIsSelect | Boolean | False |
| BackgroundIsSelect | Boolean | True | |
| backSpaceIsDelete | BackSpaceIsDelete | Boolean | True for PC keyboard; otherwise False |
| blinkRate | BlinkRate | int | 250 |
| borderColor | BorderColor | String | black |
| borderWidth | BorderWidth | int | 0 |
| 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 |
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.
backspaceIsDelete
Defaults to True if a PC keyboard is connected, otherwise defaults to False. When True, the terminal sends a delete key signal when it receives a backspace. Enables the backspace key of a PC keyboard to act like the delete key of an LK401.
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.
borderColor
Specifies the border color for the window. The window border need not be visible when re-parenting window managers are used.
borderWidth
Specifies the border width of the shell widget’s window. This value may be overridden by re-parenting window managers.
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 directed instead to the terminal window. It is provided as a way to prevent output, that would usually 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 minimized 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 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 with 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 with escape sequences.
logFile
Specifies the file name to which dtterm writes the output log. If the file name 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 file name is DttermLogXXXXX (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 maps (regularizes) itself upon subprocess output if it is unmapped (minimized). The user can specify, with 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 lets the application 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 nMarginBell resource.
menuBar
Indicates that dtterm displays a pull-down 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 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 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 the XFontSet used by dtterm when displaying bold terminal text. The XFontSet should be specified as a Motif XmFontList(3X). 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 XmFontList(3X). The terminal emulator supports only character or mono-spaced fonts. Even if a proportional font is specified, a default mono-spaced font is used. 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 |
| −background background_color | ∗background: background_color |
| −bd border_color | ∗borderColor: border_color |
| −bg background_color | ∗background: background_color |
| −bordercolor border_color | ∗borderColor: border_color |
| −borderwidth border_width | .borderWidth: border_width |
| −bs | ∗backgroundIsSelect: True |
| +bs | ∗backgroundIsSelect: False |
| −bw border_width | .borderWidth: border_width |
| −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
STDERR
Used only for diagnostic messages
OUTPUT FILES
None
EXTENDED DESCRIPTION
None
CONSEQUENCES OF ERRORS
Default
APPLICATION USAGE
None
EXAMPLES
None
ENVIRONMENT VARIABLES
The following environment variables affect the execution of dtterm:
DISPLAY
Specifies 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
Determines the user’s home directory, the location of configuration files.
LANG
Provides 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, overrides the values of all the other internationalization variables.
LC_MESSAGES
Determines 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
Determines the location of message catalogues for the processing of LC_MESSAGES.
SHELL
Determines the default application to run.
XAPPLRESDIR
Specifies 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 specifications.
XENVIRONMENT
Specifies 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
Defines a language-dependent location of app-defaults.
XMODIFIER
Specify which input method to use.
XUSERFILESEARCHPATH
Controls 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.
SEE ALSO
DtTerm(5), stty(1), dtterm(5), X(1X), XmFontList(3X), XmText(3X), pty(7), tty(7)