Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ gettydefs(4) — DG/UX 4.30

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ioctl(2)

att_stty(1)

getty(1m)

termio(7)

login(1)



     gettydefs(4)               DG/UX 4.30                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
          terminal 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.

          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 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.  The
                         flags that getty understands are a subset of
                         those described in termio(7).  Refer to this
                         man page for the meanings of the flags.
                         These flags are also available via stty(1)).
                         However, in getty, uppercase flag names are
                         used.  The flags are:

          For input modes:

          IGNBRK BRKINT IGNPAR PARMRK INPCK ISTRIP INLCR IGNCR ICRNL
          IUCLC

          IXON IXANY IXOFF

          For output modes:

          OPOST OLCUC ONLCR OCRNL ONOCR ONLRET OFILL OFDEL



     Licensed material--property of copyright holder(s)         Page 1





     gettydefs(4)               DG/UX 4.30                gettydefs(4)



          NL0 NL1 CR0 CR1 CR2 CR3 TAB0 TAB1 TAB2 TAB3 BS0 BS1

          VT0 VT1 FF0 FF1

          For control modes:

          B0 B110 B134 B150 B300 B600 B1200 B1800 B2400 B4800

          B9600 B19200 B38400 EXTA EXTB CS5 CS6 CS7 CS8 CSTOPB

          CREAD PARENB PARODD HUPCL CLOCAL LOBLK

          For line modes:

          ISIG ICANON XCASE ECHO ECHOE ECHOK ECHONL NOFLSH

          Control characters:

          INTR QUIT ERASE KILL EOF EOL EOL2 MIN TIME OBS

          When setting control characters, use two words as in:  KILL
          u Note that you may specify control characters using the
          stty format: x for control-x.

          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(1).

          final-flags
               These flags take the same values as the initial-flags
               and are set just prior to 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 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 will search for the entry with next-label as its
               label field and set up the terminal for those settings.



     Licensed material--property of copyright holder(s)         Page 2





     gettydefs(4)               DG/UX 4.30                gettydefs(4)



               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 /etc/gettydefs is used, thus making the first entry
          of /etc/gettydefs the default entry.  It 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.

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

     FILES
          /etc/gettydefs

     SEE ALSO
          ioctl(2).
          att_stty(1), getty(1m), termio(7) in the System Manager's
          Reference to the DG/UX System.
          login(1) in the User's Reference to the DG/UX System.

     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, make sure that ISTRIP does not appear in
          either the initial-flags or the final-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 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,



     Licensed material--property of copyright holder(s)         Page 3





     gettydefs(4)               DG/UX 4.30                gettydefs(4)



          after you are in SINGLE-USER state, type (see stty(1)):

                stty -istrip cs8

     BUGS
          getty does not understand berk_stty(1) modes.

          8-bit with parity mode is not supported.















































     Licensed material--property of copyright holder(s)         Page 4



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