.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "KAS_LISTTICKETS 8"
.TH KAS_LISTTICKETS 8 "2017-12-15" "OpenAFS" "AFS Command Reference"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
kas_listtickets \- Displays all of the issuer's tickets (tokens)
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBkas listtickets\fR [\fB\-name\fR\ <\fIname\ of\ server\fR>] [\fB\-long\fR] [\fB\-help\fR]
.PP
\&\fBkas listt\fR [\fB\-n\fR\ <\fIname\ of\ server\fR>] [\fB\-l\fR] [\fB\-h\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \fBkas listtickets\fR command displays the associated user \s-1ID\s0 (\s-1AFS UID\s0),
cell name, and expiration date of some or all of the issuer's tickets
(tokens), depending on which options are provided:
.IP "\(bu" 4
To display all tokens, provide neither the \fB\-name\fR argument nor \fB\-long\fR
flag. The output is similar to that of the \fBtokens\fR command.
.IP "\(bu" 4
To display a single token, provide the \fB\-name\fR argument to specify name
of the Authentication Database entry for the entity that accepts the
token. All \s-1AFS\s0 server processes accept tokens sealed with the key from the
\&\f(CW\*(C`afs\*(C'\fR entry.
.IP "\(bu" 4
To display in addition the octal numbers that constitute the token and
session key, provide the \fB\-long\fR flag.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-name\fR <\fIname of server\fR>" 4
.IX Item "-name <name of server>"
Names the Authentication Database entry of the entity (usually a server
process) that accepts the token to display.
.IP "\fB\-long\fR" 4
.IX Item "-long"
Displays the octal numbers that constitute the session key and ticket.
.IP "\fB\-help\fR" 4
.IX Item "-help"
Prints the online help for this command. All other valid options are
ignored.
.SH "OUTPUT"
.IX Header "OUTPUT"
The output reports the \s-1AFS UID\s0 of the user who owns the token, the service
(usually, \f(CW\*(C`afs\*(C'\fR) 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.
.PP
.Vb 2
\&   User\*(Aqs (AFS ID <AFS UID>) tokens for <service>[@<cellname>] \e
\&       [Expires <date>]
.Ve
.PP
If the \fB\-long\fR 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).
.PP
If the marker \f(CW\*(C`[>> POSTDATED <]\*(C'\fR 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.)
.SH "EXAMPLES"
.IX Header "EXAMPLES"
The following two examples are for a user with \s-1AFS UID 1020\s0 in the
\&\f(CW\*(C`abc.com\*(C'\fR cell and \s-1AFS UID 35\s0 in the \f(CW\*(C`test.abc.com\*(C'\fR cell. He is working
on a machine in the first cell and is authenticated in both cells.
.PP
.Vb 4
\&   % kas listtickets
\&   User\*(Aqs (AFS ID 1020) tokens for afs [Expires Wed Mar 31 9:30:54 1999]
\&   User\*(Aqs (AFS ID 35@test.abc.com) tokens for afs@test.abc.com \e
\&             [Expires Wed Mar 31 13:54:26 1999]
\&
\&   % kas listtickets \-name afs \-long
\&   User\*(Aqs (AFS ID 1020) tokens for afs [Expires Wed Mar 31 9:30:54 1999]
\&   SessionKey: \e375\e205\e351\e227\e032\e310\e263\e013
\&   Ticket: (kvno = 0, len = 56): \e033\e005\e221\e156\e203\e278\e312\e058\e016\e133...
.Ve
.SH "PRIVILEGE REQUIRED"
.IX Header "PRIVILEGE REQUIRED"
None, and no password is required.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIkas\fR\|(8),
\&\fItokens\fR\|(1)
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
\&\s-1IBM\s0 Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
.PP
This documentation is covered by the \s-1IBM\s0 Public License Version 1.0.  It was
converted from \s-1HTML\s0 to \s-1POD\s0 by software written by Chas Williams and Russ
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.