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

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



				       8		  s/qmail:(qmail-pw2u)