table of contents
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/>.
2025-01-13 | util-linux 2.40.4 |