Table Of Contents
Multicast Routing and Forwarding Commands on Cisco IOS XR Software
clear mfib hardware resource-counters
clear mfib hardware route statistics
show mfib hardware api-counter
show mfib hardware resource-counters
show mfib hardware route accept-bitmap
show mfib hardware route egress
show mfib hardware route ingress
show mfib hardware route location
show mfib hardware route olist
show mfib hardware route statistics
show mfib hardware route summary
show mfib hardware session-info
Multicast Routing and Forwarding Commands on Cisco IOS XR Software
This chapter describes the commands used to configure and monitor multicast routing on Cisco IOS XR software.
For detailed information about multicast routing concepts, configuration tasks, and examples, refer to the Implementing Multicast Routing on Cisco IOS XR Software configuration module in Cisco IOS XR Multicast Configuration Guide.
address-family (multicast)
To display available IP prefixes to enable multicast routing and forwarding on all router interfaces, use the address-family command in multicast-routing configuration mode or multicast VRF configuration submode. To disable use of an IP address prefix for routing, use the no form of this command.
address-family {ipv4 | ipv6}
no address-family {ipv4 | ipv6}
Syntax Description
Defaults
No default.
Command Modes
Multicast-routing configuration
Multicast VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the address-family command either from multicast routing configuration mode or from multicast VRF configuration submode to enter either the multicast ipv4 or ipv6 address family configuration submode, depending on which keyword was chosen.
Use the address-family command with the multicast-routing command to start the following multicast processes:
•
Multicast Routing Information Base (MRIB)
•
•
•
To enable multicast routing and protocols on interfaces, you must explicitly enable the interfaces using the interface command in multicast routing configuration mode. This action can be performed on individual interfaces or by configuring a wildcard interface using the alias command.
To enable multicast routing on all interfaces, use the interface all enable command in multicast routing configuration mode. For any interface to be fully enabled for multicast routing, it must be enabled specifically (or configured through the interface all enable command for all interfaces) in multicast routing configuration mode, and it must not be disabled in the PIM and IGMP configuration modes.
Note
To allow multicast forwarding functionality, while turning multicast routing functionality off, interface-inheritance disable command on a per interface or interface all enable basis in PIM or IGMP configuration mode.
Task ID
Examples
The following example shows how to enter IPv6 multicast routing configuration mode:
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# address-family ipv6RP/0/RP0/CPU0:router(config-mcast-default-ipv6)#The following example shows how to enter IPv6 VRF multicast routing configuration submode when address-family from multicast VRF configuration configuration mode:
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# vrf vrf-name address-family ipv6RP/0/RP0/CPU0:router(config-mcast-vrf-name-ipv6)#Related Commands
accounting per-prefix
To enable accounting for multicast routing, use the accounting per-prefix command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
accounting per-prefix
no accounting per-prefix
Syntax Description
This command has no arguments or keywords.
Defaults
This feature is disabled by default.
Command Modes
Multicast routing configuration
Multicast VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The accounting per-prefix command is used to enable per-prefix counters only in hardware. Cisco IOS XR software counters are always present. When enabled, every existing and new (S, G) route is assigned forward, punt, and drop counters on the ingress route and forward and punt counters on the egress route. The (*, G) routes are assigned a single counter.
There are a limited number of counters on all nodes. When a command is enabled, counters are assigned to routes only if they are available.
To display packet statistics, use the show route and the show mfib hardware route statistics commands. These commands display "N/A" for counters when no hardware statistics are available or when the accounting per-prefix command is disabled.
Task ID
Examples
The following example shows how to enable accounting for multicast routing:
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# accounting per-prefixRelated Commands
Displays platform-specific MFIB information for the packet and byte counters for each route.
Displays entries in the MFIB table.
boundary
To configure the multicast boundary on an interface for administratively scoped multicast addresses, use the boundary command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
boundary access-list
no boundary access-list
Syntax Description
access-list
Access list specifying scoped multicast groups. The name cannot contain a space or quotation mark; it may contain numbers.
Defaults
A multicast boundary is not configured.
Command Modes
Multicast routing interface configuration
Multicast VRF interface configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The boundary command is used to set up a boundary to keep multicast packets from being forwarded.
Task ID
Examples
The following example shows how to set up a boundary for all administratively scoped addresses:
RP/0/RP0/CPU0:router# access-list 1 deny 239.0.0.0 0.255.255.255RP/0/RP0/CPU0:router# access-list 1 permit 224.0.0.0 15.255.255.255RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# interface pos 0/2/0/2RP/0/RP0/CPU0:router(config-mcast-default-ipv4-if)# boundary 1clear mfib counter
To clear Multicast Forwarding Information Base (MFIB) route packet counters, use the clear mfib counter command in EXEC mode.
clear mfib [vrf vrf-name] [ipv4 | ipv6] counter [group-address | source-address | signal] [location {node-id | all}]
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear MFIB route packet counters on all nodes:
RP/0/RP0/CPU0:router# clear mfib counter location allclear mfib database
To clear the Multicast Forwarding Information Base (MFIB) database, use the clear mfib database command in EXEC mode.
clear mfib [ipv4 | ipv6] database {location {node-id | all}}
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to clear the Multicast Forwarding Information Base (MFIB) database on all nodes:
RP/0/RP0/CPU0:router# clear mfib database location allclear mfib hardware resource-counters
To clear global resource counters, use the clear mfib hardware resource-counters command in EXEC mode.
clear mfib [vrf vrf-name] [ipv4 | ipv6] hardware resource-counters {location {node-id | all}}
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the clear mfib hardware resource-counters to estimate resource usage for an operation.
Task ID
Examples
The following example shows how to clear all global resource counters:
RP/0/RP0/CPU0:router# clear mfib hardware resource-counters location allRelated Commands
Displays platform-specific MFIB information for the packets and bytes counters for each route.
clear mfib hardware route statistics
To clear Multicast Forwarding Information Base (MFIB) hardware statistics, use the clear mfib hardware route statistics command in EXEC mode.
clear mfib [vrf vrf-name] [ipv4 | ipv6] hardware route statistics {egress | ingress | ingress-and-egress} [* | source-address] [group-address [/prefix-length]] {location {node-id | all}}
Syntax Description
Defaults
If not specified, IPv4 addressing is the default.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The Multicast Forwarding (MFWD) process exists on each line card and assigns hardware counters to each (S, G) route. Additionally, one global counter is assigned for all (*, G) routes, depending on resource availability.
To clear the set of counters for (*, G) routes, the MFWD process assigns a single set of counters to count packets that match (*, G) routes. Consequently, the clear mfib hardware route statistics command must be used in a form that either clears counters on all routes or matches all (*, G) routes.
Task ID
Examples
The following command shows how to clear counters by route statistics for all multicast routes on both ingress and egress forwarding engines for the line card 0/1/CPU0:
RP/0/RP0/CPU0:router# clear mfib ipv4 hardware route statistics ingress-and-egress location 0/1/CPU0The following example shows how to clear the counters only on the ingress forwarding engine for (S, G) routes with the group address 224.1.1.1:
RP/0/RP0/CPU0:router# clear mfib hardware route statistics ingress 224.1.1.1 location 0/1/CPU0
Note
Related Commands
Displays platform-specific MFIB information for the packet and byte counters for each route.
disable (multicast)
To disable multicast routing and forwarding on an interface, use the disable command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
disable
no disable
Syntax Description
This command has no arguments or keywords.
Defaults
Multicast routing and forwarding settings are inherited from the global interface enable all command. Otherwise, multicast routing and forwarding is disabled.
Command Modes
Multicast routing interface configuration
Multicast VRF interface configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The disable command modifies the behavior of a specific interface to disabled. This command is useful if you want to disable multicast routing on specific interfaces, but leave it enabled on all remaining interfaces.
The following guidelines apply when the enable and disable commands (and the no forms) are used in conjunction with the interface all enable command:
•
–
–
–
•
–
–
–
Task ID
Examples
The following example shows how to enable multicast routing on all interfaces and disable the feature only on Packet-over-SONET/SDH (POS) interface 0/1/0/0:
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# interface all enableRP/0/RP0/CPU0:router(config-mcast-default-ipv4)# interface pos 0/1/0/0RP/0/RP0/CPU0:router(config-mcast-default-ipv4-if)# disableRelated Commands
Enables multicast routing and forwarding on an interface.
Enables multicast routing and forwarding on all new and existing interfaces.
enable
To enable multicast routing and forwarding on an interface, use the enable command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
enable
no enable
Syntax Description
This command has no arguments or keywords.
Defaults
Multicast routing and forwarding settings are inherited from the global interface enable all command. Otherwise, multicast routing and forwarding is disabled.
Command Modes
Multicast routing interface configuration
Multicast VRF interface configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The enable command modifies the behavior of a specific interface to enabled. This command is useful if you want to enable multicast routing on specific interfaces, but leave it disabled on all remaining interfaces.
The following guidelines apply when the enable and disable commands (and the no forms) are used in conjunction with the interface all enable command:
•
–
–
–
•
–
–
–
Task ID
Examples
The following example shows how to enable multicast routing on a specific interface only:
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# interface pos 0/1/0/0RP/0/RP0/CPU0:router(config-mcast-default-ipv4-if)# enableRelated Commands
Disables multicast routing and forwarding on an interface.
Enables multicast routing and forwarding on all new and existing interfaces.
interface (multicast)
To configure multicast interface properties, use the interface command in the appropriate configuration mode. To disable multicast routing for interfaces, use the no form of this command.
interface type instance
no interface type instance
Syntax Description
Defaults
No default behavior or values
Command Modes
Multicast routing configuration
Multicast VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the interface command to configure multicast routing properties for specific interfaces.
Task ID
Examples
The following example shows how to enable multicast routing on all interfaces and disable the feature only on Packet-over-SONET/SDH (POS) interface 0/1/0/0:
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# interface all enableRP/0/RP0/CPU0:router(config-mcast)# interface pos 0/1/0/0RP/0/RP0/CPU0:router(config-mcast-default-ipv4-if)# disableRelated Commands
interface all enable
To enable multicast routing and forwarding on all new and existing interfaces, use the interface all enable command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
interface all enable
no interface all enable
Syntax Description
This command has no arguments or keywords.
Defaults
Multicast routing and forwarding is disabled by default.
Command Modes
Multicast routing configuration
Multicast
Multicast VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
This command modifies the default behavior for all new and existing interfaces to enabled unless overridden by the enable or disable keywords available in interface configuration mode.
The following guidelines apply when the enable and disable commands (and the no forms) are used in conjunction with the interface all enable command:
•
–
–
–
•
–
–
–
Task ID
Examples
The following example shows how to enable multicast routing on all interfaces and disable the feature only on Packet-over-SONET/SDH (POS) interface 0/1/0/0:
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# interface all enableRP/0/RP0/CPU0:router(config-mcast)# interface pos 0/1/0/0RP/0/RP0/CPU0:router(config-mcast-default-ipv4-if)# disableRelated Commands
Disables multicast routing and forwarding on an interface.
Enables multicast routing and forwarding on an interface.
interface-inheritance disable
To separate PIM and IGMP routing from multicast forwarding on all interfaces, use the interface-inheritance disable command under multicast routing address-family IPv4 or IPv6 submode. To restore the default functionality, use the no form of the command.
interface-inheritance disable
no interface-inheritance disable
Syntax Description
This command hs no arguments or keywords.
Defaults
This feature is not enabled by default.
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0
No modification.
Release 3.7.0
No modification.
Command Modes
Multicast routing configuration
Address-family IPv4 or IPv6 configurationUsage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use of the interface-inheritance disable command together with the interface type interface-id or interface all enable command under multicast routing address-family IPv4 or IPv6 submode separates PIM and IGMP routing functionality from multicast forwarding on specified interfaces. You can nonetheless enable multicast routing functionality explicitly under PIM or IGMP routing configuration mode for individual interfaces.
Note
Task ID
Examples
The following configuration disables PIM and IGMP routing functionality on all the interfaces using the interface-inheritance disable command, but multicast forwarding is still enabled on all the interfaces in the example, based on use of the keywords interface all enable.
PIM is enabled on Loopback 0 based on its explicit configuration (interface Loopback0 enable) under router pim configuration mode.
IGMP protocol is enabled on GigabitEthernet0/6/0/3, because it too has been configured explicitly under router igmp configuration mode (interface GigabitEthernet0/6/0/3 router enable):
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# address-family ipv4RP/0/RP0/CPU0:router(config-mcast-default-ipv4)# interface-inheritance disableRP/0/RP0/CPU0:router(config-mcast-default-ipv4)# interface loopback 1 enableRP/0/RP0/CPU0:router(config-mcast-default-ipv4)# sh run router pimrouter pim vrf default address-family ipv4interface Loopback0enable!!RP/0/RP0/CPU0:router(config-mcast-default-ipv4)# sh run router igmprouter igmpvrf defaultinterface GigabitEthernet0/6/0/3router enable!!!log-traps
To enable logging of trap events, use the log-traps command in the appropriate configuration mode. To remove this functionality, use the no form of this command.
log-traps
no log-traps
Syntax Description
This command has no arguments or keywords.
Defaults
By default, this feature is disabled.
Command Modes
Multicast routing configuration
Multicast VRF configurationCommand History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
