NAME
          qmail-pw2u - build address assignments from a passwd file

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

     DESCRIPTION
          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

             user:password:uid:gid:gecos:home:shell

          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
          qmail-pw2u.

          If you put the output of qmail-pw2u into
          QMAILHOME/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.

     RULES
          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 userBREAKanything.  A catch-all user, alias, controls
          all other addresses.

          You may change these rules by setting up files in
          QMAILHOME/users:

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

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

          mailnames
               Replacement names for users.  Each line has the form

                  user:mailname1:mailname2:...

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

               WARNING: The addresses user and userBREAKext 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.

          subusers
               Extra addresses.  Each line has the form

                  sub:user:pre:

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

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

     OPTIONS
          -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
               BREAK.

          -C   Disable the user-extension mechanism.

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

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