<?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>shorewall6-modules</refentrytitle>

    <manvolnum>5</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>modules</refname>

    <refpurpose>shorewall6 file</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>/usr/share/shorewall6/modules</command>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>/usr/share/shorewall6/helpers</command>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <para>These files specify which kernel modules shorewall6 will load before
    trying to determine your ip6tables/kernel's capabilities. The
    <filename>modules</filename> file is used when LOAD_HELPERS_ONLY=No in
    <ulink url="shorewall6.conf.html">shorewall6.conf</ulink>(8); the
    <filename>helpers</filename> file is used when
    LOAD_HELPERS_ONLY=Yes.</para>

    <para>Each record in the files has the following format:</para>

    <cmdsynopsis>
      <command>loadmodule</command>

      <arg choice="plain"><replaceable
      class="parameter">modulename</replaceable></arg>

      <arg rep="repeat"><replaceable>moduleoption</replaceable></arg>
    </cmdsynopsis>

    <para>The <replaceable>modulename</replaceable> names a kernel module
    (without suffix). shorewall6 will search for modules based on your
    MODULESDIR and MODULE_SUFFIX settings in <ulink
    url="shorewall6.conf.html">shorewall6.conf</ulink>(8). The
    <replaceable>moduleoption</replaceable>s are passed to modprobe (if
    installed) or to insmod.</para>

    <para>The /usr/share/shorewall6/modules file contains a large number of
    modules. Users are encouraged to copy the file to /etc/shorewall6/modules
    and modify the copy to load only the modules required or use
    LOAD_HELPERS_ONLY=Yes.<note>
        <para>If you build monolithic kernels and have not installed
        module-init-tools, then create an empty /etc/shorewall6/modules file;
        that will prevent shorewall6 from trying to load modules at
        all.</para>
      </note></para>
  </refsect1>

  <refsect1>
    <title>Example</title>

    <para>loadmodule ip_conntrack_ftp ports=21,221</para>
  </refsect1>

  <refsect1>
    <title>FILES</title>

    <para>/usr/share/shorewall6/modules</para>

    <para>/usr/share/shorewall6/helpers</para>

    <para>/etc/shorewall6/modules</para>

    <para>/etc/shorewall6/helpers</para>
  </refsect1>

  <refsect1>
    <title>See ALSO</title>

    <para>shorewall6(8), shorewall6-accounting(5), shorewall6-actions(5),
    shorewall6-blacklist(5), shorewall6-hosts(5), shorewall6-interfaces(5),
    shorewall6-maclist(5), shorewall6-params(5), shorewall6-policy(5),
    shorewall6-providers(5), shorewall6-route_rules(5),
    shorewall6-routestopped(5), shorewall6-rules(5), shorewall6.conf(5),
    shorewall6-secmarks(5), shorewall6-tcclasses(5), shorewall6-tcdevices(5),
    shorewall6-tcrules(5), shorewall6-tos(5), shorewall6-tunnels(5),
    shorewall6-zones(5)</para>
  </refsect1>
</refentry>
