4BSD/usr/man/cat1/login.1

Compare this file to the similar file:
Show the results in this format:



LOGIN(1)            UNIX Programmer's Manual             LOGIN(1)



NAME
     login - sign on

SYNOPSIS
     login [ username ]

DESCRIPTION
     The _l_o_g_i_n command is used when a user initially signs on, or
     it may be used at any time to change from one user to
     another.  The latter case is the one summarized above and
     described here.  See `How to Get Started' for how to dial up
     initially.

     If _l_o_g_i_n 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 ._m_a_i_l and message-
     of-the-day files, and of the last time he logged in.  _L_o_g_i_n
     initializes the user and group IDs and the working direc-
     tory, then executes a command interpreter (usually _s_h(1))
     according to specifications found in a password file.  Argu-
     ment 0 of the command interpreter is `-sh, or more generally
     the name of the command interpreter with a leading dash (`-)
     prepended.

     Login also initializes the environment _e_n_v_i_r_o_n(5) with
     information specifying home directory, command interpreter,
     terminal type (if available) and user name.

     Login is recognized by _s_h(1),_c_s_h(1) and executed directly
     (without forking).

FILES
     /etc/utmp          accounting
     /usr/adm/wtmp      accounting
     /usr/spool/mail/*  mail
     /etc/motd          message-of-the-day
     /etc/passwd        password file

SEE ALSO
     init(8), newgrp(1), getty(8), mail(1), passwd(1), passwd(5),
     environ(5)

DIAGNOSTICS
     `Login incorrect,' if the name or the password is bad.
     `No Shell', `cannot open password file', `no directory':
     consult a programming counselor.





Printed 11/10/80                                                1