← Back to branch summary

~ubuntu-branches/ubuntu/precise/krb5/precise-updates

« back to all changes in this revision

Viewing changes to doc/klist.html

  • Committer: Package Import Robot
  • Author(s): Sam Hartman
  • Date: 2011-12-01 19:34:41 UTC
  • mfrom: (28.1.14 sid)
  • Revision ID: package-import@ubuntu.com-20111201193441-9tipg3aru1jsidyv
Tags: 1.10+dfsg~alpha1-6
http://bugs.debian.org/650671
http://bugs.debian.org/650603
http://bugs.debian.org/650611
* Fix segfault with unknown hostnames in krb5_sname_to_principal,
  Closes: #650671
* Indicate that this library breaks libsmbclient versions that depend on
  krb5_locate_kdc, Closes: #650603, #650611

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/klist.html
4
4
<!-- Manpage converted by man2html 3.0.1 -->
5
5
 
6
6
</PRE>
7
 
<H2>NAME</H2><PRE>
8
 
     klist - list cached Kerberos tickets
9
 
 
10
 
 
11
 
</PRE>
12
7
<H2>SYNOPSIS</H2><PRE>
13
 
     <B>klist</B> [<B>-e</B>] [[<B>-c</B>]  [<B>-f</B>]  [<B>-s</B>]  [<B>-a</B>   [<B>-n</B>]]]  [<B>-k</B>  [<B>-t</B>]  [<B>-K</B>]]
14
 
     [<I>cache</I>_<I>name</I> | <I>keytab</I>_<I>name</I>]
 
8
       <B>klist</B>  [<B>-e</B>]  [[<B>-c</B>]  [<B>-l</B>]  [<B>-A</B>]  [<B>-f</B>]  [<B>-s</B>]  [<B>-a</B>   [<B>-n</B>]]] [<B>-k</B> [<B>-t</B>] [<B>-K</B>]]
 
9
       [<I>cache</I><B>_</B><I>name</I> | <I>keytab</I><B>_</B><I>name</I>]
15
10
 
16
11
 
17
12
</PRE>
18
13
<H2>DESCRIPTION</H2><PRE>
19
 
     <I>Klist</I> lists the Kerberos principal and Kerberos tickets held
20
 
     in a credentials cache, or the keys held in a <B>keytab</B> file.
 
14
       <I>Klist</I> lists the Kerberos principal and Kerberos tickets held in a  cre‐
 
15
       dentials cache, or the keys held in a <B>keytab</B> file.
21
16
 
22
17
 
23
18
</PRE>
24
19
<H2>OPTIONS</H2><PRE>
25
 
     -<B>e</B>   displays the encryption types of the  session  key  and
26
 
          the ticket for each credential in the credential cache,
27
 
          or each key in the keytab file.
28
 
 
29
 
     -<B>c</B>   List tickets held in a credentials cache.  This is  the
30
 
          default if neither -<B>c</B> nor -<B>k</B> is specified.
31
 
 
32
 
     -<B>f</B>   shows the flags present in the credentials,  using  the
33
 
          following abbreviations:
34
 
 
35
 
               F    <B>F</B>orwardable
36
 
               f    <B>f</B>orwarded
37
 
               P    <B>P</B>roxiable
38
 
               p    <B>p</B>roxy
39
 
               D    post<B>D</B>ateable
40
 
               d    post<B>d</B>ated
41
 
               R    <B>R</B>enewable
42
 
               I    <B>I</B>nitial
43
 
               i    <B>i</B>nvalid
44
 
               H    <B>H</B>ardware authenticated
45
 
               A    pre<B>A</B>uthenticated
46
 
               T    <B>T</B>ransit policy checked
47
 
               O    <B>O</B>kay as delegate
48
 
               a    <B>a</B>nonymous
49
 
 
50
 
     -<B>s</B>   causes <B>klist</B> to run silently (produce no  output),  but
51
 
          to  still  set  the exit status according to whether it
52
 
          finds the credentials cache.  The exit status is `0' if
53
 
          <B>klist</B> finds a credentials cache, and `1' if it does not
54
 
          or if the tickets are
55
 
           expired.
56
 
 
57
 
     -<B>a</B>   display list of addresses in credentials.
58
 
 
59
 
     -<B>n</B>   show numeric  addresses  instead  of  reverse-resolving
60
 
          addresses.
61
 
 
62
 
     <B>-k</B>   List keys held in a <B>keytab</B> file.
63
 
 
64
 
     -<B>t</B>   display the time entry timestamps for each keytab entry
65
 
          in the keytab file.
66
 
 
67
 
     -<B>K</B>   display the value of the encryption key in each  keytab
68
 
          entry in the keytab file.
69
 
 
70
 
     If <I>cache</I>_<I>name</I> or <I>keytab</I>_<I>name</I> is not  specified,  klist  will
71
 
     display  the credentials in the default credentials cache or
72
 
     keytab file as appropriate.  If the  <B>KRB5CCNAME</B>  environment
73
 
     variable  is  set,  its  value  is  used to name the default
74
 
     ticket cache.
75
 
 
76
 
 
77
 
</PRE>
78
 
<H2>ENVIRONMENT</H2><PRE>
79
 
     <B>Klist</B> uses the following environment variables:
80
 
 
81
 
     KRB5CCNAME      Location  of  the  Kerberos  5   credentials
82
 
                     (ticket) cache.
 
20
       <B>-e</B>     displays  the encryption types of the session key and the ticket
 
21
              for each credential in the credential cache, or each key in  the
 
22
              keytab file.
 
23
 
 
24
       <B>-c</B>     List  tickets  held in a credentials cache.  This is the default
 
25
              if neither <B>-c</B> nor <B>-k</B> is specified.
 
26
 
 
27
       <B>-l</B>     If a cache collection is available, displays a table summarizing
 
28
              the caches present in the collection.
 
29
 
 
30
       <B>-A</B>     If a cache collection is available, displays the contents of all
 
31
              of the caches in the collection.
 
32
 
 
33
       <B>-f</B>     shows the flags present in the credentials, using the  following
 
34
              abbreviations:
 
35
 
 
36
                   F    <B>F</B>orwardable
 
37
                   f    <B>f</B>orwarded
 
38
                   P    <B>P</B>roxiable
 
39
                   p    <B>p</B>roxy
 
40
                   D    post<B>D</B>ateable
 
41
                   d    post<B>d</B>ated
 
42
                   R    <B>R</B>enewable
 
43
                   I    <B>I</B>nitial
 
44
                   i    <B>i</B>nvalid
 
45
                   H    <B>H</B>ardware authenticated
 
46
                   A    pre<B>A</B>uthenticated
 
47
                   T    <B>T</B>ransit policy checked
 
48
                   O    <B>O</B>kay as delegate
 
49
                   a    <B>a</B>nonymous
 
50
 
 
51
       <B>-s</B>     causes  <B>klist</B>  to run silently (produce no output), but to still
 
52
              set the exit status according to whether it  finds  the  creden‐
 
53
              tials  cache.   The  exit status is `0' if <B>klist</B> finds a creden‐
 
54
              tials cache, and `1' if it does not or if the tickets are
 
55
               expired.
 
56
 
 
57
       <B>-a</B>     display list of addresses in credentials.
 
58
 
 
59
       <B>-n</B>     show numeric addresses instead of reverse-resolving addresses.
 
60
 
 
61
       <B>-k</B>     List keys held in a <B>keytab</B> file.
 
62
 
 
63
       <B>Klist</B> uses the following environment variables:
 
64
 
 
65
       KRB5CCNAME      Location of the default Kerberos 5 credentials (ticket)
 
66
                       cache, in the form <I>type</I>:<I>residual</I>.  If no type prefix is
 
67
                       present,  the  <B>FILE</B>  type  is assumed.  The type of the
 
68
                       default cache may determine the availability of a cache
 
69
                       collection;  for  instance, a default cache of type <B>DIR</B>
 
70
                       causes caches within the directory to be present in the
 
71
                       collection.
83
72
 
84
73
 
85
74
</PRE>
86
75
<H2>FILES</H2><PRE>
87
 
     /tmp/krb5cc_[uid]  default location of  Kerberos  5  creden-
88
 
                        tials  cache ([uid] is the decimal UID of
89
 
                        the user).
 
76
       /tmp/krb5cc_[uid]  default  location  of  Kerberos  5 credentials cache
 
77
                          ([uid] is the decimal UID of the user).
90
78
 
91
 
     /etc/krb5.keytab   default location  for  the  local  host's
92
 
                        <B>keytab</B> file.
 
79
       /etc/krb5.keytab   default location for the local host's <B>keytab</B> file.
93
80
 
94
81
 
95
82
</PRE>
96
83
<H2>SEE ALSO</H2><PRE>
97
 
     <B>kinit(1)</B>, <B>kdestroy(1)</B>, <B>krb5(3)</B>
98
 
 
99
 
 
100
 
 
101
 
 
102
 
 
103
 
 
104
 
 
105
 
 
106
 
 
107
 
 
108
 
 
109
 
 
110
 
 
111
 
 
112
 
 
113
 
 
114
 
 
115
 
 
116
 
 
117
 
 
118
 
 
119
 
 
120
 
 
121
 
 
122
 
 
 
84
       <B>kinit(1)</B>, <B>kdestroy(1)</B>, <B>krb5(3)</B>
 
85
 
 
86
 
 
87
 
 
88
                                                                      <B>KLIST(1)</B>
123
89
</PRE>
124
90
<HR>
125
91
<ADDRESS>