added -f flag, hosts args, general cleanup

SCCS-vsn: usr.bin/last/last.1 6.2

diff --git a/usr/src/usr.bin/last/last.1 b/usr/src/usr.bin/last/last.1
index 34b4cdc..9d3c6fc 100644 (file)
--- a/usr/src/usr.bin/last/last.1
+++ b/usr/src/usr.bin/last/last.1
@@ -2,75 +2,52 @@
 .\" 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.
 .\"

-.\"    @(#)last.1      6.1 (Berkeley) %G%
+.\"    @(#)last.1      6.2 (Berkeley) %G%

 .\"
 .TH LAST 1 ""
 .UC 4
 .SH NAME
 .\"
 .TH LAST 1 ""
 .UC 4
 .SH NAME

-last \- indicate last logins of users and teletypes
+last \- indicate last logins of users and ttys

 .SH SYNOPSIS
 .SH SYNOPSIS

-.B last
-[
-\-N
-]
-[
-name ...
-] [
-tty ...
-]
+\fBlast\fP [-f file] [-#] [users ...] [ttys ...] [hosts ...]

 .SH DESCRIPTION
 .SH DESCRIPTION

-.I Last
-will look back in the
-.I wtmp
-file which records all logins and logouts for information about
-a user, a teletype or any group of users and teletypes.
-Arguments specify names of users or teletypes of interest.
-Names of teletypes may be given fully or abbreviated.
-For example `last 0' is the same as `last tty0'.
-If multiple arguments are given, the information which applies
-to any of the arguments is printed.  For example `last root console'
-would list all of "root's" sessions as well as all sessions
-on the console terminal.
-.I Last
-will print the sessions of the specified users and teletypes,
-most recent first, indicating the times at which the session
-began, the duration of the session, and the teletype which the
-session took place on.
-If the session is still continuing or was cut short by a reboot,
-.I last
-so indicates.
+\fILast\fP will list the sessions of specified \fIusers,\fP \fIttys,\fP
+and \fIhosts,\fP in reverse time order.  Each line of output contains
+the user name, the tty from which the session was conducted, any
+hostname, the start and stop times for the session, and the duration
+of the session.  If the session is still continuing or was cut short by
+a reboot, \fIlast\fP will so indicate.

 .PP
 .PP

-The pseudo-user
-.B reboot
-logs in at reboots of the system, thus
+\fILast\fP reads the file \fIfile\fP, or by default, /usr/adm/wtmp.
+The \fI-#\fP option limits the report to \fI#\fP lines.
+.PP
+Other arguments specify \fIusers,\fP \fIttys\fP or \fIhosts\fP of interest.
+Tty names may be given fully or abbreviated, e.g., "last 03" is equivalent
+to "last tty03".  Host names should not include domain information, and
+may be internet numbers.  If multiple arguments are given, the information
+which applies to any of the arguments is printed, e.g., "last root console"
+would list all of "root's" sessions as well as all sessions on the console
+terminal. If no users or terminals are specified, \fIlast\fP prints a record
+of all logins and logouts.
+.PP
+The pseudo-user \fBreboot\fP logs in at reboots of the system, thus

 .DT
 .PP
        last reboot
 .PP
 will give an indication of mean time between reboot.
 .PP
 .DT
 .PP
        last reboot
 .PP
 will give an indication of mean time between reboot.
 .PP

-.I Last
-with no arguments prints a record of all logins and logouts, in
-reverse order.
-The
-.B \-N
-option limits the report to N lines.
-.PP
-If
-.I last
-is interrupted, it indicates how far the search has progressed
-in
-.I wtmp.
-If interrupted with a quit signal
-(generated by a control-\e)
-.I last
-indicates how far the search has progressed so far, and the
-search continues.
+If \fIlast\fP is interrupted, it indicates to what date the search has
+progressed.  If interrupted with a quit signal \fIlast\fP indicates how
+far the search has progressed and then continues.

 .SH FILES
 /usr/adm/wtmp          login data base
 .br
 .SH FILES
 /usr/adm/wtmp          login data base
 .br

-/usr/adm/shutdownlog   which records shutdowns and reasons for same
-.SH SEE\ ALSO
-wtmp(5), ac(8), lastcomm(1)
+.SH "SEE ALSO"
+lastcomm(1), utmp(5), ac(8)
+.SH BUGS
+\fILast\fP does not distinguish between different types of information.  The
+command "last ucbvax" will report all sessions of the user "ucbvax" as well
+as all logins from the host "ucbvax.berkeley.edu".

 .SH AUTHOR
 Howard Katseff
 .SH AUTHOR
 Howard Katseff