man/man5/utmp.5

   1 .TH UTMP 5
   2 .SH NAME
   3 utmp, wtmp \- logged in users, login and logout history
   4 .SH SYNOPSIS
   5 .nf
   6 .ft B
   7 #include <sys/types.h>
   8 #include <utmp.h>
   9 .SH DESCRIPTION
  10 .de SP
  11 .if t .sp 0.4
  12 .if n .sp
  13 ..
  14 The files
  15 .B /etc/utmp
  16 and
  17 .B /usr/adm/wtmp
  18 respectively contain the currently logged in users, and the history of
  19 logins and logouts.
  20 .PP
  21 Each file is an array of the following structure defined in <utmp.h>:
  22 .PP
  23 .nf
  24 .ta +5n +15n +15n
  25 struct utmp {
  26         char    ut_user[8];     /* user name */
  27         char    ut_line[12];    /* terminal name */
  28         char    ut_host[16];    /* host name, when remote */
  29         time_t  ut_time;        /* login/logout time */
  30 };
  31 .SP
  32 .ta +15n
  33 #define ut_name ut_user /* for compatibility with other systems */
  34 .fi
  35 .DT
  36 .PP
  37 The structure contains more fields than those listed, but they are only of
  38 interest to
  39 .B init
  40 and
  41 .BR login .
  42 Note that the
  43 .B ut_name
  44 field is a compatibility alias for
  45 .BR ut_user ,
  46 it is actually better to use it.
  47 .PP
  48 A login entry is completely specified.  A logout entry has a null string for
  49 .BR ut_name .
  50 A shutdown or reboot entry has an
  51 .B ut_line
  52 field containing a "~" (tilde).  The
  53 .B ut_name
  54 field is usually the name of the program that did the shutdown, or "reboot"
  55 at reboot.  This is a bit confusing, but note that there should always be
  56 two such entries.  If you see just one entry then the system has crashed, if
  57 you see two entries then the system was properly shut down and later
  58 rebooted.
  59 .SH FILES
  60 .TP 25n
  61 .B /etc/utmp
  62 Currently logged in users.
  63 .TP
  64 .B /usr/adm/wtmp
  65 History of logins and logouts.
  66 .SH "SEE ALSO"
  67 .BR who (1),
  68 .BR ttyslot (3).
  69 .SH AUTHOR
  70 Kees J. Bot (kjb@cs.vu.nl)