NAME

       igmpproxy - Multicast router utilizing IGMP forwarding

SYNOPSIS

       igmpproxy [-h] [-n] [-d] [-v [-v]] config-file

DESCRIPTION

       igmpproxy  is  a simple multicast routing daemon which uses IGMP forwarding to dynamically
       route multicast traffic. Routing is done by defining an "upstream" interface on which  the
       daemon  act  as  a  normal  Multicast client, and one or more "downstream" interfaces that
       serves clients on the destination networks. This  is  useful  in  situations  where  other
       dynamic multicast routers (like 'mrouted' or 'pimd') cannot be used.

       Since  igmpproxy only uses IGMP signalling, the daemon is only suited for situations where
       multicast traffic comes from only one  neighbouring  network.   In  more  advanced  cases,
       'mrouted'  or  'pimd'  is probably more suited.  The daemon is not designed for cascading,
       and probably won't scale very well.

       Currently only IGMPv1 and v2 is supported  on  downstream  interfaces.   On  the  upstream
       interface  the  kernel  IGMP client implementation is used, and supported IGMP versions is
       therefore limited to that supported by the kernel.

OPTIONS

       -h     Display help.

       -v     Verbose logging. Set logging level to INFO instead of WARNING used by default.

       -vv    More verbose logging. Set logging level to DEBUG.

       -n     Do not run as a daemon.

       -d     Output log messages to STDERR instead of to syslog(3).  Implies -n.

LIMITS

       The current version compiles and runs fine with the Linux kernel version  2.4.  The  known
       limits are:

       Multicast routes: more then 200

       Multicast group membership: max. 20

FILES

       /proc/net/ip_mr_cache
              - contains the active multicast routes

       /proc/net/ip_mr_vif
              - contains the 'virtual' interfaces used by the active multicast routing daemon

       /proc/sys/net/ipv4/conf/<ifname>/force_igmp_version
              -  can  be  set  to control what IGMP version the kernel should use on the upstream
              interface.  Ex.: 'echo 2  >  /proc/sys/net/ipv4/conf/eth0/force_igmp_version'  will
              force the kernel to use IGMPv2 on eth0 (provided this is the upstream interface).

SEE ALSO

       igmpproxy.conf(5), mrouted, pimd, smcroute

BUGS

       Currently none (but there probably will be :-/ )

AUTHOR

       Originally written by Johnny Egeland <johnny@rlo.org>.