usr/share/man/cat5/utmp.0



UTMP(5)                       1990                        UTMP(5)


N\bNA\bAM\bME\bE
     utmp, wtmp - login records

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     #\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<u\but\btm\bmp\bp.\b.h\bh>\b>

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     The _\bu_\bt_\bm_\bp file records information about who is currently
     using the system.  The file is a sequence of entries with
     the following structure, as defined in the include file.

          #define UT_NAMESIZE 8
          #define UT_LINESIZE 8
          #define UT_HOSTSIZE 16
          struct utmp {
               char ut_line[UT_NAMESIZE];
               char ut_name[UT_LINESIZE];
               char ut_host[UT_HOSTSIZE];
               time_t    ut_time;
          };

     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 _\bt_\bi_\bm_\be(3).

     The _\bw_\bt_\bm_\bp 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; in such cases the name will
     be ``shutdown''.  An adjacent pair of entries with  terminal
     names  `|'  and `{' indicate the system-maintained time just
     before and  just  after  a  _\bd_\ba_\bt_\be  command  has  changed  the
     system's  idea  of the time.  The name for both entries will
     be ``date''.

     _\bW_\bt_\bm_\bp is maintained by  _\bl_\bo_\bg_\bi_\bn(1)  and  _\bi_\bn_\bi_\bt(8).   Neither  of
     these  programs  creates  the  file,  so  if  it  is removed
     record-keeping is turned off.  It is summarized  by  _\bl_\ba_\bs_\bt(1)
     and _\ba_\bc(8).

F\bFI\bIL\bLE\bES\bS
     /var/run/utmp
     /var/log/wtmp

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     last(1), login(1), who(1), ac(8), init(8)


Printed 7/27/90               June                              1