doc/html/AdminReference/auarf235.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   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">
  10 </HEAD><BODY>
  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>
  17 <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>]
  29
  30 <B>tokens</B> [<B>-h</B>]
  31 </PRE>
  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
  36 server's local cell.
  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).
  44 </TD></TR></TABLE>
  45 <P><STRONG>Options</STRONG>
  46 <DL>
  47 <P><DT><B>-help
  48 </B><DD>Prints the online help for this command. All other valid options
  49 are ignored.
  50 </DL>
  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
  54 <UL>
  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.
  59 </UL>
  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
  65 date.
  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
  68 that appears.
  69 <P><STRONG>Examples</STRONG>
  70 <P>The following example shows the output when the issuer is not authenticated
  71 in any cell.
  72 <PRE>   % <B>tokens</B>
  73    Tokens held by the Cache Manager:
  74
  75       --End of list--
  76
  77 </PRE>
  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.
  80 <PRE>   % <B>tokens</B>
  81    Tokens held by the Cache Manager:
  82
  83    User's (AFS ID 1000) tokens for afs@abc.com [Expires Jan 2 10:00]
  84       --End of list--
  85
  86 </PRE>
  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:
  91 <PRE>   % <B>tokens</B>
  92    Tokens held by the Cache Manager:
  93
  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&lt;]
  97       --End of list--
  98
  99 </PRE>
 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:
 105
 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]
 108       --End of list--
 109
 110 </PRE>
 111 <P><STRONG>Privilege Required</STRONG>
 112 <P>None
 113 <P><STRONG>Related Information</STRONG>
 114 <P><A HREF="auarf200.htm#HDRKLOG">klog</A>
 115 <P><A HREF="auarf238.htm#HDRUNLOG">unlog</A>
 116 <P>
 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  ========================================== -->
 119 <P><HR><B>
 120 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 121 </B>
 122 <!-- End Footer Records  ============================================ -->
 123 <A NAME="Bot_Of_Page"></A>
 124 </BODY></HTML>