| 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) |