.\" Automatically generated by Pandoc 3.1.3
.nh
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "firehol-server" "5" "Built 30 Mar 2024" "FireHOL Reference" "3.1.7"
.hy
.SH NAME
.PP
firehol-server - server, route commands: accept requests to a service
.SH SYNOPSIS
.PP
{ server | server46 } \f[I]service\f[R] \f[I]action\f[R]
\f[I]rule-params\f[R]
.PP
server4 \f[I]service\f[R] \f[I]action\f[R] \f[I]rule-params\f[R]
.PP
server6 \f[I]service\f[R] \f[I]action\f[R] \f[I]rule-params\f[R]
.PP
{ route | route46 } \f[I]service\f[R] \f[I]action\f[R]
\f[I]rule-params\f[R]
.PP
route4 \f[I]service\f[R] \f[I]action\f[R] \f[I]rule-params\f[R]
.PP
route6 \f[I]service\f[R] \f[I]action\f[R] \f[I]rule-params\f[R]
.SH DESCRIPTION
.PP
The \f[V]server\f[R] subcommand defines a server of a service on an
\f[V]interface\f[R] or \f[V]router\f[R].
Any \f[I]rule-params\f[R] given to a parent interface or router are
inherited by the server.
.PP
For FireHOL a server is the destination of a request.
Even though this is more complex for some multi-socket services, to
FireHOL a server always accepts requests.
.PP
The \f[V]route\f[R] subcommand is an alias for \f[V]server\f[R] which
may only be used in routers.
.PP
The \f[I]service\f[R] parameter is one of the supported service names
from firehol-services(5).
Multiple services may be specified, space delimited in quotes.
.PP
The \f[I]action\f[R] can be any of the actions listed in
firehol-actions(5).
.PP
The \f[I]rule-params\f[R] define a set of rule parameters to further
restrict the traffic that is matched to this service.
See firehol-params(5) for more details.
.RS
.PP
\f[B]Note\f[R]
.PP
Writing \f[V]server4\f[R] is equivalent to writing \f[V]ipv4 server\f[R]
and ensures this subcommand is applied only in the IPv4 firewall rules.
.PP
Writing \f[V]server6\f[R] is equivalent to writing \f[V]ipv6 server\f[R]
and ensures this subcommand is applied only in the IPv6 firewall rules.
.PP
Writing \f[V]server46\f[R] is equivalent to writing
\f[V]both server\f[R] and ensures this subcommand is applied in both the
IPv4 and IPv6 firewall rules; it cannot be used as part an interface or
router that is IPv4 or IPv6 only.
.PP
The default \f[V]server\f[R] inherits its behaviour from the enclosing
interface or router.
.PP
The same rules apply to the variations of \f[V]route\f[R].
.RE
.SH EXAMPLES
.IP
.nf
\f[C]
server smtp accept

server \[dq]smtp pop3\[dq] accept

server smtp accept src 192.0.2.1

server smtp accept log \[dq]mail packet\[dq] src 192.0.2.1
\f[R]
.fi
.SH SEE ALSO
.IP \[bu] 2
firehol(1) - FireHOL program
.IP \[bu] 2
firehol.conf(5) - FireHOL configuration
.IP \[bu] 2
firehol-modifiers(5) - ipv4/ipv6 selection
.IP \[bu] 2
firehol-services(5) - services list
.IP \[bu] 2
firehol-actions(5) - actions for rules
.IP \[bu] 2
firehol-params(5) - optional rule parameters
.IP \[bu] 2
firehol-client(5) - client subcommand
.IP \[bu] 2
firehol-interface(5) - interface definition
.IP \[bu] 2
firehol-router(5) - router definition
.IP \[bu] 2
FireHOL Website (http://firehol.org/)
.IP \[bu] 2
FireHOL Online PDF Manual (http://firehol.org/firehol-manual.pdf)
.IP \[bu] 2
FireHOL Online Documentation (http://firehol.org/documentation/)
.SH AUTHORS
FireHOL Team.