~mdw / qmail / blame
| 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) |