NAME

       pwscore - simple configurable tool for checking quality of a password

SYNOPSIS

       pwscore [user]

DESCRIPTION

       pwscore  is  a  simple  tool for checking quality of a password. The password is read from
       stdin.

       The tool uses the libpwquality library to perform configurable checks for minimum  length,
       dictionary checking against cracklib dictionaries, and other checks.

       It  either  reports an error if the password fails any of the checks, or it prints out the
       password quality score as an integer value between 0 and 100.

       The password quality score is relative to the minlen setting in  the  configuration  file.
       But  in  general  values  below  50 can be treated as moderate quality and above it fairly
       strong quality. Any password that passes the  quality  checks  (especially  the  mandatory
       cracklib  check)  should withstand dictionary attacks and scores above 50 with the default
       minlen setting even fast brute force attacks.

OPTIONS

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

FILES

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

RETURN CODES

       pwscore returns 0 on success, non zero on error.

SEE ALSO

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

AUTHORS

       Tomas Mraz <tmraz@redhat.com>