mirror of
https://git.openafs.org/openafs.git
synced 2025-01-18 23:10:58 +00:00
1cc8feb6fc
There were several different real and made-up hostnames and company names used throughout our documentation examples. The IETF has reserved "example.com" and other "example" TLDs for use in examples (RFC 2606). Replace almost all references to ABC Corporation, DEF Corporation, and State University, as well as "abc.com", "bigcell.com", "def.com", "def.gov", "ghi.com", "ghi.gov", "jkl.com", "mit.edu", "stanford.edu", "state.edu", "stateu.edu", "uncc.edu", and "xyz.com". Standardize on "Example Corporation", "Example Network", "Example Organization" (example.com, example.net, and example.org). The Scout documentation in the Admin Guide contains PNG images that contain the old cell names, so I left those references until the images can be replaced. Change-Id: I4e44815b2d2ffe204810b7fd850842248f67c367 Reviewed-on: http://gerrit.openafs.org/6697 Reviewed-by: Jeffrey Altman <jaltman@secure-endpoints.com> Tested-by: Jeffrey Altman <jaltman@secure-endpoints.com>
80 lines
2.0 KiB
Plaintext
80 lines
2.0 KiB
Plaintext
=head1 NAME
|
|
|
|
unlog - Discards all of the issuer's tokens
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
=for html
|
|
<div class="synopsis">
|
|
|
|
B<unlog> S<<< [B<-cell> <I<cell name>>+] >>> [B<-help>]
|
|
|
|
B<unlog> [B<-c ><I<cell name>>+] [B<-h>]
|
|
|
|
=for html
|
|
</div>
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The B<unlog> command by default discards all tokens that the issuer
|
|
currently holds. To discard tokens for certain cells only, name them with
|
|
the B<-cell> argument.
|
|
|
|
Since a token pertains to one client machine only, destroying tokens on
|
|
one machine has no effect on tokens on another machine.
|
|
|
|
=head1 CAUTIONS
|
|
|
|
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> argument. The outage can sometimes
|
|
interrupt the operation of jobs that require authentication.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 4
|
|
|
|
=item B<-cell> <I<cell name>>+
|
|
|
|
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.
|
|
|
|
=item B<-help>
|
|
|
|
Prints the online help for this command. All other valid options are
|
|
ignored.
|
|
|
|
=back
|
|
|
|
=head1 EXAMPLES
|
|
|
|
The following command discards all tokens.
|
|
|
|
% unlog
|
|
|
|
The following command discards only the tokens for the C<prod.example.com> and
|
|
C<testcell.example.org> cells.
|
|
|
|
% unlog -cell prod.example.com testcell
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
None
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<klog(1)>,
|
|
L<tokens(1)>
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
This documentation is covered by the IBM Public License Version 1.0. It was
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|