summaryrefslogtreecommitdiffstats
path: root/src/man/k5srvutil.man
blob: 98ed9a810ae0471a5ec63e724935213a95e0533a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
.TH "K5SRVUTIL" "1" " " "1.13" "MIT Kerberos"
.SH NAME
k5srvutil \- host key table (keytab) manipulation utility
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\" Man page generated from reStructuredText.
.
.SH SYNOPSIS
.sp
\fBk5srvutil\fP \fIoperation\fP
[\fB\-i\fP]
[\fB\-f\fP \fIfilename\fP]
[\fB\-e\fP \fIkeysalts\fP]
.SH DESCRIPTION
.sp
k5srvutil allows an administrator to list or change keys currently in
a keytab or to add new keys to the keytab.
.sp
\fIoperation\fP must be one of the following:
.INDENT 0.0
.TP
.B \fBlist\fP
Lists the keys in a keytab showing version number and principal
name.
.TP
.B \fBchange\fP
Uses the kadmin protocol to update the keys in the Kerberos
database to new randomly\-generated keys, and updates the keys in
the keytab to match.  If a key\(aqs version number doesn\(aqt match the
version number stored in the Kerberos server\(aqs database, then the
operation will fail.  Old keys are retained in the keytab so that
existing tickets continue to work.  If the \fB\-i\fP flag is given,
k5srvutil will prompt for confirmation before changing each key.
If the \fB\-k\fP option is given, the old and new keys will be
displayed.  Ordinarily, keys will be generated with the default
encryption types and key salts.  This can be overridden with the
\fB\-e\fP option.
.TP
.B \fBdelold\fP
Deletes keys that are not the most recent version from the keytab.
This operation should be used some time after a change operation
to remove old keys, after existing tickets issued for the service
have expired.  If the \fB\-i\fP flag is given, then k5srvutil will
prompt for confirmation for each principal.
.TP
.B \fBdelete\fP
Deletes particular keys in the keytab, interactively prompting for
each key.
.UNINDENT
.sp
In all cases, the default keytab is used unless this is overridden by
the \fB\-f\fP option.
.sp
k5srvutil uses the \fIkadmin(1)\fP program to edit the keytab in
place.
.SH SEE ALSO
.sp
\fIkadmin(1)\fP, \fIktutil(1)\fP
.SH AUTHOR
MIT
.SH COPYRIGHT
1985-2013, MIT
.\" Generated by docutils manpage writer.
.