AT&T UNIX™PC Unix System V Users Manual - tenox

GETUT ( 3C ) GETUT ( 3C )
NAME
getutent, getutid, getutline, pututline, setutent, endutent, utmpname
- access utmp file entry
SYNOPSIS
#include
struct utmp •getutent ( )
struct utmp *getutid (id)
struct utmp •id;
struct utmp •getutline (line)
struct utmp •line;
void pututline ( utmp)
struct utmp •utmp;
void setutent ( )
void endutent ( )
void utmpname (file)
char •file;
DESCRIPTION
Getutent, getutid and getutline each return a pointer to a structure
of the following type:
struct utmp {
char
char
char
short
short
};
struct
short
short
} ut_exit;
time_t
ut_user[8j;
ut_id[4j;
ut_line[12j;
ut_pid;
ut_type;
exit_stat us {
e_termination;
e_exit;
ut_time;
I* User login name *I
I* letclinittab id (usually line #) *I
I* device name (console, lnxx) *I
I* process id *I
I* type of entry •I
I* Process termination status *I
I* Process exit status *I
I* The exit status of a process
* marked as DEAD _.PROCESS. • I
I* time entry was made •I
Getutent reads in the next entry from a utmp-Jike file. If the file
is not already open, it opens it. If it reaches the end of the file, it
fails.
Getutid searches forward from the current point in the utmp file
until it finds an entry with a ut_type matching id- > ut_type if
the type specified is RUN_LVL, BOOT_TIME, OLD_TIME or
NEW_TIME. If the type specified in id is INIT_PROCESS,
LOGIN_PROCESS, USER_PROCESS or DEAD_PROCESS, then getutid
will return a pointer to the first entry whose type is one of
these four and whose ut_id field matches id- > ut_id . If the end
of file is reached without a match, it fails.
Getutline searches forward from the current point in the utmp file
until it finds an entry of the type LOGIN_PROCESS or
USERJ>ROCESS which also has a ut_line string matching the
- 1 -