NAME
login,
logout,
logwtmp
—
login utility functions
LIBRARY
System Utilities Library (libutil, -lutil)
SYNOPSIS
#include <util.h>
void
login(
struct utmp
*ut);
int
logout(
const char
*line);
void
logwtmp(
const
char *line,
const char
*name,
const char
*host);
DESCRIPTION
The
login(),
logout(), and
logwtmp() functions operate on the database of current users
in
/var/run/utmp and on the logfile
/var/log/wtmp of logins and logouts.
The
login() function updates the
/var/run/utmp and
/var/log/wtmp files with
user information contained in
ut.
The
logout() function removes the entry from
/var/run/utmp corresponding to the device
line.
The
logwtmp() function adds an entry to
/var/log/wtmp. Since
login() will add the
appropriate entry for
/var/log/wtmp during a login,
logwtmp() is usually used for logouts.
RETURN VALUES
logout() returns non-zero if it was able to find and delete an
entry for
line, and zero if there is no entry for
line in
/var/run/utmp.
FILES
- /dev/∗
-
- /etc/ttys
-
- /var/run/utmp
-
- /var/log/wtmp
-
SEE ALSO
utmp(5)