xref: /freebsd/usr.sbin/lastlogin/lastlogin.8 (revision 61e21613)
1.\"	$NetBSD: lastlogin.8,v 1.3 1998/02/06 06:20:39 perry Exp $
2.\"
3.\" Copyright (c) 1996 John M. Vinopal
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"	This product includes software developed for the NetBSD Project
17.\"	by John M. Vinopal.
18.\" 4. The name of the author may not be used to endorse or promote products
19.\"    derived from this software without specific prior written permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
26.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
27.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
28.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
29.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31.\" SUCH DAMAGE.
32.\"
33.Dd August 28, 2018
34.Dt LASTLOGIN 8
35.Os
36.Sh NAME
37.Nm lastlogin
38.Nd indicate last login time of users
39.Sh SYNOPSIS
40.Nm
41.Op Fl -libxo
42.Op Fl f Ar file
43.Op Fl rt
44.Op Ar user ...
45.Sh DESCRIPTION
46The
47.Nm
48utility will list the last login session of each specified
49.Ar user ,
50or for all users by default.
51Each line of output contains
52the user name, the tty from which the session was conducted, any
53hostname, and the start time for the session.
54.Pp
55If more than one
56.Ar user
57is given, the session information for each user is printed in
58the order given on the command line.
59Otherwise, information for all users is printed.
60By default, the entries are sorted by user name.
61.Pp
62The
63.Nm
64utility differs from
65.Xr last 1
66in that it only prints information regarding the very last login session.
67The last login database is never turned over or deleted in standard usage.
68.Pp
69The following options are available:
70.Bl -tag -width indent
71.It Fl -libxo
72Generate output via
73.Xr libxo 3
74in a selection of different human and machine readable formats.
75See
76.Xr xo_parse_args 3
77for details on command line arguments.
78.It Fl f Ar file
79Open last login database
80.Ar file
81instead of the system-wide database.
82.It Fl r
83Print the entries in reverse sorted order.
84.It Fl t
85Sort the elements by last login time, instead of user name.
86.El
87.Sh FILES
88.Bl -tag -width /var/log/utx.lastlogin -compact
89.It Pa /var/log/utx.lastlogin
90last login database
91.El
92.Sh SEE ALSO
93.Xr last 1 ,
94.Xr getutxent 3 ,
95.Xr ac 8 ,
96.Xr libxo 3 ,
97.Xr xo_parse_args 3
98.Sh AUTHORS
99.An -nosplit
100.An John M. Vinopal
101wrote this program in January 1996 and contributed it
102to the
103.Nx
104project.
105.An Philip Paeps added
106.Xr libxo 3
107support in August 2018.
108