qmail-users(5)                                                  qmail-users(5)



NNAAMMEE
       qmail-users - assign mail addresses to users

OOVVEERRVVIIEEWW
       The  file //vvaarr//qqmmaaiill//uusseerrss//aassssiiggnn assigns addresses to users. For exam-
       ple,

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

       says that mail for jjooee..sshhmmooee should be delivered to user jjooee, with  uid
       503 and gid 78, as specified by //hhoommee//jjooee//..qqmmaaiill.

       Assignments  fed  to qqmmaaiill--nneewwuu will be used by qqmmaaiill--llssppaawwnn to control
       qqmmaaiill--llooccaall’s   deliveries.    See   qqmmaaiill--nneewwuu(8).    A   change    to
       //vvaarr//qqmmaaiill//uusseerrss//aassssiiggnn will have no effect until qqmmaaiill--nneewwuu is run.

SSTTRRUUCCTTUURREE
       //vvaarr//qqmmaaiill//uusseerrss//aassssiiggnn  is  a series of assignments, one per line.  It
       ends with a line containing a single dot.  Lines must not contain  NUL.

SSIIMMPPLLEE AASSSSIIGGNNMMEENNTTSS
       A simple assignment is a line of the form

          =local:user:uid:gid:homedir:dash:ext:

       Here _l_o_c_a_l is an address; _u_s_e_r, _u_i_d, and _g_i_d are the account name, uid,
       and gid of the user in charge of _l_o_c_a_l; and messages to _l_o_c_a_l  will  be
       controlled by _h_o_m_e_d_i_r//..qqmmaaiill_d_a_s_h_e_x_t.

       If  there  are  several  assignments for the same _l_o_c_a_l address, qqmmaaiill--
       llssppaawwnn will use the first one.

       _l_o_c_a_l is interpreted without regard to case.

WWIILLDDCCAARRDD AASSSSIIGGNNMMEENNTTSS
       A wildcard assignment is a line of the form

          +loc:user:uid:gid:homedir:dash:pre:

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

          =locext:user:uid:gid:homedir:dash:preext:

       for every string _e_x_t.

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

          +:alias:7790:2108:/var/qmail/alias:-::
          +joe-:joe:507:100:/home/joe:-::
          =joe:joe:507:100:/home/joe:::

       The address jjooee is handled by the third line; the address jjooee--ddiirreecctt is
       handled by the second line; the address bbiillll is handled  by  the  first
       line.

SSEEEE AALLSSOO
       qmail-pw2u(8), qmail-newu(8), qmail-lspawn(8)



                                                                qmail-users(5)