137 lines
4.4 KiB
Groff
137 lines
4.4 KiB
Groff
.\"Generated by db2man.xsl. Don't modify this, modify the source.
|
||
.de Sh \" Subsection
|
||
.br
|
||
.if t .Sp
|
||
.ne 5
|
||
.PP
|
||
\fB\\$1\fR
|
||
.PP
|
||
..
|
||
.de Sp \" Vertical space (when we can't use .PP)
|
||
.if t .sp .5v
|
||
.if n .sp
|
||
..
|
||
.de Ip \" List item
|
||
.br
|
||
.ie \\n(.$>=3 .ne \\$3
|
||
.el .ne 3
|
||
.IP "\\$1" \\$2
|
||
..
|
||
.TH "LOGIN" 1 "" "" ""
|
||
.SH NAME
|
||
login \- begin session on the system
|
||
.SH "SYNOPSIS"
|
||
.ad l
|
||
.hy 0
|
||
.HP 6
|
||
\fBlogin\fR [\-p] [\fIusername\fR] [\fIENV=VAR\fR...]
|
||
.ad
|
||
.hy
|
||
.ad l
|
||
.hy 0
|
||
.HP 6
|
||
\fBlogin\fR [\-p] [\-h\ \fIhost\fR] [\-f\ \fIusername\fR]
|
||
.ad
|
||
.hy
|
||
.ad l
|
||
.hy 0
|
||
.HP 6
|
||
\fBlogin\fR [\-p] \-r\ \fIhost\fR
|
||
.ad
|
||
.hy
|
||
|
||
.SH "DESCRIPTION"
|
||
|
||
.PP
|
||
\fBlogin\fR is used to establish a new session with the system\&. It is normally invoked automatically by responding to the \fIlogin:\fR prompt on the user´s terminal\&. \fBlogin\fR may be special to the shell and may not be invoked as a sub\-process\&. Typically, \fBlogin\fR is treated by the shell as \fIexec login\fR which causes the user to exit from the current shell\&. Attempting to execute \fBlogin\fR from any shell but the login shell will produce an error message\&.
|
||
|
||
.PP
|
||
The user is then prompted for a password, where appropriate\&. Echoing is disabled to prevent revealing the password\&. Only a small number of password failures are permitted before \fBlogin\fR exits and the communications link is severed\&.
|
||
|
||
.PP
|
||
If password aging has been enabled for your account, you may be prompted for a new password before proceeding\&. You will be forced to provide your old password and the new password before continuing\&. Please refer to \fBpasswd\fR(1) for more information\&.
|
||
|
||
.PP
|
||
After a successful login, you will be informed of any system messages and the presence of mail\&. You may turn off the printing of the system message file, \fI/etc/motd\fR, by creating a zero\-length file \&.hushlogin in your login directory\&. The mail message will be one of "\fIYou have new mail\&.\fR ", "\fIYou have mail\&.\fR", or "\fINo Mail\&.\fR "according to the condition of your mailbox\&.
|
||
|
||
.PP
|
||
Your user and group ID will be set according to their values in the \fI/etc/passwd\fR file\&. The value for \fI$HOME\fR, \fI$SHELL\fR, \fI$PATH\fR, \fI$LOGNAME\fR, and \fI$MAIL\fR are set according to the appropriate fields in the password entry\&. Ulimit, umask and nice values may also be set according to entries in the GECOS field\&.
|
||
|
||
.PP
|
||
On some installations, the environmental variable \fI$TERM\fR will be initialized to the terminal type on your tty line, as specified in \fI/etc/ttytype\fR\&.
|
||
|
||
.PP
|
||
An initialization script for your command interpreter may also be executed\&. Please see the appropriate manual section for more information on this function\&.
|
||
|
||
.PP
|
||
A subsystem login is indicated by the presence of a "*" as the first character of the login shell\&. The given home directory will be used as the root of a new file system which the user is actually logged into\&.
|
||
|
||
.PP
|
||
The \fBlogin\fR program is NOT responsible for removing users from the utmp file\&. It is the responsibility of getty(8) and init(8) to clean up apparent ownership of a terminal session\&. If you use \fBlogin\fR from the shell prompt without \fBexec\fR, the user you use will continue to appear to be logged in even after you log out of the "subsession"\&.
|
||
|
||
.SH "OPTIONS"
|
||
|
||
.TP
|
||
\fB\-f\fR
|
||
Do not perform authentication, user is preauthenticated\&.
|
||
|
||
.TP
|
||
\fB\-h\fR
|
||
Name of the remote host for this login\&.
|
||
|
||
.TP
|
||
\fB\-p\fR
|
||
Preserve environment\&.
|
||
|
||
.TP
|
||
\fB\-r\fR
|
||
Perform autologin protocol for rlogin\&.
|
||
|
||
.PP
|
||
The \fB\-r\fR, \fB\-h\fR and \fB\-f\fR options are only used when \fBlogin\fR is invoked by root\&.
|
||
|
||
.SH "CAVEATS"
|
||
|
||
.PP
|
||
This version of \fBlogin\fR has many compilation options, only some of which may be in use at any particular site\&.
|
||
|
||
.PP
|
||
The location of files is subject to differences in system configuration\&.
|
||
|
||
.SH "FILES"
|
||
|
||
.TP
|
||
\fI/var/run/utmp\fR
|
||
list of current login sessions
|
||
.TP
|
||
\fI/var/log/wtmp\fR
|
||
list of previous login sessions
|
||
.TP
|
||
\fI/etc/passwd\fR
|
||
user account information
|
||
.TP
|
||
\fI/etc/shadow\fR
|
||
secure user account information
|
||
.TP
|
||
\fI/etc/motd\fR
|
||
system message of the day file
|
||
.TP
|
||
\fI/etc/nologin\fR
|
||
prevent non\-root users from logging in
|
||
.TP
|
||
\fI/etc/ttytype\fR
|
||
list of terminal types
|
||
.TP
|
||
\fI$HOME/\&.hushlogin\fR
|
||
suppress printing of system messages
|
||
.SH "SEE ALSO"
|
||
|
||
.PP
|
||
\fBmail\fR(1), \fBpasswd\fR(1), \fBsh\fR(1), \fBsu\fR(1), \fBlogin\&.defs\fR(5), \fBnologin\fR(5), \fBpasswd\fR(5), \fBgetty\fR(8)
|
||
|
||
.SH "AUTHOR"
|
||
|
||
.PP
|
||
Julianne Frances Haugh <jockgrrl@ix\&.netcom\&.com>
|
||
|