xref: /386bsd/usr/share/man/cat1/login.0 (revision a2142627)
1LOGIN(1)                    386BSD Reference Manual                   LOGIN(1)
2
3NNAAMMEE
4     llooggiinn - log into the computer
5
6SSYYNNOOPPSSIISS
7     llooggiinn [--ffpp] [--hh _h_o_s_t_n_a_m_e] [_u_s_e_r]
8
9DDEESSCCRRIIPPTTIIOONN
10     The llooggiinn utility logs users (and pseudo-users) into the computer system.
11
12     If no user is specified, or if a user is specified and authentication of
13     the user fails, llooggiinn prompts for a user name.  Authentication of users
14     is done via passwords.
15
16     The options are as follows:
17
18     --ff      The --ff option is used when a user name is specified to indicate
19             that proper authentication has already been done and that no
20             password need be requested.  This option may only be used by the
21             super-user or when an already logged in user is logging in as
22             themselves.
23
24     --hh      The --hh option specifies the host from which the connection was
25             received.  It is used by various daemons such as telnetd(8).
26             This option may only be used by the super-user.
27
28     --pp      By default, llooggiinn discards any previous environment.  The --pp
29             option disables this behavior.
30
31     If the file /_e_t_c/_n_o_l_o_g_i_n exists, llooggiinn dislays its contents to the user
32     and exits.  This is used by shutdown(8) to prevent users from logging in
33     when the system is about to go down.
34
35     Immediately after logging a user in, llooggiinn displays the system copyright
36     notice, the date and time the user last logged in, the message of the day
37     as well as other information.  If the file ``._h_u_s_h_l_o_g_i_n'' exists in the
38     user's home directory, all of these messages are suppressed.  This is to
39     simplify logins for non-human users, such as uucp(1).  LLooggiinn then records
40     an entry in the wtmp(5) and utmp(5) files and executes the user's command
41     interpretor.
42
43     Login enters information into the environment (see environ(7))
44     specifying the user's home directory (HOME), command interpreter (SHELL),
45     search path (PATH), terminal type (TERM) and user name (both LOGNAME and
46     USER).
47
48     The standard shells, csh(1) and sh(1),  do not fork before executing the
49     llooggiinn utility.
50
51FFIILLEESS
52     /etc/motd          message-of-the-day
53     /etc/nologin       disallows logins
54     /var/run/utmp      current logins
55     /var/log/wtmp      login account records
56     /var/mail/user     system mailboxes
57     .hushlogin         makes login quieter
58
59SSEEEE AALLSSOO
60     chpass(1),  passwd(1),  rlogin(1),  getpass(3),  utmp(5),  environ(7),
61
62HHIISSTTOORRYY
63     A llooggiinn appeared in Version 6 AT&T UNIX.
64
654th Berkeley Distribution        June 29, 1991                               1
66
67