qmail-pw2u
Section: Maintenance Commands (8)
Index
Return to Main Contents
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)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RULES
-
- OPTIONS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 05:37:11 GMT, April 21, 2005