Skip to content

Commit 0853285

Browse files
committed
doc: add section on static mutlicast filters
Fixes #790 Signed-off-by: Joachim Wiberg <troglobit@gmail.com>
1 parent 7841256 commit 0853285

1 file changed

Lines changed: 42 additions & 0 deletions

File tree

doc/bridging.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -183,6 +183,48 @@ In this setup we have a lot more going on. Multiple multicast router
183183
ports have been detected, and behind the scenes someone has also added
184184
an IGMP/MLD fast-leave port.
185185

186+
### Static Multicast Filters
187+
188+
When IGMP/MLD snooping is in use, traffic for an unregistered group is
189+
flooded to all ports until a receiver joins. For MAC multicast groups,
190+
or for groups where snooping cannot learn membership automatically, you
191+
can add static entries to the MDB that immediately restrict forwarding
192+
to a given set of ports.
193+
194+
> [!NOTE]
195+
> Snooping must be enabled on the bridge (or per VLAN) before static
196+
> multicast filters can be configured.
197+
198+
On a plain (non-VLAN) bridge, add a static IPv4 or MAC multicast filter
199+
like this:
200+
201+
<pre class="cli"><code>admin@example:/> <b>configure</b>
202+
admin@example:/config/> <b>edit interface br0</b>
203+
admin@example:/config/interface/br0/> <b>set bridge multicast-filters multicast-filter 224.1.1.1 ports e2</b>
204+
admin@example:/config/interface/br0/> <b>set bridge multicast-filters multicast-filter 224.1.1.1 ports e3</b>
205+
admin@example:/config/interface/br0/> <b>set bridge multicast-filters multicast-filter 01:00:5e:01:01:01 ports e2</b>
206+
admin@example:/config/interface/br0/> <b>leave</b>
207+
admin@example:/> <b>copy running-config startup-config</b>
208+
</code></pre>
209+
210+
Each `ports` entry for the same group adds one port to the filter.
211+
Receivers on all other ports will not see traffic for that group.
212+
213+
On a VLAN-filtering bridge the filter is scoped per VLAN:
214+
215+
<pre class="cli"><code>admin@example:/config/interface/br1/> <b>set bridge vlans vlan 10 multicast-filters multicast-filter 224.2.2.2 ports e5</b>
216+
admin@example:/config/interface/br1/> <b>set bridge vlans vlan 10 multicast-filters multicast-filter 224.2.2.2 ports e6</b>
217+
</code></pre>
218+
219+
To verify the MDB — both statically configured and dynamically learned
220+
entries — use:
221+
222+
<pre class="cli"><code>admin@example:/> <b>show bridge mdb</b>
223+
<span class="header">BRIDGE VID GROUP PORTS </span>
224+
br0 224.1.1.1 e2, e3
225+
br0 01:00:5e:01:01:01 e2
226+
</code></pre>
227+
186228
### Terminology & Abbreviations
187229

188230
- **IGMP**: Internet Group Membership Protocol, multicast subscription

0 commit comments

Comments
 (0)