utmp(4)                                                   utmp(4)



     NAME
          utmp, wtmp - utmp and wtmp entry formats

     SYNOPSIS
          #include <sys/types.h>
          #include <utmp.h>

     DESCRIPTION
          These files, which hold user and accounting information for
          such commands as who(1), write(1), and login(1), have the
          following structure as defined by <utmp.h>:

          #define   UTMP_FILE "/etc/utmp"
          #define   WTMP_FILE "/etc/wtmp"

          #define   ut_name   ut_user

          struct utmp {
                 char   ut_user[8];         /* User login name */
                 char   ut_id[4];           /* /etc/inittab id
                                             * (usually line #) */
                 char   ut_line[12];        /* device name (console,
                                               lnxx) */
                 short  ut_pid;             /* process id */
                 short  ut_type;            /* type of entry */
                 struct exit_status {
                    short   e_termination;  /* Process termination
                                               status */
                    short   e_exit;         /* Process exit status */
                 } ut_exit;                 /* The exit status of
                                               a process
                                             * marked as
                                               DEAD_PROCESS */
               time_t     ut_time;          /* time entry was made */
               char     ut_host[16];        /* host name if remote */
          };

          /*  Definitions for ut_type  */
          #define   EMPTY          0
          #define   RUN_LVL        1
          #define   BOOT_TIME      2
          #define   OLD_TIME       3
          #define   NEW_TIME       4
          #define   INIT_PROCESS   5       /* Process spawned
                                                by init */
          #define   LOGIN_PROCESS  6       /* A getty process
                                                waiting for login */
          #define   USER_PROCESS   7       /* A user process */
          #define   DEAD_PROCESS   8
          #define   ACCOUNTING     9
          #define   UTMAXTYPE  ACCOUNTING  /* Largest legal value
                                                of ut_type */



     Page 1                                        (last mod. 1/14/87)

     utmp(4)                                                   utmp(4)



          /* Special strings or formats used in the ut_line */
          /* field when accounting for something other than */
          /* a process.  No string for the ut_line field    */
          */ can be more than 11 chars + a NULL in length.  */

          #define   RUNLVL_MSG     "run-level %c"
          #define   BOOT_MSG  "system boot"
          #define   OTIME_MSG "old time"
          #define   NTIME_MSG "new time"

     FILES
          /usr/include/utmp.h
          /etc/utmp
          /etc/wtmp

     SEE ALSO
          login(1), who(1), write(1), getut(3C).






































     Page 2                                        (last mod. 1/14/87)