Return to utmp.5 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / man / man5

Annotation of 43BSDReno/share/man/man5/utmp.5, revision 1.1.1.1

1.1       root        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: .\"
                      5: .\"    @(#)utmp.5      6.6 (Berkeley) 6/23/90
                      6: .\"
                      7: .TH UTMP 5  "June 23, 1990"
                      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
                     16: file records information about who is currently using the system.
                     17: The file is a sequence of entries with the following structure, as
                     18: defined in the include file.
                     19: .RS
                     20: .PP
                     21: .nf
                     22: #define UT_NAMESIZE    8
                     23: #define UT_LINESIZE    8
                     24: #define UT_HOSTSIZE    16
                     25: struct utmp {
                     26:        char    ut_line[UT_NAMESIZE];
                     27:        char    ut_name[UT_LINESIZE];
                     28:        char    ut_host[UT_HOSTSIZE];
                     29:        time_t  ut_time;
                     30: };
                     31: .ft R
                     32: .ad
                     33: .fi
                     34: .RE
                     35: .PP
                     36: This structure gives the name of the special file
                     37: associated with the user's terminal, the user's login name,
                     38: and the time of the login in the form of
                     39: .IR time (3).
                     40: .PP
                     41: The
                     42: .I wtmp
                     43: file records all logins and logouts.
                     44: A null user name indicates a logout on the associated terminal.
                     45: Furthermore, the terminal name `~' indicates that the system was
                     46: rebooted at the indicated time; in such cases the name will be
                     47: ``shutdown''.  An adjacent pair of entries with terminal names
                     48: `\^|\^' and `{' indicate the system-maintained time just before
                     49: and just after a
                     50: .I date
                     51: command has changed the system's idea of the time.  The name for
                     52: both entries will be ``date''.
                     53: .PP
                     54: .I Wtmp
                     55: is maintained by
                     56: .IR login (1)
                     57: and
                     58: .IR init (8).
                     59: Neither of these programs creates the file, so if it is removed
                     60: record-keeping is turned off.  It is summarized by
                     61: .IR last (1)
                     62: and
                     63: .IR ac (8).
                     64: .SH FILES
                     65: /var/run/utmp
                     66: .br
                     67: /var/log/wtmp
                     68: .SH "SEE ALSO"
                     69: last(1), login(1), who(1), ac(8), init(8)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.