Commit | Line | Data |
---|---|---|
2117e02e MW |
1 | .TH qmail-users 5 |
2 | .SH NAME | |
3 | qmail-users \- assign mail addresses to users | |
4 | .SH OVERVIEW | |
5 | The file | |
6 | .B QMAILHOME/users/assign | |
7 | assigns addresses to users. For example, | |
8 | ||
9 | .EX | |
10 | =joe.shmoe:joe:503:78:/home/joe::: | |
11 | .EE | |
12 | ||
13 | says that mail for | |
14 | .B joe.shmoe | |
15 | should be delivered to user | |
16 | .BR joe , | |
17 | with uid 503 and gid 78, | |
18 | as specified by | |
19 | .BR /home/joe/.qmail . | |
20 | ||
21 | Assignments fed to | |
22 | .B qmail-newu | |
23 | will be used by | |
24 | .B qmail-lspawn | |
25 | to control | |
26 | .BR qmail-local 's | |
27 | deliveries. | |
28 | See | |
29 | .BR qmail-newu (8). | |
30 | A change to | |
31 | .B QMAILHOME/users/assign | |
32 | will have no effect until | |
33 | .B qmail-newu | |
34 | is run. | |
35 | .SH STRUCTURE | |
36 | .B QMAILHOME/users/assign | |
37 | is a series of assignments, one per line. | |
38 | It ends with a line containing a single dot. | |
39 | Lines must not contain NUL. | |
40 | .SH "SIMPLE ASSIGNMENTS" | |
41 | A simple assignment is a line of the form | |
42 | ||
43 | .EX | |
44 | =local:user:uid:gid:homedir:dash:ext: | |
45 | .EE | |
46 | ||
47 | Here | |
48 | .I local | |
49 | is an address; | |
50 | .IR user , | |
51 | .IR uid , | |
52 | and | |
53 | .I gid | |
54 | are the account name, uid, and gid | |
55 | of the user in charge of | |
56 | .IR local ; | |
57 | and messages to | |
58 | .I local | |
59 | will be controlled by | |
60 | .IR homedir\fB/.qmail\fIdashext . | |
61 | ||
62 | If there are several assignments for the same | |
63 | .I local | |
64 | address, | |
65 | .B qmail-lspawn | |
66 | will use the first one. | |
67 | ||
68 | .I local | |
69 | is interpreted without regard to case. | |
70 | .SH "WILDCARD ASSIGNMENTS" | |
71 | A wildcard assignment is a line of the form | |
72 | ||
73 | .EX | |
74 | +loc:user:uid:gid:homedir:dash:pre: | |
75 | .EE | |
76 | ||
77 | This assignment applies to any address beginning with | |
78 | .IR loc , | |
79 | including | |
80 | .I loc | |
81 | itself. | |
82 | It means the same as | |
83 | ||
84 | .EX | |
85 | =locext:user:uid:gid:homedir:dash:preext: | |
86 | .EE | |
87 | ||
88 | for every string | |
89 | .IR ext . | |
90 | ||
91 | A more specific wildcard assignment overrides a less specific | |
92 | assignment, and a simple assignment overrides any wildcard assignment. | |
93 | For example: | |
94 | ||
95 | .EX | |
96 | +:alias:7790:2108:QMAILHOME/alias:-:: | |
97 | +joe-:joe:507:100:/home/joe:-:: | |
98 | =joe:joe:507:100:/home/joe::: | |
99 | .EE | |
100 | ||
101 | The address | |
102 | .B joe | |
103 | is handled by the third line; | |
104 | the address | |
105 | .B joe-direct | |
106 | is handled by the second line; | |
107 | the address | |
108 | .B bill | |
109 | is handled by the first line. | |
110 | .SH "SEE ALSO" | |
111 | qmail-pw2u(8), | |
112 | qmail-newu(8), | |
113 | qmail-lspawn(8) |