doc/man-pages/pod1/unlog.pod

   1 =head1 NAME
   2
   3 unlog - Discards all of the issuer's tokens
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 B<unlog> S<<< [B<-cell> <I<cell name>>+] >>> [B<-help>]
  11
  12 B<unlog> [B<-c ><I<cell name>>+] [B<-h>]
  13
  14 =for html
  15 </div>
  16
  17 =head1 DESCRIPTION
  18
  19 The B<unlog> command by default discards all tokens that the issuer
  20 currently holds. To discard tokens for certain cells only, name them with
  21 the B<-cell> argument.
  22
  23 Since a token pertains to one client machine only, destroying tokens on
  24 one machine has no effect on tokens on another machine.
  25
  26 =head1 CAUTIONS
  27
  28 Specifying one or more cell names can cause a brief authentication outage
  29 during which the issuer has no valid tokens in any cell. This is because
  30 the command actually discards all tokens and then restores the ones for
  31 cells not named by the B<-cell> argument. The outage can sometimes
  32 interrupt the operation of jobs that require authentication.
  33
  34 =head1 OPTIONS
  35
  36 =over 4
  37
  38 =item B<-cell> <I<cell name>>+
  39
  40 Specifies each cell for to discard the token. If this argument is omitted,
  41 the Cache Manager discards all tokens. Provide the fully qualified domain
  42 name, or a shortened form, in which case successful resolution depends on
  43 the availability of a name resolution service (such as the Domain Name
  44 Service or a local host table) at the time the command is issued.
  45
  46 =item B<-help>
  47
  48 Prints the online help for this command. All other valid options are
  49 ignored.
  50
  51 =back
  52
  53 =head1 EXAMPLES
  54
  55 The following command discards all tokens.
  56
  57    % unlog
  58
  59 The following command discards only the tokens for the C<prod.example.com> and
  60 C<testcell.example.org> cells.
  61
  62    % unlog -cell prod.example.com testcell
  63
  64 =head1 PRIVILEGE REQUIRED
  65
  66 None
  67
  68 =head1 SEE ALSO
  69
  70 L<klog(1)>,
  71 L<tokens(1)>
  72
  73 =head1 COPYRIGHT
  74
  75 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
  76
  77 This documentation is covered by the IBM Public License Version 1.0.  It was
  78 converted from HTML to POD by software written by Chas Williams and Russ
  79 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.