krb5 commit: Clarify kpropd standalone mode documentation

Greg Hudson ghudson at MIT.EDU
Fri Nov 1 10:56:05 EDT 2013


https://github.com/krb5/krb5/commit/bfec0671ca6df811453d46a2f47afc7168b980fc
commit bfec0671ca6df811453d46a2f47afc7168b980fc
Author: Greg Hudson <ghudson at mit.edu>
Date:   Wed Oct 30 18:22:00 2013 -0400

    Clarify kpropd standalone mode documentation
    
    The kpropd -S option is no longer needed to run kpropd in standalone
    mode, but its functionality is not deprecated; standalone mode is
    automatically activated when appropriate.  Clarify the kpropd
    documentation on standalone mode to avoid giving the impression that
    the mode is deprecated.
    
    ticket: 7751 (new)
    target_version: 1.12
    tags: pullup

 doc/admin/admin_commands/kpropd.rst |   27 ++++++++++++---------------
 1 files changed, 12 insertions(+), 15 deletions(-)

diff --git a/doc/admin/admin_commands/kpropd.rst b/doc/admin/admin_commands/kpropd.rst
index b5cebcc..0bd0a02 100644
--- a/doc/admin/admin_commands/kpropd.rst
+++ b/doc/admin/admin_commands/kpropd.rst
@@ -39,9 +39,14 @@ the ``/etc/inetd.conf`` file which looks like this:
 
     kprop  stream  tcp  nowait  root  /usr/local/sbin/kpropd  kpropd
 
-kpropd can also run as a standalone daemon.  This is required for
-incremental propagation.  But this is also useful for debugging
-purposes.
+kpropd can also run as a standalone daemon, backgrounding itself and
+waiting for connections on port 754 (or the port specified with the
+**-P** option if given).  Standalone mode is required for incremental
+propagation.  Starting in release 1.11, kpropd automatically detects
+whether it was run from inetd and runs in standalone mode if it is
+not.  Prior to release 1.11, the **-S** option is required to run
+kpropd in standalone mode; this option is now accepted for backward
+compatibility but does nothing.
 
 Incremental propagation may be enabled with the **iprop_enable**
 variable in :ref:`kdc.conf(5)`.  If incremental propagation is
@@ -75,19 +80,11 @@ OPTIONS
     program; by default the pathname used is |sbindir|\
     ``/kdb5_util``.
 
-**-S**
-    [DEPRECATED] Enable standalone mode.  Normally kpropd is invoked by
-    inetd(8) so it expects a network connection to be passed to it
-    from inetd(8).  If the **-S** option is specified, or if standard
-    input is not a socket, kpropd will put itself into the background,
-    and wait for connections on port 754 (or the port specified with the
-    **-P** option if given).
-
 **-d**
-    Turn on debug mode.  In this mode, if the **-S** option is
-    selected, kpropd will not detach itself from the current job and
-    run in the background.  Instead, it will run in the foreground and
-    print out debugging messages during the database propagation.
+    Turn on debug mode.  In this mode, kpropd will not detach
+    itself from the current job and run in the background.  Instead,
+    it will run in the foreground and print out debugging messages
+    during the database propagation.
 
 **-P**
     Allow for an alternate port number for kpropd to listen on.  This


More information about the cvs-krb5 mailing list