'\" t
.\"     Title: shorewall-modules
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 06/28/2012
.\"    Manual: [FIXME: manual]
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "SHOREWALL\-MODULES" "5" "06/28/2012" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
modules \- Shorewall file
.SH "SYNOPSIS"
.HP \w'\fB/usr/share/shorewall/modules\fR\ 'u
\fB/usr/share/shorewall/modules\fR
.HP \w'\fB/usr/share/shorewall/helpers\fR\ 'u
\fB/usr/share/shorewall/helpers\fR
.SH "DESCRIPTION"
.PP
These files specify which kernel modules Shorewall will load before trying to determine your iptables/kernel\*(Aqs capabilities\&.
.PP
The
modules
file is used when LOAD_HELPERS_ONLY=No in
\m[blue]\fBshorewall\&.conf\fR\m[]\&\s-2\u[1]\d\s+2(8); the
helpers
file is used when LOAD_HELPERS_ONLY=Yes
.PP
Each record in the files has the following format:
.HP \w'\fBloadmodule\fR\ 'u
\fBloadmodule\fR \fImodulename\fR [\fImoduleoption\fR...]
.PP
The
\fImodulename\fR
names a kernel module (without suffix)\&. Shorewall will search for modules based on your MODULESDIR and MODULE_SUFFIX settings in
\m[blue]\fBshorewall\&.conf\fR\m[]\&\s-2\u[1]\d\s+2(8)\&. The
\fImoduleoption\fRs are passed to modprobe (if installed) or to insmod\&.
.PP
The /usr/share/shorewall/modules file contains a large number of modules\&. Users are encouraged to copy the file to /etc/shorewall/modules and modify the copy to load only the modules required or to use LOAD_HELPERS_ONLY=Yes\&..if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
If you build monolithic kernels and have not installed module\-init\-tools, then create an empty /etc/shorewall/modules file; that will prevent Shorewall from trying to load modules at all\&.
.sp .5v
.RE
.SH "EXAMPLE"
.PP
loadmodule ip_conntrack_ftp ports=21,221
.SH "FILES"
.PP
/usr/share/shorewall/modules
.PP
/usr/share/shorewall/helpers
.PP
/etc/shorewall/modules
.PP
/etc/shorewall/helpers
.SH "SEE ALSO"
.PP
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\-routestopped(5), shorewall\-rules(5), shorewall\&.conf(5), shorewall\-secmarks(5), shorewall\-tcclasses(5), shorewall\-tcdevices(5), shorewall\-tcrules(5), shorewall\-tos(5), shorewall\-tunnels(5), shorewall\-zones(5)
.SH "NOTES"
.IP " 1." 4
shorewall.conf
.RS 4
\%http://www.shorewall.net/manpages/shorewall.conf.html
.RE