LL2_NEW_CONTEXT(3)            Programmers Manual            LL2_NEW_CONTEXT(3)

NAME
       ll2_new_context - Allocates context which defines the lastlog2
       environment.

SYNOPSIS
       #include <lastlog2.h>

       *ll2_context * ll2_new_context(const char *db_path);

DESCRIPTION
       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
       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
       Thorsten Kukuk <kukuk@suse.de>

SEE ALSO
       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
       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/>.

util-linux 2.42                   2026-04-01                LL2_NEW_CONTEXT(3)