added depend label

[unix-history] / usr / src / usr.bin / login / login.1

diff --git a/usr/src/usr.bin/login/login.1 b/usr/src/usr.bin/login/login.1
index 3cb2cf5..e54705b 100644 (file)
--- a/usr/src/usr.bin/login/login.1
+++ b/usr/src/usr.bin/login/login.1
@@ -2,15 +2,15 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"

-.\"    @(#)login.1     4.1 (Berkeley) %G%
+.\"    @(#)login.1     6.2 (Berkeley) %G%

 .\"
 .\"

-.TH LOGIN 1 4/1/81
+.TH LOGIN 1 ""

 .UC 4
 .SH NAME
 login \- sign on
 .SH SYNOPSIS
 .B login
 .UC 4
 .SH NAME
 login \- sign on
 .SH SYNOPSIS
 .B login

-[ username ]
+[ \-p ] [ username ]

 .SH DESCRIPTION
 The
 .I login
 .SH DESCRIPTION
 The
 .I login


@@ -34,30 +34,32 @@ session.
 After a successful login,
 accounting files are updated and
 the user is informed of the
 After a successful login,
 accounting files are updated and
 the user is informed of the

-existence of mail,
-and
-the message of the day is printed,
-as is the time he last logged in (unless he has a \*(lq.hushlogin\*(rq
-file in his home directory \- this
+existence of mail.
+The message of the day is printed,
+as is the time of his last login.
+Both are suppressed if he has a \*(lq.hushlogin\*(rq
+file in his home directory; this

 is mostly used to make life easier for non-human users, such as
 is mostly used to make life easier for non-human users, such as

-.IR uucp ).
+.IR uucp .

 .PP
 .I Login
 initializes the user and group IDs and the working directory,
 then executes a command interpreter (usually
 .PP
 .I Login
 initializes the user and group IDs and the working directory,
 then executes a command interpreter (usually

-.IR  sh (1))
+.IR  csh (1))

 according to specifications found in a password file.
 according to specifications found in a password file.

-Argument 0 of the command interpreter is \*(lq\-sh\*(rq, or
-more generally the name of the command interpreter with
-a leading dash (\*(lq\-\*(rq) prepended.
+Argument 0 of the command interpreter is
+the name of the command interpreter with
+a leading dash (\*(lq\-\*(rq).

 .PP
 .PP

-Login also initializes the
+Login also modifies the

 environment
 environment

-.IR environ (5)
+.IR environ (7)

 with information specifying home directory, command interpreter, terminal
 type (if available) and user name.
 with information specifying home directory, command interpreter, terminal
 type (if available) and user name.

+The `\-p' argument causes the remainder of the environment to be preserved,
+otherwise any previous environment is discarded.

 .PP
 .PP

-If the file /etc/nologin exists
+If the file /etc/nologin exists,

 .I login
 prints its contents on the user's terminal and exits. This is
 used by
 .I login
 prints its contents on the user's terminal and exits. This is
 used by


@@ -84,11 +86,9 @@ and executed directly (without forking).
 /etc/nologin   stops logins
 .br
 \&.hushlogin   makes login quieter
 /etc/nologin   stops logins
 .br
 \&.hushlogin   makes login quieter

-.br
-/etc/securetty lists ttys that root may log in on

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-init(8), newgrp(1), getty(8), mail(1), passwd(1), passwd(5), environ(5),
-shutdown(8)
+init(8), getty(8), mail(1), passwd(1), passwd(5), environ(7),
+shutdown(8), rlogin(1c)

 .SH DIAGNOSTICS
 \*(lqLogin incorrect,\*(rq
 if the name or the password is bad.
 .SH DIAGNOSTICS
 \*(lqLogin incorrect,\*(rq
 if the name or the password is bad.


@@ -96,3 +96,15 @@ if the name or the password is bad.
 \*(lqNo Shell\*(rq, \*(lqcannot open password file\*(rq,
 \*(lqno directory\*(rq:
 consult a programming counselor.
 \*(lqNo Shell\*(rq, \*(lqcannot open password file\*(rq,
 \*(lqno directory\*(rq:
 consult a programming counselor.

+.SH BUGS
+An undocumented option,
+.B \-r
+is used by the remote login server,
+.IR rlogind (8C)
+to force
+.I login
+to enter into an initial connection protocol.
+.B \-h is used by
+.IR telnetd (8C)
+and other servers to list the host from which
+the connection was received.