bionic (8) qmail-pw2u.8.gz

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)