checkqpasswd(8)

NAME
checkqpasswd - password checking against /usr/pkg/etc/qpasswd

SYNOPSIS
checkqpasswd subprogram [args]

DESCRIPTION
Use this utility to check user,pass,greet against the qpasswd database.

RETURN VALUES
0    password was okay
1    password failure
2    misuse
111    temporary failure

PROCESS-STATE CHANGES
If checkqpasswd runs with root privileges, the following changes are made:

1.	check for a valid password or exit with 2

2.	SETgid + SETuid, if sth. here fails, exit with 111

3.	chdir to the virtual home directory

4.	set up serveral environment variables

Without root privileges, step two is left out!

ENVIRONMENT

$SASL
        - is used for setting the type of authentication
        - valid method are: plain, apop, cram-md5, cram-sha1, cram-ripemd or digest-md5
        - the case is ignored

$HOME
    becomes homedirectory of the authenticated user

$USER
    becomes the name of the authenticated user

$SHELL
    becomes the users homeshell of the authenticated user

$UID
    becomes the numerical value of the user id (uid) of the authenticated user

$GID
    becomes the numerical value of the group id (gid) of the authenticated user

$DIGEST_RESPONSE
    is used by digest-md5 authentication

FILES

$HOME/.qpasswd
    has one password per line, all the passwords of this file will be tried

$HOME/.lastpop
    if enabled in params.h when compiling, every home/vhome gets a .lastpop file each line @ this file contains: 'timestamp,ip:port'
    xxx: lastpop isn't finished yet!

/etc/passwd
    user account information of the system (used for switching privileges)

/etc/shadow

/usr/pkg/etc/qpasswd
    qmail virtual homes and user id database

SEE ALSO
checkqpasswd(8), checkpasswd(8), cmd5checkpw(8), qpasswd(5)

VERSION
This documentation describes checkqpasswd version 0.5 of the qpasswd tools.

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