1 <?xml version="1.0" encoding="UTF-8"?>
4 <refentrytitle>unlog</refentrytitle>
5 <manvolnum>1</manvolnum>
8 <refname>unlog</refname>
9 <refpurpose>Discards all of the issuer's tokens</refpurpose>
12 <title>Synopsis</title>
13 <para><emphasis role="bold">unlog</emphasis> [<emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>>+] [<emphasis role="bold">-help</emphasis>]</para>
15 <para><emphasis role="bold">unlog</emphasis> [<emphasis role="bold">-c </emphasis><<emphasis>cell name</emphasis>>+] [<emphasis role="bold">-h</emphasis>]</para>
19 <title>Description</title>
20 <para>The <emphasis role="bold">unlog</emphasis> command by default discards all tokens that the issuer
21 currently holds. To discard tokens for certain cells only, name them with
22 the <emphasis role="bold">-cell</emphasis> argument.</para>
24 <para>Since a token pertains to one client machine only, destroying tokens on
25 one machine has no effect on tokens on another machine.</para>
29 <title>Cautions</title>
30 <para>Specifying one or more cell names can cause a brief authentication outage
31 during which the issuer has no valid tokens in any cell. This is because
32 the command actually discards all tokens and then restores the ones for
33 cells not named by the <emphasis role="bold">-cell</emphasis> argument. The outage can sometimes
34 interrupt the operation of jobs that require authentication.</para>
38 <title>Options</title>
41 <term><emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>>+</term>
43 <para>Specifies each cell for to discard the token. If this argument is omitted,
44 the Cache Manager discards all tokens. Provide the fully qualified domain
45 name, or a shortened form, in which case successful resolution depends on
46 the availability of a name resolution service (such as the Domain Name
47 Service or a local host table) at the time the command is issued.</para>
52 <term><emphasis role="bold">-help</emphasis></term>
54 <para>Prints the online help for this command. All other valid options are
62 <title>Examples</title>
63 <para>The following command discards all tokens.</para>
69 <para>The following command discards only the tokens for the <computeroutput>abc.com</computeroutput> and
70 <computeroutput>stateu.edu</computeroutput> cells.</para>
73 % unlog -cell abc.com stateu
78 <title>Privilege Required</title>
83 <title>See Also</title>
84 <para><link linkend="klog1">klog(1)</link>,
85 <link linkend="tokens1">tokens(1)</link></para>
89 <title>Copyright</title>
90 <para>IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.</para>
92 <para>This documentation is covered by the IBM Public License Version 1.0. It was
93 converted from HTML to POD by software written by Chas Williams and Russ
94 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>