4.3BSD-UWisc/man/cat5/utmp.5

UTMP(5)             UNIX Programmer's Manual              UTMP(5)



NAME
     utmp, wtmp - login records

SYNOPSIS
     #include <utmp.h>

DESCRIPTION
     The _u_t_m_p 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:

          /*
           * RCS Info
           *   $Header: utmp.h,v 1.1 86/09/05 08:03:18 tadl Exp $
           *   $Locker: tadl $
           */
          /*
           * Copyright (c) 1980 Regents of the University of California.
           * All rights reserved.  The Berkeley software License Agreement
           * specifies the terms and conditions for redistribution.
           *
           *   @(#)utmp.h     5.1 (Berkeley) 5/30/85
           */

          /*
           * Structure of utmp and wtmp files.
           *
           * Assuming the number 8 is unwise.
           */
          struct utmp {
               char ut_line[8];         /* tty name */
               char ut_name[8];         /* user id */
               char ut_host[16];        /* host name, if remote */
               long ut_time;       /* time on */
          };

     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 _t_i_m_e(3C).

     The _w_t_m_p file records all logins and logouts.  A null user
     name indicates a logout on the associated terminal.  Furth-
     ermore, 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 _d_a_t_e command
     has changed the system's idea of the time.

     _W_t_m_p is maintained by _l_o_g_i_n(1) and _i_n_i_t(8).  Neither of
     these programs creates the file, so if it is removed
     record-keeping is turned off.  It is summarized by _a_c(8).




Printed 12/27/86          June 23, 1985                         1






UTMP(5)             UNIX Programmer's Manual              UTMP(5)



FILES
     /etc/utmp
     /usr/adm/wtmp

SEE ALSO
     login(1), init(8), who(1), ac(8)

















































Printed 12/27/86          June 23, 1985                         2