doc/rst_source/krb_users/user_commands/kvno.rst

   1 .. _kvno(1):
   2
   3 kvno
   4 ====
   5
   6 SYNOPSIS
   7 --------
   8
   9 **kvno**
  10 [**-c** *ccache*]
  11 [**-e** *etype*]
  12 [**-q**]
  13 [**-h**]
  14 [**-P**]
  15 [**-S** *sname*]
  16 [**-U** *for_user*]
  17 *service1 service2* ...
  18
  19
  20 DESCRIPTION
  21 -----------
  22
  23 kvno acquires a service ticket for the specified Kerberos principals
  24 and prints out the key version numbers of each.
  25
  26
  27 OPTIONS
  28 -------
  29
  30 **-c** *ccache*
  31     Specifies the name of a credentials cache to use (if not the
  32     default)
  33
  34 **-e** *etype*
  35     Specifies the enctype which will be requested for the session key
  36     of all the services named on the command line.  This is useful in
  37     certain backward compatibility situations.
  38
  39 **-q**
  40     Suppress printing output when successful.  If a service ticket
  41     cannot be obtained, an error message will still be printed and
  42     kvno will exit with nonzero status.
  43
  44 **-h**
  45     Prints a usage statement and exits.
  46
  47 **-P**
  48     Specifies that the *service1 service2* ...  arguments are to be
  49     treated as services for which credentials should be acquired using
  50     constrained delegation.  This option is only valid when used in
  51     conjunction with protocol transition.
  52
  53 **-S** *sname*
  54     Specifies that the *service1 service2* ... arguments are
  55     interpreted as hostnames, and the service principals are to be
  56     constructed from those hostnames and the service name *sname*.
  57     The service hostnames will be canonicalized according to the usual
  58     rules for constructing service principals.
  59
  60 **-U** *for_user*
  61     Specifies that protocol transition (S4U2Self) is to be used to
  62     acquire a ticket on behalf of *for_user*.  If constrained
  63     delegation is not requested, the service name must match the
  64     credentials cache client principal.
  65
  66
  67 ENVIRONMENT
  68 -----------
  69
  70 kvno uses the following environment variable:
  71
  72 **KRB5CCNAME**
  73     Location of the credentials (ticket) cache.
  74
  75
  76 FILES
  77 -----
  78
  79 ``/tmp/krb5cc_[uid]``
  80     Default location of the credentials cache ([*uid*] is the decimal
  81     UID of the user).
  82
  83
  84 SEE ALSO
  85 --------
  86
  87 :ref:`kinit(1)`, :ref:`kdestroy(1)`