ll2_write_entry(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | AUTHORS | SEE ALSO | REPORTING BUGS | AVAILABILITY

LL2_WRITE_ENTRY(3)         Programmers Manual         LL2_WRITE_ENTRY(3)

NAME         top

       ll2_write_entry - Write a new entry into the database.

SYNOPSIS         top

       #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);

DESCRIPTION         top

       Writes an 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         top

       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.

AUTHORS         top

       Thorsten Kukuk ([email protected])

SEE ALSO         top

       lastlog2(3), ll2_new_context(3), *ll2_unref_context(3),
       *ll2_read_all(3), ll2_read_entry(3), ll2_update_login_time(3),
       ll2_remove_entry(3), ll2_rename_user(3), ll2_import_lastlog(3)

REPORTING BUGS         top

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

AVAILABILITY         top

       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/>. This page
       is part of the util-linux (a random collection of Linux
       utilities) project. Information about the project can be found at
       ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have
       a bug report for this manual page, send it to
       [email protected]. This page was obtained from the
       project's upstream Git repository
       ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
       2024-06-14. (At that time, the date of the most recent commit
       that was found in the repository was 2024-06-10.) If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in
       this COLOPHON (which is not part of the original manual page),
       send a mail to [email protected]

util-linux 2.41.devel-537-e... 2024-01-28             LL2_WRITE_ENTRY(3)

Pages that refer to this page: ll2_import_lastlog(3)ll2_read_entry(3)ll2_remove_entry(3)ll2_rename_user(3)ll2_update_login_time(3)