CHECKPASSWD(3)

NAME
checkpasswd - check password
setcheckpasswd - set parameters for checkpasswd

SYNOPSIS
int checkpasswd(uid, password);
int uid;
char *password;

void setcheckpasswd(opt1, opt2, ... optn, 0);
char *opt1, *opt2, ... *optn;

DESCRIPTION
Checkpasswd checks if password is suitable for use by the UNIX user with user id uid.

Checkpasswd returns 1 if the password is deemed suitable, and 0 otherwise. An informative message is also printed to the standard output if the password does not pass the tests.

Setcheckpasswd may be used to change the operation parameters of checkpasswd. It accepts a list of strings which may be the following:

-c  Take the next argument as the configuration file to read. See the CONFIGURATION section in checkpasswd(8) for information on the configuration file.

-e  Return the detailed check status instead of 1 or 0. See below for an explanation.

-s  Suppress message output.

The detailed check status is one of the following:
-1	Password check did not complete.
0	Password passed all checks.
1	Password was a null string.
2	Password was 'too easy' to guess.
3	Password was part of the users 'finger' information.
4	Password was found in a dictionary search.
5	Password contained an illegal character or sequence of characters.
6	Password was too short.

SEE ALSO
makedict(8), viewdict(8), checkpasswd(8), npasswd(1)

AUTHOR
Clyde Hoover
Computation Center
The University of Texas at Austin
Austin, Texas
clyde@emx.utexas.edu, uunet!cs.utexas.edu!ut-emx!clyde