shorewall_code/docs/GettingStarted.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<article>
  <!--$Id$-->

  <articleinfo>
    <title>Getting Started with Shorewall</title>

    <authorgroup>
      <author>
        <firstname>Tom</firstname>

        <surname>Eastep</surname>
      </author>
    </authorgroup>

    <pubdate><?dbtimestamp format="Y/m/d"?></pubdate>

    <copyright>
      <year>2006</year>

      <holder>Thomas M. Eastep</holder>
    </copyright>

    <legalnotice>
      <para>Permission is granted to copy, distribute and/or modify this
      document under the terms of the GNU Free Documentation License, Version
      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>
    </legalnotice>
  </articleinfo>

  <section>
    <title>Getting Started</title>

    <para>If you are new to Shorewall, please read these two articles
    first.</para>

    <itemizedlist>
      <listitem>
        <para><ulink url="Introduction.html">Introduction to
        Shorewall</ulink></para>
      </listitem>

      <listitem>
        <para><ulink url="shorewall_quickstart_guide.htm">QuickStart Guides
        (HOWTOs)</ulink></para>
      </listitem>
    </itemizedlist>

    <para>The following articles are also recommended reading for
    newcomers.</para>

    <itemizedlist>
      <listitem>
        <para><ulink url="configuration_file_basics.htm">Configuration File
        Basics</ulink><blockquote>
            <para><informaltable frame="none">
                <tgroup cols="2">
                  <tbody valign="middle">
                    <row>
                      <entry><ulink
                      url="configuration_file_basics.htm#Manpages">Man
                      Pages</ulink></entry>

                      <entry><ulink
                      url="configuration_file_basics.htm#MAC">Using MAC
                      Addresses in Shorewall</ulink></entry>
                    </row>

                    <row>
                      <entry><ulink
                      url="configuration_file_basics.htm#Comments">Comments in
                      configuration files</ulink></entry>

                      <entry><ulink
                      url="configuration_file_basics.htm#Variables">Using
                      Shell Variables</ulink></entry>
                    </row>

                    <row>
                      <entry><ulink
                      url="configuration_file_basics.htm#COMMENT">Attach
                      Comment to Netfilter Rules</ulink></entry>

                      <entry><ulink
                      url="configuration_file_basics.htm#dnsnames">Using DNS
                      Names</ulink></entry>
                    </row>

                    <row>
                      <entry><ulink
                      url="configuration_file_basics.htm#Continuation">Line
                      Continuation</ulink></entry>

                      <entry><ulink
                      url="configuration_file_basics.htm#Compliment">Complementing
                      an IP address or Subnet</ulink></entry>
                    </row>

                    <row>
                      <entry><ulink
                      url="configuration_file_basics.htm#INCLUDE">INCLUDE
                      Directive</ulink></entry>

                      <entry><ulink
                      url="configuration_file_basics.htm#IPRanges">IP Address
                      Ranges</ulink></entry>
                    </row>

                    <row>
                      <entry><ulink
                      url="configuration_file_basics.htm#Ports">Port
                      Numbers/Service Names</ulink></entry>

                      <entry><ulink
                      url="configuration_file_basics.htm#Levels">Shorewall
                      Configurations (making a test
                      configuration)</ulink></entry>
                    </row>

                    <row>
                      <entry><ulink
                      url="configuration_file_basics.htm#Ranges">Port
                      Ranges</ulink></entry>

                      <entry></entry>
                    </row>
                  </tbody>
                </tgroup>
              </informaltable></para>
          </blockquote></para>
      </listitem>

      <listitem>
        <para>PPPPPPPS ( or, Paul's Principles for Practical Provision of
        Packet Processing with Shorewall ) <ulink
        url="http://linuxman.wikispaces.com/PPPPPPS">http://linuxman.wikispaces.com/PPPPPPS</ulink></para>
      </listitem>
    </itemizedlist>
  </section>
</article>