Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

utmpx(3HEAD)

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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
Standard

See Also

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