1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
3 <TITLE>Administration Reference</TITLE>
4 <!-- Begin Header Records ========================================== -->
5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
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="auarf234.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="auarf236.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>
18 <H2><A NAME="HDRTOKENS" HREF="auarf002.htm#ToC_249">tokens</A></H2>
19 <A NAME="IDX5475"></A>
20 <A NAME="IDX5476"></A>
21 <A NAME="IDX5477"></A>
22 <A NAME="IDX5478"></A>
23 <A NAME="IDX5479"></A>
24 <A NAME="IDX5480"></A>
25 <P><STRONG>Purpose</STRONG>
26 <P>Displays the issuer's tokens
27 <P><STRONG>Synopsis</STRONG>
28 <PRE><B>tokens</B> [<B>-help</B>]
30 <B>tokens</B> [<B>-h</B>]
32 <P><STRONG>Description</STRONG>
33 <P>The <B>tokens</B> command displays all tokens (tickets) cached on the
34 local machine for the issuer. AFS server processes require that their
35 clients present a token as evidence that they have authenticated in the
37 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">The <B>tokens.krb</B> version of this command is intended for use
38 by sites that employ standard Kerberos authentication for their
39 clients. The <B>tokens.krb</B> command provides all of the
40 functionality of the <B>tokens</B> command. In addition, it
41 provides information on the Kerberos tickets stored in the file specified by
42 the KRBTKFILE environment variable (the <B>/tmp/tkt</B><VAR>X</VAR> file,
43 where <VAR>X</VAR> is the number of the user's PAG).
45 <P><STRONG>Options</STRONG>
48 </B><DD>Prints the online help for this command. All other valid options
51 <P><STRONG>Output</STRONG>
52 <P>The output lists one token for each cell in which the user is
53 authenticated. The output indicates the
55 <P><LI>User's AFS UID, if it is available for display.
56 <P><LI>Server for which the token is valid (normally, <B>afs</B>).
57 This includes a cell specification.
58 <P><LI>Day and time the token expires.
60 <P>The output of the Kerberos version of this command,
61 <B>tokens.krb</B>, also reports the following about the Kerberos
62 ticket-granting ticket: the ticket owner, which Kerberos ticket-granting
63 service that issued the ticket (for example,
64 <B>krbtgt.ABC.COM</B>), and ticket's expiration
66 <P>The string <TT>--End of list--</TT> appears at the end of the
67 output. If the user is not authenticated in any cell, this line is all
69 <P><STRONG>Examples</STRONG>
70 <P>The following example shows the output when the issuer is not authenticated
73 Tokens held by the Cache Manager:
78 <P>The following example shows the output when the issuer is authenticated in
79 ABC Corporation cell, where he or she has AFS UID 1000.
81 Tokens held by the Cache Manager:
83 User's (AFS ID 1000) tokens for afs@abc.com [Expires Jan 2 10:00]
87 <P>The following example shows the output when the issuer is authenticated in
88 the ABC Corporation cell, the State University cell, and the XYZ Company
89 cell. The user has different AFS UIDs in the three cells. Tokens
90 for last cell are expired:
92 Tokens held by the Cache Manager:
94 User's (AFS ID 1000) tokens for afs@abc.com [Expires Jan 3 10:00]
95 User's (AFS ID 4286) tokens for afs@stateu.edu [Expires Jan 3 1:34]
96 User's (AFS ID 22) tokens for afs@xyz.com [>>Expired<]
100 <P>The following example shows the output when the issuer uses the
101 <B>tokens.krb</B> version of the command after authenticating in
102 the ABC Corporation cell using the <B>klog.krb</B> command.
103 <PRE> % <B>tokens.krb</B>
104 Tokens held by the Cache Manager:
106 User's (AFS ID 1000) tokens for afs@abc.com [Expires Jan 31 00:09]
107 User smiths tokens for krbtgt.ABC.COM@abc.com [Expires Jan 31 00:09]
111 <P><STRONG>Privilege Required</STRONG>
113 <P><STRONG>Related Information</STRONG>
114 <P><A HREF="auarf200.htm#HDRKLOG">klog</A>
115 <P><A HREF="auarf238.htm#HDRUNLOG">unlog</A>
117 <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="auarf234.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="auarf236.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>
118 <!-- Begin Footer Records ========================================== -->
120 <br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
122 <!-- End Footer Records ============================================ -->
123 <A NAME="Bot_Of_Page"></A>