


GETTY(8)                                                 GETTY(8)


NNAAMMEE
       getty - alternative System V/SunOS 4 getty

SSYYSSTTEEMM VV SSYYNNOOPPSSIISS
       getty [-i] [-l login_program] [-m] [-t timeout] port baud_rate,...

SSUUNNOOSS 44 SSYYNNOOPPSSIISS
       getty [-h] [-l login_program] [-m] [-t timeout] baud_rate,... port

DDEESSCCRRIIPPTTIIOONN
       _g_e_t_t_y  opens  a  tty  port,  prompts  for a login name and
       invokes the /bin/login command. It is normally invoked  by
       _i_n_i_t_(_8_).

       _g_e_t_t_y  has  several  _n_o_n_-_s_t_a_n_d_a_r_d features that are useful
       for hard-wired and for dial-in lines:

       o      Adapts the tty  settings  to  parity  bits  and  to
              erase,  kill,  end-of-line and uppercase characters
              when it reads a login name.  The program can handle
              7-bit characters with even, odd, none or space par-
              ity, and 8-bit characters with no parity. The  fol-
              lowing  special  characters  are  recognized: @ and
              Control-U (kill); #, DEL and  back  space  (erase);
              carriage return and line feed (end of line).

       o      Optionally  deduces  the baud rate from the CONNECT
              messages produced by Hayes(tm)-compatible modems.

       o      Optionally does not hang up when  it  is  given  an
              already  opened line (useful for call-back applica-
              tions).

       o      Optionally does not display  the  contents  of  the
              _/_e_t_c_/_i_s_s_u_e file (System V only).

       o      Optionally  invokes  a  non-standard  login program
              instead of _/_b_i_n_/_l_o_g_i_n.

       o      Optionally turns on hard-ware flow control (SunOS 4
              only).

       This program does not use the _/_e_t_c_/_g_e_t_t_y_d_e_f_s (System V) or
       _/_e_t_c_/_g_e_t_t_y_t_a_b (SunOS 4) files.

AARRGGUUMMEENNTTSS
       port   A path name relative to the _/_d_e_v  directory.  If  a
              "-"  is  specified, _g_e_t_t_y assumes that its standard
              input is already connected to a tty port and that a
              connection to a remote user has already been estab-
              lished.

              Under System V, a "-" _p_o_r_t argument should be  pre-
              ceded by a "--".



                                                                1





GETTY(8)                                                 GETTY(8)


       baud_rate,...
              A  comma-separated  list of one or more baud rates.
              Each time  _g_e_t_t_y  receives  a  BREAK  character  it
              advances  through  the list, which is treated as if
              it were circular.

              Baud rates should be specified in descending order,
              so  that  the  null  character (Ctrl-@) can also be
              used for baud rate switching.

OOPPTTIIOONNSS
       -h (SunOS 4 only)
              Enable hardware (RTS/CTS) flow control. It is  left
              up   to   the   application   to  disable  software
              (XON/XOFF) flow protocol where appropriate.

       -i (System V only)
              Do not display the contents  of  _/_e_t_c_/_i_s_s_u_e  before
              writing  the  login prompt. Terminals or communica-
              tions hardware may become confused  when  receiving
              lots  of  text  at  the  wrong  baud  rate; dial-up
              scripts may fail if the login prompt is preceded by
              too much text.

       -l login_program
              Invoke   the  specified  _l_o_g_i_n___p_r_o_g_r_a_m  instead  of
              /bin/login.  This allows the use of a  non-standard
              login  program  (for  example,  one that asks for a
              dial-up password or that uses a different  password
              file).

       -m     Try  to  extract  the  baud rate the _c_o_n_n_e_c_t status
              message  produced  by   some   Hayes(tm)-compatible
              modems.  These  status  messages  are  of the form:
              "<junk><speed><junk>".   _g_e_t_t_y  assumes  that   the
              modem emits its status message at the same speed as
              specified with (the first) _b_a_u_d___r_a_t_e value  on  the
              command line.

              Since  the  _-_m  feature  may fail on heavily-loaded
              systems, you still should enable  BREAK  processing
              by  enumerating all expected baud rates on the com-
              mand line.

       -t timeout
              Terminate if no user  name  could  be  read  within
              _t_i_m_e_o_u_t seconds. This option should probably not be
              used with hard-wired lines.

SSYYSSTTEEMM VV EEXXAAMMPPLLEESS
       This section shows sample entries for the _/_e_t_c_/_i_n_i_t_t_a_b file.

       For a hard-wired line:
            t0:2:respawn:/bin/getty ttyM0 9600



                                                                2





GETTY(8)                                                 GETTY(8)


       For a dial-in line with a 2400/1200/300 baud modem:
            t1:2:respawn:/bin/getty -mt60 ttyM1 2400,1200,300

SSUUNNOOSS 44 EEXXAAMMPPLLEESS
       This section show sample entries for the _/_e_t_c_/_t_t_y_t_a_b file.
       Note  that  init(8)  appends  the port name to the command
       specified in the inittab file.

       For a hard-wired line:
            ttya  "/bin/getty 9600"  vt100  on local

       For a dial-in line with a 2400/1200/300 baud modem:
            ttyb  "/bin/getty -mt60 2400,1200,300"   unknown   on
       modem

       The latter also requires that the _D_T_R and _C_D modem control
       lines are enabled (see the eeprom(8) manual page).

FFIILLEESS
       /etc/utmp, the system status file (System V only).
       /etc/issue, printed before the login prompt (System V only).
       /dev/console, problem reports (if syslog(3) is not used).
       /etc/inittab (System V init(8) configuration file).
       /etc/ttytab (SunOS 4 init(8) configuration file).

BBUUGGSS
       The baud-rate detection feature (the _-_m  option)  requires
       that  _g_e_t_t_y be scheduled soon enough after completion of a
       dial-in call (within 30 ms with modems that talk  at  2400
       baud).  For robustness, always use the _-_m option in combi-
       nation with a multiple baud rate command-line argument, so
       that BREAK processing is enabled.

       The  text  in  the /etc/issue file (System V only) and the
       login prompt are always output with 7-bit  characters  and
       space parity.

       The  baud-rate  detection feature (the _-_m option) requires
       that the modem emits its status message _a_f_t_e_r raising  the
       DCD line.

DDIIAAGGNNOOSSTTIICCSS
       Depending  on how the program was configured, all diagnos-
       tics are written to the console device or reported via the
       syslog(3)  facility.   Error  messages are produced if the
       _p_o_r_t argument does not specify a terminal device; if there
       is  no  /etc/utmp  entry for the current process (System V
       only); and so on.

AAUUTTHHOORR((SS))
       W.Z. Venema <wietse@wzv.win.tue.nl>
       Eindhoven University of Technology
       Department of Mathematics and Computer Science
       Den Dolech 2, P.O. Box 513, 5600 MB Eindhoven, The Netherlands



                                                                3





GETTY(8)                                                 GETTY(8)


CCRREEAATTIIOONN DDAATTEE
       Sat Nov 25 22:51:05 MET 1989

LLAASSTT MMOODDIIFFIICCAATTIIOONN
       91/09/01 23:22:00

VVEERRSSIIOONN//RREELLEEAASSEE
       1.29

















































                                                                4


