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)