


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


