Flush out the last dregs in the terminal before quitting when

[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 e54705b..2a69db8 100644 (file)
--- a/usr/src/usr.bin/login/login.1
+++ b/usr/src/usr.bin/login/login.1
@@ -2,7 +2,7 @@
 .\" 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     6.2 (Berkeley) %G%
+.\"    @(#)login.1     6.4 (Berkeley) %G%

 .\"
 .TH LOGIN 1 ""
 .UC 4
 .\"
 .TH LOGIN 1 ""
 .UC 4


@@ -10,17 +10,36 @@
 login \- sign on
 .SH SYNOPSIS
 .B login
 login \- sign on
 .SH SYNOPSIS
 .B login

-[ \-p ] [ username ]
+[
+.B \-p
+] [ username ]
+.br
+.B login
+[
+.B \-p
+] [
+.B \-h
+hostname
+] [
+.B \-f
+] [
+username
+]

 .SH DESCRIPTION
 The
 .I login
 command
 is used when a user initially
 .SH DESCRIPTION
 The
 .I login
 command
 is used when a user initially

-signs on, or it may be used at any time to change
+signs on.
+It may also be used at any time to change

 from one user to another.
 from one user to another.

-The latter case is the one summarized above and
-described here.
-See \*(lqHow to Get Started\*(rq for how to dial up initially.
+This case is the one summarized first above and described here.
+See \*(lqHow to Get Started\*(rq for how to connect initially.
+The invocation of
+.I login
+for initial sign-on
+is made by a system program or server using the latter form of the command
+and is described below.

 .PP
 If
 .I login
 .PP
 If
 .I login


@@ -71,6 +90,24 @@ Login is recognized by
 and
 .IR csh (1)
 and executed directly (without forking).
 and
 .IR csh (1)
 and executed directly (without forking).

+.PP
+There are several additional options to
+.I login
+for use at initial login.
+With one exception, these options are available only to the superuser.
+The
+.B \-h
+option is used by
+.IR telnetd (8C)
+and other servers to list the host from which
+the connection was received.
+The
+.B \-f
+option is used with a username on the command line
+to indicate that proper authentication has already been done
+and that no password need be requested.
+This option may be used by the superuser
+or by the user specified on the command line.

 .SH FILES
 .ta \w'/usr/spool/mail/*\ \ 'u
 /etc/utmp      accounting
 .SH FILES
 .ta \w'/usr/spool/mail/*\ \ 'u
 /etc/utmp      accounting


@@ -87,8 +124,8 @@ and executed directly (without forking).
 .br
 \&.hushlogin   makes login quieter
 .SH "SEE ALSO"
 .br
 \&.hushlogin   makes login quieter
 .SH "SEE ALSO"

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

 .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.


@@ -100,11 +137,7 @@ consult a programming counselor.
 An undocumented option,
 .B \-r
 is used by the remote login server,
 An undocumented option,
 .B \-r
 is used by the remote login server,

-.IR rlogind (8C)
+.IR rlogind (8)

 to force
 .I login
 to enter into an initial connection protocol.
 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.