3 kas unlock - Unlocks a locked user account
7 kas unlock -name <I<authentication ID>>
8 [B<-admin_username> <I<admin principal to use for authentication>>]
9 [B<-password_for_admin> <I<admin password>>] [-cell <I<cell name>>]
10 [-servers <I<explicit list of authentication servers>>+]
13 kas u -na <I<authentication ID>>
14 [B<-a> <I<admin principal to use for authentication>>]
15 [B<-p> <I<admin password>>] [-c <I<cell name>>]
16 [B<-s> <I<explicit list of authentication servers>>+] [B<-no>] [-h]
20 The kas unlock command unlocks the Authentication Database entry
21 named by the B<-name> argument. An entry becomes locked when
22 the user exceeds the limit on failed authentication attempts, generally by
23 providing the wrong password to either an AFS-modified login utility or the
24 B<klog> command. Use the B<kas setfields> command to
25 set the limit and the lockout time, and the B<kas examine> command to
28 To unlock all locked user accounts at once, shutdown the
29 B<kaserver> process on every database server machine, and remove the
30 B</usr/afs/local/kaauxdb> file from each one. The
31 B<kaserver> process recreates the file as it restarts.
39 Names the Authentication Database entry to unlock.
43 Specifies the user identity under which to authenticate with the
44 Authentication Server for execution of the command. For more details,
45 see the introductory B<kas> reference page.
47 =item -password_for_admin
49 Specifies the password of the command's issuer. If it is
50 omitted (as recommended), the B<kas> command interpreter prompts for
51 it and does not echo it visibly. For more details, see the introductory
52 B<kas> reference page.
56 Names the cell in which to run the command. For more details, see
57 the introductory B<kas> reference page.
61 Names each machine running an Authentication Server with which to
62 establish a connection. For more details, see the introductory
63 B<kas> reference page.
67 Assigns the unprivileged identity anonymous to the
68 issuer. For more details, see the introductory B<kas> reference
73 Prints the online help for this command. All other valid options
80 In the following example, an administrator using the admin
81 account unlocks the entry for B<jones>:
83 % kas unlock -name jones -admin_username admin
84 Administrator's (admin) Password:
86 =head1 PRIVILEGE REQUIRED
88 The issuer must have the C<ADMIN> flag set on his or her
89 Authentication Database entry.
100 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
102 This documentation is covered by the IBM Public License Version 1.0. It was
103 converted from HTML to POD by software written by Chas Williams and Russ
104 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.