Provided by: qmail_1.06-4_i386 bug

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  /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.

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

       You may change these rules by setting up files in /var/lib/qmail/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 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.

       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; sub-ext 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 -.

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

                                                                 qmail-pw2u(8)