mirror of
https://gitlab.com/shorewall/code.git
synced 2024-11-09 01:04:06 +01:00
175 lines
7.1 KiB
XML
175 lines
7.1 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
||
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
|
||
<refentry>
|
||
<refmeta>
|
||
<refentrytitle>shorewall-stoppedrules</refentrytitle>
|
||
|
||
<manvolnum>5</manvolnum>
|
||
|
||
<refmiscinfo>Configuration Files</refmiscinfo>
|
||
</refmeta>
|
||
|
||
<refnamediv>
|
||
<refname>stoppedrules</refname>
|
||
|
||
<refpurpose>The Shorewall file that governs what traffic flows through the
|
||
firewall while it is in the 'stopped' state.</refpurpose>
|
||
</refnamediv>
|
||
|
||
<refsynopsisdiv>
|
||
<cmdsynopsis>
|
||
<command>/etc/shorewall/stoppedrules</command>
|
||
</cmdsynopsis>
|
||
</refsynopsisdiv>
|
||
|
||
<refsect1>
|
||
<title>Description</title>
|
||
|
||
<para>This file is used to define the hosts that are accessible when the
|
||
firewall is stopped or is being stopped.</para>
|
||
|
||
<warning>
|
||
<para>Changes to this file do not take effect until after the next
|
||
<command>shorewall start</command>, <command>shorewall reload</command>,
|
||
<command>shorewall restart</command>, or <option>shorewall
|
||
compile</option> command.</para>
|
||
</warning>
|
||
|
||
<para>The columns in the file are as follows (where the column name is
|
||
followed by a different name in parentheses, the different name is used in
|
||
the alternate specification syntax).</para>
|
||
|
||
<variablelist>
|
||
<varlistentry>
|
||
<term><emphasis role="bold">ACTION</emphasis> -
|
||
<option>ACCEPT|NOTRACK|DROP</option></term>
|
||
|
||
<listitem>
|
||
<para>Determines the disposition of the packet.</para>
|
||
|
||
<para><option>ACCEPT</option> means that the packet will be
|
||
accepted.</para>
|
||
|
||
<para><option>NOTRACK</option> indicates that no conntrack entry
|
||
should be created for the packet. <option>NOTRACK</option> does not
|
||
imply <option>ACCEPT</option>.</para>
|
||
|
||
<para><option>DROP</option> was added in Shorewall 4.6.0 and causes
|
||
the packet to be dropped in the raw table's PREROUTING chain.</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
|
||
<varlistentry>
|
||
<term><emphasis role="bold">SOURCE</emphasis> - [<emphasis
|
||
role="bold">-</emphasis>|[$FW|<replaceable>interface</replaceable>]|[{$FW|interface}[<emphasis>:address</emphasis>[,<emphasis>address</emphasis>]...]]|[<emphasis>address</emphasis>[,<emphasis>address</emphasis>]...]</term>
|
||
|
||
<listitem>
|
||
<para><option>$FW</option> matches packets originating on the
|
||
firewall itself, while <replaceable>interface</replaceable>
|
||
specifies packets arriving on the named interface.</para>
|
||
|
||
<para>This column may also include a comma-separated list of
|
||
IP/subnet addresses. If your kernel and iptables include iprange
|
||
match support, IP address ranges are also allowed. Ipsets and
|
||
exclusion are also supported. When <option>$FW</option> or interface
|
||
are specified, the list must be preceded by a colon (":").</para>
|
||
|
||
<para>If left empty or supplied as "-", 0.0.0.0/0 is assumed.</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
|
||
<varlistentry>
|
||
<term><emphasis role="bold">DEST</emphasis> - [<emphasis
|
||
role="bold">-</emphasis>|[$FW|<replaceable>interface</replaceable>]|[{$FW|interface}[<emphasis>:address</emphasis>[,<emphasis>address</emphasis>]...]]|[<emphasis>address</emphasis>[,<emphasis>address</emphasis>]...]</term>
|
||
|
||
<listitem>
|
||
<para><option>$FW</option> matches packets addressed the firewall
|
||
itself, while <replaceable>interface</replaceable> specifies packets
|
||
arriving on the named interface. Neither may be specified if the
|
||
target is <option>NOTRACK</option> or <option>DROP</option>.</para>
|
||
|
||
<para>This column may also include a comma-separated list of
|
||
IP/subnet addresses. If your kernel and iptables include iprange
|
||
match support, IP address ranges are also allowed. Ipsets and
|
||
exclusion are also supported. When <option>$FW</option> or interface
|
||
are specified, the list must be preceded by a colon (":").</para>
|
||
|
||
<para>If left empty or supplied as "-", 0.0.0.0/0 is assumed.</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
|
||
<varlistentry>
|
||
<term><emphasis role="bold">PROTO (Optional)</emphasis> ‒
|
||
<replaceable>protocol-name-or-number</replaceable>[,...]</term>
|
||
|
||
<listitem>
|
||
<para>Protocol.</para>
|
||
|
||
<para>Beginning with Shorewall 4.5.12, this column can accept a
|
||
comma-separated list of protocols.</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
|
||
<varlistentry>
|
||
<term><emphasis role="bold">DEST PORT(S) (dport)</emphasis> ‒
|
||
<replaceable>service-name/port-number-list</replaceable></term>
|
||
|
||
<listitem>
|
||
<para>Optional. A comma-separated list of port numbers and/or
|
||
service names from <filename>/etc/services</filename>. May also
|
||
include port ranges of the form
|
||
<replaceable>low-port</replaceable>:<replaceable>high-port</replaceable>
|
||
if your kernel and iptables include port range support.</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
|
||
<varlistentry>
|
||
<term><emphasis role="bold">SOURCE PORT(S) (sport)</emphasis> ‒
|
||
<replaceable>service-name/port-number-list</replaceable></term>
|
||
|
||
<listitem>
|
||
<para>Optional. A comma-separated list of port numbers and/or
|
||
service names from <filename>/etc/services</filename>. May also
|
||
include port ranges of the form
|
||
<replaceable>low-port</replaceable>:<replaceable>high-port</replaceable>
|
||
if your kernel and iptables include port range support.</para>
|
||
|
||
<para>Beginning with Shorewall 4.5.15, you may place '=' in this
|
||
column, provided that the DEST PORT(S) column is non-empty. This
|
||
causes the rule to match when either the source port or the
|
||
destination port in a packet matches one of the ports specified in
|
||
DEST PORTS(S). Use of '=' requires multi-port match in your iptables
|
||
and kernel.</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
</refsect1>
|
||
|
||
<refsect1>
|
||
<title>FILES</title>
|
||
|
||
<para>/etc/shorewall/stoppedrules</para>
|
||
</refsect1>
|
||
|
||
<refsect1>
|
||
<title>See ALSO</title>
|
||
|
||
<para><ulink
|
||
url="/starting_and_stopping_shorewall.htm">http://www.shorewall.net/starting_and_stopping_shorewall.htm</ulink></para>
|
||
|
||
<para><ulink
|
||
url="/configuration_file_basics.htm#Pairs">http://www.shorewall.net/configuration_file_basics.htm#Pairs</ulink></para>
|
||
|
||
<para>shorewall(8), shorewall-accounting(5), shorewall-actions(5),
|
||
shorewall-blacklist(5), shorewall-hosts(5), shorewall_interfaces(5),
|
||
shorewall-ipsets(5), shorewall-maclist(5), shorewall-masq(5),
|
||
shorewall-nat(5), shorewall-netmap(5), shorewall-params(5),
|
||
shorewall-policy(5), shorewall-providers(5), shorewall-proxyarp(5),
|
||
shorewall-rtrules(5), shorewall-rules(5), shorewall.conf(5),
|
||
shorewall-secmarks(5), shorewall-tcclasses(5), shorewall-tcdevices(5),
|
||
shorewall-mangle(5), shorewall-tos(5), shorewall-tunnels(5),
|
||
shorewall-zones(5)</para>
|
||
</refsect1>
|
||
</refentry>
|