doc/html/AdminReference/auarf190.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="auarf189.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="auarf191.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="HDRKAS_LISTTICKETS" HREF="auarf002.htm#ToC_204">kas listtickets</A></H2>
  19 <A NAME="IDX5116"></A>
  20 <A NAME="IDX5117"></A>
  21 <A NAME="IDX5118"></A>
  22 <A NAME="IDX5119"></A>
  23 <P><STRONG>Purpose</STRONG>
  24 <P>Displays all of the issuer's tickets (tokens)
  25 <P><STRONG>Synopsis</STRONG>
  26 <PRE><B>kas listtickets</B> [<B>-name</B> &lt;<VAR>name&nbsp;of&nbsp;server</VAR>>]  [<B>-long</B>]  [<B>-help</B>]
  27
  28 <B>kas listt</B> [<B>-n</B> &lt;<VAR>name&nbsp;of&nbsp;server</VAR>>]  [<B>-l</B>]  [<B>-h</B>]
  29 </PRE>
  30 <P><STRONG>Description</STRONG>
  31 <P>The <B>kas listtickets</B> command displays the associated user ID (AFS
  32 UID), cell name, and expiration date of some or all of the issuer's
  33 tickets (tokens), depending on which options are provided:
  34 <UL>
  35 <P><LI>To display all tokens, provide neither the <B>-name</B> argument nor
  36 <B>-long</B> flag. The output is similar to that of the
  37 <B>tokens</B> command.
  38 <P><LI>To display a single token, provide the <B>-name</B> argument to
  39 specify name of the Authentication Database entry for the entity that accepts
  40 the token. All AFS server processes accept tokens sealed with the key
  41 from the <B>afs</B> entry.
  42 <P><LI>To display in addition the octal numbers that constitute the token and
  43 session key, provide the <B>-long</B> flag.
  44 </UL>
  45 <P><STRONG>Options</STRONG>
  46 <DL>
  47 <P><DT><B>-name
  48 </B><DD>Names the Authentication Database entry of the entity (usually a server
  49 process) that accepts the token to display.
  50 <P><DT><B>-long
  51 </B><DD>Displays the octal numbers that constitute the session key and
  52 ticket.
  53 <P><DT><B>-help
  54 </B><DD>Prints the online help for this command. All other valid options
  55 are ignored.
  56 </DL>
  57 <P><STRONG>Output</STRONG>
  58 <P>The output reports the AFS UID of the user who owns the token, the service
  59 (usually, <TT>afs</TT>) and cell for which it is valid, and its expiration
  60 date, using the following format. If the message does not specify a
  61 cell, the ticket is for the local cell.
  62 <PRE>   User's (AFS ID <VAR>AFS UID</VAR>) tokens for <VAR>service</VAR>[@<VAR>cellname</VAR>] [Expires <VAR>date</VAR>]
  63
  64 </PRE>
  65 <P>If the <B>-long</B> flag is provided, the output also includes the
  66 octal numbers making up the session key and token, along with the key version
  67 number and the number of bytes in the token (if the number of bytes is not 56,
  68 there is an error).
  69 <P>If the marker <TT>[>> POSTDATED &lt;]</TT> appears instead of an
  70 expiration date, the ticket does not become valid until the indicated
  71 time. (Only internal calls can create a postdated ticket; there is
  72 no standard interface that allows users to do this.)
  73 <P><STRONG>Examples</STRONG>
  74 <P>The following two examples are for a user with AFS UID 1020 in the
  75 <B>abc.com</B> cell and AFS UID 35 in the
  76 <B>test.abc.com</B> cell. He is working on a machine
  77 in the first cell and is authenticated in both cells.
  78 <PRE>   % <B>kas listtickets</B>
  79    User's (AFS ID 1020) tokens for afs [Expires Wed Mar 31 9:30:54 1999]
  80    User's (AFS ID 35@test.abc.com) tokens for afs@test.abc.com  \
  81              [Expires Wed Mar 31 13:54:26 1999]
  82
  83    % <B>kas listtickets -name afs -long</B>
  84    User's (AFS ID 1020) tokens for afs [Expires Wed Mar 31 9:30:54 1999]
  85    SessionKey: \375\205\351\227\032\310\263\013
  86    Ticket: (kvno = 0, len = 56): \033\005\221\156\203\278\312\058\016\133 <VAR>(etc.)</VAR>
  87
  88 </PRE>
  89 <P><STRONG>Privilege Required</STRONG>
  90 <P>None, and no password is required.
  91 <P><STRONG>Related Information</STRONG>
  92 <P><A HREF="auarf181.htm#HDRKAS_INTRO">kas</A>
  93 <P><A HREF="auarf235.htm#HDRTOKENS">tokens</A>
  94 <P>
  95 <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="auarf189.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="auarf191.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>
  96 <!-- Begin Footer Records  ========================================== -->
  97 <P><HR><B>
  98 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  99 </B>
 100 <!-- End Footer Records  ============================================ -->
 101 <A NAME="Bot_Of_Page"></A>
 102 </BODY></HTML>