vpasswd(1)

NAME

vpasswd - virtual users password manipulation tool

SYNTAX

vpasswd [owner] -l
vpasswd [owner] [-f] -a user [passwd]
vpasswd [owner] [-f] -d user
vpasswd [owner] [-f] -x user

DESCRIPTION

The program vpasswd manipulates with password files for virtual domains. Virtual domains and it's owners (real system users) is listed in file domains.cf placed into "virtual etc" directory. Password file is passwd-like: fields delimited with ':', first field is user name, second is password.

OPTIONS

-a user [password]
    Add new user account into password database. 1st parameter is user name (login), second parameter is password. If password is omitted then vpasswd will ask input for password.

-d user
    Remove virtual account from passwords file.

-f  Force operation (disable confirmation).

-l  Lists virtual users.

-x user
    Disable virtual account. To enable you may use option -a

Option -f may be used with any other option. Another options can't be used simultaneously.

If vpasswd is runs with root privilegues then all operations is applies for virtual domain owned by system user specified in 1st parameter. Otherwize used virtual domain owned by current user (effective UID).

FILES

/usr/local/etc/virtual
Directory with config files and domains subdiretories.

/usr/local/etc/virtual/domains.cf
    Domains definitions file, one domain in one line. Format of domain record:
    owner:domain
    where
    owner - real system user, owner of the virtual domain files
    domain - virtual domain name

/usr/local/etc/virtual/<domain>/passwd
    Passwords file for the domain <domain>. Password file format is passwd-like:
    user:password::::

ENVIRONMENT VARIABLES

Enviroment variables isn't used.

EXAMPLES

Add user <user1> with password <password1> into virtual domain owned by you:
vpasswd -a user1 password1

Disable user <user1> of virtual domain owned by you:
vpasswd -x user1

List users of virtual domain owned by you:
vpasswd -l

List users of domain owned by www:
su root -c "vpasswd www -l"

AUTHORS

David L. Parsons <orc@pell.chi.il.us>

SEE ALSO

post(8), valias(1), vpoppasswd(8)