Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ getty(1m) — DG/UX 4.30

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ct(1C)

init(1M)

login(1)

ioctl(2)

gettydefs(4)

inittab(4)

tty(7)



     getty(1m)                  DG/UX 4.30                   getty(1m)



     NAME
          getty - set terminal type, modes, speed, and line discipline

     SYNOPSIS
          /etc/getty [ -h ] [ -t timeout ] line [ speed [
          terminaltype [ linedisc ] ] ]
          /etc/getty -c file

     DESCRIPTION
          Getty is a program that is invoked by init(1M).  It is the
          second process in the series init-getty-login-shell that
          ultimately connects a user with a DG/UX system.

          First, getty generates a system identification message from
          the values returned by the uname(2) system call.  Then, if
          /etc/issue exists, it outputs this to the user's terminal,
          followed finally by the login message field for the entry it
          is using from /etc/gettydefs.  Getty reads the user's login
          name and invokes the login(1) command with the user's name
          as argument.  While reading the name, getty tries to adapt
          the system to the speed and type of terminal being used.

          Line is the name of a tty line in /dev to which getty is to
          attach itself.  Getty uses line as the name of a file in the
          /dev directory to open for reading and writing.  Unless you
          invoke getty with the -h flag, getty forces a hangup on the
          line by setting the speed to zero before setting the speed
          to the default or specified speed.

          The -t flag, plus timeout in seconds, specifies that getty
          should exit if the open on the line succeeds and no one
          types anything in the specified number of seconds.

          The optional second argument, speed, is a label to a speed
          and tty definition in the file /etc/gettydefs.  This
          definition tells getty at what speed to initially run, what
          the login message should look like, what the initial tty
          settings are, and what speed to try next if the user
          indicates that the speed is inappropriate (by typing a
          <break> character).  The default speed is 300 baud.

          The optional third argument is a character string that will
          be assigned to the TERM variable and exported.  If this
          argument is not supplied, no TERM value is assigned.  Getty
          does not confirm that the terminaltype is valid.

          The optional fourth argument, linedisc, is a character
          string describing which line discipline to use in
          communicating with the terminal.  The hooks for line
          disciplines are available in the operating system, but the
          only one presently available is the default line discipline,
          LDISC0.



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





     getty(1m)                  DG/UX 4.30                   getty(1m)



          When given no optional arguments, getty sets the speed of
          the interface to 300 baud, specifies that raw mode is to be
          used (awaken on every character), and that echo is to be
          suppressed.  Either parity is allowed, new-line characters
          are converted to carriage-return line-feed, and tab
          expansion performed on the standard output.  Getty types the
          login message before reading the user's name a character at
          a time.  If a null character (or framing error) is received,
          getty assumes that the user pushed the BREAK key.  Getty
          then tries the next speed in the series found in
          /etc/gettydefs.

          The user's name is terminated by a new-line or carriage-
          return character.  The latter sets the system to treat
          carriage returns appropriately (see ioctl(2)).

          The user's name is scanned for lowercase alphabetic
          characters; if none are found and the name is non-empty, the
          system is told to map any future uppercase characters into
          the corresponding lowercase characters.

          Finally, login is called with the user's name as an
          argument.  Additional arguments may be typed after the login
          name.  These are passed to login, which places them in the
          environment (see login(1)).

          A check option is provided.  When getty is invoked with the
          -c option and file, it scans the file as if it were scanning
          /etc/gettydefs and prints out the results to the standard
          output.  If there are any unrecognized modes or improperly
          constructed entries, it reports these.  If the entries are
          correct, it prints out the values of the various flags (see
          ioctl(2)).  Note that some values are added to the flags
          automatically.

     FILES
          /etc/gettydefs
          /etc/issue

     SEE ALSO
          ct(1C), init(1M), login(1), ioctl(2), gettydefs(4),
          inittab(4), tty(7).

     EXCEPTIONS
          DG/UX does not support SYS V style kernel terminal types.
          The terminaltype is the name of a terminfo entry.

          Unlike SYS V getty, DG/UX getty understands control
          character assignments (see gettydefs(4)).






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



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