VAUTHENTICATE(1) VMailMgr Tools Documentation VAUTHENTICATE(1)NAMEvauthenticate - Authenticate a virtual user
SYNOPSISvauthenticateDESCRIPTIONvauthenticate reads a domain name, user name, and pass phrase from
standard input, and authenticates the virtual user. If authentication
is successful, it prints out information about the virtual user on
stdout
The domain name, user name, and pass phrase are passed to vauthenticate
on standard input each seperated by a NUL byte.
The output consists of a series of lines containing an identifier, an
equal sign, and the data for that identifier, terminated by a newline.
The identifiers are:
UID The base user's numerical user ID.
GID The base user's numerical group ID.
USER
The base user's name.
HOME
The base user's home directory.
MAILDIR
The virtual user's mailbox directory, relative to "HOME".
VUSER
The virtual user's name.
OPTIONS
None
RETURN VALUE
Returns 0 if authentication succeeds, and non-zero otherwise.
SEE ALSOvmailmgr(7)CAVEATS
Although the output from vauthenticate appears to be suitable for using
as shell input, care must be taken to escape characters that would
cause the shell to misbehave, such as semicolons.
RESTRICTIONS
This program will not authenticate non-virtual users.
AUTHOR
Bruce Guenter <bruceg@em.ca>
vmailmgr 0.97 2016-02-18 VAUTHENTICATE(1)