checkpasswd(8)

NAME
checkpasswd - password checking against systemusers

SYNOPSIS
checkpasswd subprogram [args]

DESCRIPTION
Use this utility to check user,pass,greet against the systemwide user/password database.

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

PROCESS-STATE CHANGES
If checkpasswd 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

$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

FILES

/etc/passwd
    user account information of the system

/etc/shadow
    encrypted passwords and age information

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

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

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