Penguin
Annotated edit history of login(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 LOGIN
2 !!!LOGIN
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 CAVEATS
8 FILES
9 SEE ALSO
10 AUTHOR
11 ----
12 !!NAME
13
14
15 login - Begin session on the system
16 !!SYNOPSIS
17
18
19 __login__ [[__-p__] [[''username''] [[''ENV=VAR
20 ...'']__
21 login__ [[__-p__] [[__-h__ ''host''] [[__-f__
22 ''username'']__
23 login__ [[__-p__] __-r__ ''host''
24 !!DESCRIPTION
25
26
27 __login__ is used to establish a new session with the
28 system. It is normally invoked automatically by responding
29 to the ''login:'' prompt on the user's terminal.
30 __login__ may be special to the shell and may not be
31 invoked as a sub-process. Typically, __login__ is treated
32 by the shell as __exec login__ which causes the user to
33 exit from the current shell. Attempting to execute
34 __login__ from any shell but the login shell will produce
35 an error message.
36
37
38 When invoked from the ''login:'' prompt, the user may
39 enter environmental variables after the username. These
40 variables are entered in the form __NAME=VALUE__. Not all
41 variables may be set in the fashion, notably __PATH__,
42 __HOME__ and __SHELL__. Additionally, __IFS__ may
43 be inhibited if the user's login shell is
44 __/bin/sh__.
45
46
47 The user is then prompted for a password, where appropriate.
48 Echoing is disabled to prevent revealing the password. Only
49 a small number of password failures are permitted before
50 __login__ exits and the communications link is
51 severed.
52
53
54 If password aging has been enabled for your account, you may
55 be prompted for a new password before proceeding. You will
56 be forced to provide your old password and the new password
57 before continuing. Please refer to __passwd__ (1) for
58 more information.
59
60
61 After a successful login, you will be informed of any system
62 messages and the presence of mail. You may turn off the
63 printing of the system message file, ''/etc/motd'', by
64 creating a zero-length file ''.hushlogin'' in your login
65 directory. The mail message will be one of ''You have
66 new mail.____You have mail.__
67 __No Mail.__
68 __
69
70
71 Your user and group ID will be set according to their values
72 in the ''/etc/passwd'' file. The value for __$HOME__,
73 __$SHELL__, __$PATH__, __$LOGNAME__, and
74 __$MAIL__ are set according to the appropriate fields in
75 the password entry. Ulimit, umask and nice values may also
76 be set according to entries in the GECOS field.
77
78
79 On some installations, the environmental variable
80 __$TERM__ will be initialize to the terminal type on your
81 tty line, as specified in ''/etc/ttytype''.
82
83
84 An initialization script for your command interpreter may
85 also be executed. Please see the appropriate manual section
86 for more information on this function.
87
88
89 A subsystem login is indicated by the presense of a
90 !!OPTIONS
91
92
93 __-p__
94
95
96 Preserve environment.
97
98
99 __-f__
100
101
102 Do not perform authentication, user is
103 preauthenticated.
104
105
106 __-h__
107
108
109 Name of the remote host for this login.
110
111
112 __-r__
113
114
115 Perform autologin protocol for rlogin.
116
117
118 The __-r -h__ and __-f__ options are only used when
119 __login__ is invoked by root.
120 !!CAVEATS
121
122
123 This version of __login__ has many compilation options,
124 only some of which may be in use at any particular
125 site.
126
127
128 The location of files is subject to differences in system
129 configuration.
130 !!FILES
131
132
133 /var/run/utmp - list of current login sessions
134 /var/log/wtmp - list of previous login sessions
135 /etc/passwd - user account information
136 /etc/shadow - encrypted passwords and age information
137 /etc/motd - system message file
138 /etc/nologin - prevent non-root users from logging in
139 /etc/ttytype - list of terminal types
140 $HOME/.profile - initialization script for default shell
141 $HOME/.hushlogin - suppress printing of system
142 messages
143 !!SEE ALSO
144
145
146 getty(8), mail(1), passwd(1),
2 perry 147 sh(1), su(1), login.defs(5),
1 perry 148 passwd(5), nologin(5)
149 !!AUTHOR
150
151
152 Julianne Frances Haugh (jfh@austin.ibm.com)
153 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.