Just in case

git-svn-id: https://shorewall.svn.sourceforge.net/svnroot/shorewall/trunk@2018 fbd18981-670d-0410-9b5c-8dc0c1a9a2bb
This commit is contained in:
teastep 2005-03-31 23:26:45 +00:00
parent e6e9fccab4
commit fc113cc51c

View File

@ -13,7 +13,7 @@
</author>
</authorgroup>
<pubdate>2004-06-30</pubdate>
<pubdate>2004-08-30</pubdate>
<copyright>
<year>2001-2004</year>
@ -27,7 +27,8 @@
1.2 or any later version published by the Free Software Foundation; with
no Invariant Sections, with no Front-Cover, and with no Back-Cover
Texts. A copy of the license is included in the section entitled
<quote><ulink url="GnuCopyright.htm">GNU Free Documentation License</ulink></quote>.</para>
<quote><ulink url="GnuCopyright.htm">GNU Free Documentation
License</ulink></quote>.</para>
</legalnotice>
</articleinfo>
@ -55,9 +56,9 @@
<listitem>
<para><emphasis role="bold">DO NOT INSTALL CORRECTED COMPONENTS ON A
RELEASE EARLIER THAN THE ONE THAT THEY ARE LISTED UNDER BELOW.</emphasis>
For example, do NOT install the 1.3.9a firewall script if you are
running 1.3.7c.</para>
RELEASE EARLIER THAN THE ONE THAT THEY ARE LISTED UNDER
BELOW.</emphasis> For example, do NOT install the 1.3.9a firewall
script if you are running 1.3.7c.</para>
</listitem>
</itemizedlist>
</caution>
@ -65,7 +66,8 @@
<section>
<title>RFC1918 File</title>
<para><ulink url="http://shorewall.net/pub/shorewall/errata/1.4.8/rfc1918">Here</ulink>
<para><ulink
url="http://shorewall.net/pub/shorewall/errata/1.4.10/rfc1918">Here</ulink>
is the most up to date version of the <ulink
url="Documentation.htm#rfc1918">rfc1918 file</ulink>.</para>
</section>
@ -87,12 +89,13 @@
</listitem>
<listitem>
<para>Shorewall fails to start if there is no <command>mktemp</command>
utility.</para>
<para>Shorewall fails to start if there is no
<command>mktemp</command> utility.</para>
</listitem>
</itemizedlist>
<para>These problems have been corrected in Shorewall version 1.4.10g.</para>
<para>These problems have been corrected in Shorewall version
1.4.10g.</para>
</section>
<section>
@ -100,18 +103,18 @@
<itemizedlist>
<listitem>
<para>Unexplained errors may occur during &#34;shorewall
[re]start&#34; when the /etc/shorewall/masq file is being processed.</para>
<para>Unexplained errors may occur during "shorewall [re]start" when
the /etc/shorewall/masq file is being processed.</para>
</listitem>
<listitem>
<para>The <emphasis role="bold">maclist</emphasis> interface option
previously wasn&#39;t available on Atheros WiFi cards.</para>
previously wasn't available on Atheros WiFi cards.</para>
</listitem>
<listitem>
<para>In the /etc/shorewall/masq entry <quote>eth0:!10.1.1.150
&#x00A0; &#x00A0;0.0.0.0/0!10.1.0.0/16 &#x00A0; &#x00A0; 10.1.2.16</quote>,
&nbsp; &nbsp;0.0.0.0/0!10.1.0.0/16 &nbsp; &nbsp; 10.1.2.16</quote>,
the <quote>!10.1.0.0/16</quote> is ignored.</para>
</listitem>
@ -122,7 +125,8 @@
<listitem>
<para>Specifying multiple excluded source zones in a REDIRECT or
DNAT rule produces a startup error. Example of problem rule:<programlisting>#ACTION SOURCE DEST PROTO DEST PORT(S)
DNAT rule produces a startup error. Example of problem
rule:<programlisting>#ACTION SOURCE DEST PROTO DEST PORT(S)
DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para>
</listitem>
@ -165,7 +169,8 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
<para>The first seven problems corrections were included in Shorewall
update 1.4.10e;</para>
<para>All problem corrections were included in Shorewall update 1.4.10f.</para>
<para>All problem corrections were included in Shorewall update
1.4.10f.</para>
</section>
<section>
@ -180,7 +185,8 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
<para>This problem has been corrected in <ulink
url="http://shorewall.net/pub/shorewall/errata/1.4.9/action.template">this
action.template file</ulink> which may be installed in /etc/shorewall.</para>
action.template file</ulink> which may be installed in
/etc/shorewall.</para>
<itemizedlist>
<listitem>
@ -191,8 +197,8 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
</listitem>
<listitem>
<para>Unexplained errors may occur during &#34;shorewall
[re]start&#34; when the /etc/shorewall/masq file is being processed.</para>
<para>Unexplained errors may occur during "shorewall [re]start" when
the /etc/shorewall/masq file is being processed.</para>
</listitem>
</itemizedlist>
@ -207,15 +213,14 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
<itemizedlist>
<listitem>
<para>When a DNAT rules specifies SNAT (e.g., when &#60;original
dest addr&#62;:&#60;SNAT addr&#62; is given in the ORIGINAL DEST
column), the SNAT specification is effectively ignored in some
cases.</para>
<para>When a DNAT rules specifies SNAT (e.g., when &lt;original dest
addr&gt;:&lt;SNAT addr&gt; is given in the ORIGINAL DEST column),
the SNAT specification is effectively ignored in some cases.</para>
</listitem>
<listitem>
<para>Unexplained errors may occur during &#34;shorewall
[re]start&#34; when the /etc/shorewall/masq file is being processed.</para>
<para>Unexplained errors may occur during "shorewall [re]start" when
the /etc/shorewall/masq file is being processed.</para>
</listitem>
</itemizedlist>
@ -232,16 +237,16 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
<listitem>
<para>Using some versions of <quote>ash</quote> (such as from RH8)
as the SHOREWALL_SHELL causes <quote>shorewall [re]start</quote> to
fail with:<programlisting> &#x00A0;&#x00A0; local: --limit: bad variable name
&#x00A0;&#x00A0; iptables v1.2.8: Couldn&#39;t load match `-j&#39;:/lib/iptables/libipt_-j.so:
&#x00A0;&#x00A0; cannot open shared object file: No such file or directory
&#x00A0;&#x00A0; Try `iptables -h&#39; or &#39;iptables --help&#39; for more information.</programlisting></para>
fail with:<programlisting> &nbsp;&nbsp; local: --limit: bad variable name
&nbsp;&nbsp; iptables v1.2.8: Couldn't load match `-j':/lib/iptables/libipt_-j.so:
&nbsp;&nbsp; cannot open shared object file: No such file or directory
&nbsp;&nbsp; Try `iptables -h' or 'iptables --help' for more information.</programlisting></para>
</listitem>
<listitem>
<para>When more than one ICMP type is listed in a rule and your
kernel includes multiport match support,&#x00A0; the firewall fails
to start.</para>
kernel includes multiport match support,&nbsp; the firewall fails to
start.</para>
</listitem>
<listitem>
@ -255,15 +260,14 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
</listitem>
<listitem>
<para>When a DNAT rules specifies SNAT (e.g., when &#60;original
dest addr&#62;:&#60;SNAT addr&#62; is given in the ORIGINAL DEST
column), the SNAT specification is effectively ignored in some
cases.</para>
<para>When a DNAT rules specifies SNAT (e.g., when &lt;original dest
addr&gt;:&lt;SNAT addr&gt; is given in the ORIGINAL DEST column),
the SNAT specification is effectively ignored in some cases.</para>
</listitem>
<listitem>
<para>Unexplained errors may occur during &#34;shorewall
[re]start&#34; when the /etc/shorewall/masq file is being processed.</para>
<para>Unexplained errors may occur during "shorewall [re]start" when
the /etc/shorewall/masq file is being processed.</para>
</listitem>
</itemizedlist>
@ -279,7 +283,7 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
<itemizedlist>
<listitem>
<para>If TC_ENABLED is set to yes in shorewall.conf then Shorewall
would fail to start with the error <quote>ERROR:&#x00A0; Traffic
would fail to start with the error <quote>ERROR:&nbsp; Traffic
Control requires Mangle</quote>; that problem has been corrected in
<ulink
url="http://shorewall.net/pub/shorewall/errata/1.4.6/firewall">this
@ -302,7 +306,7 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
versions, you will have to edit your <quote>firewall</quote> script
(in versions 1.4.*, it is located in /usr/share/shorewall/firewall).
Locate the function add_tcrule_() and in that function, replace this
line:<programlisting> &#x00A0; r=`mac_match $source`&#x00A0;</programlisting>with<programlisting> &#x00A0; &#x00A0; &#x00A0;r=&#34;`mac_match $source` &#34;</programlisting>Note
line:<programlisting> &nbsp; r=`mac_match $source`&nbsp;</programlisting>with<programlisting> &nbsp; &nbsp; &nbsp;r="`mac_match $source` "</programlisting>Note
that there must be a space before the ending quote!</para>
</listitem>
</itemizedlist>
@ -322,7 +326,7 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
</listitem>
<listitem>
<para>The INCLUDE directive doesn&#39;t work when placed in the
<para>The INCLUDE directive doesn't work when placed in the
/etc/shorewall/zones file. This problem may be corrected by
installing <ulink
url="ftp://ftp1.shorewall.net/pub/shorewall/errata/1.4.4b/functions">this
@ -338,9 +342,9 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
<listitem>
<para>Log messages are being displayed on the system console even
though the log level for the console is set properly according to
FAQ 16. This problem may be corrected by installing <ulink url="???">this
firewall script</ulink> in /usr/share/shorewall/firewall as
described above.</para>
FAQ 16. This problem may be corrected by installing <ulink
url="???">this firewall script</ulink> in
/usr/share/shorewall/firewall as described above.</para>
</listitem>
</itemizedlist>
</section>
@ -412,7 +416,8 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
<itemizedlist>
<listitem>
<para>When a <quote>shorewall check</quote> command is executed,
each <quote>rule</quote> produces the harmless additional message:<programlisting>&#x00A0; &#x00A0; &#x00A0;/usr/share/shorewall/firewall: line 2174: [: =: unary operator expected</programlisting>You
each <quote>rule</quote> produces the harmless additional
message:<programlisting>&nbsp; &nbsp; &nbsp;/usr/share/shorewall/firewall: line 2174: [: =: unary operator expected</programlisting>You
may correct the problem by installing <ulink
url="ftp://ftp.shorewall.net/pub/shorewall/errata/1.4.1/firewall">this
corrected script</ulink> in /usr/share/shorewall/firewall as
@ -449,12 +454,12 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
<para>There are a couple of serious bugs in iptables 1.2.3 that prevent it
from working with Shorewall. Regrettably, RedHat released this buggy
iptables in RedHat 7.2.&#x00A0;</para>
iptables in RedHat 7.2.&nbsp;</para>
<para>I have built a <ulink
url="ftp://ftp.shorewall.net/pub/shorewall/errata/iptables-1.2.3-3.i386.rpm">corrected
1.2.3 rpm which you can download here</ulink>&#x00A0; and I have also
built an <ulink
1.2.3 rpm which you can download here</ulink>&nbsp; and I have also built
an <ulink
url="ftp://ftp.shorewall.net/pub/shorewall/iptables-1.2.4-1.i386.rpm">iptables-1.2.4
rpm which you can download here</ulink>. If you are currently running
RedHat 7.1, you can install either of these RPMs before you upgrade to
@ -462,7 +467,8 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
<para><emphasis role="bold">Update 11/9/2001:</emphasis> RedHat has
released an iptables-1.2.4 RPM of their own which you can download from
<ulink url="http://www.redhat.com/support/errata/RHSA-2001-144.html.">http://www.redhat.com/support/errata/RHSA-2001-144.html</ulink>.I
<ulink
url="http://www.redhat.com/support/errata/RHSA-2001-144.html.">http://www.redhat.com/support/errata/RHSA-2001-144.html</ulink>.I
have installed this RPM on my firewall and it works fine.</para>
<para>If you would like to patch iptables 1.2.3 yourself, the patches are
@ -471,14 +477,14 @@ DNAT z1!z2,z3 z4:192.168.4.5 tcp 22</programlisting></para
which corrects a problem with parsing of the --log-level specification
while this <ulink
url="ftp://ftp.shorewall.net/pub/shorewall/errata/iptables-1.2.3/tos.patch">patch</ulink>
corrects a problem in handling the&#x00A0; TOS target.</para>
corrects a problem in handling the&nbsp; TOS target.</para>
<para>To install one of the above patches:<programlisting> cd iptables-1.2.3/extensions
patch -p0 &#60; the-patch-file</programlisting></para>
patch -p0 &lt; the-patch-file</programlisting></para>
</section>
<section>
<title>Problems with kernels &#62;= 2.4.18 and RedHat iptables</title>
<title>Problems with kernels &gt;= 2.4.18 and RedHat iptables</title>
<para>Users who use RedHat iptables RPMs and who upgrade to kernel
2.4.18/19 may experience the following:</para>
@ -497,10 +503,10 @@ Validating hosts file...
Determining Hosts in Zones...
Net Zone: eth0:0.0.0.0/0
iptables: libiptc/libip4tc.c:380: do_check: Assertion
`h-&#62;info.valid_hooks == (1 &#60;&#60; 0 | 1 &#60;&#60; 3)&#39; failed.
`h-&gt;info.valid_hooks == (1 &lt;&lt; 0 | 1 &lt;&lt; 3)' failed.
Aborted (core dumped)
iptables: libiptc/libip4tc.c:380: do_check: Assertion
`h-&#62;info.valid_hooks == (1 &#60;&#60; 0 | 1 &#60;&#60; 3)&#39; failed.
`h-&gt;info.valid_hooks == (1 &lt;&lt; 0 | 1 &lt;&lt; 3)' failed.
Aborted (core dumped)</programlisting>
</blockquote>
@ -511,7 +517,8 @@ Aborted (core dumped)</programlisting>
url="http://www.shorewall.net/pub/shorewall/iptables-1.2.5-1.i386.rpm">this
iptables RPM</ulink>. If you are already running a 1.2.5 version of
iptables, you will need to specify the --oldpackage option to rpm (e.g.,
<quote>iptables -Uvh --oldpackage iptables-1.2.5-1.i386.rpm</quote>).</para>
<quote>iptables -Uvh --oldpackage
iptables-1.2.5-1.i386.rpm</quote>).</para>
</section>
<section>
@ -542,8 +549,8 @@ Aborted (core dumped)</programlisting>
<para>/etc/shorewall/nat entries of the following form will result in
Shorewall being unable to start:</para>
<programlisting> #EXTERNAL&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0; INTERFACE&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0; INTERNAL&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0; ALL INTERFACES&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0;&#x00A0; LOCAL
192.0.2.22&#x00A0;&#x00A0;&#x00A0; eth0&#x00A0;&#x00A0;&#x00A0; 192.168.9.22&#x00A0;&#x00A0; yes&#x00A0;&#x00A0;&#x00A0;&#x00A0; yes
<programlisting> #EXTERNAL&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; INTERFACE&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; INTERNAL&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ALL INTERFACES&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; LOCAL
192.0.2.22&nbsp;&nbsp;&nbsp; eth0&nbsp;&nbsp;&nbsp; 192.168.9.22&nbsp;&nbsp; yes&nbsp;&nbsp;&nbsp;&nbsp; yes
#LAST LINE -- ADD YOUR ENTRIES ABOVE THIS LINE -- DO NOT REMOVE</programlisting>
<para>Error message is:</para>
@ -567,26 +574,120 @@ Aborted (core dumped)</programlisting>
--reject-with tcp-reset</quote> is broken. The symptom most commonly seen
is that REJECT rules act just like DROP rules when dealing with TCP. A
kernel patch and precompiled modules to fix this problem are available at
<ulink url="ftp://ftp1.shorewall.net/pub/shorewall/errata/kernel">ftp://ftp1.shorewall.net/pub/shorewall/errata/kernel</ulink></para>
<ulink
url="ftp://ftp1.shorewall.net/pub/shorewall/errata/kernel">ftp://ftp1.shorewall.net/pub/shorewall/errata/kernel</ulink></para>
<note>
<para>RedHat have corrected this problem in their 2.4.20-27.x kernels.</para>
<para>RedHat have corrected this problem in their 2.4.20-27.x
kernels.</para>
</note>
</section>
<appendix>
<title>Revision History4</title>
<para><revhistory><revision><revnumber>1.9</revnumber><date>2004-03-20</date><authorinitials>TE</authorinitials><revremark>Proxy
ARP/IPSEC fix.</revremark></revision><revision><revnumber>1.8</revnumber><date>2004-03-04</date><authorinitials>TE</authorinitials><revremark>Multiple
excluded zones problem..</revremark></revision><revision><revnumber>1.7</revnumber><date>2004-02-15</date><authorinitials>TE</authorinitials><revremark>TCrules
file problem..</revremark></revision><revision><revnumber>1.6</revnumber><date>2004-02-09</date><authorinitials>TE</authorinitials><revremark>Masq
file exclusion problem.</revremark></revision><revision><revnumber>1.5</revnumber><date>2004-02-05</date><authorinitials>TE</authorinitials><revremark>Startup
Problem</revremark></revision><revision><revnumber>1.4</revnumber><date>2004-01-19</date><authorinitials>TE</authorinitials><revremark>IPV6
address problems. Make RFC1918 file section more prominent.</revremark></revision><revision><revnumber>1.3</revnumber><date>2004-01-14</date><authorinitials>TE</authorinitials><revremark>Confusing
template file in 1.4.9</revremark></revision><revision><revnumber>1.3</revnumber><date>2004-01-03</date><authorinitials>TE</authorinitials><revremark>Added
note about REJECT RedHat Kernal problem being corrected.</revremark></revision><revision><revnumber>1.2</revnumber><date>2003-12-29</date><authorinitials>TE</authorinitials><revremark>Updated
RFC1918 file</revremark></revision><revision><revnumber>1.1</revnumber><date>2003-12-17</date><authorinitials>TE</authorinitials><revremark>Initial
Conversion to Docbook XML</revremark></revision></revhistory></para>
<para><revhistory>
<revision>
<revnumber>1.9</revnumber>
<date>2004-03-20</date>
<authorinitials>TE</authorinitials>
<revremark>Proxy ARP/IPSEC fix.</revremark>
</revision>
<revision>
<revnumber>1.8</revnumber>
<date>2004-03-04</date>
<authorinitials>TE</authorinitials>
<revremark>Multiple excluded zones problem..</revremark>
</revision>
<revision>
<revnumber>1.7</revnumber>
<date>2004-02-15</date>
<authorinitials>TE</authorinitials>
<revremark>TCrules file problem..</revremark>
</revision>
<revision>
<revnumber>1.6</revnumber>
<date>2004-02-09</date>
<authorinitials>TE</authorinitials>
<revremark>Masq file exclusion problem.</revremark>
</revision>
<revision>
<revnumber>1.5</revnumber>
<date>2004-02-05</date>
<authorinitials>TE</authorinitials>
<revremark>Startup Problem</revremark>
</revision>
<revision>
<revnumber>1.4</revnumber>
<date>2004-01-19</date>
<authorinitials>TE</authorinitials>
<revremark>IPV6 address problems. Make RFC1918 file section more
prominent.</revremark>
</revision>
<revision>
<revnumber>1.3</revnumber>
<date>2004-01-14</date>
<authorinitials>TE</authorinitials>
<revremark>Confusing template file in 1.4.9</revremark>
</revision>
<revision>
<revnumber>1.3</revnumber>
<date>2004-01-03</date>
<authorinitials>TE</authorinitials>
<revremark>Added note about REJECT RedHat Kernal problem being
corrected.</revremark>
</revision>
<revision>
<revnumber>1.2</revnumber>
<date>2003-12-29</date>
<authorinitials>TE</authorinitials>
<revremark>Updated RFC1918 file</revremark>
</revision>
<revision>
<revnumber>1.1</revnumber>
<date>2003-12-17</date>
<authorinitials>TE</authorinitials>
<revremark>Initial Conversion to Docbook XML</revremark>
</revision>
</revhistory></para>
</appendix>
</article>