NAME                                                     LOGIN(I)
     login  -  sign onto UNIX

SYNOPSIS
     login [ username ]

DESCRIPTION
     The login command is used when a user initially  signs  onto
     UNIX,  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	login 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 and message-
     of-the-day	files.	Login initializes the user and group  IDs
     and  the  working	directory, then	executes a command inter-
     preter (usually sh(I)) according to specifications	found  in
     a password	file.

     Login is recognized  by  the  Shell  and  executed	 directly
     (without forking).

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

SEE ALSO
     init(VIII),  getty(VIII),	mail(I),  passwd(I),   passwd(V),
     sh(I), su(I)

DIAGNOSTICS
     `login incorrect,'	if the name or the password is bad.   `No
     Shell',  `cannot  open password file,' `no	directory':  con-
     sult a UNIX programming counselor.	 System	hangs up  a  line
     left in login state.