openafs/doc/html/AdminReference/auarf238.htm
Derrick Brashear d7da1acc31 initial-html-documentation-20010606
pull in all documentation from IBM
2001-06-06 19:09:07 +00:00

81 lines
4.2 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
<HTML><HEAD>
<TITLE>Administration Reference</TITLE>
<!-- Begin Header Records ========================================== -->
<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
</HEAD><BODY>
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
<BODY bgcolor="ffffff">
<!-- End Header Records ============================================ -->
<A NAME="Top_Of_Page"></A>
<H1>Administration Reference</H1>
<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>
<P>
<H2><A NAME="HDRUNLOG" HREF="auarf002.htm#ToC_252">unlog</A></H2>
<A NAME="IDX5487"></A>
<A NAME="IDX5488"></A>
<A NAME="IDX5489"></A>
<A NAME="IDX5490"></A>
<A NAME="IDX5491"></A>
<A NAME="IDX5492"></A>
<P><STRONG>Purpose</STRONG>
<P>Discards all of the issuer's tokens
<P><STRONG>Synopsis</STRONG>
<PRE><B>unlog</B> [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>><SUP>+</SUP>] [<B>-help</B>]
<B>unlog</B> [<B>-c </B>&lt;<VAR>cell&nbsp;name</VAR>><SUP>+</SUP>] [<B>-h</B>]
</PRE>
<P><STRONG>Description</STRONG>
<P>The <B>unlog</B> command by default discards all tokens that the issuer
currently holds. To discard tokens for certain cells only, name them
with the <B>-cell</B> argument.
<P>Since a token pertains to one client machine only, destroying tokens on one
machine has no effect on tokens on another machine.
<P><STRONG>Cautions</STRONG>
<P>Specifying one or more cell names can cause a brief authentication outage
during which the issuer has no valid tokens in any cell. This is
because the command actually discards all tokens and then restores the ones
for cells not named by the <B>-cell</B> argument. The outage can
sometimes interrupt the operation of jobs that require authentication.
<P><STRONG>Options</STRONG>
<DL>
<P><DT><B>-cell
</B><DD>Specifies each cell for to discard the token. If this argument is
omitted, the Cache Manager discards all tokens. Provide the fully
qualified domain name, or a shortened form, in which case successful
resolution depends on the availability of a name resolution service (such as
the Domain Name Service or a local host table) at the time the command is
issued.
<P><DT><B>-help
</B><DD>Prints the online help for this command. All other valid options
are ignored.
</DL>
<P><STRONG>Examples</STRONG>
<P>The following command discards all tokens.
<PRE> % <B>unlog</B>
</PRE>
<P>The following command discards only the tokens for the
<B>abc.com</B> and <B>stateu.edu</B> cells.
<PRE> % <B>unlog -cell abc.com stateu</B>
</PRE>
<P><STRONG>Privilege Required</STRONG>
<P>None
<P><STRONG>Related Information</STRONG>
<P><A HREF="auarf200.htm#HDRKLOG">klog</A>
<P><A HREF="auarf235.htm#HDRTOKENS">tokens</A>
<P>
<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>
<!-- Begin Footer Records ========================================== -->
<P><HR><B>
<br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
</B>
<!-- End Footer Records ============================================ -->
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>