NAME |SYNOPSIS |DESCRIPTION |RETURN VALUE |AUTHORS |SEE ALSO |REPORTING BUGS |AVAILABILITY | |
LL2_RENAME_USER(3) Programmers ManualLL2_RENAME_USER(3)ll2_rename_user - Renames a user entry.
#include <lastlog2.h>int ll2_rename_user (struct ll2_context *context, const char*user, const char *newname, char **error);
Changes user name fromuser tonewname of one entry in database, which is defined bycontext. All other entries with the useruser will be deleted. Ifcontext is NULL, the default database, defined inLL2_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);
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.
Thorsten Kukuk (kukuk@suse.de)
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)
For bug reports, use the issue tracker <https://github.com/util-linux/util-linux/issues>.
Theliblastlog2library 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 theutil-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 2025-08-11. (At that time, the date of the most recent commit that was found in the repository was 2025-08-05.) 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 isnot part of the original manual page), send a mail to man-pages@man7.orgutil-linux 2.42-start-521-ec46 2025-01-16LL2_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)
HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH. | ![]() |