vauthenticate - Authenticate a virtual user

# NAME

vauthenticate - Authenticate a virtual user

# SYNOPSIS

vauthenticate

# DESCRIPTION

vauthenticate 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 ALSO

vmailmgr(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 <bruce@untroubled.org>