UP

Name

SMCRoute - a Static Multicast Router (Version 0.8)

Synopsis

smcroute  <options> [<command>]

Description

SMCRoute is a command line tool to manipulate the multicast routes of the Linux kernel. It can be used as an alternative to dynamic multicast routers like 'mrouted' in situations where static multicast routes should be maintained and/or no proper IGMP signaling exists.

Multicast routes in the kernel exists only as long as smcroute or another multicast routing daemon is running. Only one multicast router daemon can be active at the same time, so it's impossible to run smcroute and e.g. 'mrouted' at the same time.

With the '-d' option smcroute is started as daemon otherwise smcroute searches for an already running smcroute daemon and passes most other option (a, r, k) to it. The '-k' option will terminate a running daemon.

Multicast routes can be added with the '-a' option and removed with the  '-r' option. They can be used togehter with the '-d' option or alone. Multiple use of the '-a' and '-r' option is possible.

Options

-v    Prints copyright message at startup and gives some more  detailed error/status information to stderr.

Commands

-a <InputIntf> <OriginIpAdr> <McGroupAdr> <OutputIntf> [<OutputIntf>] ...

 

 

Adds a static routing entry for IP multicast packets to the kernel that match the following criterias:
    <InputIntf> - the interface on which the packet must be received, e.g. eth1, gre0, ...
    <OrigingIpAdr> - the IP address of the sender, e.g. 123.123.123.123
    <McGroupAdr> - the IP multicast target address of the packet, e.g. 224.12.13.14

Packet that match the criterias will be send out on all interfaces in the output interface list: <OutputIntf> [<OutputIntf>] ...
 

-d    Starts the program in daemon mode.

-h    Prints a short help message to stdout.

 

-r <InputIntf> <OriginIpAdr> <McGroupAdr> <OutputIntf> [<OutputIntf>] ...

 

 

Removes  a multicast route. Parameters are the same as for the '-a' option.

Files

/proc/net/ip_mr_cache

contains active multicast routes

/proc/net/ip_mr_vif

contains the 'virtual' interfaces used by any active multicast routing daemon

/var/lib/smcroute

IPC file created by the smcroute daemon

Bugs

?

Author

Carsten Schill (carsten@cschill.de), check http://www.cschill.de

See Also

mrouted

Thanks

Thanks to everyone who uses the program.