.TH qmail-users 5.SH NAMEqmail-users \- assign mail addresses to users.SH OVERVIEWThe file.B QMAILHOME/users/assignassigns addresses to users. For example,.EX   =joe.shmoe:joe:503:78:/home/joe:::.EEsays that mail for.B joe.shmoeshould be delivered to user.BR joe ,with uid 503 and gid 78,as specified by.BR /home/joe/.qmail .Assignments fed to.B qmail-newuwill be used by.B qmail-lspawnto control.BR qmail-local 'sdeliveries.See.BR qmail-newu (8).A change to.B QMAILHOME/users/assignwill have no effect until.B qmail-newuis run..SH STRUCTURE.B QMAILHOME/users/assignis a series of assignments, one per line.It ends with a line containing a single dot.Lines must not contain NUL..SH "SIMPLE ASSIGNMENTS"A simple assignment is a line of the form.EX   =local:user:uid:gid:homedir:dash:ext:.EEHere.I localis an address;.IR user ,.IR uid ,and.I gidare the account name, uid, and gidof the user in charge of.IR local ;and messages to.I localwill be controlled by.IR homedir\fB/.qmail\fIdashext .If there are several assignments for the same.I localaddress,.B qmail-lspawnwill use the first one..I localis interpreted without regard to case..SH "WILDCARD ASSIGNMENTS"A wildcard assignment is a line of the form.EX   +loc:user:uid:gid:homedir:dash:pre:.EEThis assignment applies to any address beginning with.IR loc ,including.I locitself.It means the same as.EX   =locext:user:uid:gid:homedir:dash:preext:.EEfor every string.IR ext .A more specific wildcard assignment overrides a less specificassignment, and a simple assignment overrides any wildcard assignment.For example:.EX   +:alias:7790:2108:QMAILHOME/alias:-::   +joe-:joe:507:100:/home/joe:-::   =joe:joe:507:100:/home/joe:::.EEThe address.B joeis handled by the third line;the address.B joe-directis handled by the second line;the address.B billis handled by the first line..SH "SEE ALSO"qmail-pw2u(8),qmail-newu(8),qmail-lspawn(8)