Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ gettydefs(F) — OpenDesktop 3.0.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

stty(C)

ioctl(S)

getty(M)

login(M)

scancode(HW)


 gettydefs(F)                    19 June 1992                    gettydefs(F)


 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 that 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

    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 char-
    acter.  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).

                The /etc/gettydefs entries for PC-scancode terminals use the
                flag SCANCODE to set the default mapping from scancodes to a
                character set.  The getty utility understands the SCANCODE
                flag in /etc/gettydefs entries and issues an ioctl request to
                set the KBISSCANCODE | KBXSCANCODE flags on the tty.

    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 IXOFF 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 is finally linked to
                2400.

    If getty is called without a second argument, then the first entry of
    /etc/gettydefs is used as the default entry.  The first entry is also
    used if getty cannot 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.

 File

    /etc/gettydefs

 See also

    stty(C), ioctl(S), getty(M), login(M), inittab(F,) scancode(HW)


Typewritten Software • bear@typewritten.org • Edmonds, WA 98026