Skip to content

vrenameuser.1

Manvendra Bhangui edited this page Feb 25, 2024 · 4 revisions

NAME

vrenameuser - change email address of a virtual user to a new email address

SYNOPSYS

vrenameuser [options] old_email_address new_email_address

DESCRIPTION

vrenameuser changes the email address of an existing virtual domain user to a new email address. This can be used to either change the username or to move the user to a new virtual domain lying on the same host. vrenameuser changes only the pw_name and pw_domain component, and doesn't change attributes like pw_gecos, pw_dir, etc. But can be used in conjunction with vmoveuserdir(1), vmoduser it can be used to change the homedir, gecos also. vrenameuser has setuid bit set and can be run by the root user, by user having uid/gid of the domain in /etc/indimail/users/assign or if the user has the gid of the domain as a supplementary group. If the uid of domain in old_email_address is different from the domain in new_email_address in /etc/indimail/users/assign, vrenameuser will run with root privileges. If the uid of both the domains is same, then vrenamedomain runs with the uid of the caller. .SH POST HANDLE If the environment variable POST_HANDLE is set, vrenameuser executes the program defined by the POST_HANDLE environment variable. If POST_HANDLE is not defined, the program @libdexecdir@/vrenameuser will be executed. Additionally if the uid of domain in old_email_address is different from the domain in new_email_address in /etc/indimail/users/assign, the POST_HANDLE program root privileges will be dropped and the program will run with the original uid of the caller. If POST_HANDLE is not defined and if the uid of domain in old_email_address is different from the domain in new_email_address in /etc/indimail/users/assign, POST_HANDLE program will run with root privileges. If the uids are same, then the POST_HANDLE program will run with the original uid of the caller. The POST_HANDLE program is executed with old_email_address and new_email_address as command line arguments. POST_HANDLE program is executed as the last step after all earlier steps have been successful.

OPTIONS

-V
Print Version Numbers

-v
Set verbose mode

old_email_address
Current email address of the user.

new_email_address
Desired new email address for the user.

RETURN VALUE

0 if successful, 1 in case of any failure.

SEE ALSO

vmoveuserdir(1)

Clone this wiki locally