1PWSCORE(1)                  General Commands Manual                 PWSCORE(1)
2
3
4

NAME

6       pwscore - simple configurable tool for checking quality of a password
7

SYNOPSIS

9       pwscore [user]
10

DESCRIPTION

12       pwscore is a simple tool for checking quality of a password. The
13       password is read from stdin.
14
15       The tool uses the libpwquality library to perform configurable checks
16       for minimum length, dictionary checking against cracklib dictionaries,
17       and other checks.
18
19       It either reports an error if the password fails any of the checks, or
20       it prints out the password quality score as an integer value between 0
21       and 100.
22
23       The password quality score is relative to the minlen setting in the
24       configuration file. But in general values below 50 can be treated as
25       moderate quality and above it fairly strong quality. Any password that
26       passes the quality checks (especially the mandatory cracklib check)
27       should withstand dictionary attacks and scores above 50 with the
28       default minlen setting even fast brute force attacks.
29

OPTIONS

31       The first and only optional argument is the user name that is used to
32       check the similarity of the password to the username.
33

FILES

35       /etc/security/pwquality.conf - The configuration file for the
36       libpwquality library.
37

RETURN CODES

39       pwscore returns 0 on success, non zero on error.
40

SEE ALSO

42       pwscore(1), pwquality.conf(5), pam_pwquality(8)
43

AUTHORS

45       Tomas Mraz <tmraz@redhat.com>
46
47
48
49Red Hat, Inc.                     2017-02-10                        PWSCORE(1)
Impressum