src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf180.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
   8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58: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="auarf179.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="auarf181.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="HDRKADB_CHECK" HREF="auarf002.htm#ToC_194">kadb_check</A></H2>
  19 <A NAME="IDX5054"></A>
  20 <A NAME="IDX5055"></A>
  21 <A NAME="IDX5056"></A>
  22 <P><STRONG>Purpose</STRONG>
  23 <P>Checks the integrity of the Authentication Database
  24 <P><STRONG>Synopsis</STRONG>
  25 <PRE><B>kadb_check -database</B> &lt;<VAR>kadb_file</VAR>>  [<B>-uheader</B>]  [<B>-kheader</B>]  [<B>-entries</B>]
  26            [<B>-verbose</B>]  [<B>-rebuild</B> &lt;<VAR>out_file</VAR>>]  [<B>-help</B>]
  27
  28 <B>kadb_check -d</B> &lt;<VAR>kadb_file</VAR>>  [<B>-u</B>]  [<B>-k</B>]  [<B>-e</B>]  [<B>-v</B>]  [<B>-r</B> &lt;<VAR>out_file</VAR>>]  [<B>-h</B>]
  29 </PRE>
  30 <P><STRONG>Description</STRONG>
  31 <P>The <B>kadb_check</B> command checks the integrity of the Protection
  32 Database, reporting any errors or corruption it finds. If there are
  33 problems, do not issue any <B>kas</B> commands until the database is
  34 repaired.
  35 <P><STRONG>Cautions</STRONG>
  36 <P>The results can be unpredictable if the Authentication Server makes changes
  37 to the Authentication Database while this command is running. Use the
  38 <B>bos shutdown</B> command to shutdown the local <B>kaserver</B>
  39 process before running this command, or before creating a second copy of the
  40 <B>kaserver.DB0</B> file (with a different name) on which to run
  41 the command.
  42 <P><STRONG>Options</STRONG>
  43 <DL>
  44 <P><DT><B>-database
  45 </B><DD>Names the Authentication Database (copy of the
  46 <B>kaserver.DB0</B> file) to check. If the current working
  47 directory is not the location of the file, provide a pathname, either full or
  48 relative to the current working directory.
  49 <P><DT><B>-uheader
  50 </B><DD>Displays information which Ubik maintains in the database&#39;s
  51 header.
  52 <P><DT><B>-kheader
  53 </B><DD>Displays information which the Authentication Server maintains in the
  54 database&#39;s header.
  55 <P><DT><B>-entries
  56 </B><DD>Outputs every entry in the database, providing information similar to that
  57 returned by the <B>kas examine</B> command.
  58 <P><DT><B>-verbose
  59 </B><DD>Reports additional information about the database, including the number of
  60 free (allocated but unused) entries in the database.
  61 <P><DT><B>-rebuild
  62 </B><DD>Names the file in which to record a list of <B>kas</B> commands which,
  63 if issued in the command shell, recreate the current state of the database
  64 being verified. Partial pathnames are interpreted relative to the
  65 current working directory.
  66 <P><DT><B>-help
  67 </B><DD>Prints the online help for this command. All other valid options
  68 are ignored.
  69 </DL>
  70 <P><STRONG>Output</STRONG>
  71 <P>If there are errors in the database, the output always reports them on the
  72 standard error stream. If any options other than <B>-database</B>
  73 or <B>-help</B> are provided, the output written to the standard output
  74 stream includes additional information as described for each option in the
  75 preceding <B>Options</B> section of this reference page. The output
  76 is intended for debugging purposes and is meaningful to someone familiar with
  77 the internal structure of the Authentication Database.
  78 <P><STRONG>Privilege Required</STRONG>
  79 <P>The issuer must be logged in as the local superuser <B>root</B>.
  80 <P><STRONG>Related Information</STRONG>
  81 <P><A HREF="auarf045.htm#HDRKASERVERDB">kaserver.DB0 and kaserver.DBSYS1</A>
  82 <P><A HREF="auarf118.htm#HDRBOS_SHUTDOWN">bos shutdown</A>
  83 <P><A HREF="auarf185.htm#HDRKAS_EXAMINE">kas examine</A>
  84 <P><A HREF="auarf198.htm#HDRKASERVER">kaserver</A>
  85 <P>
  86 <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="auarf179.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="auarf181.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>
  87 <!-- Begin Footer Records  ========================================== -->
  88 <P><HR><B>
  89 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  90 </B>
  91 <!-- End Footer Records  ============================================ -->
  92 <A NAME="Bot_Of_Page"></A>
  93 </BODY></HTML>