|SMCROUTECTL(8)||System Manager's Manual (smm)||SMCROUTECTL(8)|
||⟨help | flush | kill | reload | version⟩|
groups | routes]
||⟨add | rem⟩ IIF
SOURCE] GROUP[/LEN] OIF [
||⟨join | leave⟩ IIF [
smcroutectlis the control tool for smcrouted(8). It can be used to query status, debug, modify the kernel multicast forwarding cache (MFC), manage group interface memberships, reload
smcroute.conf, and kill a running
smcroutectloptions are available:
smcroutedinstance that runs with another identity, NAME. This option is required for both
smcroutectlwhen running multiple
smcroutedinstances, e.g., when using multiple routing tables, on Linux.
showcommand output. No ANSI control characters are used, not even for probing screen width.
smcroutectl. Use this to override the default socket path, otherwise derived from the identity,
-iNAME. This option can be useful when overriding the identity is not sufficient, e.g. for testing. The default depends on how
smcroutectlis configured at build time, see FILES.
smcroutectlcommands are the interface names, or interface wildcards of the form eth+, which matches eth0, eth10, etc. Wildcards are available for both inbound and outbound interfaces. A multicast route is defined by an input interface IIF, the sender's unicast IP address SOURCE, which is optional, the multicast group GROUP and a list of, at least one, output interface OIF [OIF ...]. Please refer to smcrouted(8) for more details on the operation and how ASM/SSM multicast works.
show groups. The following commands are available:
addIIF [SOURCE[/LEN]] GROUP[/LEN] OIF [OIF ...]
’ or ‘
’, including tunnel interfaces and loopback. Provided
ip link list
smcroutedhas "enumerated" them. See smcrouted(8), in particular the command line option
-N, and the smcroute.conf(5) ‘
’ directive. To add a (*,G) route, either omit the SOURCE argument completely, or set it to 0.0.0.0 for IPv4, and if you want to specify a range of groups, use the ‘
GROUP/LEN’ modifier, e.g. ‘
removeIIF [SOURCE[/LEN]] GROUP[/LEN] [OIF [OIF ...]]
-cSEC works in
smcrouted, this command initiates an immediate flush of all dynamically installed (*,G) multicast routes. Useful when a topology change has been detected and need to be propagated to
joinIIF [SOURCE[/LEN]] GROUP[/LEN]
leaveIIF [SOURCE[/LEN]] GROUP[/LEN]
smcroutedto exit gracefully, same as SIGTERM.
smcroutedto reload its configuration and activate the changes. Same as SIGHUP. Note, any routes or groups added or removed with
smcroutectlwill be lost. Only the configuration set in the file smcroute.conf is activated.
-doption to get details for each multicast route.
|November 28, 2021||Debian|