getutmpx man page on MacOSX

Man page or keyword search:  
man Server   23457 pages
apropos Keyword Search (all sections)
Output format
MacOSX logo
[printable version]

GETLASTLOGX(3)		 BSD Library Functions Manual		GETLASTLOGX(3)

NAME
     getlastlogx, getlastlogxbyname, getutmp, getutmpx, utmpxname — user
     accounting database functions

SYNOPSIS
     #include <utmpx.h>

     struct lastlogx *
     getlastlogx(uid_t uid, struct lastlogx *ll);

     struct lastlogx *
     getlastlogxbyname(const char *name, struct lastlogx *ll);

     void
     getutmp(const struct utmpx *ux, struct utmp *u);

     void
     getutmpx(const struct utmp *u, struct utmpx *ux);

     int
     utmpxname(const char *fname);

DESCRIPTION
     The getlastlogx() function looks up the entry for the user with user id
     uid 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 getlastlogxbyname() function is similar to getlastlogx(),
     except the user name is passed.

     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.

     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 */
     };

     The utmpxname() function sets the default utmpx(5) database file name to
     fname.

RETURN VALUES
     getlastlogx() and getlastlogxbyname() return the found entry on success,
     or NULL if it could not open the database, could not find an entry match‐
     ing uid or name, 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’.

SEE ALSO
     endutxent(3), utmpx(5)

HISTORY
     The functions getutmp(), getutmpx(), and utmpxname() first appeared in
     Solaris.  getlastlogx first appeared in NetBSD 2.0.

BSD				 Dec 26, 2005				   BSD
[top]

List of man pages available for MacOSX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net