doc/html/AdminReference/auarf199.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf198.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf200.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRKDB" HREF="auarf002.htm#ToC_213">kdb</A></H2>
  19 <A NAME="IDX5173"></A>
  20 <A NAME="IDX5174"></A>
  21 <A NAME="IDX5175"></A>
  22 <P><STRONG>Purpose</STRONG>
  23 <P>Displays log or privileged actions performed by the Authentication Server
  24 <P><STRONG>Synopsis</STRONG>
  25 <PRE><B>kdb</B> [<B>-dbmfile</B> &lt;<VAR>dbmfile&nbsp;to&nbsp;use&nbsp;(default&nbsp;/usr/afs/logs/AuthLog)</VAR>>]
  26     [<B>-key</B> &lt;<VAR>extract&nbsp;entries&nbsp;that&nbsp;match&nbsp;specified&nbsp;key</VAR>>]  [<B>-help</B>]
  27
  28 </PRE>
  29 <P><STRONG>Description</STRONG>
  30 <P>The <B>kdb</B> command displays the contents of the
  31 <B>AuthLog.dir</B> and <B>AuthLog.pag</B> files
  32 associated with the <B>AuthLog</B> file that resides on the local disk, by
  33 default in the <B>/usr/afs/logs</B> directory. The files must exist
  34 in that directory, which normally implies that the Authentication Server is
  35 running on the machine. The files contain information on privileged
  36 actions performed by the Authentication Server.
  37 <P><STRONG>Cautions</STRONG>
  38 <P>It is possible that on some operating systems that AFS otherwise supports,
  39 the Authentication Server cannot create the
  40 <B>/usr/afs/logs/AuthLog.dir</B> and
  41 <B>/usr/afs/logs/AuthLog.pag</B> files, making this command
  42 inoperative. See the <I>IBM AFS Release Notes</I> for
  43 details.
  44 <P><STRONG>Options</STRONG>
  45 <DL>
  46 <P><DT><B>-dbmfile
  47 </B><DD>Specifies the pathname of the file to display. Provide either a
  48 complete pathname, a pathname relative to the <B>/usr/afs/logs</B>
  49 directory, or a filename only, in which case the file must reside in the
  50 <B>/usr/afs/logs</B> directory. Omit this argument to display
  51 information from the <B>AuthLog.dir</B> and
  52 <B>AuthLog.pag</B> files in the <B>/usr/afs/logs</B>
  53 directory.
  54 <P><DT><B>-key
  55 </B><DD>Specifies each entry to be displayed from the indicated file.
  56 <P><DT><B>-help
  57 </B><DD>Prints the online help for this command. All other valid options
  58 are ignored.
  59 </DL>
  60 <P><STRONG>Output</STRONG>
  61 <P>The first line of output indicates the location of the files from which the
  62 subsequent information is derived:
  63 <PRE>   Printing all entries found in <VAR>file_location</VAR>
  64 </PRE>
  65 <P>Each entry then includes the following two fields, separated by a
  66 colon:
  67 <DL>
  68 <P><DT><B><TT>user/server</TT>
  69 </B><DD>Identifies the user requesting the corresponding service and the server
  70 that performed that service. In cases where no user is directly
  71 involved, only the server appears; in cases where no server is directly
  72 involved, only the user appears.
  73 <P><DT><B><TT>service</TT>
  74 </B><DD>Identifies one of the following actions or services performed by the user
  75 or server process.
  76 <UL>
  77 <P><LI><TT>auth</TT>: Obtained a ticket-granting ticket
  78 <P><LI><TT>chp</TT>: Changed a user password
  79 <P><LI><TT>cruser</TT>: Created a user entry in the Authentication
  80 Database
  81 <P><LI><TT>delu</TT>: Deleted a user entry from the Authentication
  82 Database
  83 <P><LI><TT>gtck</TT>: Obtained a ticket other than a ticket-granting
  84 ticket
  85 <P><LI><TT>setf</TT>: Set fields in an Authentication Database entry
  86 <P><LI><TT>unlok</TT>: Unlocked an Authentication Database entry
  87 </UL>
  88 </DL>
  89 <P>The final line of output sums the number of entries.
  90 <P><STRONG>Examples</STRONG>
  91 <P>The following example shows the output of the <B>kdb</B> command in the
  92 ABC Corporation cell (<B>abc.com</B>):
  93 <PRE>   % <B>kdb</B>
  94    Printing all entries found in /usr/afs/logs/AuthLog
  95    admin,krbtgt.ABC.COM:auth
  96    admin,afs:gtck
  97    admin:cruser
  98    admin:delu
  99    4 entries were found
 100
 101 </PRE>
 102 <P><STRONG>Privilege Required</STRONG>
 103 <P>The issuer must be logged in as the local superuser <B>root</B>.
 104 <P><STRONG>Related Information</STRONG>
 105 <P><A HREF="auarf013.htm#HDRWQ5">AuthLog.dir, AuthLog.pag</A>
 106 <P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
 107 <P><A HREF="auarf198.htm#HDRKASERVER">kaserver</A>
 108 <P>
 109 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf198.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf200.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 110 <!-- Begin Footer Records  ========================================== -->
 111 <P><HR><B>
 112 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 113 </B>
 114 <!-- End Footer Records  ============================================ -->
 115 <A NAME="Bot_Of_Page"></A>
 116 </BODY></HTML>