ll2_new_context(3) — Linux manual page

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

LL2_NEW_CONTEXT(3)          Programmers Manual         LL2_NEW_CONTEXT(3)

NAME         top

       ll2_new_context - Allocates context which defines the lastlog2
       environment.

SYNOPSIS         top

       #include <lastlog2.h>

       *ll2_context * ll2_new_context(const char *db_path);

DESCRIPTION         top

       Defines lastlog2 context e.g. database file, which will be used
       for any other lastlog2 call. If db_path is NULL, the default path
       defined in LL2_DEFAULT_DATABASE will be taken.

           const   char *db_path = "/var/lib/lastlog/lastlog2.db";
           ll2_context *context = ll2_new_context(db_path);

RETURN VALUE         top

       Returns context which will be used for all other lastlog2 library
       calls. This context should be released with ll2_unref_context when
       it is not needed anymore. Returns NULL on an error.

AUTHORS         top

       Thorsten Kukuk <kukuk@suse.de>

SEE ALSO         top

       lastlog2(3), ll2_unref_context(3), ll2_read_all(3),
       ll2_write_entry(3), ll2_read_entry(3), ll2_remove_entry(3),
       ll2_update_login_time(3), ll2_import_lastlog(3)

REPORTING BUGS         top

       For bug reports, use the issue tracker
       <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
       util-linux@vger.kernel.org. This page was obtained from the
       project's upstream Git repository
       ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
       2026-05-24. (At that time, the date of the most recent commit that
       was found in the repository was 2026-05-20.) 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 man-pages@man7.org

util-linux 2.43.devel-739-eee2e 2026-05-24             LL2_NEW_CONTEXT(3)

Pages that refer to this page: lastlog2(3)ll2_get_journal_mode(3)ll2_import_lastlog(3)ll2_read_all(3)ll2_read_entry(3)ll2_remove_entry(3)ll2_rename_user(3)ll2_set_journal_mode(3)ll2_unref_context(3)ll2_update_login_time(3)ll2_write_entry(3)