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