utmpx.h

, utmpx

- user accounting database definitions

Synopsis

#include <utmpx.h>

Description

The <utmpx.h> header defines the utmpx structure, which includes the following members:

char                  ut_user[];  /* user login name */
char                  ut_id[];    /* unspecified initialization */
                                  /* process identifier */
char                  ut_line[];  /* device name */
pid_t                 ut_pid;     /* process ID */
short                 ut_type;    /* type of entry */

for X/Open compilation environments:

struct ut_exit_status ut_exit; /* process termination/exit status*/

for all other compilation environments:

struct exit_status    ut_exit;    /* process termination/exit status*/

struct timeval        ut_tv;      /* time entry was made */
int                   ut_session; /* session ID, used for windowing */
short                 ut_syslen;  /* significant length of ut_host */
                                  /* including terminating null */
char                  ut_host[];  /* remote host name */

The pid_t type is defined through typedef as described in <sys/types.h>.

The timeval structure is defined as described in <sys/time.h>.

Inclusion of the <utmpx.h> header can also make visible all symbols from <sys/time.h>.

The following symbolic constants are defined as possible values for the ut_type member of the utmpx structure:

EMPTY

No valid user accounting information.

BOOT_TIME

Identifies time of system boot.

OLD_TIME

Identifies time when system clock changed.

NEW_TIME

Identifies time after system clock changed.

USER_PROCESS

Identifies a process.

INIT_PROCESS

Identifies a process spawned by the init process.

LOGIN_PROCESS

Identifies the session leader of a logged-in user.

DEAD_PROCESS

Identifies a session leader who has exited.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

endutxent(3C), time.h(3HEAD), types.h(3HEAD), attributes(5), standards(5)