Commit | Line | Data |
---|---|---|
5e02908f KM |
1 | .\" Copyright (c) 1980 Regents of the University of California. |
2 | .\" All rights reserved. The Berkeley software License Agreement | |
3 | .\" specifies the terms and conditions for redistribution. | |
4 | .\" | |
f6513e13 | 5 | .\" @(#)utmp.5 6.2 (Berkeley) %G% |
5e02908f | 6 | .\" |
e2339c1f | 7 | .TH UTMP 5 "" |
5e02908f KM |
8 | .UC 4 |
9 | .SH NAME | |
10 | utmp, wtmp \- login records | |
11 | .SH SYNOPSIS | |
12 | .B #include <utmp.h> | |
13 | .SH DESCRIPTION | |
14 | The | |
15 | .I utmp | |
e6d8beef | 16 | file records information about who is currently using the system. |
5e02908f KM |
17 | The file is a sequence of entries with the following |
18 | structure declared in the include file: | |
19 | .RS | |
20 | .PP | |
21 | .nf | |
22 | .so /usr/include/utmp.h | |
23 | .fi | |
24 | .RE | |
25 | .PP | |
26 | This structure gives the name of the special file | |
27 | associated with the user's terminal, the user's login name, | |
28 | and the time of the login in the form of | |
e6d8beef | 29 | .IR time (3C). |
5e02908f KM |
30 | .PP |
31 | The | |
32 | .I wtmp | |
33 | file records all logins and logouts. | |
e6d8beef | 34 | A null user name indicates a logout on the associated terminal. |
5e02908f KM |
35 | Furthermore, the terminal name `~' indicates that the |
36 | system was rebooted at the indicated time; | |
37 | the adjacent pair of entries with terminal names | |
f6513e13 | 38 | `\^|\^' and `{' indicate the system-maintained time just before and just after a |
5e02908f KM |
39 | .I date |
40 | command has changed the system's idea of the time. | |
41 | .PP | |
42 | .I Wtmp | |
43 | is maintained by | |
44 | .IR login (1) | |
45 | and | |
46 | .IR init (8). | |
47 | Neither of these programs creates the file, | |
e6d8beef | 48 | so if it is removed record-keeping is turned off. It is summarized by |
5e02908f KM |
49 | .IR ac (8). |
50 | .SH FILES | |
51 | /etc/utmp | |
52 | .br | |
53 | /usr/adm/wtmp | |
54 | .SH "SEE ALSO" | |
55 | login(1), init(8), who(1), ac(8) |