ll2_get_journal_mode(3) — Linux manual page

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

LL2_GET_JOURNAL_MODE(3)     Programmers Manual    LL2_GET_JOURNAL_MODE(3)

NAME         top

       ll2_get_journal_mode - get current SQLite journal mode for
       lastlog2 database

SYNOPSIS         top

       #include <lastlog2.h>

       int ll2_get_journal_mode(struct ll2_context *context, char mode,
       char error);

DESCRIPTION         top

       The ll2_get_journal_mode() function retrieves the current SQLite
       journal mode for the lastlog2 database associated with context.

       If context is NULL, the default database, defined in
       LL2_DEFAULT_DATABASE, will be taken.

       The returned journal mode string is in uppercase (e.g., "WAL",
       "DELETE") for consistency with user input.

       Common journal modes include:

       •   WAL - Write-Ahead Logging mode

       •   DELETE - Default mode

       •   TRUNCATE - Truncate mode

       •   PERSIST - Persist mode

       •   MEMORY - Memory mode

       •   OFF - Journaling disabled

           struct ll2_context *ctx;
           char *mode = NULL;
           char *error = NULL;

           ctx = ll2_new_context(NULL);
           if (!ctx) {
               fprintf(stderr, "Failed to create context\n");
               return 1;
           }

           if (ll2_get_journal_mode(ctx, &mode, &error) != 0) {
               fprintf(stderr, "Failed to get journal mode: %s\n", error);
               free(error);
               ll2_unref_context(ctx);
               return 1;
           }

           printf("Current journal mode: %s\n", mode);
           free(mode);
           ll2_unref_context(ctx);

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 successful, mode will be set to
       a newly allocated string containing the current journal mode. The
       caller must free this string.

AUTHORS         top

       Thorsten Kukuk <kukuk@suse.de>, WanBingjiang
       <wanbingjiang@webray.com.cn>

SEE ALSO         top

       lastlog2(3), ll2_set_journal_mode(3), ll2_new_context(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.43. 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_GET_JOURNAL_MODE(3)

Pages that refer to this page: ll2_set_journal_mode(3)