summaryrefslogtreecommitdiffstats
path: root/crypto/heimdal/kdc/hprop.cat8
blob: 0ac37e2420537b6c3029943a06d46fd7f9c6be36 (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
90
91
92
93
94
95
96
97
98
HPROP(8)                NetBSD System Manager's Manual                HPROP(8)

NNAAMMEE
     hhpprroopp - propagate the KDC database

SSYYNNOOPPSSIISS
     hhpprroopp [--mm _f_i_l_e | ----mmaasstteerr--kkeeyy==_f_i_l_e] [--dd _f_i_l_e | ----ddaattaabbaassee==_f_i_l_e]
     [----ssoouurrccee==_h_e_i_m_d_a_l_|_m_i_t_-_d_u_m_p_|_k_r_b_4_-_d_u_m_p_|_k_r_b_4_-_d_b_|_k_a_s_e_r_v_e_r] [--rr _s_t_r_i_n_g |
     ----vv44--rreeaallmm==_s_t_r_i_n_g] [--cc _c_e_l_l | ----cceellll==_c_e_l_l] [--SS | ----kkaassppeecciiaallss] [--kk _k_e_y_t_a_b
     | ----kkeeyyttaabb==_k_e_y_t_a_b] [--RR _s_t_r_i_n_g | ----vv55--rreeaallmm==_s_t_r_i_n_g] [--DD | ----ddeeccrryypptt] [--EE |
     ----eennccrryypptt] [--nn | ----ssttddoouutt] [--vv | ----vveerrbboossee] [----vveerrssiioonn] [--hh | ----hheellpp]
     [_h_o_s_t[:_p_o_r_t]] _._._.

DDEESSCCRRIIPPTTIIOONN
     hhpprroopp takes a principal database in a specified format and converts it
     into a stream of Heimdal database records. This stream can either be
     written to standard out, or (more commonly) be propagated to a hpropd(8)
     server running on a different machine.

     If propagating, it connects to all _h_o_s_t_s specified on the command by
     opening a TCP connection to port 754 (service hprop) and sends the
     database in encrypted form.

     Supported options:

     --mm _f_i_l_e, ----mmaasstteerr--kkeeyy==_f_i_l_e
             Where to find the master key to encrypt or decrypt keys with.

     --dd _f_i_l_e, ----ddaattaabbaassee==_f_i_l_e
             The database to be propagated.

     ----ssoouurrccee==_h_e_i_m_d_a_l_|_m_i_t_-_d_u_m_p_|_k_r_b_4_-_d_u_m_p_|_k_r_b_4_-_d_b_|_k_a_s_e_r_v_e_r
             Specifies the type of the source database. Alternatives include:

                   heimdal    a Heimdal database
                   mit-dump   a MIT Kerberos 5 dump file
                   krb4-db    a Kerberos 4 database
                   krb4-dump  a Kerberos 4 dump file
                   kaserver   an AFS kaserver database

     --kk _k_e_y_t_a_b, ----kkeeyyttaabb==_k_e_y_t_a_b
             The keytab to use for fetching the key to be used for authenti-
             cating to the propagation daemon(s). The key _k_a_d_m_i_n_/_h_p_r_o_p is used
             from this keytab.  The default is to fetch the key from the KDC
             database.

     --RR _s_t_r_i_n_g, ----vv55--rreeaallmm==_s_t_r_i_n_g
             Local realm override.

     --DD, ----ddeeccrryypptt
             The encryption keys in the database can either be in clear, or
             encrypted with a master key. This option transmits the database
             with unencrypted keys.

     --EE, ----eennccrryypptt
             This option transmits the database with encrypted keys.

     --nn, ----ssttddoouutt
             Dump the database on stdout, in a format that can be fed to
             hpropd.

     The following options are only valid if hhpprroopp is compiled with support
     for Kerberos 4 (kaserver).

     --rr _s_t_r_i_n_g, ----vv44--rreeaallmm==_s_t_r_i_n_g
             v4 realm to use

     --cc _c_e_l_l, ----cceellll==_c_e_l_l
             The AFS cell name, used if reading a kaserver database.

     --SS, ----kkaassppeecciiaallss
             Also dump the principals marked as special in the kaserver
             database.

     --44, ----vv44--ddbb
             Deprecated, identical to `--source=krb4-db'.

     --KK, ----kkaa--ddbb
             Deprecated, identical to `--source=kaserver'.

EEXXAAMMPPLLEESS
     The following will propagate a database to another machine (which should
     run hpropd(8):)

           $ hprop slave-1 slave-2

     Copy a Kerberos 4 database to a Kerberos 5 slave:

           $ hprop --source=krb4-db -E krb5-slave

     Convert a Kerberos 4 dump-file for use with a Heimdal KDC:

           $ hprop -n --source=krb4-dump -d /var/kerberos/principal.dump --master-key=/.k | hpropd -n

SSEEEE AALLSSOO
     hpropd(8)

 HEIMDAL                         June 19, 2000                               2
OpenPOWER on IntegriCloud