👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

NetBSD 6.1.5 - man page for updlastlogx (netbsd section 3)

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

NAME
     getlastlogx, getutmp, getutmpx, updlastlogx, updwtmpx, utmpxname -- user accounting database
     functions

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #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);

DESCRIPTION
     The 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 nec-
     essary 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 */
     };
     All the fields should be filled out by the caller.

     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.

RETURN VALUES
     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 respec-
     tively could not be opened or the data not written into it.

SEE ALSO
     endutxent(3), loginx(3), utmpx(5)

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

BSD					 August 26, 2003				      BSD


All times are GMT -4. The time now is 11:37 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password





Not a Forum Member?
Forgot Password?