document -u flag and environment variables

1 files changed, 32 insertions, 4 deletions

diff --git a/usr.bin/login/login.1 b/usr.bin/login/login.1
index 8eef1b5154d..218900a1446 100644
--- a/usr.bin/login/login.1
+++ b/usr.bin/login/login.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: login.1,v 1.13 2000/03/24 21:41:08 aaron Exp $
+.\"	$OpenBSD: login.1,v 1.14 2000/11/29 23:15:09 millert Exp $
 .\"	$NetBSD: login.1,v 1.7 1995/08/31 22:52:33 jtc Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
@@ -44,6 +44,7 @@
 .Nm login
 .Op Fl fp
 .Op Fl h Ar hostname
+.Op Fl u Ar username
 .Op Ar user
 .Sh DESCRIPTION
 The
@@ -73,9 +74,12 @@ requested.
 This option may only be used by the superuser or when an already
 logged in user is logging in as themselves.
 .It Fl h Ar hostname
-The
-.Fl h
-option specifies the host from which the connection was received.
+Specifies the host from which the connection was received.
+It is used by various daemons such as
+.Xr telnetd 8 .
+This option may only be used by the superuser.
+.It Fl u Ar username
+Specifies the remote user that initiated the connection.
 It is used by various daemons such as
 .Xr telnetd 8 .
 This option may only be used by the superuser.
@@ -150,6 +154,30 @@ and
 do not fork before executing the
 .Nm
 utility.
+.Sh ENVIRONMENT
+.Nm
+sets the following environment variables:
+.Bl -tag -width REMOTEHOST
+.It Ev HOME
+The user's home directory, as specified by the password database.
+.It Ev SHELL
+The user's shell, as specified by the password database.
+.It Ev TERM
+The user's terminal type, if it can be determined.
+.It Ev LOGNAME
+The user's login name.
+.It Ev USER
+Same as
+.Ev LOGNAME .
+.It Ev REMOTEHOST
+The name of the host from which the user logged in, if the
+.Fl h
+flag was specified.
+.It Ev REMOTEUSER
+The name of the remote user who initiated the connection, if the
+.Fl u
+flag was specified.
+.El
 .Sh FILES
 .Bl -tag -width /var/log/failedlogin -compact
 .It Pa /etc/fbtab