Blame src/man/kvno.man

Packit fd8b60
.\" Man page generated from reStructuredText.
Packit fd8b60
.
Packit fd8b60
.TH "KVNO" "1" " " "1.18.2" "MIT Kerberos"
Packit fd8b60
.SH NAME
Packit fd8b60
kvno \- print key version numbers of Kerberos principals
Packit fd8b60
.
Packit fd8b60
.nr rst2man-indent-level 0
Packit fd8b60
.
Packit fd8b60
.de1 rstReportMargin
Packit fd8b60
\\$1 \\n[an-margin]
Packit fd8b60
level \\n[rst2man-indent-level]
Packit fd8b60
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
Packit fd8b60
-
Packit fd8b60
\\n[rst2man-indent0]
Packit fd8b60
\\n[rst2man-indent1]
Packit fd8b60
\\n[rst2man-indent2]
Packit fd8b60
..
Packit fd8b60
.de1 INDENT
Packit fd8b60
.\" .rstReportMargin pre:
Packit fd8b60
. RS \\$1
Packit fd8b60
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
Packit fd8b60
. nr rst2man-indent-level +1
Packit fd8b60
.\" .rstReportMargin post:
Packit fd8b60
..
Packit fd8b60
.de UNINDENT
Packit fd8b60
. RE
Packit fd8b60
.\" indent \\n[an-margin]
Packit fd8b60
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
Packit fd8b60
.nr rst2man-indent-level -1
Packit fd8b60
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
Packit fd8b60
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
Packit fd8b60
..
Packit fd8b60
.SH SYNOPSIS
Packit fd8b60
.sp
Packit fd8b60
\fBkvno\fP
Packit fd8b60
[\fB\-c\fP \fIccache\fP]
Packit fd8b60
[\fB\-e\fP \fIetype\fP]
Packit fd8b60
[\fB\-q\fP]
rpm-build 49565d
[\fB\-u\fP | \fB\-S\fP \fIsname\fP]
Packit fd8b60
[\fB\-P\fP]
rpm-build 49565d
[[{\fB\-F\fP \fIcert_file\fP | {\fB\-I\fP | \fB\-U\fP} \fIfor_user\fP} [\fB\-P\fP]] | \fB\-\-u2u\fP \fIccache\fP]
Packit fd8b60
\fIservice1 service2\fP ...
Packit fd8b60
.SH DESCRIPTION
Packit fd8b60
.sp
Packit fd8b60
kvno acquires a service ticket for the specified Kerberos principals
Packit fd8b60
and prints out the key version numbers of each.
Packit fd8b60
.SH OPTIONS
Packit fd8b60
.INDENT 0.0
Packit fd8b60
.TP
Packit fd8b60
\fB\-c\fP \fIccache\fP
Packit fd8b60
Specifies the name of a credentials cache to use (if not the
Packit fd8b60
default)
Packit fd8b60
.TP
Packit fd8b60
\fB\-e\fP \fIetype\fP
Packit fd8b60
Specifies the enctype which will be requested for the session key
Packit fd8b60
of all the services named on the command line.  This is useful in
Packit fd8b60
certain backward compatibility situations.
Packit fd8b60
.TP
rpm-build 49565d
\fB\-k\fP \fIkeytab\fP
rpm-build 49565d
Decrypt the acquired tickets using \fIkeytab\fP to confirm their
rpm-build 49565d
validity.
rpm-build 49565d
.TP
Packit fd8b60
\fB\-q\fP
Packit fd8b60
Suppress printing output when successful.  If a service ticket
Packit fd8b60
cannot be obtained, an error message will still be printed and
Packit fd8b60
kvno will exit with nonzero status.
Packit fd8b60
.TP
rpm-build 49565d
\fB\-u\fP
rpm-build 49565d
Use the unknown name type in requested service principal names.
rpm-build 49565d
This option Cannot be used with \fI\-S\fP\&.
Packit fd8b60
.TP
Packit fd8b60
\fB\-P\fP
Packit fd8b60
Specifies that the \fIservice1 service2\fP ...  arguments are to be
Packit fd8b60
treated as services for which credentials should be acquired using
Packit fd8b60
constrained delegation.  This option is only valid when used in
Packit fd8b60
conjunction with protocol transition.
Packit fd8b60
.TP
Packit fd8b60
\fB\-S\fP \fIsname\fP
Packit fd8b60
Specifies that the \fIservice1 service2\fP ... arguments are
Packit fd8b60
interpreted as hostnames, and the service principals are to be
Packit fd8b60
constructed from those hostnames and the service name \fIsname\fP\&.
Packit fd8b60
The service hostnames will be canonicalized according to the usual
Packit fd8b60
rules for constructing service principals.
Packit fd8b60
.TP
Packit fd8b60
\fB\-I\fP \fIfor_user\fP
Packit fd8b60
Specifies that protocol transition (S4U2Self) is to be used to
Packit fd8b60
acquire a ticket on behalf of \fIfor_user\fP\&.  If constrained
Packit fd8b60
delegation is not requested, the service name must match the
Packit fd8b60
credentials cache client principal.
Packit fd8b60
.TP
Packit fd8b60
\fB\-U\fP \fIfor_user\fP
Packit fd8b60
Same as \-I, but treats \fIfor_user\fP as an enterprise name.
Packit fd8b60
.TP
Packit fd8b60
\fB\-F\fP \fIcert_file\fP
Packit fd8b60
Specifies that protocol transition is to be used, identifying the
Packit fd8b60
client principal with the X.509 certificate in \fIcert_file\fP\&.  The
Packit fd8b60
certificate file must be in PEM format.
Packit fd8b60
.TP
Packit fd8b60
\fB\-\-u2u\fP \fIccache\fP
Packit fd8b60
Requests a user\-to\-user ticket.  \fIccache\fP must contain a local
Packit fd8b60
krbtgt ticket for the server principal.  The reported version
Packit fd8b60
number will typically be 0, as the resulting ticket is not
Packit fd8b60
encrypted in the server\(aqs long\-term key.
Packit fd8b60
.UNINDENT
Packit fd8b60
.SH ENVIRONMENT
Packit fd8b60
.sp
Packit fd8b60
See kerberos(7) for a description of Kerberos environment
Packit fd8b60
variables.
Packit fd8b60
.SH FILES
Packit fd8b60
.INDENT 0.0
Packit fd8b60
.TP
Packit fd8b60
.B \fB@CCNAME@\fP
Packit fd8b60
Default location of the credentials cache
Packit fd8b60
.UNINDENT
Packit fd8b60
.SH SEE ALSO
Packit fd8b60
.sp
Packit fd8b60
kinit(1), kdestroy(1), kerberos(7)
Packit fd8b60
.SH AUTHOR
Packit fd8b60
MIT
Packit fd8b60
.SH COPYRIGHT
Packit fd8b60
1985-2020, MIT
Packit fd8b60
.\" Generated by docutils manpage writer.
Packit fd8b60
.