igmpproxy.conf - Configuration file for igmpproxy
(8) multicast daemon
contains the configuration for the igmpproxy
multicast daemon. It defines which network interfaces should be used by the
routing daemon. Each interface must be give one of the following roles:
network interface is the outgoing interface which is
responsible for communicating to availible multicast data sources. There can
only be one upstream interface.
network interfaces are the distribution interfaces to the
destination networks, where multicast clients can join groups and receive
multicast data. One or more downstream interfaces must be configured.
network interfaces all IGMP or multicast traffic is ignored
altogether. If multiple IP addresses is used on one single interface (ae.
eth0:1 ...), all interface aliases not in use should be configured as
Any line in the configuration file starting with #
is treated as a
comment. Keywords and parameters can be distributed over many lines. The
configuration file has two main keywords:
Enables quickleave mode. In this mode the
daemon will send a Leave IGMP message upstream as soon as it recieves a Leave
message for any downstream interface. The daemon will then ask for Membership
reports on the downstream interfaces, and if a report is recieved the group is
joined again upstream. Normally this is not noticed at all by clients on the
downstream networks. If it's vital that the daemon should act exactly as a
real multicast client on the upstream interface, this function should not be
used. Disabling this function increases the risk of bandwidth
phyint interface role
[ ratelimit limit
] [ altnet networkaddr ...
Defines the state and settings of a network
The name of the interface the settings are
for. This option is required for phyint settings.
The role of the interface. This should be
either upstream (only one interface), downstream (one or more
interfaces) or disabled
Defines a ratelimit for the network interface.
If ratelimit is set to 0 (default), no ratelimit will be applied. This setting
Defines the TTL threshold for the network
interface. Packets with a lower TTL than the threshols value will be ignored.
This setting is optional, and by default the threshold is 1.
Defines alternate sources for multicasting and
IGMP data. The network address must be on the following format 'a.b.c.d/n'. By
default the router will accept data from sources on the same network as
configured on an interface. If the multicast source lies on a remote network,
one must define from where traffic should be accepted.
This is especially useful for the upstream interface, since the source for
multicast traffic is often from a remote location. Any number of altnet
parameters can be specified.
## Enable quickleave quickleave
## Define settings for eth0 (upstream)
phyint eth0 upstream
## Disable alternate IP on eth0 (eth0:0)
phyint eth0:0 disabled
## Define settings for eth1 (downstream)
phyint eth1 downstream ratelimit 0 threshold 1
## Define settings for eth2 (also downstream)
phyint eth2 downstream
Originally written by Johnny Egeland <firstname.lastname@example.org>