Miscellaneous small edits to RST docs
[krb5.git] / src / man / kprop.8
1 .TH "KPROP" "8" "January 06, 2012" "0.0.1" "MIT Kerberos"
2 .SH NAME
3 kprop \- propagate a Kerberos V5 principal database to a slave server
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 \fBkprop\fP
37 .sp
38 [\fB\-r\fP \fIrealm\fP]
39 [\fB\-f\fP \fIfile\fP]
40 [\fB\-d\fP]
41 [\fB\-P\fP \fIport\fP]
42 [\fB\-s\fP \fIkeytab\fP]
43 \fIslave_host\fP
44 .UNINDENT
45 .SH DESCRIPTION
46 .sp
47 \fIkprop\fP  is used to propagate a Kerberos V5 database dump file from the master
48 Kerberos server to a slave Kerberos server, which is specified by \fIslave_host\fP.
49 This is done by transmitting the dumped database file to the slave server over
50 an encrypted, secure channel.
51 The dump file must be created by \fIkdb5_util(8)\fP.
52 .SH OPTIONS
53 .INDENT 0.0
54 .INDENT 3.5
55 .INDENT 0.0
56 .TP
57 .B \fB\-r\fP \fIrealm\fP
58 .sp
59 Specifies the realm of the master server.
60 .TP
61 .B \fB\-f\fP \fIfile\fP
62 .sp
63 Specifies the filename where the dumped principal database file is to be found;
64 by default the dumped database file is normally
65 \fI/usr/local/var/krb5kdc/slave_datatrans\fP.
66 .TP
67 .B \fB\-P\fP \fIport\fP
68 .sp
69 Specifies the port to use to contact the \fIkpropd(8)\fP server on the remote host.
70 .TP
71 .B \fB\-d\fP
72 .sp
73 Prints debugging information.
74 .TP
75 .B \fB\-s\fP \fIkeytab\fP
76 .sp
77 Specifies the location of the keytab file.
78 .UNINDENT
79 .UNINDENT
80 .UNINDENT
81 .SH ENVIRONMENT
82 .sp
83 \fIkprop\fP uses the following environment variable:
84 .INDENT 0.0
85 .INDENT 3.5
86 .INDENT 0.0
87 .IP \(bu 2
88 .
89 \fBKRB5_CONFIG\fP
90 .UNINDENT
91 .UNINDENT
92 .UNINDENT
93 .SH SEE ALSO
94 .sp
95 kpropd(8), kdb5_util(8), krb5kdc(8)
96 .SH AUTHOR
97 MIT
98 .SH COPYRIGHT
99 2011, MIT
100 .\" Generated by docutils manpage writer.
101 .