Miscellaneous small edits to RST docs
[krb5.git] / src / man / kvno.1
1 .TH "KVNO" "1" "January 06, 2012" "0.0.1" "MIT Kerberos"
2 .SH NAME
3 kvno \- print key version numbers of Kerberos principals
4 .
5 .nr rst2man-indent-level 0
6 .
7 .de1 rstReportMargin
8 \\$1 \\n[an-margin]
9 level \\n[rst2man-indent-level]
10 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11 -
12 \\n[rst2man-indent0]
13 \\n[rst2man-indent1]
14 \\n[rst2man-indent2]
15 ..
16 .de1 INDENT
17 .\" .rstReportMargin pre:
18 . RS \\$1
19 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
20 . nr rst2man-indent-level +1
21 .\" .rstReportMargin post:
22 ..
23 .de UNINDENT
24 . RE
25 .\" indent \\n[an-margin]
26 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
27 .nr rst2man-indent-level -1
28 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30 ..
31 .\" Man page generated from reStructeredText.
32 .
33 .SH SYNOPSIS
34 .INDENT 0.0
35 .TP
36 .B \fBkvno\fP
37 .sp
38 [\fB\-c\fP \fIccache\fP]
39 [\fB\-e\fP \fIetype\fP]
40 [\fB\-q\fP]
41 [\fB\-h\fP]
42 [\fB\-P\fP]
43 [\fB\-S\fP \fIsname\fP]
44 [\fB\-U\fP \fIfor_user\fP]
45 \fIservice1 service2\fP ...
46 .UNINDENT
47 .SH DESCRIPTION
48 .sp
49 \fIkvno\fP acquires a service ticket for the specified Kerberos principals and
50 prints out the key version numbers of each.
51 .SH OPTIONS
52 .INDENT 0.0
53 .INDENT 3.5
54 .INDENT 0.0
55 .TP
56 .B \fB\-c\fP \fIccache\fP
57 .sp
58 Specifies the name of a credentials cache to use (if not the default)
59 .TP
60 .B \fB\-e\fP \fIetype\fP
61 .sp
62 Specifies the enctype which will be requested for the session key of all
63 the services named on the command line.
64 This is useful in certain backward compatibility situations.
65 .TP
66 .B \fB\-q\fP
67 .sp
68 Suppress printing
69 .TP
70 .B \fB\-h\fP
71 .sp
72 Prints a usage statement and exits
73 .TP
74 .B \fB\-P\fP
75 .sp
76 Specifies that the \fIservice1 service2\fP ...  arguments are to be treated as
77 services for which credentials should be acquired using constrained delegation.
78 This option is only valid when used in conjunction with protocol transition.
79 .TP
80 .B \fB\-S\fP \fIsname\fP
81 .sp
82 Specifies that \fIkrb5_sname_to_principal()\fP will be used to build principal names.
83 If this flag is specified, the \fIservice1 service2\fP ...  arguments are interpreted as
84 \fIhostnames\fP (rather than principal names),
85 and \fIsname\fP is interpreted as the service name.
86 .TP
87 .B \fB\-U\fP \fIfor_user\fP
88 .sp
89 Specifies that protocol transition (S4U2Self) is to be used
90 to acquire a ticket on behalf of \fIfor_user\fP.
91 If constrained  delegation is not requested,
92 the service name must match the credentials cache client principal.
93 .UNINDENT
94 .UNINDENT
95 .UNINDENT
96 .SH ENVIRONMENT
97 .sp
98 \fIkvno\fP uses the following environment variable:
99 .INDENT 0.0
100 .INDENT 3.5
101 .sp
102 \fBKRB5CCNAME\fP  \- Location of the credentials (ticket) cache.
103 .UNINDENT
104 .UNINDENT
105 .SH FILES
106 .sp
107 /tmp/krb5cc_[uid] \- Default location of the credentials cache ([uid] is the decimal UID of the user).
108 .SH SEE ALSO
109 .sp
110 kinit(1), kdestroy(1)
111 .SH AUTHOR
112 MIT
113 .SH COPYRIGHT
114 2011, MIT
115 .\" Generated by docutils manpage writer.
116 .