3 kpwvalid - Checks quality of new password
17 The B<kpwvalid> command checks the quality of a new password passed to it
18 from the B<kpasswd> or B<kas setpassword> command. It is optional. If it
19 exists, it must reside in the same AFS directory as the binaries for the
20 B<kpasswd> and B<kas> command suites (create a symbolic link from the
21 client machine's local disk to this directory). The directory's ACL must
22 extend the C<a> (administer) and C<w> (write) permissions to the
23 system:administrators group only. These requirements prevent unauthorized
24 users from substituting a spurious B<kpwvalid> binary.
26 The AFS distribution includes an example B<kpwvalid> program that checks
27 that the password is at least eight characters long; the code for it
28 appears in L<EXAMPLES> below.
30 The script or program must accept a sequence of password strings, one per
31 line, on the standard input stream. The first is the current password and
32 is ignored. Each subsequent string is a candidate password to be
33 checked. The program must write the following to the standard output
40 C<0> (zero) and a newline character to indicate that the password is
45 A non-zero decimal number and a newline character to indicate that the
46 password is not acceptable.
50 Further, it must write any error messages only to the standard error
51 stream, not to the standard output stream.
55 The following example program, included in the AFS distribution, verifies
56 that the requested password includes eight or more characters.
59 /* prints 0 if the password is long enough, otherwise non-zero */
62 char oldpassword[512];
65 if (fgets(oldpassword, 512, stdin))
66 while (fgets(password, 512, stdin)) {
67 if (strlen(password) > 8) { /* password includes a newline */
72 fputs("Passwords must contain at least 8 characters.\n",
83 L<kas_setpassword(8)>,
88 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
90 This documentation is covered by the IBM Public License Version 1.0. It was
91 converted from HTML to POD by software written by Chas Williams and Russ
92 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.