NAME

       qmail-users - assign mail addresses to users

OVERVIEW

       The file /var/lib/qmail/users/assign assigns addresses to users. For example,

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

       says  that mail for joe.shmoe should be delivered to user joe, with uid 503 and gid 78, as
       specified by /home/joe/.qmail.

       Assignments fed to qmail-newu will  be  used  by  qmail-lspawn  to  control  qmail-local's
       deliveries.   See  qmail-newu(8).   A  change  to /var/lib/qmail/users/assign will have no
       effect until qmail-newu is run.

STRUCTURE

       /var/lib/qmail/users/assign is a series of assignments, one per line.  It ends with a line
       containing a single dot.  Lines must not contain NUL.

SIMPLE ASSIGNMENTS

       A simple assignment is a line of the form

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

       Here  local  is  an  address; user, uid, and gid are the account name, uid, and gid of the
       user  in  charge   of   local;   and   messages   to   local   will   be   controlled   by
       homedir/.qmaildashext.

       If  there  are  several  assignments for the same local address, qmail-lspawn will use the
       first one.

       local is interpreted without regard to case.

WILDCARD ASSIGNMENTS

       A wildcard assignment is a line of the form

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

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

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

       for every string ext.

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

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

       The address joe is handled by the third line; the address joe-direct  is  handled  by  the
       second line; the address bill is handled by the first line.

SEE ALSO

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

                                                                                   qmail-users(5)