[unix-history] / usr / man / man5 / utmp.5

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