NAME
qmail-pw2u - build address assignments from a passwd file
SYNOPSIS
qmail-pw2u [ -/ohHuUC ] [ -cchar ]
DESCRIPTION
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.
RULES
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.
OPTIONS
-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.
-/ Use home/.qmail-/... instead of home/.qmail-...
SEE ALSO
qmail-users(5), qmail-lspawn(8), qmail-newu(8),
qmail-getpw(8)
Man(1) output converted with
man2html