svn rev #25070: trunk/doc/rst_source/ krb_admins/admin_commands/

[tsitkova@MIT.EDU]

http://src.mit.edu/fisheye/changelog/krb5/?cs=25070
Commit By: tsitkova
Log Message:
Added kprop document to Sphinx doc tree



Changed Files:
U   trunk/doc/rst_source/conf.py
U   trunk/doc/rst_source/krb_admins/admin_commands/index.rst
A   trunk/doc/rst_source/krb_admins/admin_commands/kprop.rst
Modified: trunk/doc/rst_source/conf.py
===================================================================
--- trunk/doc/rst_source/conf.py	2011-08-03 17:50:23 UTC (rev 25069)
+++ trunk/doc/rst_source/conf.py	2011-08-03 18:21:23 UTC (rev 25070)
@@ -226,4 +226,6 @@
     ('krb_users/user_commands/ksu', 'ksu', u'Kerberized super-user', [u'MIT'], 1),
     ('krb_admins/admin_commands/krb5kdc', 'krb5kdc', u'Kerberos V5 KDC', [u'MIT'], 8),
     ('krb_admins/admin_commands/kadmin_local', 'kadmin.local', u'Kerberos V5 database administration program', [u'MIT'], 8),
+    ('krb_admins/admin_commands/kadmin', 'kadmin', u'Kerberos V5 database administration program', [u'MIT'], 1),
+    ('krb_admins/admin_commands/kprop', 'kprop', u'propagate a Kerberos V5 principal database to a slave server', [u'MIT'], 8),
 ]

Modified: trunk/doc/rst_source/krb_admins/admin_commands/index.rst
===================================================================
--- trunk/doc/rst_source/krb_admins/admin_commands/index.rst	2011-08-03 17:50:23 UTC (rev 25069)
+++ trunk/doc/rst_source/krb_admins/admin_commands/index.rst	2011-08-03 18:21:23 UTC (rev 25070)
@@ -9,6 +9,7 @@
 
    krb5kdc.rst
    kadmin_local.rst
+   kprop.rst
 
 
 ------------

Added: trunk/doc/rst_source/krb_admins/admin_commands/kprop.rst
===================================================================
--- trunk/doc/rst_source/krb_admins/admin_commands/kprop.rst	                        (rev 0)
+++ trunk/doc/rst_source/krb_admins/admin_commands/kprop.rst	2011-08-03 18:21:23 UTC (rev 25070)
@@ -0,0 +1,46 @@
+kprop - propagate a Kerberos V5 principal database to a slave server
+=====================================================================
+
+SYNOPSIS
+-------------
+
+**kprop**
+         [**-r** *realm*] 
+         [**-f** *file*] 
+         [**-d**] 
+         [**-P** *port*] 
+         [**-s** *keytab*] 
+         *slave_host*
+
+DESCRIPTION
+-------------
+
+*kprop*  is used to propagate a Kerberos V5 database dump file from the master Kerberos server to a slave Kerberos server, 
+which is specfied by *slave_host*.  This is done by transmitting the dumped database file to the slave server over an encrypted, secure channel.   
+The dump file must be created by *kdb5_util*, and is normally *KPROP_DEFAULT_FILE* (/usr/local/var/krb5kdc/slave_datatrans).
+
+OPTIONS
+-------------
+
+       **-r** *realm*
+              Specifies the realm of the master server; by default the realm returned by krb5_default_local_realm(3) is used.
+
+       **-f** *file*
+              Specifies the filename where the dumped principal database file is to be found; by default the dumped database file is
+              *KPROP_DEFAULT_FILE* (normally /usr/local/var/krb5kdc/slave_datatrans).
+
+       **-P** *port*
+              Specifies the port to use to contact the kpropd server on the remote host.
+
+       **-d**     
+              Prints debugging information.
+
+       **-s** *keytab*
+              Specifies the location of the keytab file.
+
+
+SEE ALSO
+-------------
+
+kpropd(8), kdb5_util(8), krb5kdc(8)
+