ll2_write_entry(3)

ll2_write_entry3

Writes a new entry into the database.

Usage

#include <lastlog2.h>

int ll2_write_entry (struct ll2_context *context, const char *user, int64_t ll_time, const char *tty, const char *rhost, const char *pam_service, char **error);

Overview

Writes a new entry into database, which is defined in context. If context is NULL, the default database, defined in LL2_DEFAULT_DATABASE, will be taken.

time_t login_time = time(0); // Get the system time
char   *error = NULL;
const  char *user = "root";
int ret = ll2_write_entry (NULL, user, login_time, "pts/0",
                            "192.168.122.1", NULL, &error);

pam_service is the service or instance name which has generated the entry (optional).

Return value

Returns 0 on success, -ENOMEM or -1 on other failure. error contains an error string if the return value is -1. error is not guaranteed to contain an error string, could also be NULL. error should be freed by the caller.

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

Authors

Thorsten Kukuk <[email protected]>

Reporting bugs

For bug reports, use the issue tracker <https://github.com/util-linux/util-linux/issues>.

Availability

The liblastlog2 library is part of the util-linux package since version 2.40. It can be downloaded from Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/>.

From util-linux-libs 2.42.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.