valias(1)

NAME

valias - virtual users aliases manipulation tool

SYNTAX

valias [owner] -l
valias [owner] [-f] -a alias [user[,user...]]
valias [owner] [-f] -d alias
valias [owner] [-f] -x alias

DESCRIPTION

The program valias is simlink to the program vpasswd and it's manipulates with alias files for virtual domains. Virtual domains and it's owners (real system users) is listed in file domains.cf placed into "virtual etc" directory. Aliases file format is: fields delimited with ':', first field is alias name, second is user name.

OPTIONS

-a alias [user]
    Add new or change existing alias for user account. 1st parameter is alias name, second parameter is user name (login). If user name is omitted then valias will ask input for user. If needs to use mailing list the 2nd parameter should be comma-delimited list of users.

-d alias
    Remove alias from aliases file.

-f  Force operation (disable confirmation).

-l  Lists aliases.

-x alias
    Temporary disable alias.

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

If valias is runs with root privilegues then all operations is applies for virtual domain owned by system user specified in 1st parameter (befora any option). 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::::

/usr/local/etc/virtual/<domain>/aliases
    Aliases file for the domain <domain>. File format is colon-delimited:
    alias:user

ENVIRONMENT VARIABLES

Enviroment variables isn't used.

EXAMPLES

Add alias <alias1> for user <user1> into virtual domain owned by you:
valias -a alias1 user1

Add alias <list2> for users <user1>, <user2>, <user3> into virtual domain owned by user domain1hostuser:
valias domain1hostuser -a alias1 user1,user2,user3

Disable alias <alias1> of virtual domain owned by you:
valias -x alias1

List aliases of virtual domain owned by you:
valias -l

List aliases of domain owned by www:
su root -c "valias www -l"

AUTHORS

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

SEE ALSO

post(8), vpasswd(1), vpoppasswd(8)