GETTYDEFS(4) GETTYDEFS(4)
NAME
gettydefs - speed and terminal settings used by getty
DESCRIPTION
The /etc/gettydefs file contains information used by
getty(1M) to set up the speed and terminal settings for a
line. It supplies information on what the login(1) 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.
NOTE: Customers who need to support terminals that pass 8
bits to the system (as is typical outside the U.S.A.) must
modify the entries in /etc/gettydefs as described in the
WARNINGS section.
Each entry in /etc/gettydefs has the following format:
label# initial-flags # final-flags # login-prompt
#next-label
Each entry is followed by 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(1M)
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(2) settings
to which the terminal is to be set if a
terminal type is not specified to getty(1M).
The flags that getty(1M) understands are the
same as the ones listed in
/usr/include/sys/termio.h [see termio(7)].
Normally only the speed flag is required in
the initial-flags. getty(1M) automatically
Page 1 May 1989
GETTYDEFS(4) GETTYDEFS(4)
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(1M) executes login(1).
final-flags These flags take the same values as the
initial-flags and are set just before
getty(1M) executes login(1). 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, 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(1M) will search for the
entry with next-label as its label field and
set 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(1M) 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. It is also used
if getty(1M) can not find the specified label. If
/etc/gettydefs itself is missing, there is one entry built
into getty(1M) which will bring up a terminal at 300 baud.
Page 2 May 1989
GETTYDEFS(4) GETTYDEFS(4)
It is strongly recommended that after making or modifying
/etc/gettydefs, it be run through getty(1M) with the check
option to be sure there are no errors.
FILES
/etc/gettydefs
SEE ALSO
getty(1M), termio(7) in the System Administrator's Reference
Manual.
ioctl(2) in the Programmer's Reference Manual.
login(1), stty(1) in the User's Reference Manual.
WARNINGS
To support terminals that pass 8 bits to the system (also,
see the BUGS section), modify the entries in the
/etc/gettydefs 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
An example of changing an entry in /etc/gettydefs 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 will permit 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(1M) 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)):
Page 3 May 1989
GETTYDEFS(4) GETTYDEFS(4)
stty -istrip cs8
BUGS
8-bit with parity mode is not supported.
Page 4 May 1989