| 1 |
=pod |
| 2 |
|
| 3 |
=head1 NAME |
| 4 |
|
| 5 |
pwscore - simple configurable tool for checking quality of a password |
| 6 |
|
| 7 |
=head1 SYNOPSIS |
| 8 |
|
| 9 |
B<pwscore> [I<user>] |
| 10 |
|
| 11 |
=head1 DESCRIPTION |
| 12 |
|
| 13 |
B<pwscore> is a simple tool for checking quality of a password. The password |
| 14 |
is read from stdin. |
| 15 |
|
| 16 |
The tool uses the B<libpwquality> library to perform configurable checks |
| 17 |
for minimum length, dictionary checking against cracklib dictionaries, |
| 18 |
and other checks. |
| 19 |
|
| 20 |
It either reports an error if the password fails any of the checks, or it |
| 21 |
prints out the password quality score as an integer value between I<0> and |
| 22 |
I<100>. |
| 23 |
|
| 24 |
The password quality score is relative to the B<minlen> setting in the |
| 25 |
configuration file. But in general values below 50 can be treated as moderate |
| 26 |
quality and above it fairly strong quality. Any password that passes the quality |
| 27 |
checks (especially the mandatory cracklib check) should withstand dictionary |
| 28 |
attacks and scores above 50 with the default minlen setting even fast brute |
| 29 |
force attacks. |
| 30 |
|
| 31 |
=head1 OPTIONS |
| 32 |
|
| 33 |
The first and only optional argument is the user name that is used to check |
| 34 |
the similarity of the password to the username. |
| 35 |
|
| 36 |
=head1 FILES |
| 37 |
|
| 38 |
F</etc/security/pwquality.conf> - The configuration file for the libpwquality |
| 39 |
library. |
| 40 |
|
| 41 |
=head1 RETURN CODES |
| 42 |
|
| 43 |
B<pwscore> returns 0 on success, non zero on error. |
| 44 |
|
| 45 |
=head1 SEE ALSO |
| 46 |
|
| 47 |
L<pwscore(1)>, L<pwquality.conf(5)>, L<pam_pwquality(8)> |
| 48 |
|
| 49 |
=head1 AUTHORS |
| 50 |
|
| 51 |
Tomas Mraz <[email protected]> |