xref: /freebsd/usr.sbin/lastlogin/lastlogin.8 (revision a5615c90442b10b0d286b8fcf2cfdcc1c2958d58)
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 June 6, 2011
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 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 f Ar file
72Open last login database
73.Ar file
74instead of the system-wide database.
75.It Fl r
76Print the entries in reverse sorted order.
77.It Fl t
78Sort the elements by last login time, instead of user name.
79.El
80.Sh FILES
81.Bl -tag -width /var/log/utx.lastlogin -compact
82.It Pa /var/log/utx.lastlogin
83last login database
84.El
85.Sh SEE ALSO
86.Xr last 1 ,
87.Xr getutxent 3 ,
88.Xr ac 8
89.Sh AUTHORS
90.An John M. Vinopal
91wrote this program in January 1996 and contributed it
92to the
93.Nx
94project.
95