UTEMPTER
Section: C Library Functions (3)
Page Index
BSD mandoc
ALT Linux
NAME
utempter_add_record
utempter_remove_added_record
utempter_remove_record
utempter_set_helper
- utempter interface
SYNOPSIS
In utempter.h
Ft int
Fn utempter_add_record int fd const char *host
Ft int
Fn utempter_remove_added_record void
Ft int
Fn utempter_remove_record int fd
Ft void
Fn utempter_set_helper const char *pathname
DESCRIPTION
Fn utempter_add_record
function adds a login record to the database for the TTY belonging to
the pseudo-terminal master file descriptor
Fa fd ,
using the username corresponding with the real user ID of the calling
process and the optional hostname
Fa host .
This function spawns a privileged process to perform the actual logging.
Fn utempter_remove_record
function marks the login session as being closed for the TTY belonging
to the pseudo-terminal master file descriptor
Fa fd .
This function spawns a privileged process to perform the actual logging.
Fn 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.
Fn 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.