LL2_RENAME_USER(3)            Programmers Manual            LL2_RENAME_USER(3)

NAME
       ll2_rename_user - Renames an user entry.

SYNOPSIS
       #include <lastlog2.h>

       int ll2_rename_user (struct ll2_context *context, const char *user,
       const char *newname, char **error);

DESCRIPTION
       Changing user name from user to newname of one entry in database, which
       is defined by context. All other entries with the user user will be
       deleted.  If context is NULL, the default database, defined in
       LL2_DEFAULT_DATABASE, will be taken.

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

           int ret = ll2_rename_user (NULL, user, new_user, &error);

RETURN VALUE
       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
       Thorsten Kukuk ( <kukuk@suse.de>)

SEE ALSO
       lastlog2(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
       For bug reports, use the issue tracker at
       <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.40.1                 2024-05-06                LL2_RENAME_USER(3)