Provided by: qmail_1.06-6.1_amd64 bug


       qmail-pw2u - build address assignments from a passwd file


       qmail-pw2u [ -/ohHuUC ] [ -cchar ]


       qmail-pw2u  reads  a  V7-format  passwd file from standard input and prints a qmail-users-
       format assignment file.

       A V7-format passwd file is a series of lines.  Each line has the format


       where user is an account name, uid and gid are the user id and group id of  that  account,
       and  home  is  the  account's  home  directory.  password, gecos, and shell are ignored by

       If you put the output of qmail-pw2u into /var/lib/qmail/users/assign, and then run  qmail-
       newu,  qmail-lspawn  will  obey  the  assignments  printed  by qmail-pw2u.  WARNING: After
       changing any users, uids, gids, or home directories in your  passwd  file,  you  must  run
       qmail-pw2u and qmail-newu again if you want qmail-lspawn to see the changes.


       By default, qmail-pw2u follows the same rules as qmail-getpw.  It skips user if (1) uid is
       zero, (2) home does not exist, (3) user does not own home, or (4) user contains  uppercase
       letters.   It  then  gives each remaining user control over the basic user address and all
       addresses of the  form  user-anything.   A  catch-all  user,  alias,  controls  all  other

       You may change these rules by setting up files in /var/lib/qmail/users:

              Allowed users, one per line.  If include exists, and user is not listed in include,
              user is ignored.

              Ignored users, one per line.  If exclude exists, and user  is  listed  in  exclude,
              user is ignored.

              Replacement names for users.  Each line has the form


              The addresses mailname1 and mailname1-ext and mailname2 and so on will be delivered
              to user.

              WARNING: The addresses user and user-ext will not be delivered to user unless  user
              is listed as one of the mailnames.

              A line in mailnames is silently ignored if the user does not exist.

              Extra addresses.  Each line has the form


              sub  will  be handled by home/.qmail-pre, where home is user's home directory; sub-
              ext will be handled by home/.qmail-pre-ext.

       append Extra assignments, printed at the end of qmail-pw2u's output.


       -o     (Default.)  Skip user if home does not exist (or is  not  visible  to  qmail-pw2u).
              Skip user if home is not owned by user.

       -h     Stop if home does not exist.  This is appropriate if every user is supposed to have
              a home directory.  Skip user if home is not owned by user.

       -H     Do not check the existence or ownership of home.

       -U     (Default.)  Skip user if there are any uppercase letters in user.

       -u     Allow uppercase letters in user.

       -cchar Use char as the user-extension delimiter in place of -.

       -C     Disable the user-extension mechanism.

       -/     Use home/.qmail-/...  instead of home/.qmail-...


       qmail-users(5), qmail-lspawn(8), qmail-newu(8), qmail-getpw(8)