Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

getty(8)

login(1)

stty(1)

termio(7)

ioctl(2)



  gettydefs(4)                        CLIX                        gettydefs(4)



  NAME

    gettydefs - Line speed/terminal settings file

  DESCRIPTION

    The /etc/gettydefs file 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 pressing <Break>.

    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, and so on, as well as nnn, where
    nnn is the octal value of the desired character.  The various fields are
    as follows:

    label          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 /usr/include/sys/termio.h (see
                   termio(7).  Normally only the speed flag is required in the
                   initial-flags.  The getty command 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, and
                   HUPCL, so that the line is hung up on the final close.

    login-prompt   This entire field is displayed as the login-prompt.  Unlike
                   the above fields where white space is ignored (a space, tab
                   or newline), they are included in the login-prompt field.

    next-label     If this entry does not specify the desired speed, indicated
                   by the user pressing <break>, getty will search for the



  2/94 - Intergraph Corporation                                              1






  gettydefs(4)                        CLIX                        gettydefs(4)



                   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 a closed set.  For example, 2400 is
                   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
    gettydefs is used, thus making the first entry of gettydefs the default
    entry.  It is also used if getty can not find the specified label.  If
    gettydefs itself is missing, there is one entry built into getty which
    will bring up a terminal at 300 baud.

    It is strongly recommended that after making or modifying gettydefs, it be
    run through getty with the check option to be sure there are no errors.

  FILES

    /etc/gettydefs

  NOTES

    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 gettydefs as
    described in the CAUTIONS section.

  CAUTIONS

    8-bit with parity mode is not supported.

    To support terminals that pass 8 bits to the system, modify the entries in
    the 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 ONCLR CS8 ISIG ICANON ECHO ECHOK''.

    An example of changing an entry in /etc/gettydefs is illustrated below.
    All of 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 state.  When the system changes to state, the getty
    command is killed and the terminal attributes are lost.  To permit a



  2                                              Intergraph Corporation - 2/94






  gettydefs(4)                        CLIX                        gettydefs(4)



    terminal to pass 8 bits to the system in state after you are in state,
    type the following (see stty(1)):

    stty -istrip cs8


  RELATED INFORMATION

    Commands:  getty(8), login(1), stty(1)

    Files:  termio(7)

    Functions:  ioctl(2)









































  2/94 - Intergraph Corporation                                              3




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