--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
+<HTML><HEAD>
+<TITLE>Administration Reference</TITLE>
+<!-- Begin Header Records ========================================== -->
+<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
+<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
+<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
+<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
+<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
+</HEAD><BODY>
+<!-- (C) IBM Corporation 2000. All Rights Reserved -->
+<BODY bgcolor="ffffff">
+<!-- End Header Records ============================================ -->
+<A NAME="Top_Of_Page"></A>
+<H1>Administration Reference</H1>
+<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>
+<P>
+<H2><A NAME="HDRKAS_LISTTICKETS" HREF="auarf002.htm#ToC_204">kas listtickets</A></H2>
+<A NAME="IDX5116"></A>
+<A NAME="IDX5117"></A>
+<A NAME="IDX5118"></A>
+<A NAME="IDX5119"></A>
+<P><STRONG>Purpose</STRONG>
+<P>Displays all of the issuer's tickets (tokens)
+<P><STRONG>Synopsis</STRONG>
+<PRE><B>kas listtickets</B> [<B>-name</B> <<VAR>name of server</VAR>>] [<B>-long</B>] [<B>-help</B>]
+
+<B>kas listt</B> [<B>-n</B> <<VAR>name of server</VAR>>] [<B>-l</B>] [<B>-h</B>]
+</PRE>
+<P><STRONG>Description</STRONG>
+<P>The <B>kas listtickets</B> command displays the associated user ID (AFS
+UID), cell name, and expiration date of some or all of the issuer's
+tickets (tokens), depending on which options are provided:
+<UL>
+<P><LI>To display all tokens, provide neither the <B>-name</B> argument nor
+<B>-long</B> flag. The output is similar to that of the
+<B>tokens</B> command.
+<P><LI>To display a single token, provide the <B>-name</B> argument to
+specify name of the Authentication Database entry for the entity that accepts
+the token. All AFS server processes accept tokens sealed with the key
+from the <B>afs</B> entry.
+<P><LI>To display in addition the octal numbers that constitute the token and
+session key, provide the <B>-long</B> flag.
+</UL>
+<P><STRONG>Options</STRONG>
+<DL>
+<P><DT><B>-name
+</B><DD>Names the Authentication Database entry of the entity (usually a server
+process) that accepts the token to display.
+<P><DT><B>-long
+</B><DD>Displays the octal numbers that constitute the session key and
+ticket.
+<P><DT><B>-help
+</B><DD>Prints the online help for this command. All other valid options
+are ignored.
+</DL>
+<P><STRONG>Output</STRONG>
+<P>The output reports the AFS UID of the user who owns the token, the service
+(usually, <TT>afs</TT>) and cell for which it is valid, and its expiration
+date, using the following format. If the message does not specify a
+cell, the ticket is for the local cell.
+<PRE> User's (AFS ID <VAR>AFS UID</VAR>) tokens for <VAR>service</VAR>[@<VAR>cellname</VAR>] [Expires <VAR>date</VAR>]
+
+</PRE>
+<P>If the <B>-long</B> flag is provided, the output also includes the
+octal numbers making up the session key and token, along with the key version
+number and the number of bytes in the token (if the number of bytes is not 56,
+there is an error).
+<P>If the marker <TT>[>> POSTDATED <]</TT> appears instead of an
+expiration date, the ticket does not become valid until the indicated
+time. (Only internal calls can create a postdated ticket; there is
+no standard interface that allows users to do this.)
+<P><STRONG>Examples</STRONG>
+<P>The following two examples are for a user with AFS UID 1020 in the
+<B>abc.com</B> cell and AFS UID 35 in the
+<B>test.abc.com</B> cell. He is working on a machine
+in the first cell and is authenticated in both cells.
+<PRE> % <B>kas listtickets</B>
+ User's (AFS ID 1020) tokens for afs [Expires Wed Mar 31 9:30:54 1999]
+ User's (AFS ID 35@test.abc.com) tokens for afs@test.abc.com \
+ [Expires Wed Mar 31 13:54:26 1999]
+
+ % <B>kas listtickets -name afs -long</B>
+ User's (AFS ID 1020) tokens for afs [Expires Wed Mar 31 9:30:54 1999]
+ SessionKey: \375\205\351\227\032\310\263\013
+ Ticket: (kvno = 0, len = 56): \033\005\221\156\203\278\312\058\016\133 <VAR>(etc.)</VAR>
+
+</PRE>
+<P><STRONG>Privilege Required</STRONG>
+<P>None, and no password is required.
+<P><STRONG>Related Information</STRONG>
+<P><A HREF="auarf181.htm#HDRKAS_INTRO">kas</A>
+<P><A HREF="auarf235.htm#HDRTOKENS">tokens</A>
+<P>
+<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>
+<!-- Begin Footer Records ========================================== -->
+<P><HR><B>
+<br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
+</B>
+<!-- End Footer Records ============================================ -->
+<A NAME="Bot_Of_Page"></A>
+</BODY></HTML>
git://git.openafs.org / openafs.git / blobdiff