NCDTERM(1) USER COMMANDS NCDTERM(1)
NAME
ncdterm - vt320 terminal emulator
SYNOPSIS
rsh hostname term [ -option ... ]
lcexec term [ -option ... ]
DESCRIPTION
The ncdterm program is a terminal emulator for the X Window
System. It currently supports DEC VT320 emulation and the
curses (3V) screen handling library.
ncdterm provides many of the same functions and features as
xterm (1), but is a completely new program with improved
performance and additional features including:
⊕ Telnet, LAT, CTerm, and serial connections, including
encrypted Telnet and LAT passwords.
⊕ Broadcasting for available connections, and a "terminal
chooser" panel for listing and selecting available con-
nections.
⊕ A Motif interface for the chooser, function and option
menus, and scrollbar.
⊕ A Motif-compliant selection mechanism for cutting and
pasting text.
⊕ Print Screen and Print Log Buffer functions.
⊕ Automatic setting of the DISPLAY environment variable
on Telnet sessions.
⊕ 8-bit and ISO Latin 1 Font modes.
⊕ AutoConnect and AutoReconnect functions, Grab Keyboard
function, blinking cursor, a status line, and more. See
the X DEFAULTS section below for a complete list of
resources.
OPTIONS
ncdterm supports the following options:
-ctype [term | telnet | cterm | lat | serial]
Connection type to start. term selects the terminal
chooser rather than a direct connection. The default
is term.
-geometry <[columns]x[rows]+/-[xoff]+/-[yoff]>
Startup size and location. The default is "80x24."
NCDware 3.1 1
NCDTERM(1) USER COMMANDS NCDTERM(1)
-help
Print help text instead of starting the terminal emula-
tor.
-host <hostname>
Host system to connect to. This option should be used
together with the -ctype option.
-iconic
Start in iconic form.
-name <classname>
Class name which ncdterm should use to find X
resources. The default is "NCDterm."
-title <titlebar>
Title for the application window. The default is "NCD
User Services: Terminal Emulator."
X DEFAULTS
ncdterm supports the following X resources. Resources are
searched for under the name "ncdterm", class "NCDterm".
The following resources have Boolean (True/False) values:
alwaysHighlight
Specifies whether ncdterm should always display a
highlighted text cursor. By default, a hollow text
cursor is displayed whenever the pointer moves out of
the window or the window loses the input focus.
Default is "False."
appCursorMode
Specifies whether to turn on Application Cursor Mode,
used by some applications, at startup time. Default is
"False."
appKeypadMode
Specifies whether to turn on Application Keypad Mode,
used by some applications at startup time. Default is
"False."
autoLineFeed
Specifies that ASCII carriage return characters should
be interpreted as a carriage return and newline to
avoid overstriking. Default is "True."
autoReconnect
Specifies whether to try to try to reconnect to the
host specified by the defaulthost resource whenever the
connection is closed. Default is "False."
NCDware 3.1 2
NCDTERM(1) USER COMMANDS NCDTERM(1)
autoWrap
Specifies that lines of text longer than the width of
the terminal should be continued on the next line.
Default is "True."
blinkCursor
Specifies whether a blinking cursor should be used.
Note that this may slow the terminal.
curses
Specifies whether the last column bug in curses(3x)
should be worked around. Default is "False." Default
is "False."
cutNewline
Specifies whether newlines in a multi-line selection
should be included in the selection. Default is
"True."
cutToBeginningOfLine
Specifies whether selecting a line of text should
include text to the left of the cursor. Useful for
leaving the system prompt out of selected command line.
Default is "True."
c132 Specifies whether the VT102 DECCOLM escape sequence
should be honored. Default is "True."
DECKeyboard
Causes keyboards which do not not have DEC layouts to
have function keys F1 thru F5 treated as they are on
Digital keyboards. Specific translations will override
this behavior. Default is "False."
eightBitInput
Specifies whether 8-bit characters should be accepted.
Default is "False."
eightBitEmit
Specifies whether 8-bit characters should be emitted
from function and keypad sequences. Default is the
value of the "eightBitInput" resource.
eightBitBinary
Informs the telnet connection to run in binary mode.
Default value is "False".
exitOnDisconnect
Specifies whether ncdterm should exit completely when
connection to a host is closed, or drop back to the
terminal chooser. Default is "False."
NCDware 3.1 3
NCDTERM(1) USER COMMANDS NCDTERM(1)
iconic
Specifies whether to start ncdterm iconified if the
window manager supports it. Default is "False."
jumpScroll
Specifies that the screen should redraw as fast as pos-
sible, rather than scrolling smoothly. Default is
"False."
keepWithinScreen
Specifies that the maximum size of the ncdterm window
will be the maximum screen dimensions. Otherwise the
maximum is 32767 in each direction. Default is "True."
latin1Font
Specifies whether the 8-bit ISO Latin-1 character or
string associated with a pressed keysym should be
inserted. Default is "True."
logfileAscii
Used when generating ncdterm debug output with the
"Start Debugging Log" menu selection. When True, debug
output is written in ASCII. When False, debug output
is written in hex. Default is "False".
marginBell
Specifies whether the bell should be run when the user
types near the right margin. Default is "False."
menuBar
Specifies whether the Motif menubar with the File,
Options, and Font menus should be displayed at the top
of the application window. Default is "True."
noCursor
Specifies cursorless operation. Default is "False."
pageFlip
Specifies whether exiting cursor addressable mode
should cause the previous screen of text to be
redisplayed. Setting to False enables the text
displayed by programs such as emacs (1) and various
menu-based programs to remain on the screen after the
program exits. Default is "True."
retainColors
When "True", retains the current foreground and back-
ground colors of the window upon receipt of the SGR
sequence (ESC0m) as well as soft and hard resets.
These sequences normally reset the colors to the
default values. Default is "False".
NCDware 3.1 4
NCDTERM(1) USER COMMANDS NCDTERM(1)
retainHeight
When "True", retains the current height of the window
upon receipt of certain escape sequence which would
otherwise resize the window height to the default size.
Default is "False".
retainWidth
When "True", retains the current width of the window
upon receipt of certain escape sequence which would
otherwise resize the window width to the default size.
Default is "False".
reverseVideo
Specifies that foreground and background colors should
be reversed. Default is "False."
reverseWrap
Specifies that the cursor can be moved back to previous
lines of a wrapped line of text. Useful for editing
long commands. Default is "False."
scrollLastPage
Setting to False means that the scrollbar will stop
with the last line of text on the bottom of the screen,
in the style of xterm (1). True means that the last
page can be scrolled so there is one line visible in
the style of cmdtool (1). Default is "True."
secureKeyboard
Specifies whether the keyboard input to the display
should always be directed to the terminal emulator win-
dow. This function has been changed to "Grab Keyboard"
on the Options menu. Default is "False."
statusLine
Specifies whether the status line should be displayed
at the bottom of the application window. Default is
"False."
stripParity
Specifies whether or not eight-bit characters sent from
the host should be accepted as is or stripped when
printed. The default is "False".
visualBell
Specifies that the screen should flash rather than ring
the terminal bell when a Ctrl-G character is received.
Default is "False."
The following resources have Integer values:
bellSuppressTime
NCDware 3.1 5
NCDTERM(1) USER COMMANDS NCDTERM(1)
Specifies the minimum amount of time in milliseconds
between terminal bell rings which will be honored to
prevent excessive ringing. Default is 200.
holdLed
Specifies which LED to use to signal XON/XOFF flow con-
trol, i.e., "Hold Screen" behavior. Default is 4.
internalBorder
Specifies the number of pixels between the content of
ncdterm and the border of its window. Default is 2.
menuBorder
Specifies the size in pixels of the border surrounding
menus. Default is 2.
menuPad
Specifies the number of pixels between menu items and
the menu border. Default is 3.
multiClickTime
Specifies the maximum amount of time in milliseconds
allowable between mouse button clicks in multi-click
operations. Default is 250.
nMarginBell
Specifies the number of characters after which the mar-
gin bell should ring on a row of text. Default is 80.
printerPort
Specifies the serial port to use for printing. Default
it 1.
saveLines
Specifies the number of lines of text that should be
saved for scrolling. Default is 1000.
scrollQueue
Specifies how many scrolling actions should be scrolled
up before ncdterm updates the entire text area. The
minimum value of 1 will cause scrolling o be continual,
complete, and slow. The maximum value of 20 will leave
parts of the screen visibly unrefreshed during fast
scrolling. Default is 10.
selectBeginAfter
Specifies how many pixels the pointer must be moved
over while dragging with a mouse button pressed before
the previous selection will be terminated and a new
selection started. A high value will make it more dif-
ficult to accidentally lose a selection. Default is 0.
NCDware 3.1 6
NCDTERM(1) USER COMMANDS NCDTERM(1)
topMargin
bottomMargin
leftMargin
rightMargin
These resources specify the number of pixels between
the text area of ncdterm and its surrounding borders.
Defaults for all is 5.
The following resources have character String values:
answerbackString
Specifies the response string returned by ncdterm upon
receipt of an answerback request. No default.
charClass
Specifies comma-separated lists of character class
bindings of the form [low-]high:value. These are used
in determining which sets of characters should be
treated the same when doing cut and paste.
This resource is simply a list of range:value pairs where
the range is either a single number or low-high in the range
of 0 to 127, corresponding to the ASCII code for the charac-
ter or characters to be set. The value is arbitrary,
although the default table uses the character number of the
first character occurring in the set.
The default table is:
static int charClass[128] = {
/* NUL SOH STX ETX EOT ENQ ACK BEL */
32, 1, 1, 1, 1, 1, 1, 1,
/* BS HT NL VT NP CR SO SI */
1, 32, 1, 1, 1, 1, 1, 1,
/* DLE DC1 DC2 DC3 DC4 NAK SYN ETB */
1, 1, 1, 1, 1, 1, 1, 1,
/* CAN EM SUB ESC FS GS RS US */
1, 1, 1, 1, 1, 1, 1, 1,
/* SP ! " # $ % & ' */
32, 33, 34, 35, 36, 37, 38, 39,
/* ( ) * + , - . / */
40, 41, 42, 43, 44, 45, 46, 47,
/* 0 1 2 3 4 5 6 7 */
48, 48, 48, 48, 48, 48, 48, 48,
/* 8 9 : ; < = > ? */
48, 48, 58, 59, 60, 61, 62, 63,
/* @ A B C D E F G */
64, 48, 48, 48, 48, 48, 48, 48,
/* H I J K L M N O */
NCDware 3.1 7
NCDTERM(1) USER COMMANDS NCDTERM(1)
48, 48, 48, 48, 48, 48, 48, 48,
/* P Q R S T U V W */
48, 48, 48, 48, 48, 48, 48, 48,
/* X Y Z [ \ ] ^ _ */
48, 48, 48, 91, 92, 93, 94, 48,
/* ` a b c d e f g */
96, 48, 48, 48, 48, 48, 48, 48,
/* h i j k l m n o */
48, 48, 48, 48, 48, 48, 48, 48,
/* p q r s t u v w */
48, 48, 48, 48, 48, 48, 48, 48,
/* x y z { | } ~ DEL */
48, 48, 48, 123, 124, 125, 126, 1};
For example, the string ``33:48,37:48,45-47:48,64:48'' indi-
cates that the exclamation mark, percent sign, dash, period,
slash, and ampersand characters should be treated the same
way as characters and numbers. This is very useful for cut-
ting and pasting electronic mailing addresses and filenames.
defaultHost
Specifies a telnet host to try to connect to at startup
time. No default.
geometry
Specifies the default geometry, in the form
[columns]x[rows]+/-[xoff]+/-[yoff]. Default is
"80x24."
icon Specifies the text string appearing under the icon when
ncdterm is iconified. The default is "NCDterm."
logDirectory
Specifies the directory into which to save log files.
Default is /usr/lib/X11/ncd/termlog.
primaryDevAttr
Specifies the response string returned by ncdterm upon
receipt of a primary identification request. Default
is "62;1;2;6;8;9".
secondaryDevAttr
Specifies the response string returned by ncdterm upon
receipt of a secondary identification request. Default
is "1;1;0".
title
Specifies the application title to be displayed by the
window manager. Default is "NCD User Services: Terminal
Emulator."
NCDware 3.1 8
NCDTERM(1) USER COMMANDS NCDTERM(1)
Translations
Specifies the key and button bindings for menus, selec-
tions, "programmed strings," etc. No default.
The following resources accept a limited set of strings as
values:
connectType [ none | term | pty | lat | serial | telnet | cterm ]
Specifies which type of connection to attempt at
startup time. Default is "none," i.e. bring up the
terminal chooser instead.
cursorType [ SolidBlock | BrightHatched | BrightUnderline |
DiagLines | Framed | Hatched |
HollowBlock | Invisible | Underline ]
Specifies which cursor type to use. Default is SolidBlock."
scrollbar [ Right | Left | None ]
Specifies the location of the scrollbar. Default is
"Right."
The following resources control printing behavior:
printerFormFeed
Specifies whether to send a form feed to flush the
printed data page when ready to close the printer con-
nection. Default is "True."
printerHost
Specifies another NCD terminal to send print output
print to. Printing to other hosts is not supported.
Default is the local serial port.
printerInit
Specifies a string to be sent to the printer after it
is opened for printing to initialize the printer using
any escape sequences or other characters the printer
understands.
printerPostscript
Specifies that the printer is a PostScript printer.
Default is "False."
printerTimeout
Number of seconds to wait for response from the
printer, during which time the terminal will appear to
be hung. Default is 15.
The following resources specify colors for various parts of
the interface:
background (class Background)
NCDware 3.1 9
NCDTERM(1) USER COMMANDS NCDTERM(1)
Color to use for the background of the application win-
dow. Default is "white."
borderColor (class Foreground)
Color to use for the borders. Default is "black."
cursorColor (class Foreground)
Color to use for the text cursor. Default is "black."
foreground (class Foreground)
Color to use for text characters. Default is "black."
pointerColor (class Foreground)
Color to use for the mouse pointer. Default is
"black."
The following resources specify fonts and font fields used
to build a set of fonts, rather than using the twelve
separate resources of xterm:
family
Default is "terminal."
foundry
Default is "*".
pointSize
Default is 140.
subFont
Default is "8x13."
A full set of bold, italic, double-size, etc, fonts are
built using these fields as parameters.
SEE ALSO
xterm (1)
curses (3V)
COPYRIGHT
Copyright 1992, 1993, Network Computing Devices, Inc.
AUTHORS
Jim Becker, Network Computing Devices, Inc.
Tim Freese, Network Computing Devices, Inc.
NCDware 3.1 10