qpasswd(5)

NAME
qpasswd - qmail password file

DESCRIPTION
The qpasswd is a text file, that contains sections with lists of usernames:homedir pairs.

OVERVIEW
[/path/of/section1:uid:gid:optional-timestamp]
user1:realative-path-to-home1
user2:/absolute/path/to/home2
user3:home3/is/relative
user4:home4
[/path/of/section2:uid:gid:optional-timestamp]
user1@2:home1
user2@2:home2
user3@2:home3
user4@2:home4

RULES
1.    comments begin with '#'
2.    empty lines are ignored
3.    the homedir has to have a .qpasswd file
4.    the .qpasswd file:
    - has to exist!
    - each new line defines a password
    - is needed for SASL/APOP authentication
    - can't have comments
    - should't have empty lines

SAMPLE FILE
[/some/path/to/put/in/here:112:109]
user1:home1
# if checkqpasswd reads 'user1' as username, it would try:
# -> read /usr/pkg/etc/qpasswd, search the user 'user1'
# -> read $VHOME/.qpasswd @ /some/path/to/put/in/here/home1/.qpasswd
# -> switch to group with gid=109 (if getuid = root)
# -> switch to user with uid=112 (if getuid = root)
# -> setting up serveral environment vaiables: UID,GID,HOME,USER,SHELL
# -> chdir to /some/path/to/put/in/here/home1
# -> exit with 0, if that all was okay
[/some/other/path:22:2222]
user1@foo.bar:home1
user2@foo.bar:/home1
user3@foo.bar:/home2
user4@foo.bar:/home3
[/some/path/to/put/xx/here:3:3]
user1@3.com:home1
user2@3.com:/home
[/some/ccccc/path:4:44]
user1@lala.de:homeXY
user2@lala.de:/home

FILES
/usr/pkg/etc/qpasswd:

SECURITY

/usr/pkg/etc/qpasswd:
    I use a 660 permission for this file:
    -rw-rw---- root.admins

checkpassword programs:
    I use a 4510 permission for multicheckpw(8), checkpasswd(8) and checkqpasswd(8).
    -r-s--x--- root.nofiles

SEE ALSO
passwd(5), shadow(5)

VERSION
This documentation describes the version 0.5 of the qpasswd fileformat.

AUTHOR
Tino Reichardt <milky-qpasswd@mcmilk.de>