qmail-pw2u - build address assignments from a passwd file
] [ -cchar ]
reads a V7-format passwd file from standard input and prints a
-format assignment file.
A V7-format passwd file is a series of lines. Each line has the format
is an account name, uid
are the user id
and group id of that account, and home
is the account's home directory.
, and shell
are ignored by
If you put the output of qmail-pw2u
and then run qmail-newu
will obey the assignments
printed by qmail-pw2u
After changing any users, uids,
gids, or home directories in your passwd file, you must run qmail-pw2u
again if you want qmail-lspawn
to see the
By default, qmail-pw2u
follows the same rules as qmail-getpw
if (1) uid
is zero, (2) home
does not exist,
does not own home
, or (4) user
uppercase letters. It then gives each remaining user
control over the
address and all addresses of the form
user-anything. A catch-all user,
, controls all other addresses.
You may change these rules by setting up files in /var/qmail/users
- Allowed users, one per line. If include exists, and user is
not listed in include, user is ignored.
- Ignored users, one per line. If exclude exists, and user is
listed in exclude, user is ignored.
- Replacement names for users. Each line has the form
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
- Extra addresses. Each line has the form
sub will be handled by home/.qmail-pre,
where home is user's home directory;
sub-ext will be handled by
- Extra assignments, printed at the end of qmail-pw2u's output.
- (Default.) Skip user if home does not exist (or is not
visible to qmail-pw2u). Skip user if home is not
owned by user.
- 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.
- Do not check the existence or ownership of home.
- (Default.) Skip user if there are any uppercase letters in
- Allow uppercase letters in user.
- Use char as the user-extension delimiter in place of -.
- Disable the user-extension mechanism.
- Use home/.qmail-/... instead of
qmail-users(5), qmail-lspawn(8), qmail-newu(8), qmail-getpw(8)