NAME

       ll2_rename_user - Renames a user entry.

SYNOPSIS

       #include <lastlog2.h>

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

DESCRIPTION

       Changes 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 <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.41                                    2025-02-26                                 LL2_RENAME_USER(3)