Add note about 3.2.6 and 'find_first_interface_address'

git-svn-id: https://shorewall.svn.sourceforge.net/svnroot/shorewall/trunk@8608 fbd18981-670d-0410-9b5c-8dc0c1a9a2bb
2008-07-07 20:22:09 +00:00 · 2008-07-07 20:22:09 +00:00 · 1cd0d84a16
commit 1cd0d84a16
parent 36e147f57b
32 changed files with 88 additions and 30 deletions
--- a/docs/6to4.xml
+++ b/docs/6to4.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/Accounting.xml
+++ b/docs/Accounting.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/Actions.xml
+++ b/docs/Actions.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/Anatomy.xml
+++ b/docs/Anatomy.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/Anatomy_ru.xml
+++ b/docs/Anatomy_ru.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/CompiledPrograms.xml
+++ b/docs/CompiledPrograms.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/Documentation_Index.xml
+++ b/docs/Documentation_Index.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--/$Id$-->

--- a/docs/ECN.xml
+++ b/docs/ECN.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="ECN">
  <!--$Id$-->

--- a/docs/FAQ.xml
+++ b/docs/FAQ.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

@ -611,7 +613,13 @@ DNAT       loc           loc:192.168.1.5    tcp      www         -         <emph

          <para>Using this technique, you will want to configure your
          DHCP/PPPoE/PPTP/… client to automatically restart Shorewall each
-          time that you get a new IP address.</para>
+          time that you get a new IP address.<note>
+              <para>If you are running Shorewall 3.2.6 on a Debian-based
+              system, the call to find_first_interface_address in
+              /etc/shorewall/params must be preceded with a load of the
+              Shorewall function library:<programlisting><command>. /usr/share/shorewall/functions</command>
+<command>ETH0_IP=`find_first_interface_address eth0`</command></programlisting></para>
+            </note></para>
        </listitem>
      </itemizedlist>

@ -731,6 +739,14 @@ DNAT       loc           dmz:192.168.2.4    tcp      80          -         <emph
          save</command> and <command>shorewall[-lite]
          restore</command></ulink>.</para>
        </warning>
+
+        <note>
+          <para>If you are running Shorewall 3.2.6 on a Debian-based system,
+          the call to find_first_interface_address in /etc/shorewall/params
+          must be preceded with a load of the Shorewall function
+          library:<programlisting><command>. /usr/share/shorewall/functions</command>
+<command>ETH0_IP=`find_first_interface_address eth0`</command></programlisting></para>
+        </note>
      </section>

      <section id="faq2c">
--- a/docs/FTP.xml
+++ b/docs/FTP.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="FTP">
  <!--$Id$-->

--- a/docs/GenericTunnels.xml
+++ b/docs/GenericTunnels.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="GenericTunnels">
  <!--$Id$-->

--- a/docs/GettingStarted.xml
+++ b/docs/GettingStarted.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/GnuCopyright.xml
+++ b/docs/GnuCopyright.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <appendix id="gfdl">
 <title>GNU Free Documentation License</title>
 <subtitle>Version 1.2, November 2002</subtitle>
--- a/docs/IPIP.xml
+++ b/docs/IPIP.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="IPIP">
  <!--$Id$-->

--- a/docs/IPP2P.xml
+++ b/docs/IPP2P.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

@ -229,4 +229,4 @@ SAVE:F               -             -           tcp          -              -
    <para>It will work the same and will work with a <ulink
    url="MultiISP.html">Multi-ISP setup</ulink>.</para>
  </section>
-</article>
+</article>
--- a/docs/IPSEC-2.6.xml
+++ b/docs/IPSEC-2.6.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="IPSEC">
  <!--$Id$-->

@ -1019,4 +1019,4 @@ ipip                    <emphasis role="bold">vpn</emphasis>     0.0.0.0/0</prog
    ipsec-tools source tree. It has a wide variety of sample racoon
    configuration files.</para>
  </section>
-</article>
+</article>
--- a/docs/IPSEC.xml
+++ b/docs/IPSEC.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="IPSEC">
  <!--$Id$-->

@ -438,4 +438,4 @@ ipsec       net        0.0.0.0/0       vpn1,vpn2,vpn3</programlisting>

    <programlisting>/sbin/shorewall delete ipsec0:134.28.54.2 vpn2</programlisting>
  </section>
-</article>
+</article>
--- a/docs/Install.xml
+++ b/docs/Install.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="Install">
  <!--$Id$-->

--- a/docs/Introduction.xml
+++ b/docs/Introduction.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="usefull_links">
  <!--$Id$-->

--- a/docs/KVM.xml
+++ b/docs/KVM.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

@ -93,4 +93,4 @@
    configured with the <option>routeback</option> option in <ulink
    url="manpages/shorewall-interfaces.html">shorewall-interfaces</ulink>(5).</para>
  </section>
-</article>
+</article>
--- a/docs/MAC_Validation.xml
+++ b/docs/MAC_Validation.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article id="MAC_Validation">
  <!--$Id$-->

@ -263,4 +263,4 @@ $WIFI_IF                00:1f:79:cd:fe:2e       192.168.3.6     #Work Laptop
      of the host sending the traffic.</para>
    </example>
  </section>
-</article>
+</article>
--- a/docs/Macros.xml
+++ b/docs/Macros.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article lang="en" status="">
  <!--$Id$-->

@ -640,4 +640,4 @@ bar:debug</programlisting>
      </listitem>
    </orderedlist>
  </section>
-</article>
+</article>
--- a/docs/Manpages.xml
+++ b/docs/Manpages.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id: template.xml 5908 2007-04-12 23:04:36Z teastep $-->

@ -180,4 +180,4 @@
      </simplelist>
    </blockquote>
  </section>
-</article>
+</article>
--- a/docs/ManualChains.xml
+++ b/docs/ManualChains.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

@ -207,4 +207,4 @@ DNAT-            net               loc:192.168.1.5 tcp         22            -
 PERL Knock 'net', '$FW', {name =&gt; 'SSH', knocker =&gt; 1600, trap =&gt; [1599, 1601]};
 PERL Knock 'net', 'loc:192.168.1.5', {name =&gt; 'SSH', target =&gt; 22, original_dest =&gt; '206.124.136.178'};</programlisting></para>
  </section>
-</article>
+</article>
--- a/docs/blacklisting_support.xml
+++ b/docs/blacklisting_support.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/blacklisting_support_ru.xml
+++ b/docs/blacklisting_support_ru.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id: blacklisting_support.xml 6774 2007-07-04 00:10:35Z teastep $-->

--- a/docs/bridge-Shorewall-perl.xml
+++ b/docs/bridge-Shorewall-perl.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/configuration_file_basics.xml
+++ b/docs/configuration_file_basics.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/dhcp.xml
+++ b/docs/dhcp.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/fallback.xml
+++ b/docs/fallback.xml
@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

--- a/docs/ipsets.xml
+++ b/docs/ipsets.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->

@ -214,4 +214,4 @@ dyn           eth3:+Dyn</programlisting>
    you're all set. You can add and delete addresses from Dyn without having
    to touch Shorewall.</para>
  </section>
-</article>
+</article>
--- a/docs/kernel.xml
+++ b/docs/kernel.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 <article>
  <!--$Id$-->