table of contents
UTEMPTER(3) | Library Functions Manual | UTEMPTER(3) |
NAME¶
utempter_add_record
,
utempter_remove_added_record
,
utempter_remove_record
,
utempter_set_helper
—
SYNOPSIS¶
#include <utempter.h>
int
utempter_add_record
(int
fd, const char
*host);
int
utempter_remove_added_record
(void);
int
utempter_remove_record
(int
fd);
void
utempter_set_helper
(const
char *pathname);
DESCRIPTION¶
utempter_add_record
() function adds a login record to
the database for the TTY belonging to the pseudo-terminal master file
descriptor fd, using the username corresponding with the
real user ID of the calling process and the optional hostname
host. This function spawns a privileged process to
perform the actual logging.
utempter_remove_record
() function marks
the login session as being closed for the TTY belonging to the
pseudo-terminal master file descriptor fd. This
function spawns a privileged process to perform the actual logging.
utempter_remove_added_record
() function
has the same properties as the previously mentioned function, except that it
uses an internally cached value of the file descriptor passed to the login
functions.
utempter_set_helper
() function changes
default helper path to the specified value. The pointer passed to this
function must remain valid all the time while utempter interface is in
use.
RETURN VALUES¶
On error, zero is returned. On success, a non-zero value is returned.NOTES¶
During execution of the privileged process spawned by these functions, SIGCHLD signal handler will be temporarily set to the default action.SEE ALSO¶
pututline(3), sigaction(3), updwtmp(3).HISTORY¶
These functions appeared in ALT Linux Sisyphus in October 2001.November 4, 2010 | ALT Linux |