man pages section 3: Library Interfaces and Headers

utmpx.h(3HEAD)

Name | Synopsis | Description | Attributes | See Also

Name

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:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Standard