GETTY(M)                 XENIX System V                  GETTY(M)



     Name
          getty - Sets terminal type, modes, speed, and line
          discipline.

     Syntax
          /etc/getty [ -h ] [ -t timeout ] line [ speed [ type [
          linedisc ] ] ]
          /etc/getty -c file

     Description
          getty is a program that is invoked by init(M).  It is the
          second process in the series, (init-getty-login-shell), that
          ultimately connects a user with the XENIX system.  Initially
          getty displays the login message field for the entry it is
          using from /etc/gettydefs.  getty reads the user's login
          name and invokes the login(M) command with the user's name
          as argument.  While reading the name, getty attempts to
          adapt the system to the speed and type of terminal being
          used.

          Line is the name of a tty line in /etc/ttys to which getty
          is to attach itself.  getty uses this string as the name of
          a file in the /dev directory to open for reading and
          writing.  Unless getty is invoked with the -h flag, getty
          will force 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
          enters 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 what speed to initially run, what the login
          message should look like, what the initial tty settings are,
          and what speed to try next should the user indicate that the
          speed is inappropriate (by entering a BREAK character).  The
          default speed is 300 baud.  The optional third argument,
          type, is a character string describing to getty what type of
          terminal is connected to the line in question.  getty
          understands the type none-any CRT or normal terminal unknown
          to the system.  This is the default.

          For terminal type to have any meaning, the virtual terminal
          handlers must be compiled into the operating system.  They
          are available, but not compiled in the default condition.
          The optional fourth argument, linedisc, is a character
          string describing which line discipline to use in
          communicating with the terminal.  Again the hooks for line
          disciplines are available in the operating system but there
          is only one presently available, the default line
          discipline, LDISC0.

          When given no optional arguments, getty sets the speed of



     Page 1                                           (printed 8/7/87)

     GETTY(M)                 XENIX System V                  GETTY(M)



          the interface to 300 baud, specifies that raw mode will be
          used (awaken on every character), that echo will be
          suppressed, either parity allowed, that new-line characters
          will be converted to carriage return-line feed, and that tab
          expansion is performed on the standard output.  It displays
          the login message before reading the user's name a character
          at a time.  If a null character (or framing error) is
          received, it is assumed to be the result of the user pushing
          the BREAK key.  This will cause getty to attempt the next
          speed in the series.  The series that getty tries is
          determined by what it finds in /etc/gettydefs.

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

          The user's name is scanned to see if it contains any lower-
          case alphabetic characters. getty suggests that the user use
          all lower-case characters.  If the user uses upper case
          characters, the system is told to map any future upper-case
          characters into the corresponding lower-case characters.

          Finally, the login-program from /etc/gettydefs is called
          with the user's name as an argument.  Additional arguments
          may be entered after the login name.  These are passed to
          the login-program.  The default login-program, /etc/login,
          places them in the environment (see login(M)).

          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 displays the values of the various flags.  See
          ioctl(S) to interpret the values.  Note that some values are
          added to the flags automatically.

     Files
          /etc/gettydefs
          /etc/ttys

     See Also
          init(M), login(M), ioctl(S), gettydefs(F), ttys(M)












     Page 2                                           (printed 8/7/87)