logwtmpx(3) [netbsd man page]

LOGINX(3)						   BSD Library Functions Manual 						 LOGINX(3)

NAME

     loginx, logoutx, logwtmpx -- login utility functions

LIBRARY

     System Utilities Library (libutil, -lutil)

SYNOPSIS

     #include <util.h>

     void
     loginx(const struct utmpx *ut);

     int
     logoutx(const char *line, int status, int type);

     void
     logwtmpx(const char *line, const char *name, const char *host, int status, int type);

DESCRIPTION

     The loginx(), logoutx(), and logwtmpx() operate on the utmpx(5) database of currently logged in users, and the wtmpx(5) database of logins
     and logouts.

     The loginx() function updates the /var/run/utmpx and /var/log/wtmpx databases with the information from ut.

     logoutx() updates the entry corresponding to line with the type and status from type and status.

     logwtmpx() writes an entry filled with data from line, name, host, status, and type to the wtmpx(5) database.

RETURN VALUES

     logoutx() returns 1 on success, and 0 if no corresponding entry was found.

SEE ALSO

     endutxent(3), utmpx(5)

BSD
								September 26, 2002							       BSD

UTMPX(5)						      BSD File Formats Manual							  UTMPX(5)

NAME

     utmpx, wtmpx, lastlogx -- user accounting database

SYNOPSIS

     #include <utmpx.h>

DESCRIPTION

     In contrast to utmp and wtmp, the extended databases in utmpx and wtmpx reserve more space for logging hostnames, and also information on a
     process' ID, termination signal and exit status.

     The <utmpx.h> header defines the structures and functions for logging user.  Currently logged in users are tracked in /var/run/utmpx, a list
     of all logins and logouts, as well as all shutdowns, reboots and date changes, is kept in /var/log/wtmpx, and the last login of each user is
     noted in /var/log/lastlogx.

     The interface to the utmpx file is described in getutxent(3).

     The wtmpx file can grow rapidly on busy systems, and is normally rotated with newsyslog(8).

     In the event of a date change, a shutdown, or a reboot, the following items are logged in the wtmpx file:
	   date        The system time has been manually or automatically updated by date(1).  The command name date is recorded in the field
		       ut_name.  In the field ut_line, the character '|' indicates the time prior to the change, and the character '{' indicates
		       the new time.
	   reboot
	   shutdown    A system reboot or shutdown has been initiated.	The character '~' is placed in the field ut_line, and reboot or shutdown
		       in the field ut_name (see shutdown(8) and reboot(8)), using logwtmpx(3).

FILES

     /var/run/utmpx	The utmpx file.
     /var/log/wtmpx	The wtmpx file.
     /var/log/lastlogx	The lastlogx file.

SEE ALSO

     last(1), login(1), rwho(1), w(1), who(1), endutxent(3), logwtmpx(3), utmp(5), ac(8), init(8), newsyslog(8), reboot(8)

BSD
								 January 31, 2007							       BSD