qmail-pw2user  -  build  address assignments from a passwd
       file

SYNOPSIS

       qmail-pw2user [ -ohHuUbBC ] [ -cchar ]

DESCRIPTION

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

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

RULES

       By default, qmail-pw2user 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, (4) user contains
       uppercase letters, or (5) user contains - characters.   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/qmail/users:

       include
              A list of allowed users, one per line.  If  include
              exists,  and user is not listed in include, user is
              ignored.

       exclude
              A list of 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

              The addresses mailname1 and mailname1-ext and mail-
              name2 and so on will be  delivered  to  user.   The
              addresses  user  and user-ext will not be delivered
              to user unless user is listed as one of  the  mail-
              names.

              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.

OPTIONS

       -o     (Default.)  Skip user if home does not exist.  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.

       -B     (Default.)  Skip user if it contains -.

       -b     Allow - in user.

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

       -C     Disable the user-extension mechanism.

SEE ALSO

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