UTEMPTER(3) Library Functions Manual UTEMPTER(3)

# [NAME](#NAME)

`utempter_add_record`, `utempter_remove_added_record`, `utempter_remove_record`, `utempter_set_helper` — utempter interface

# [SYNOPSIS](#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](#DESCRIPTION)

[`utempter_add_record`](#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`](#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`](#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`](#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](#RETURN_VALUES)

On error, zero is returned. On success, a non-zero value is returned.

# [NOTES](#NOTES)

During execution of the privileged process spawned by these functions, SIGCHLD signal handler will be temporarily set to the default action.

# [SEE ALSO](#SEE_ALSO)

[pututline(3)](/man/os/libutempter/pututline.3), [sigaction(3)](/man/os/libutempter/sigaction.3), [updwtmp(3)](/man/os/libutempter/updwtmp.3).

# [HISTORY](#HISTORY)

These functions appeared in ALT Linux Sisyphus in October 2001.

November 4, 2010 ALT Linux

---

Document: utempter_remove_added_record(3) from libutempter 1.2.3-r11 (Chainguard OS)
Source: https://github.com/altlinux/libutempter