utmp(4)                                                                utmp(4)



NAME
     utmp, wtmp - utmp and wtmp entry formats

SYNOPSIS
     #include <utmp.h>

DESCRIPTION
     These files, which hold user and accounting information for such commands
     as who, last, write, and login, contain entries with the following
     structure, defined in utmp.h:

     #define UTMPFILE   "/var/adm/utmp"
     #define WTMPFILE   "/var/adm/wtmp"
     #define utname     utuser

     struct     utmp {

        char    utuser[8];      /* user login name */

        char    utid[4];        /* /etc/inittab id (created by */

                                 /* process that puts entry in utmp) */

        char    utline[12];     /* device name (console, lnxx) */

        short   utpid;          /* process id */

        short   uttype;         /* type of entry */

        struct  exitstatus {

           short  etermination; /* process termination status */

           short  eexit;        /* process exit status */

        } utexit;               /* exit status of a process */

                                 /* marked as DEADPROCESS */

        timet  uttime;         /* time entry was made */

     };

     /*  Definitions for uttype  */

     #define EMPTY         0

     #define RUNLVL       1

     #define BOOTTIME     2

     #define OLDTIME      3

     #define NEWTIME      4

     #define INITPROCESS  5   /* process spawned by "init" */

     #define LOGINPROCESS 6   /* a "getty" process waiting for login */

     #define USERPROCESS  7   /* a user process */

     #define DEADPROCESS  8

     #define ACCOUNTING    9

     #define UTMAXTYPE     ACCOUNTING /* max legal value of uttype */

     /*  Below are the special strings or formats used in the "utline" */
     /*  field when accounting for something other than a process.  */
     /*  Strings for the utline field must be no more than 11 chars +  */
     /*  terminating NULL in length.  */

     #define RUNLVLMSG     "run-level %c"

     #define BOOTMSG       "system boot"

     #define OTIMEMSG      "old time"

     #define NTIMEMSG      "new time"





                                                                        Page 1

utmp(4)                                                                utmp(4)



FILES
     /var/adm/utmp
     /var/adm/wtmp

WARNING
     All changes to /var/adm/wtmp must also be logged in /var/adm/wtmpx.  Most
     commands that extract information from these files silently discard all
     wtmpx entries without wtmp complements.

SEE ALSO
     w(1), login(1), who(1), last(1), utmpx(4), write(1), getut(3C),
     getutx(3C)











































                                                                        Page 2