4.3BSD-Reno/share/man/cat1/login.0

LOGIN(1)		    UNIX Reference Manual		      LOGIN(1)

NNAAMMEE
     llooggiinn - sign on

SSYYNNOOPPSSIISS
     llooggiinn [--pp] [_u_s_e_r_n_a_m_e]
     llooggiinn [--pp] [--hh _h_o_s_t_n_a_m_e] [--ff] [_u_s_e_r_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
     The llooggiinn command is used when a user initially signs on.	It may also be
     used at any time to change from one user to another.  This case is the
     one summarized first above and described here.  See _H_o_w _t_o _G_e_t _S_t_a_r_t_e_d
     for how to connect initially.  The invocation of llooggiinn for initial sign-
     on is made by a system program or server using the latter form of the
     command and is described below.

     If llooggiinn is invoked without an argument, it asks for a user name, and, if
     appropriate, a password.  Echoing is turned off (if possible) during the
     typing of the password, so it will not appear on the written record of
     the session.

     After a successful login, accounting files are updated and the user is
     informed of the existence of mail.  The message of the day is printed, as
     is the time of his last login.  Both are suppressed if he has a ``._h_u_s_h_-
     _l_o_g_i_n'' file in his home directory; this is mostly used to make life
     easier for non-human users, such as uucp(1).

     LLooggiinn initializes the user and group IDs and the working directory, then
     executes a command interpreter (usually csh(1)) according to specifica-
     tions found in a password file.  Argument 0 of the command interpreter is
     the name of the command interpreter with a leading dash `--'.

     Login also modifies the environment (see environ(7)) with information
     specifying home directory, command interpreter, terminal type (if
     available) and user name.

     Options:

     --pp    Causes the remainder of the environment to be preserved, otherwise
	   any previous environment is discarded.

     --hh    option is used by telnetd(8) (at initial login) and other servers
	   to list the host from which the connection was received.

     --ff    Used with a username on the command line, at initial login, to in-
	   dicate that proper authentication has already been done and that no
	   password need be requested.	This option may be used by the su-
	   peruser or by the user specified on the command line.

     If the file /_e_t_c/_n_o_l_o_g_i_n exists, llooggiinn prints its contents on the user's
     terminal and exits. This is used by shutdown(8) to stop users logging in
     when the system is about to go down.

     Login is recognized by sh(1) and csh(1) and executed directly (without
     forking).

FFIILLEESS
     /_v_a_r/_r_u_n/_u_t_m_p   accounting
     /_v_a_r/_l_o_g/_w_t_m_p   accounting
     /_v_a_r/_m_a_i_l/*     mail
     /_e_t_c/_m_o_t_d	     message-of-the-day
     /_e_t_c/_p_a_s_s_w_d     password file
     /_e_t_c/_n_o_l_o_g_i_n    stops logins
     ._h_u_s_h_l_o_g_i_n      makes login quieter

SSEEEE AALLSSOO
     mail(1), passwd(1), rlogin(1), getpass(3), passwd(5), utmp(5), en-
     viron(7), init(8), getty(8), shutdown(8),

HHIISSTTOORRYY
     llooggiinn appeared in Version 6 AT&T Unix.

DDIIAAGGNNOOSSTTIICCSS
     Login incorrect
	       if the name or the password is bad.
     No Shell
     cannot open password file
     no directory
	       consult a programming counselor.