tail head cat sleep
QR code linking to this page
Main index Section 3
Go to:
Options

Manual Pages  — UTEMPTER_ADD_RECORD

NAME

utempter_add_record, utempter_remove_added_record, utempter_remove_record, addToUtmp, removeFromUtmp, removeLineFromUtmp – utempter compatibility interface

CONTENTS

LIBRARY

User Login Record Library (libulog, -lulog)

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
addToUtmp(const char *pty, const char *host, int fd);

void
removeFromUtmp(void);

void
removeLineFromUtmp(const char *pty, int fd);

DESCRIPTION

The utempter_add_record() and addToUtmp() functions add 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. These functions are equivalent to ulog_login_pseudo(3).

The utempter_remove_record() and removeLineFromUtmp() functions mark the login session as being closed for the TTY belonging to the pseudo-terminal master file descriptor fd. These functions are equivalent to ulog_logout_pseudo(3).

The utempter_remove_added_record() and removeFromUtmp() functions have the same properties as the previously mentioned functions, except that they use an internally cached value of the file descriptor passed to the login functions.

The pty arguments of addToUtmp() and removeLineFromUtmp() are unused.

RETURN VALUES

In this implementation, the utempter_add_record(), utempter_remove_added_record() and utempter_remove_record() always return a value of 0.

SEE ALSO

pututxline(3), ulog_login_pseudo(3)

HISTORY

These functions appeared in FreeBSD 9.0 .
UTEMPTER_ADD_RECORD (3) December 6, 2009
tail head cat sleep
QR code linking to this page
Main index Section 3
Go to:
Options

Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

“ "I liken starting one's computing career with Unix, say as an undergraduate, to being born in East Africa. It is intolerably hot, your body is covered with lice and flies, you are malnourished and you suffer from numerous curable diseases. But, as far as young East Africans can tell, this is simply the natural condition and they live within it. By the time they find out differently, it is too late. They already think that the writing of shell scripts is a natural act." ”
— Ken Pier, Xerox PARC