xref: /freebsd/crypto/heimdal/admin/ktutil.8 (revision daf1cffce2e07931f27c6c6998652e90df6ba87e)
1.\" $Id: ktutil.8,v 1.6 2000/01/02 05:07:50 assar Exp $
2.\"
3.Dd Aug 27, 1997
4.Dt KTUTIL 8
5.Os HEIMDAL
6.Sh NAME
7.Nm ktutil
8.Ar command
9.Nd
10handle a keytab
11.Sh SYNOPSIS
12.Nm
13.Op Fl k Ar keytab
14.Op Fl -keytab= Ns Ar keytab
15.Op Fl v
16.Op Fl -version
17.Op Fl h
18.Op Fl -help
19.Ar command
20.Sh DESCRIPTION
21.Nm
22is a program for managing keytabs.
23.Ar command
24can be one of the following:
25.Bl -tag -width Ds
26.It add Xo
27.Op Fl p Ar principal
28.Op Fl -principal= Ns Ar principal
29.Op Fl V Ar kvno
30.Op Fl -kvno= Ns Ar kvno
31.Op Fl e Ar encype
32.Op Fl -enctype= Ns Ar enctype
33.Op Fl w Ar password
34.Op Fl -password= Ns Ar password
35.Op Fl r
36.Op Fl -random
37.Op Fl s
38.Op Fl -no-salt
39.Xc
40Adds a key to the keytab. Options that are not specified will be
41prompted for.
42.It change Xo
43.Op Fl r Ar realm
44.Op Fl -realm= Ns Ar realm
45.Op Fl -a Ar host
46.Op Fl -admin-server= Ns Ar hots
47.Op Fl -s Ar port
48.Op Fl -server-port= Ns Ar port
49.Xc
50Update one or several keys to new versions.  By default, use the admin
51server for the realm of an keytab entry.  Otherwise it will use the
52values specified by the options.
53.Pp
54If no principals are given, all the ones in the keytab are updated.
55.It copy Xo
56.Ar keytab-src
57.Ar keytab-dest
58.Xc
59Copies all the entries from
60.Ar keytab-src
61to
62.Ar keytab-dest .
63.It get Xo
64.Op Fl p Ar admin principal
65.Op Fl -principal= Ns Ar admin principal
66.Op Fl r Ar realm
67.Op Fl -realm= Ns Ar realm
68.Op Fl a Ar admin server
69.Op Fl -admin-server= Ns Ar admin server
70.Op Fl s Ar server port
71.Op Fl -server-port= Ns Ar server port
72.Ar principal
73.Xc
74Get a key for
75.Nm principal
76and store it in a keytab.
77.It list
78List the keys stored in the keytab.
79.It remove Xo
80.Op Fl p Ar principal
81.Op Fl -principal= Ns Ar principal
82.Op Fl V kvno
83.Op Fl -kvno= Ns Ar kvno
84.Op Fl e enctype
85.Op Fl -enctype= Ns Ar enctype
86.Xc
87Removes the specified key or keys. Not specifying a
88.Ar kvno
89removes keys with any version number. Not specifying a
90.Ar enctype
91removes keys of any type.
92.It purge Xo
93.Op Fl -age= Ns Ar age
94.Xc
95Removes all old entries (for which there is a newer version) that are
96older than
97.Ar age
98seconds.
99.It srvconvert
100.It srv2keytab Xo
101.Op Fl s Ar srvtab
102.Op Fl -srvtab= Ns Ar srvtab
103.Xc
104Converts the version 4 srvtab in
105.Ar srvtab
106to a version 5 keytab and stores it in
107.Ar keytab .
108.It srvcreate
109.It key2srvtab Xo
110.Op Fl s Ar srvtab
111.Op Fl -srvtab= Ns Ar srvtab
112.Xc
113Converts the version 5 keytab in
114.Ar keytab
115to a version 4 srvtab and stores it in
116.Ar srvtab .
117.El
118.Sh SEE ALSO
119.Xr kadmin 8
120