UTMPX.H(3HEAD) Headers UTMPX.H(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 | Standard |
+--------------------+-----------------+

SEE ALSO

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

April 16, 2007 UTMPX.H(3HEAD)