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

この例で、joe.shmoe 宛のメールは、 /home/joe/.qmail に指定された方法で、 uid が 503、gid が 78 で、 ユーザー joe に配送されることを指定します。

assign ファイルは qmail-newu (8)で処理された後、qmail-lspawn (8) により使われ、 qmail-local (8)のローカル配送を制御します。 qmail-newu (8)に与えられる役割は、 qmail-local (8)の配送を制御するために、 qmail-lspawn (8)によって使用されます。 qmail-newu (8) が実行されるまで、 /var/qmail/users/assign ファイルの変更は効果がありません。

• 一連の指定(assignments)を、1行に1つずつ記述します。
• このファイルは、1つのドット(.)だけの行で終わります。
• 行には、NUL を含めてはいけません。

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

• local は、アドレスです。
• user、uid、gid などは、 local を担当するユーザーの、アカウント名、ユーザーID、グループID です。
• local へのメッセージは、homedir/.qmaildashext により制御されます。

同じローカル･アドレスに対して幾つかの指定がある場合、 qmail-lspawn (8) は、 最初の1つを使用します。

local では、大文字と小文字が区別されません。

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

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

より明確なワイルドカード指定は、 より不明確な指定より優先します。 また、単純な指定は、 どんなワイルドカード指定よりも優先します。

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

• アドレス joe は、3番目の行で処理されます。
• アドレス joe-direct は、2番目の行で処理されます。
• アドレス bill は、最初の行で処理されます。