File: qmail-users.9

package info (click to toggle)
qmail 1.01-5
  • links: PTS
  • area: non-free
  • in suites: hamm
  • size: 2,188 kB
  • ctags: 1,711
  • sloc: ansic: 13,993; makefile: 1,914; perl: 448; sh: 377
file content (113 lines) | stat: -rw-r--r-- 1,998 bytes parent folder | download | duplicates (11)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
.TH qmail-users 5
.SH NAME
qmail-users \- assign mail addresses to users
.SH OVERVIEW
The file
.B QMAILHOME/users/assign
assigns addresses to users. For example,

.EX
   =joe.shmoe:joe:503:78:/home/joe:::
.EE

says that mail for
.B joe.shmoe
should be delivered to user
.BR joe ,
with uid 503 and gid 78,
as specified by
.BR /home/joe/.qmail .

Assignments fed to
.B qmail-newu
will be used by
.B qmail-lspawn
to control
.BR qmail-local 's
deliveries.
See
.BR qmail-newu (8).
A change to
.B QMAILHOME/users/assign
will have no effect until
.B qmail-newu
is run.
.SH STRUCTURE
.B QMAILHOME/users/assign
is a series of assignments, one per line.
It ends with a line containing a single dot.
Lines must not contain NUL.
.SH "SIMPLE ASSIGNMENTS"
A simple assignment is a line of the form

.EX
   =local:user:uid:gid:homedir:dash:ext:
.EE

Here
.I local
is an address;
.IR user ,
.IR uid ,
and
.I gid
are the account name, uid, and gid
of the user in charge of
.IR local ;
and messages to
.I local
will be controlled by
.IR homedir\fB/.qmail\fIdashext .

If there are several assignments for the same
.I local
address,
.B qmail-lspawn
will use the first one.

.I local
is interpreted without regard to case.
.SH "WILDCARD ASSIGNMENTS"
A wildcard assignment is a line of the form

.EX
   +loc:user:uid:gid:homedir:dash:pre:
.EE

This assignment applies to any address beginning with
.IR loc ,
including
.I loc
itself.
It means the same as

.EX
   =locext:user:uid:gid:homedir:dash:preext:
.EE

for every string
.IR ext .

A more specific wildcard assignment overrides a less specific
assignment, and a simple assignment overrides any wildcard assignment.
For example:

.EX
   +:alias:7790:2108:QMAILHOME/alias:-::
   +joe-:joe:507:100:/home/joe:-::
   =joe:joe:507:100:/home/joe:::
.EE

The address
.B joe
is handled by the third line;
the address
.B joe-direct
is handled by the second line;
the address
.B bill
is handled by the first line.
.SH "SEE ALSO"
qmail-pw2u(8),
qmail-newu(8),
qmail-lspawn(8)