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