OVERVIEW

       The  file /var/qmail/users/assign assigns addresses to users. For exam-
       ple,

	  =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/qmail/users/assign will have no effect until qmail-newu is run.

STRUCTURE

       /var/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 assign-
       ment, and a simple assignment overrides any wildcard  assignment.   For
       example:

	  +:alias:7790:2108:QMAIL/var/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)