man7.org > Linux > man-pages

Linux/UNIX system programming training

ll2_read_all(3) — Linux manual page

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

LL2_READ_ALL(3)            Programmers Manual            LL2_READ_ALL(3)

NAME         top

       ll2_read_all - Reads all entries from database and calls the
       callback function for each entry.

SYNOPSIS         top

       #include <lastlog2.h> int ll2_read_all (struct ll2_context
       *context, int (*callback)(const char *user, int64_t ll_time,
       const char *tty, const char *rhost, const char *pam_service,
       const char *cb_error), char **error);

DESCRIPTION         top

       Reads all entries from database, defined in context, and calls
       callback function callback for each entry. If context is NULL,
       the default database, defined in LL2_DEFAULT_DATABASE, will be
       taken.

           char  *error = NULL;
           const char *user = "root";

           static int
           callback (const char *res_user, int64_t ll_time, const char *res_tty,
                     const char *res_rhost, const char *res_service, const char *cb_error)
           {
              /* returning != 0 if no further entry has to be handled by the callback */
              return 0;
           }

           int ret = ll2_read_all (NULL, callback, &error);

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. If lastlog2 database does not
       exist at all, the errno ENOENT has been set and can be checked.

AUTHORS         top

       Thorsten Kukuk ([email protected])

SEE ALSO         top

       lastlog2(3), ll2_new_context(3), *ll2_unref_context(3),
       *ll2_write_entry(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-06-13                LL2_READ_ALL(3)

Pages that refer to this page: lastlog2(3)

HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI