GETTYDEFS(F) UNIX System V
Name
gettydefs - speed and terminal settings used by getty
Description
The /etc/gettydefs file contains information used by
getty(M) 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 /etc/gettydefs has the following format:
label# initial-flags # final-flags # login-prompt
#next-label [# login-program]
Each entry must be followed by a carriage return and a blank
line. The various 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 various fields
are:
label This is the string against which getty(M)
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(S) settings
to which the terminal is to be set if a
terminal type is not specified to getty(M).
The flags that getty(M) understands are the
same as the ones listed in
/usr/include/sys/termio.h [see termio(M)].
Normally only the speed flag is required in
the initial-flags. getty(M) 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(M) executes login(M).
final-flags Sets the same values as the initial-flags.
These flags are set just prior to getty
executing login-program. The speed flag is
again required. The composite flag
SANE is a composite flag that sets the
following termio(M) parameters:
modes set:
CREAD BRKINT IGNPAR ISTRIP ICRNL
IXON ISIG ICANON ECHO ECHOK OPOST
ONLCR
modes cleared:
CLOCAL IGNBRK PARMRK INPCK INLCR
IUCLC IXOFJF XCASE ECHOE ECHONL
NOFLSH OLCUC OCRNL ONOCR ONLRET
OFILL OFDEL NLDLY CRDLY TABDLY BSDLY VTDLY FFDLY
The other two commonly specified final-flags
are
TAB3, so that tabs are sent to the terminal
as spaces, and
HUPCL, so that the line is hung up on the
final close.
login-prompt Contains login prompt message that greets
users. Unlike the above fields where white
space is ignored (a space, tab, or new-line),
it is included in the login-prompt field.
The `@' in the login-prompt field is expanded
to the first line (or second line if it
exists) in /etc/systemid (unless the `@' is
preceded by a `\'). Several character
sequences are recognized, including:
\n Linefeed
\r Carriage return
\v Vertical tab
\nnn (3 octal digits) Specify ASCII character
\t Tab
\f Form feed
\b Backspace
next-label
Identifies the next entry in gettydefs for getty to try if
the current one is not successful. Getty tries the next
label if a user presses the BREAK key while attempting to
log in to the system. Groups of entries, for example, for
dial-up lines or for TTY lines, should form a closed set so
that getty cycles back to the original entry if none of the
entries is successful. For instance, 2400 linked to 1200,
which in turn is linked to 300, which finally is linked to
2400.
login-program
The name of the program that actually logs the user onto
UNIX. The default program is /etc/login. If preceded by
the keyword AUTO, getty will not prompt for a username, but
instead uses its first argument as the username and executes
the login-program immediately.
If getty is called without a second argument, then the first
entry of /etc/gettydefs is used, thus making the first entry
of /etc/gettydefs the default entry. The first entry is
also used if getty can not find the specified label. If
/etc/gettydefs itself is missing, there is one entry built
into the command which will bring up a terminal at 300 baud.
After modifying /etc/gettydefs, run it through getty with
the check option to be sure there are no errors.
Files
/etc/gettydefs
See Also
stty(C), ioctl(S), getty(M), login(M)
(printed 8/23/89) GETTYDEFS(F)