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.

HISTORY

These functions appeared in ALT Linux Sisyphus in October 2001.