.\"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\&. .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