Blame SOURCES/Clarify-debug-and-debug_level-in-man-pages.patch

e8d79a
From d71d354f1020a7deac57f26cc7c2cafb3fa675a3 Mon Sep 17 00:00:00 2001
e8d79a
From: Robbie Harwood <rharwood@redhat.com>
e8d79a
Date: Wed, 11 Apr 2018 16:01:21 -0400
e8d79a
Subject: [PATCH] Clarify debug and debug_level in man pages
e8d79a
e8d79a
In particular, add debug_level to gssproxy(5) since it was previously
e8d79a
accepted but not documented.
e8d79a
e8d79a
Signed-off-by: Robbie Harwood <rharwood@redhat.com>
e8d79a
Reviewed-by: Simo Sorce <simo@redhat.com>
e8d79a
Merges: #229
e8d79a
(cherry picked from commit e0e96e46be03102903533a9816b4deefe1adfaf8)
e8d79a
---
e8d79a
 man/gssproxy.8.xml      | 24 +++++++++++++++++++++++-
e8d79a
 man/gssproxy.conf.5.xml |  5 ++++-
e8d79a
 2 files changed, 27 insertions(+), 2 deletions(-)
e8d79a
e8d79a
diff --git a/man/gssproxy.8.xml b/man/gssproxy.8.xml
e8d79a
index 1df4b0d..21f7e6a 100644
e8d79a
--- a/man/gssproxy.8.xml
e8d79a
+++ b/man/gssproxy.8.xml
e8d79a
@@ -118,13 +118,35 @@
e8d79a
                     </para>
e8d79a
                 </listitem>
e8d79a
             </varlistentry>
e8d79a
+
e8d79a
             <varlistentry>
e8d79a
                 <term>
e8d79a
                     <option>-d</option>,<option>--debug</option>
e8d79a
                 </term>
e8d79a
                 <listitem>
e8d79a
                     <para>
e8d79a
-                        Turn on debugging.
e8d79a
+                        Turn on debugging.  This option is identical to
e8d79a
+                        --debug-level=1.
e8d79a
+                    </para>
e8d79a
+                </listitem>
e8d79a
+            </varlistentry>
e8d79a
+
e8d79a
+            <varlistentry>
e8d79a
+                <term>
e8d79a
+                    <option>--debug-level=</option>
e8d79a
+                </term>
e8d79a
+                <listitem>
e8d79a
+                    <para>
e8d79a
+                        Turn on debugging at the specified level.  0
e8d79a
+                        corresponds to no logging, while 1 turns on basic
e8d79a
+                        debug logging.  Level 2 increases verbosity, including
e8d79a
+                        more detailed credential verification.
e8d79a
+                    </para>
e8d79a
+                    <para>
e8d79a
+                        At level 3 and above, KRB5_TRACE output is logged.  If
e8d79a
+                        KRB5_TRACE was already set in the execution
e8d79a
+                        environment, trace output is sent to its value
e8d79a
+                        instead.
e8d79a
                     </para>
e8d79a
                 </listitem>
e8d79a
             </varlistentry>
e8d79a
diff --git a/man/gssproxy.conf.5.xml b/man/gssproxy.conf.5.xml
e8d79a
index de846b4..21c9653 100644
e8d79a
--- a/man/gssproxy.conf.5.xml
e8d79a
+++ b/man/gssproxy.conf.5.xml
e8d79a
@@ -192,7 +192,10 @@
e8d79a
                 <varlistentry>
e8d79a
                     <term>debug (boolean)</term>
e8d79a
                     <listitem>
e8d79a
-                        <para>Enable debugging to syslog.</para>
e8d79a
+                        <para>
e8d79a
+                            Enable debugging to syslog.  Setting to true is
e8d79a
+                            identical to setting debug_level to 1.
e8d79a
+                        </para>
e8d79a
                         <para>Default: debug = false</para>
e8d79a
                     </listitem>
e8d79a
                 </varlistentry>