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