HomeFreeBSD

pf: Document broadcast/multicast forwarding through route-to

Description

pf: Document broadcast/multicast forwarding through route-to

pf_route() and pf_route6() forward broadcast and multicast traffic
when a route-to rule matches, without any check against the output
interface's broadcast domain. This is a deliberate property of the
route option code path, but it is not documented and the workaround
is non-obvious.

Document the behavior in pf.conf(5) with example block-out rules on
the target interface, scoped with the received-on qualifier so that
only forwarded traffic is dropped while the router's own broadcast
and multicast traffic continues to pass.

Add regression tests covering the full broadcast/multicast and
forwarded/local matrix on both IPv4 and IPv6.

Reviewed by: glebius, kp
Approved by: kp (mentor)
MFC after: 1 week
Sponsored by: Rubicon Communications, LLC ("Netgate")
Differential Revision: https://reviews.freebsd.org/D56559

Details

Provenance
rcmAuthored on Apr 23 2026, 6:52 PM
Reviewer
glebius
Differential Revision
D56559: pf: Document broadcast/multicast forwarding through route-to
Parents
rGaad4fec5d7e2: ctld: Move the pidfile handle out to a global variable
Branches
Unknown
Tags
Unknown