xref: /freebsd/crypto/heimdal/kuser/klist.1 (revision 84ee9401a3fc8d3c22424266f421a928989cd692)
1.\" Copyright (c) 2000 - 2002 Kungliga Tekniska H�gskolan
2.\" (Royal Institute of Technology, Stockholm, Sweden).
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\"
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\"
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\"
16.\" 3. Neither the name of the Institute nor the names of its contributors
17.\"    may be used to endorse or promote products derived from this software
18.\"    without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" $Id: klist.1,v 1.12 2003/02/16 21:10:26 lha Exp $
33.\"
34.Dd July 8, 2000
35.Dt KLIST 1
36.Os HEIMDAL
37.Sh NAME
38.Nm klist
39.Nd list Kerberos credentials
40.Sh SYNOPSIS
41.Nm
42.Oo Fl c Ar cache \*(Ba Xo
43.Fl -cache= Ns Ar cache
44.Xc
45.Oc
46.Op Fl s | Fl t | Fl -test
47.Op Fl 4 | Fl -v4
48.Op Fl T | Fl -tokens
49.Op Fl 5 | Fl -v5
50.Op Fl v | Fl -verbose
51.Op Fl f
52.Op Fl -version
53.Op Fl -help
54.Sh DESCRIPTION
55.Nm
56reads and displays the current tickets in the crential cache (also
57known as the ticket file).
58.Pp
59Options supported:
60.Bl -tag -width Ds
61.It Xo
62.Fl c Ar cache ,
63.Fl -cache= Ns Ar cache
64.Xc
65credentials cache to list
66.It Xo
67.Fl s ,
68.Fl t ,
69.Fl -test
70.Xc
71Test for there being an active and valid TGT for the local realm of
72the user in the credential cache.
73.It Xo
74.Fl 4 ,
75.Fl -v4
76.Xc
77display v4 tickets
78.It Xo
79.Fl T ,
80.Fl -tokens
81.Xc
82display AFS tokens
83.It Xo
84.Fl 5 ,
85.Fl -v5
86.Xc
87display v5 cred cache (this is the default)
88.It Fl f
89Include ticket flags in short form, each charcted stands for a
90specific flag, as follows:
91.Bl -tag -width  XXX -compact -offset indent
92.It F
93forwardable
94.It f
95forwarded
96.It P
97proxiable
98.It p
99proxied
100.It D
101postdate-able
102.It d
103postdated
104.It R
105renewable
106.It I
107initial
108.It i
109invalid
110.It A
111pre-authenticated
112.It H
113hardware authenticated
114.El
115.Pp
116This information is also output with the
117.Fl -verbose
118option, but in a more verbose way.
119.It Xo
120.Fl v ,
121.Fl -verbose
122.Xc
123Verbose output. Include all possible information:
124.Bl -tag -width XXXX -offset indent
125.It Server
126the princial the ticket is for
127.It Ticket etype
128the encryption type use in the ticket, followed by the key version of
129the ticket, if it is available
130.It Session key
131the encryption type of the session key, if it's different from the
132encryption type of the ticket
133.It Auth time
134the time the authentication exchange took place
135.It Start time
136the time that this tickets is valid from (only printed if it's
137different from the auth time)
138.It End time
139when the ticket expires, if it has already expired this is also noted
140.It Renew till
141the maximum possible end time of any ticket derived from this one
142.It Ticket flags
143the flags set on the ticket
144.It Addresses
145the set of addresses from which this ticket is valid
146.El
147.El
148.Sh SEE ALSO
149.Xr kdestroy 1 ,
150.Xr kinit 1
151