gettydefs(4) gettydefs(4)
NAME
gettydefs - speed and terminal settings used by getty
DESCRIPTION
The file /usr/lib/saf/ttymondefs contains information used by
the getty command to set up the speed and terminal settings
for a line. It supplies information on what the login prompt
should look like. It also supplies the speed to try next if
the user indicates the current speed is not correct by typing
a break character.
Each entry in ttymondefs has the following format:
label# initial-flags # final-flags # login-prompt #next-label
Each entry is followed by a blank line. The fields can
contain quoted characters of the form \b, \n, \c, etc., as
well as \nnn, where nnn is the octal value of the desired
character. The fields are:
label This is the string against which getty tries to
match its second argument. It is often the
speed, such as 1200, at which the terminal is
supposed to run, but it need not be (see below).
initial-flags These flags are the initial ioctl settings to
which the terminal is to be set if a terminal
type is not specified to getty. The flags that
getty understands are the same as the ones
listed in the termio.h header file [see
termio(7)]. Normally only the speed flag is
required in the initial-flags. getty
automatically sets the terminal to raw input
mode and takes care of most of the other flags.
The initial-flag settings remain in effect until
getty executes login.
final-flags These flags take the same values as the
initial-flags and are set just before getty
executes login. The speed flag is again
required. The composite flag SANE takes care of
most of the other flags that need to be set so
that the processor and terminal are
communicating in a rational fashion. The other
two commonly specified final-flags are TAB3, so
that tabs are sent to the terminal as spaces,
Copyright 1994 Novell, Inc. Page 1
gettydefs(4) gettydefs(4)
and HUPCL, so that the line is hung up on the
final close.
login-prompt This entire field is printed as the login-
prompt. Unlike the above fields where white
space is ignored (a space, tab or new-line),
they are included in the login-prompt field.
next-label If this entry does not specify the desired
speed, indicated by the user typing a break
character, then getty searches for the entry
with next-label as its label field and sets up
the terminal for those settings. Usually, a
series of speeds are linked together in this
fashion, into a closed set; for instance, 2400
linked to 1200, which in turn is linked to 300,
which finally is linked to 2400.
If getty is called without a second argument, then the first
entry of ttymondefs is used, thus making the first entry of
ttymondefs the default entry. It is also used if getty can
not find the specified label. If ttymondefs itself is
missing, there is one entry built into getty that brings up a
terminal at 300 baud.
It is strongly recommended that after making or modifying
ttymondefs, it be run through getty with the check option to
be sure there are no errors.
FILES
/usr/lib/saf/ttymondefs
/usr/include/sys/termio.h
REFERENCES
getty(1M), ioctl(2), login(1), stty(1), termio(7)
NOTICES
To support terminals that pass 8 bits to the system (as is
typical outside the U.S.), modify the entries in the
ttymondefs file for those terminals as follows: add CS8 to
initial-flags and replace all occurrences of SANE with the
values: BRKINT IGNPAR ICRNL IXON OPOST ONLCR CS8 ISIG ICANON
ECHO ECHOK
Copyright 1994 Novell, Inc. Page 2
gettydefs(4) gettydefs(4)
An example of changing an entry in ttymondefs is illustrated
below. All the information for an entry must be on one line
in the file.
Original entry:
CONSOLE # B9600 HUPCL OPOST ONLCR # B9600 SANE IXANY
TAB3 HUPCL # Console Login: # console
Modified entry:
CONSOLE # B9600 CS8 HUPCL OPOST ONLCR # B9600 BRKINT
IGNPAR ICNRL IXON OPOST ONLCR CS8 ISIG ICANON ECHO ECHOK
IXANY TAB3 HUPCL # Console Login: # console
This change permits terminals to pass 8 bits to the system so
long as the system is in multi-user state. When the system
changes to single-user state, the getty is killed and the
terminal attributes are lost. So to permit a terminal to pass
8 bits to the system in single-user state, after you are in
single-user state, type [see stty(1)]:
stty -istrip cs8
8-bit with parity mode is not supported.
Copyright 1994 Novell, Inc. Page 3