src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf238.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="auarf237.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="auarf239.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="HDRUNLOG" HREF="auarf002.htm#ToC_252">unlog</A></H2>
  19 <A NAME="IDX5487"></A>
  20 <A NAME="IDX5488"></A>
  21 <A NAME="IDX5489"></A>
  22 <A NAME="IDX5490"></A>
  23 <A NAME="IDX5491"></A>
  24 <A NAME="IDX5492"></A>
  25 <P><STRONG>Purpose</STRONG>
  26 <P>Discards all of the issuer&#39;s tokens
  27 <P><STRONG>Synopsis</STRONG>
  28 <PRE><B>unlog</B> [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>><SUP>+</SUP>]  [<B>-help</B>]
  29
  30 <B>unlog</B> [<B>-c </B>&lt;<VAR>cell&nbsp;name</VAR>><SUP>+</SUP>]  [<B>-h</B>]
  31 </PRE>
  32 <P><STRONG>Description</STRONG>
  33 <P>The <B>unlog</B> command by default discards all tokens that the issuer
  34 currently holds. To discard tokens for certain cells only, name them
  35 with the <B>-cell</B> argument.
  36 <P>Since a token pertains to one client machine only, destroying tokens on one
  37 machine has no effect on tokens on another machine.
  38 <P><STRONG>Cautions</STRONG>
  39 <P>Specifying one or more cell names can cause a brief authentication outage
  40 during which the issuer has no valid tokens in any cell. This is
  41 because the command actually discards all tokens and then restores the ones
  42 for cells not named by the <B>-cell</B> argument. The outage can
  43 sometimes interrupt the operation of jobs that require authentication.
  44 <P><STRONG>Options</STRONG>
  45 <DL>
  46 <P><DT><B>-cell
  47 </B><DD>Specifies each cell for to discard the token. If this argument is
  48 omitted, the Cache Manager discards all tokens. Provide the fully
  49 qualified domain name, or a shortened form, in which case successful
  50 resolution depends on the availability of a name resolution service (such as
  51 the Domain Name Service or a local host table) at the time the command is
  52 issued.
  53 <P><DT><B>-help
  54 </B><DD>Prints the online help for this command. All other valid options
  55 are ignored.
  56 </DL>
  57 <P><STRONG>Examples</STRONG>
  58 <P>The following command discards all tokens.
  59 <PRE>   % <B>unlog</B>
  60
  61 </PRE>
  62 <P>The following command discards only the tokens for the
  63 <B>abc.com</B> and <B>stateu.edu</B> cells.
  64 <PRE>   % <B>unlog -cell abc.com stateu</B>
  65
  66 </PRE>
  67 <P><STRONG>Privilege Required</STRONG>
  68 <P>None
  69 <P><STRONG>Related Information</STRONG>
  70 <P><A HREF="auarf200.htm#HDRKLOG">klog</A>
  71 <P><A HREF="auarf235.htm#HDRTOKENS">tokens</A>
  72 <P>
  73 <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="auarf237.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="auarf239.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>
  74 <!-- Begin Footer Records  ========================================== -->
  75 <P><HR><B>
  76 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  77 </B>
  78 <!-- End Footer Records  ============================================ -->
  79 <A NAME="Bot_Of_Page"></A>
  80 </BODY></HTML>