ll2_rename_user(3) — Linux manual page

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/>. 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
       2024-06-14. (At that time, the date of the most recent commit
       that was found in the repository was 2024-06-10.) 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.41.devel-537-e... 2024-01-28             LL2_RENAME_USER(3)

Pages that refer to this page: lastlog2(3), ll2_import_lastlog(3), ll2_read_all(3), ll2_read_entry(3), ll2_remove_entry(3), ll2_update_login_time(3), ll2_write_entry(3)

---