Man pages sections > man5 > qmail-users

qmail-users - assign mail addresses to users

qmail-users(5) File Formats Manual qmail-users(5)

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)
Debian Sid