Table of Contents
qmail-pw2u - build address assignments from a passwd file
qmail-pw2u [ -ohHuUC ] [ -cchar ]
qmail-pw2u reads a V7-format
passwd file from standard input and prints a qmail-users-format assignment
file.
A V7-format passwd file is a series of lines. Each line has the format
user:password:uid:gid:gecos:home:shell
where user is an account
name, uid and gid are the user id and group id of that account, and home
is the account's home directory. password, gecos, and shell are ignored
by qmail-pw2u.
If you put the output of qmail-pw2u into /var/qmail/users/assign,
and then run qmail-newu, qmail-lspawn will obey the assignments printed
by qmail-pw2u. WARNING: After changing any users, uids, gids, or home directories
in your passwd file, you must run qmail-pw2u and qmail-newu again if you
want qmail-lspawn to see the changes.
By default, qmail-pw2u follows
the same rules as qmail-getpw. It skips user if (1)
uid is zero, (2) home
does not exist, (3) user does not own home, or (4)
user contains uppercase
letters. It then gives each remaining user control over the basic user
address and all addresses of the form user-anything. A catch-all user, alias,
controls all other addresses.
You may change these rules by setting up
files in /var/qmail/users:
- include
- Allowed users, one per line. If include
exists, and user is not listed in include, user is ignored.
- exclude
- Ignored
users, one per line. If exclude exists, and user is listed in exclude,
user is ignored.
- mailnames
- Replacement names for users. Each line has the
form
user:mailname1:mailname2:...
The addresses mailname1 and mailname1-ext
and mailname2 and so on will be delivered to user.
WARNING: The addresses
user and user-ext will not be delivered to user unless user is listed as
one of the mailnames.
A line in mailnames is silently ignored if the user
does not exist.
- subusers
- Extra addresses. Each line has the form
sub:user:pre:
sub will be handled by home/.qmail-pre, where home is user's home directory;
sub-ext will be handled by home/.qmail-pre-ext.
- append
Extra assignments,
printed at the end of qmail-pw2u's output.
- -o
- (Default.) Skip user
if home does not exist (or is not visible to qmail-pw2u). Skip user if home
is not owned by user.
- -h
- Stop if home does not exist. This is appropriate
if every user is supposed to have a home directory. Skip user if home is
not owned by user.
- -H
- Do not check the existence or ownership of home.
- -U
- (Default.) Skip user if there are any uppercase letters in user.
- -u
- Allow
uppercase letters in user.
- -cchar
- Use char as the user-extension delimiter
in place of -.
- -C
- Disable the user-extension mechanism.
qmail-users(5)
,
qmail-lspawn(8)
, qmail-newu(8)
, qmail-getpw(8)
Table of Contents