GETLASTLOGX(3) | Library Functions Manual | GETLASTLOGX(3) |
getlastlogx
, getutmp
,
getutmpx
, updlastlogx
,
updwtmpx
, utmpxname
—
#include <utmpx.h>
struct lastlogx *
getlastlogx
(const
char *fname, uid_t
uid, struct lastlogx
*ll);
void
getutmp
(const
struct utmpx *ux, struct
utmp *u);
void
getutmpx
(const
struct utmp *u, struct
utmpx *ux);
int
updlastlogx
(const
char *fname, uid_t
uid, struct lastlogx
*ll);
int
updwtmpx
(const
char *file, const struct
utmpx *utx);
int
utmpxname
(const
char *fname);
getlastlogx
() function looks up the entry for the
user with user id uid in the
lastlogx(5) file given by
fname and returns it in ll. If the
provided ll is NULL
, the
necessary space will be allocated by getlastlogx
() and
should be free
()d by the caller.
The getutmp
() function fills out the
entries in the struct utmp u with the data provided in
the struct utmpx ux.
getutmpx
() does the opposite, filling out the
entries in the struct utmpx ux with the data provided
in the struct utmp u, and initializing all the unknown
fields to 0. The sole exception is the ut_type field,
which will be initialized to USER_PROCESS
.
The updlastlogx
() function tries to update
the information for the user with the user id uid in
the lastlogx(5) file given
by fname with the data supplied in
ll. A struct lastlogx is defined
like this:
struct lastlogx { struct timeval ll_tv; /* time entry was created */ char ll_line[_UTX_LINESIZE]; /* tty name */ char ll_host[_UTX_HOSTSIZE]; /* host name */ struct sockaddr_storage ll_ss; /* address where entry was made from */ };
The updwtmpx
() function updates the
wtmpx(5) file
file with the
utmpx(5) entry
utx.
The utmpxname
() function sets the default
utmpx(5) database file name to
fname.
getlastlogx
() returns the found entry on success, or
NULL
if it could not open the database, could not find
an entry matching uid in there, or could not allocate
the necessary space (in case ll was
NULL
).
utmpxname
() returns 1 on success, or 0 if
the supplied file name was too long or did not end with
‘x’.
updlastlogx
() and
updwtmpx
() return 0 on success, or -1 in case the
database or file respectively could not be opened or the data not written
into it.
getutmp
(),
getutmpx
(), updwtmpx
(), and
utmpxname
() first appeared in Solaris.
getlastlogx
and updlastlogx
first appeared in NetBSD 2.0.
August 26, 2003 | NetBSD 9.0 |