Debian Codegraph @

doc/man/pwscore.1.pod

raw
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]>