3 kdb - Displays log or privileged actions performed by the Authentication Server
10 B<kdb> S<<< [B<-dbmfile> <I<dbmfile to use (default /usr/afs/logs/AuthLog)>>] >>>
11 S<<< [B<-key> <I<extract entries that match specified key>>] >>> [B<-help>]
18 The B<kdb> command displays the contents of the F<AuthLog.dir> and
19 F<AuthLog.pag> files associated with the F<AuthLog> file that resides on
20 the local disk, by default in the F</usr/afs/logs> directory. The files
21 must exist in that directory, which normally implies that the
22 Authentication Server is running on the machine. The files contain
23 information on privileged actions performed by the Authentication Server.
27 It is possible that on some operating systems that AFS otherwise supports,
28 the Authentication Server cannot create the F</usr/afs/logs/AuthLog.dir>
29 and F</usr/afs/logs/AuthLog.pag> files, making this command
30 inoperative. See the I<IBM AFS Release Notes> for details.
36 =item B<-dbmfile> <I<dbmfile to use>>
38 Specifies the pathname of the file to display. Provide either a complete
39 pathname, a pathname relative to the F</usr/afs/logs> directory, or a
40 filename only, in which case the file must reside in the F</usr/afs/logs>
41 directory. Omit this argument to display information from the
42 F<AuthLog.dir> and F<AuthLog.pag> files in the F</usr/afs/logs> directory.
44 =item B<-key> <I<extract entries that match specified key>>
46 Specifies each entry to be displayed from the indicated file.
50 Prints the online help for this command. All other valid options are
57 The first line of output indicates the location of the files from which
58 the subsequent information is derived:
60 Printing all entries found in <file_location>
62 Each entry then includes the following two fields, separated by a colon:
68 Identifies the user requesting the corresponding service and the server
69 that performed that service. In cases where no user is directly involved,
70 only the server appears; in cases where no server is directly involved,
71 only the user appears.
75 Identifies one of the following actions or services performed by the user
82 C<auth>: Obtained a ticket-granting ticket.
86 C<chp>: Changed a user password.
90 C<cruser>: Created a user entry in the Authentication Database.
94 C<delu>: Deleted a user entry from the Authentication Database.
98 C<gtck>: Obtained a ticket other than a ticket-granting ticket.
102 C<setf>: Set fields in an Authentication Database entry.
106 C<unlok>: Unlocked an Authentication Database entry.
112 The final line of output sums the number of entries.
116 The following example shows the output of the B<kdb> command in the ABC
117 Corporation cell (C<abc.com>):
120 Printing all entries found in /usr/afs/logs/AuthLog
121 admin,krbtgt.ABC.COM:auth
127 =head1 PRIVILEGE REQUIRED
129 The issuer must be logged in as the local superuser C<root>.
139 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
141 This documentation is covered by the IBM Public License Version 1.0. It was
142 converted from HTML to POD by software written by Chas Williams and Russ
143 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.