Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
igmpproxy.conf(5)	      File Formats Manual	     igmpproxy.conf(5)

       igmpproxy.conf -	Configuration file for igmpproxy(8) multicast daemon

       igmpproxy.conf  contains	 the configuration for the igmpproxy multicast
       daemon. It defines which	network	interfaces should be used by the rout-
       ing daemon. Each	interface must be give one of the following roles: up-
       stream ,	downstream or disabled

       The upstream network interface is the outgoing interface	which  is  re-
       sponsible  for communicating to availible multicast data	sources. There
       can only	be one upstream	interface.

       Downstream network interfaces are the distribution  interfaces  to  the
       destination  networks,  where multicast clients can join	groups and re-
       ceive multicast data. One or more downstream interfaces must be config-

       On disabled 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 disabled.

       Any line	in the configuration file starting with	# is treated as	a com-
       ment.  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 mes-
	      sage 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	multi-
	      cast  client on the upstream interface, this function should not
	      be used. Disabling this function increases the risk of bandwidth

       phyint  interface  role	[ ratelimit limit ] [ threshold	ttl ] [	altnet
       networkaddr ...	]
	      Defines the state	and settings of	a network interface.

	      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

       ratelimit limit
	      Defines a	ratelimit for the network interface. If	 ratelimit  is
	      set  to  0 (default), no ratelimit will be applied. This setting
	      is optional.

       threshold ttl
	      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.

       altnet networkaddr
	      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 <>

igmpproxy 0.1						     igmpproxy.conf(5)


Want to link to this manual page? Use this URL:

home | help