1 .\" Copyright (c) 1980, 1991, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. All advertising materials mentioning features or use of this software
13 .\" must display the following acknowledgement:
14 .\" This product includes software developed by the University of
15 .\" California, Berkeley and its contributors.
16 .\" 4. Neither the name of the University nor the names of its contributors
17 .\" may be used to endorse or promote products derived from this software
18 .\" without specific prior written permission.
20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .\" @(#)utmp.5 8.2 (Berkeley) 3/17/94
33 .\" $FreeBSD: src/share/man/man5/utmp.5,v 1.9.2.8 2001/12/17 11:30:15 ru Exp $
34 .\" $DragonFly: src/share/man/man5/utmp.5,v 1.3 2006/05/26 19:39:40 swildner Exp $
50 declares the structures used to record information about current
53 logins and logouts in the file
55 and last logins in the file
57 The time stamps of date changes, shutdowns and reboots are also logged in
61 .Bd -literal -offset indent
62 #define _PATH_UTMP "/var/run/utmp"
63 #define _PATH_WTMP "/var/log/wtmp"
64 #define _PATH_LASTLOG "/var/log/lastlog"
66 #define UT_NAMESIZE 16
68 #define UT_HOSTSIZE 16
71 time_t ll_time; /* When user logged in */
72 char ll_line[UT_LINESIZE]; /* Terminal line name */
73 char ll_host[UT_HOSTSIZE]; /* Host user came from */
77 char ut_line[UT_LINESIZE]; /* Terminal line name */
78 char ut_name[UT_NAMESIZE]; /* User's login name */
79 char ut_host[UT_HOSTSIZE]; /* Host user came from */
80 time_t ut_time; /* When user logged in */
86 file is a linear array of
88 structures indexed by a user's
92 file is a linear array of
94 structures indexed by a terminal line number
101 structures and is a binary log file,
102 that is, grows linearly at its end.
104 Each time a user logs in, the
106 program looks up the user's
110 If it is found, the timestamp of the last time the user logged
111 in, the terminal line and the hostname
112 are written to the standard output (unless the login is
118 program then records the new login time in the file
131 record for the user is inserted.
132 This record remains there until
133 the user logs out at which time it is deleted.
136 file is used by the programs
145 program opens the file
147 and appends the user's
150 The user's subsequent logout from the terminal
151 line is marked by a special
166 file is used by the programs
171 In the event of a date change, a shutdown or reboot, the
172 following items are logged in the
176 .Bl -tag -width ".Li shutdown" -compact
179 A system reboot or shutdown has been initiated.
182 is placed in the field
196 The system time has been manually or automatically updated
201 is recorded in the field
207 indicates the time prior to the change, and the character
209 indicates the new time.
214 file can grow rapidly on busy systems, so daily or weekly rotation
219 If any one of these files does not exist, it is not created by
221 They must be created manually.
228 utility functions should be used to perform
229 the standard actions on the
233 files in order to maintain the portability across
234 systems with different formats of those files.
236 .Bl -tag -width ".Pa /var/log/lastlog" -compact
245 .It Pa /var/log/lastlog
266 file format appeared in
270 file format appeared in