386BSD 0.1 development

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

diff --git a/usr/src/usr.bin/last/last.1 b/usr/src/usr.bin/last/last.1
index 34b4cdc..70ef095 100644 (file)
--- a/usr/src/usr.bin/last/last.1
+++ b/usr/src/usr.bin/last/last.1
@@ -1,76 +1,123 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)last.1      6.1 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.TH LAST 1 ""
-.UC 4
-.SH NAME
-last \- indicate last logins of users and teletypes
-.SH SYNOPSIS
-.B last
-[
-\-N
-]
-[
-name ...
-] [
-tty ...
-]
-.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.
-.PP
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)last.1     6.8 (Berkeley) 5/5/91
+.\"
+.Dd May 5, 1991
+.Dt LAST 1
+.Os BSD 4
+.Sh NAME
+.Nm last
+.Nd indicate last logins of users and ttys
+.Sh SYNOPSIS
+.Nm last
+.Op Fl Ns Ar n
+.Op Fl f Ar file
+.Op Fl h Ar host
+.Op Fl t Ar tty
+.Op user ...
+.Sh DESCRIPTION
+.Nm Last
+will list the sessions of specified
+.Ar users ,
+.Ar ttys ,
+and
+.Ar hosts ,
+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 crash or shutdown,
+.Nm last
+will so indicate.
+.Pp
+.Bl -tag -width indent-two
+.It Fl f Ar file
+.Nm Last
+reads the file
+.Ar file
+instead of the default,
+.Pa /var/log/wtmp .
+.It Fl Ar n
+Limits the report to
+.Ar n
+lines.
+.It Fl t Ar tty
+Specify the
+.Ar tty .
+Tty names may be given fully or abbreviated, for example,
+.Dq Li "last -t 03"
+is
+equivalent to
+.Dq Li "last -t tty03" .
+.It Fl h Ar host
+.Ar Host
+names may be names or internet numbers.
+.El
+.Pp
+If
+multiple arguments are given, the information which applies to any of the
+arguments is printed, e.g.,
+.Dq Li "last root -t console"
+would list all of
+.Dq Li root Ns 's
+sessions as well as all sessions on the console terminal. If no
+users, hostnames or terminals are specified,
+.Nm last
+prints a record of
+all logins and logouts.
+.Pp

 The pseudo-user
 The pseudo-user

-.B reboot
+.Ar reboot

 logs in at reboots of the system, thus
 logs in at reboots of the system, thus

-.DT
-.PP
-       last reboot
-.PP
+.Dq Li last reboot

 will give an indication of mean time between reboot.
 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
+.Pp

 If
 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.
-.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 AUTHOR
-Howard Katseff
+.Nm last
+is interrupted, it indicates to what date the search has
+progressed.  If interrupted with a quit signal
+.Nm last
+indicates how
+far the search has progressed and then continues.
+.Sh FILES
+.Bl -tag -width /var/log/wtmp -compact
+.It Pa /var/log/wtmp
+login data base
+.El
+.Sh SEE ALSO
+.Xr lastcomm 1 ,
+.Xr utmp 5 ,
+.Xr ac 8
+.Sh HISTORY
+.Nm Last
+appeared in
+.Bx 3.0 .