From e570d91ab1af7c835ce864d79c0ab6c16930e5cd Mon Sep 17 00:00:00 2001
From: Tom Eastep <teastep@shorewall.net>
Date: Wed, 18 Sep 2013 17:58:28 -0700
Subject: [PATCH] Document 'hostroute' and 'nohostroute'

Signed-off-by: Tom Eastep <teastep@shorewall.net>
---
 Shorewall/manpages/shorewall-providers.xml   | 33 ++++++++++++++++++++
 Shorewall6/manpages/shorewall6-providers.xml | 33 ++++++++++++++++++++
 2 files changed, 66 insertions(+)

diff --git a/Shorewall/manpages/shorewall-providers.xml b/Shorewall/manpages/shorewall-providers.xml
index 85122b4d5..37b9b966e 100644
--- a/Shorewall/manpages/shorewall-providers.xml
+++ b/Shorewall/manpages/shorewall-providers.xml
@@ -307,6 +307,39 @@
                 <option>tproxy</option> provider is allowed.</para>
               </listitem>
             </varlistentry>
+
+            <varlistentry>
+              <term><emphasis role="bold">hostroute</emphasis></term>
+
+              <listitem>
+                <para>Added in Shorewall 4.5.21. This is the default behavior
+                that results in a host route to the defined <emphasis
+                role="bold">GATEWAY</emphasis> being inserted into the main
+                routing table and into the provider's routing table. <emphasis
+                role="bold">hostroute</emphasis> is required for older
+                distributions but <emphasis role="bold">nohostroute</emphasis>
+                (below) is appropriate for recent distributions. <emphasis
+                role="bold">hostroute</emphasis> may interfere with Zebra's
+                ability to add routes on some distributions such as Debian
+                7.</para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
+              <term><emphasis role="bold">nohostroute</emphasis></term>
+
+              <listitem>
+                <para>Added in Shorewall 4.5.21. nohostroute inhibits addition
+                of a host route to the defined <emphasis
+                role="bold">GATEWAY</emphasis> being inserted into the main
+                routing table and into the provider's routing table. <emphasis
+                role="bold">nohostroute</emphasis> is not appropriate for
+                older distributions but is appropriate for recent
+                distributions. <emphasis role="bold">nohostroute</emphasis>
+                allows Zebra's to correctly add routes on some distributions
+                such as Debian 7.</para>
+              </listitem>
+            </varlistentry>
           </variablelist>
         </listitem>
       </varlistentry>
diff --git a/Shorewall6/manpages/shorewall6-providers.xml b/Shorewall6/manpages/shorewall6-providers.xml
index ee5488d5d..7f5c8323a 100644
--- a/Shorewall6/manpages/shorewall6-providers.xml
+++ b/Shorewall6/manpages/shorewall6-providers.xml
@@ -282,6 +282,39 @@
                 <option>tproxy</option> provider is allowed.</para>
               </listitem>
             </varlistentry>
+
+            <varlistentry>
+              <term><emphasis role="bold">hostroute</emphasis></term>
+
+              <listitem>
+                <para>Added in Shorewall 4.5.21. This is the default behavior
+                that results in a host route to the defined <emphasis
+                role="bold">GATEWAY</emphasis> being inserted into the main
+                routing table and into the provider's routing table. <emphasis
+                role="bold">hostroute</emphasis> is required for older
+                distributions but <emphasis role="bold">nohostroute</emphasis>
+                (below) is appropriate for recent distributions. <emphasis
+                role="bold">hostroute</emphasis> may interfere with Zebra's
+                ability to add routes on some distributions such as Debian
+                7.</para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
+              <term><emphasis role="bold">nohostroute</emphasis></term>
+
+              <listitem>
+                <para>Added in Shorewall 4.5.21. nohostroute inhibits addition
+                of a host route to the defined <emphasis
+                role="bold">GATEWAY</emphasis> being inserted into the main
+                routing table and into the provider's routing table. <emphasis
+                role="bold">nohostroute</emphasis> is not appropriate for
+                older distributions but is appropriate for recent
+                distributions. <emphasis role="bold">nohostroute</emphasis>
+                allows Zebra's to correctly add routes on some distributions
+                such as Debian 7.</para>
+              </listitem>
+            </varlistentry>
           </variablelist>
         </listitem>
       </varlistentry>