-
Cisco IOS XR Multicast Command Reference, Release 3.5
-
Multicast IPv4 and IPv6 Commands on Cisco IOS XR Software
-
Multicast Routing and Forwarding Commands on Cisco IOS XR Software
-
Multicast Source Discovery Protocol Commands on Cisco IOS XR Software
-
Multicast PIM Commands on Cisco IOS XR Software
-
Multicast Tool and Utility Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
Multicast Routing and Forwarding Commands on Cisco IOS XR Software
clear mfib hardware connections-counters
clear mfib hardware resource-counters
clear mfib hardware route statistics
show mfib hardware resource-counters
show mfib hardware route accept-bitmap
show mfib hardware route olist
show mfib hardware route statistics
show mfib hardware route summary
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.
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.
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 route 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 connections-counters
To clear global connections counters, use the clear mfib hardware connections-counters command in EXEC mode.
clear mfib [vrf vrf-name] [ipv4 | ipv6] hardware connections-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 connections-counters to check if the connections to any of the servers are flapping. For the case of resource counters it can be used in debugging to estimate resource usage for an operation.
Task ID
Examples
The following example shows how to clear all global connection counters:
RP/0/RP0/CPU0:router# clear mfib hardware connections-counters location allRelated Commands
show mfib hardware connection
Displays the status of MFIB connections to servers.
clear 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
This command does not clear global (*, G) counters.
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)# disableinterface 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 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.
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
Release 3.4.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.5.0
This command was supported in multicast VRF configuration mode.
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 enable logging of trap events:
RP/0/RP0/CPU0:router# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# log-trapsmaximum disable
To disable maximum state limits, use the maximum disable command in the appropriate configuration mode. To remove this functionality, use the no form of this command.
maximum disable
no maximum disable
Syntax Description
This command has no arguments or keywords.
Defaults
Maximum state limits are enabled.
Command Modes
Multicast routing configuration
Multicast VRF configurationCommand History
Release 3.4.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.5.0
This command was supported in multicast VRF configuration mode.
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 maximum disable command to override the default software limit on the number of multicast routes.
Task ID
Examples
The following example shows how to disable maximum state limits:
RP/0/RP0/CPU0:router# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# maximum disablemdt data
To configure the multicast VPN (MVPN) data multicast distribution tree (MDT) group configuration, use the mdt data command in the appropriate configuration mode. To remove this functionality, use the no form of this command.
mdt data mdt-group-address/prefix-length threshold threshold acl-name
no mdt data mdt-group-address/prefix-length threshold threshold acl-name
Syntax Description
Command Default
threshold: 1
Command Modes
Multicast routing configuration
Multicast VRF configurationCommand History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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.
When certain multicast streams exceed a configured bandwidth, the multicast data is moved to an MDT data group that is dynamically chosen from an available pool of multicast addresses. If the traffic bandwidth falls below the threshold, the source is switched back to the default MDT. To avoid transitions between the MDTs, traffic only reverts to the default MDT if traffic below the data MDT threshold is at least one minute old.
Task ID
Examples
The following example shows how to configure the data MDT group:
RP/0/RP0/CPU0:router# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# mdt data 172.23.2.2/24 threshold 1200 acl_ARelated Commands
mdt default
To configure the default group address of the multicast VPN (MVPN) multicast distribution tree (MDT), use the mdt default command in the appropriate configuration mode. To remove this functionality, use the no form of this command.
mdt default mdt-group-address
no mdt default mdt-group-address
Syntax Description
Command Default
The MDT default group address must be unique.
Command Modes
Multicast routing configuration
Multicast VRF configurationCommand History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 default MDT has a unique group address used to create MVPN multicast tunnel interfaces.
Task ID
Examples
The following example shows how to configure the MDT default group address:
RP/0/RP0/CPU0:router# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# mdt default 172.16.10.1Related Commands
Configures the MDT data group address range.
Configures the MDT maximum transmission unit (MTU).
Configures the interface used to set the MDT source address.
mdt mtu
To configure the maximum transmission unit (MTU) configuration of the multicast VPN (MVPN) multicast distribution tree (MDT), use the mdt mtu command in multicast VPN configuration mode. To remove this functionality, use the no form of this command.
mdt mtu value
no mdt mtu value
Syntax Description
Command Default
The MDT tunnel default size is 1376.
Command Modes
Multicast VRF configuration
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 configure the MDT MDU:
RP/0/RP0/CPU0:router# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# vrf vrf_ARP/0/RP0/CPU0:router(config-mcast-vrf_A-ipv4)# mdt mtu 2345Related Commands
Configures the MDT data group address range.
Configures the MDT default group address.
Configures the interface used to set the MDT source address.
mdt source
To configure the interface used to set the multicast VPN (MVPN) data multicast distribution tree (MDT) source address, use the mdt data command in the appropriate configuration mode. To remove this functionality, use the no form of this command.
mdt source type instance
no mdt source type instance
Syntax Description
Command Default
No default behavior or values
Command Modes
Multicast routing configuration
Multicast VRF configurationCommand History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 mdt source command to identify the root of the multicast distribution tree in the service provider network. This address is used to update all MVPN peers through multiprotocol BGP.
Task ID
Examples
The following example shows how to configure the interface used to set the MDT source address:
RP/0/RP0/CPU0:router# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# mdt source POS 0/1/0/0Related Commands
Configures the MDT data group address range.
Configures the MDT default group address.
Configures the MDT maximum transmission unit (MTU).
mhost default-interface
To configure the default interface for IP multicast transmission and reception to and from the host stack, use the mhost default-interface command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
mhost {ipv4 | ipv6} default-interface type instance
no mhost {ipv4 | ipv6} default-interface type instance
Syntax Description
Defaults
If no Multicast Host (MHost) default interface is configured, an arbitrary interface is selected as the active MHost default. If the multicast routing feature is enabled, a multicast enabled interface is always selected as the MHost default interface.
Command Modes
Global configuration
Global 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 mhost default-interface command configures the interface that the automatic route processing (Auto-RP), ping, and mtrace applications use for multicast transmissions, and the interface to which multicast groups are joined for reception.
Auto-RP, ping, and mtrace may use the MHost default interface to process multicast messaging. When IP multicast routing is enabled, packets sent to the MHost default interface are switched on other interfaces with a matching forwarding state. In addition, an arbitrary interface may be chosen to be the active MHost default interface if the configured interface is not operational. If no MHost default interface is configured with this command, an arbitrary interface is selected as the active MHost default.
Task ID
Examples
The following example shows how to configure Loopback interface 1 as the default interface:
RP/0/RP0/CPU0:router(config)# mhost ipv4 default-interface loopback 1Related Commands
multicast-routing
To enter multicast routing configuration mode or to enable multicast routing and forwarding on all router interfaces, use the multicast-routing command in global configuration mode. To return to the default behavior, use the no form of this command.
multicast-routing [address-family {ipv4 | ipv6}]
no multicast-routing
Syntax Description
address-family
(Optional) Displays the available configuration modes.
ipv4
(Optional) Specifies IPv4 address prefixes.
ipv6
(Optional) Specifies IPv6 address prefixes.
Defaults
IPv4 addressing is the default.
Command Modes
Global configuration
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-routing command starts the following multicast processes:
•
•
•
•
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
Task ID
Examples
The following example shows how to enter IPv4 multicast routing configuration mode:
RP/0/RP0/CPU0:router(config)# multicast-routing address-family ipv6RP/0/RP0/CPU0:router(config-mcast-default-ipv6)#Related Commands
multipath
To enable Protocol Independent Multicast (PIM) to divide the multicast load among several equal cost paths, use the multipath command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
multipath [interface-extended-hash]
no multipath [interface-extended-hash]
Syntax Description
interface-extended-hash
(Optional) Enables extensions for non-unique next-hop addresses. This option is available for IPv6 addressing in multicast routing configuration mode only.
Defaults
The multipath command is not enabled.
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 multipath command is not specific to IPv4, IPv6, or PIM mode.
By default, equal-cost multipath (ECMP) paths are not load balanced. A single path from each unicast route is used for all multicast routes (which is the equivalent of the no form of the multipath command).
Task ID
Examples
The following example shows how to enable multipath functionality:
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# multipathnsf (multicast)
To turn on the nonstop forwarding (NSF) capability for the multicast routing system, use the nsf command in multicast routing configuration mode. To turn off this function, use the no form of this command.
nsf [lifetime seconds]
no nsf [lifetime]
Syntax Description
lifetime seconds
(Optional) Specifies the maximum time (in seconds) for NSF mode. Range is 30 to 3600.
Defaults
NSF is disabled.
Command Modes
Multicast routing configuration
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 nsf command does not enable or disable the multicast routing system, but just the NSF capability for all the relevant components. When the no form of this command is used, the NSF configuration is returned to its default disabled state.
Enable multicast NSF when you require enhanced availability of multicast forwarding. When enabled, failures of the control-plane multicast routing components Multicast Routing Information Base (MRIB) or Protocol Independent Multicast (PIM) will not cause multicast forwarding to stop. When these components fail or communication with the control plane is otherwise disrupted, existing Multicast Forwarding Information Base (MFIB) entries continue to forward packets until either the control plane recovers or the MFIB NSF timeout expires.
Enable multicast NSF when you upgrade control-plane Cisco IOS XR software packages so that the live upgrade process does not interrupt forwarding.
When the MFIB partner processes enter NSF mode, forwarding on stale (nonupdated) MFIB entries continues as the control-plane components attempt to recover gracefully. Successful NSF recovery is signaled to the Multicast Forwarding Engine (MFWD) partner processes by MRIB. MRIB remains in NSF mode until Internet Group Management Protocol (IGMP) has recovered state from the network and host stack and until PIM has recovered state from the network and IGMP. When both PIM and IGMP have recovered and fully updated the MRIB, MRIB signals the MFIBs that NSF is ending, and begins updating the stale MFIB entries. When all updates have been sent, the MFWD partner processes delete all remaining stale MFIB entries and returns to normal operation, ending the NSF mode. MFIB NSF timeout prior to the signal from MRIB may cause NSF to end, and thus forwarding to stop.
When forwarding is in NSF mode, multicast flows may continue longer than necessary when network conditions change due to multicast routing protocols, unicast routing protocol reachability information, or local sender and receiver changes. The MFWD partner processes halt forwarding on stale MFIB entries when the potential for a multicast loop is detected by receipt of incoming data on a forwarding interface for the matching MFIB entry.
Note
Task ID
Examples
The following example shows how to enable NSF for the multicast routing system:
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# nsfRelated Commands
oom-handling
To enable the out-of-memory (OOM) functionality on multicast routing software components, use the oom-handling command in multicast routing configuration mode. To remove this functionality, use the no form of this command.
oom-handling
no oom-handling
Syntax Description
This command has no arguments or keywords.
Defaults
This feature is disabled.
Command Modes
Multicast routing configuration
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.
When the oom-handling command is enabled, and the router memory is low or in a warning state, the following states are not created:
•
•
•
Multicast routing show commands such as the show pim topology command indicate when the router is running low on memory and that new state creation has stopped.
Task ID
Examples
The following example shows how to enable the out-of-memory functionality:
RP/0/RP0/CPU0:router# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# oom-handlingRelated Commands
rate-per-route
To enable individual (source, group [S, G]) rate calculations, use the rate-per-route command in the appropriate configuration mode. To remove this functionality, use the no form of this command.
rate-per-route
no rate-per-route
Syntax Description
This command has no arguments or keywords.
Defaults
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
Examples
The following example shows how to enable individual route calculations:
RP/0/RP0/CPU0:router# multicast-routing vrf vpn12 address-family ipv4RP/0/RP0/CPU0:router(config-mcast)# rate-per-routeRelated Commands
show mfib connections
To display the status of Multicast Forwarding Information Base (MFIB) connections to servers, use the show mfib connections command in EXEC mode.
show mfib [ipv4 | ipv6] connections [location node-id]
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Release 3.4.0
This command was introduced on the Cisco CRS-1.
Release 3.5.0
This command was supported on the Cisco XR 12000 Series Router.
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 show mfib connections command to display a list of servers connected to the MFIB and the status of the connections.
Task ID
Examples
The following is sample output from the show mfib connection command:
RP/0/RP0/CPU0:router# show mfib connectionsNetio : connectedIM : connectedPakman : connectedMRIB : connectedIFH : connectedSysDB-Global : connectedSysDB-Local : connectedSysDB-NSF : connectedSYSDB-EDM : connectedSYSDB-Action : connectedAIB : connectedMLIB : connectedIDB : connectedIIR : connectedIPARM : connectedGSP : connectedRelated Commands
Displays hardware switching interface information for the MFIB process.
Displays route entries in the MFIB table.
show mfib counter
To display Multicast Forwarding Information Base (MFIB) counter statistics for packets that have dropped, use the show mfib counter command in EXEC mode.
show mfib [vrf vrf-name] [ipv4 | ipv6] counter [location node-id]
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.
The show mfib counter command displays packet drop statistics for packets that cannot be accounted for under route counters.
Task ID
Examples
The following is sample output from the show mfib counter command:
RP/0/RP0/CPU0:router# show mfib counter location 0/1/CPU0MFIB global counters are :* Packets [no input idb] : 0* Packets [failed route lookup] : 0* Packets [Failed idb lookup] : 0* Packets [Mcast disabled on input I/F] : 0* Packets [encap drops due to ratelimit] : 0Table 15 describes the significant fields shown in the display.
Related Commands
Displays hardware switching interface information for the MFIB process.
Displays route entries in the MFIB table.
show mfib encap-info
To display the status of encapsulation information for Multicast Forwarding Information Base (MFIB) Multicast VPN (MVPN), use the show mfib encap-info command in EXEC mode.
show mfib [vrf vrf-name] [ipv4 | ipv6] encap-info [location node-id]
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 is sample output from the show mfib encap-info command:
RP/0/RP0/CPU0:router# show mfib vrf vrf_a encap-info----------------------------Encaps String Dependent Encaps MDT Name/Routes # Table ID Handle(192.168.5.203, 255.1.1.1) 5 0xe0000000 mdtA1 (0x100a480)Related Commands
Displays hardware switching interface information for the MFIB process.
Displays route entries in the MFIB table.
show mfib hardware interface
To display hardware switching interface information for the Multicast Forwarding Information Base (MFIB) process, use the show mfib hardware interface command in EXEC mode.
show mfib [vrf vrf-name] [ipv4 | ipv6] hardware interface [detail] [type instance] [location node-id]
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.
The show mfib hardware interface command displays multicast-specific information about the software switching interfaces of the router hardware.
Task ID
Examples
The following is sample output from the show mfib hardware interface command. The first line displays information for the fabric interface (FI0/1/1) on the line card. The fabric interface is a special interface that represents the hardware connection to the fabric.
RRP/0/RP0/CPU0:router# show mfib ipv4 hardware interface location 0/1/1Interface Handle Ghandle RefCnt TTL uIDB E-uIDB Parent-I/F Enbld CommentFI0/1/1 0x1180000 0x0 2 0 0 Unknwn Unknown False successPO0/1/1/0 0x1180060 0x118006 20002 0 1 1 N/A True successPO0/1/1/1 0x11800c0 0x11800c 20002 0 2 2 N/A True successPO0/1/1/3 0x1180180 0x118018 2 0 4 4 N/A True successTable 16 describes the significant fields shown in the display.
Related Commands
show mfib hardware resource-counters
To display the allocated and freed hardware resources for the Multicast Forwarding Information Base (MFIB) process, use the show mfib hardware resource-counters command in EXEC mode.
show mfib [vrf vrf-name] [ipv4 | ipv6] hardware resource-counters [location node-id]
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Release 3.4.0
This command was introduced on the Cisco CRS-1.
Release 3.5.0
The vrf vrf-name keyword and argument were added.
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 show mfib hardware resource-counters command to understand the table lookup unit (TLU) resource usage by MFIB. The output shows the following:
•
•
•
•
Task ID
Examples
The following is sample output from the show mfib hardware resource-counters command:
RRP/0/RP0/CPU0:router# show mfib ipv4 hardware resource-counters location 0/5/cpu0TLU blocks channel 0 : ingress: 171,0 egress: 1,0TLU blocks channel 1 : ingress: 0,0 egress: 0,0TLU blocks channel 2 : ingress: 18,0 egress: 0,0TLU blocks channel 3 : ingress: 2,0 egress: 1,0TLU blocks for PLU_EXTENSION: 18,0TLU blocks for S_BITMAP: 2,0TLU blocks for USE_ACCEPT_BITMAP: 171,0TLU blocks for CONN_CHECK: 0,0TLU blocks for OLIST: 1,0TLU blocks for L2_LOAD_INFO: 1,0TLU blocks for L2_TE: 0,0TLU blocks for OLIST1: 0,0TLU blocks for OLIST2: 0,0TLU blocks for UNKNOWN: 0,0Number of times we failed to allocate TLU block(s): 0 Number of general TLU failures: 0Mstat success #calls: ingress: 21,0 egress: 14,0Mstat failure #calls: ingress: 0,0 egress: 0,0Table 17 describes the significant fields shown in the display.
Related Commands
show mfib hardware route accept-bitmap
To display platform-specific Multicast Forwarding Information Base (MFIB) information for the interface list that accepts bidirectional routes, use the show mfib hardware route accept-bitmap command in EXEC mode.
show mfib [vrf vrf-name] [ipv4 | ipv6] hardware route accept-bitmap [hash-tree-only | normal-tree-only] [detail | hex-dump] [* | source-address] [group-address [/prefix-length]] [location node-id]
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
In the following example, the bidirectional range is configured as 233.1.0.0/16 and 233.4.0.0/16:
RP/0/RP0/CPU0:router(config)# ipv4 access-list bidir-rangeRP/0/RP0/CPU0:router(config-ipv4-acl)# permit 233.1.0.0 0.0.255.255RP/0/RP0/CPU0:router(config-ipv4-acl)# permit 233.4.0.0 0.0.255.255RP/0/RP0/CPU0:router(config-ipv4-acl)# deny anyRP/0/RP0/CPU0:router(config-ipv4-acl)# commitRP/0/RP0/CPU0:router(config-ipv4-acl)# exitRP/0/RP0/CPU0:router(config)# router pimRP/0/RP0/CPU0:router(config-pim-default-ipv4)# no rp-address 10.1.1.1 bidirRP/0/RP0/CPU0:router(config-pim-default-ipv4)# commitRP/0/RP0/CPU0:router(config-pim-default-ipv4)# rp-address 10.1.1.1 bidir-range bidirRP/0/RP0/CPU0:router(config-pim-default-ipv4)# commitThe sample output from the show mfib hardware route accept-bitmap command displays the accepting interface list for (*,233.1.0.0/16) and (*,233.4.0.0/16) only. The accepting interface list is POS0/1/1/0, POS0/1/1/1, and POS0/1/1/3.
RP/0/RP0/CPU0:router# show mfib hardware route accept-bitmap detail location 0/1/CPU0Source: Source address Group: Group Address M: Mask LengthiQoS : Ingress QoS tag C : Directly connected check flagRPF : Accepting interface for non-bidir entriesS : Signal on RPF interface FU : For usPLUext: PLU result extension addressFGID : Fabric Group IDoQoS : Output QoS tagFGID2 : Secondary Fabric Group IDA_num : Number of I/Fs in the accepting listA_TLU : Address of the first TLU in the accepting listInterface: Accepting interface nameSource Group M iQoS C RPF S FU PLUext FGID FGID2 P PF BA oQoS A_num A_TLU Interface* 224.0.0.0 4 0 T Null F F 200ae2c 41785 -1 F F T 0 0 Null* 224.0.0.0 24 0 F Null F F 200d00f 47206 -1 F F T 0 0 Null* 224.0.1.39 32 0 F Null F F 200d000 47205 -1 T F F 0 0 Null* 224.0.1.40 32 0 F Null F F 200d00d 27202 -1 T F F 0 0 Null* 232.0.0.0 8 0 F Null F F 200d010 47207 -1 F F T 0 0 Null* 233.1.0.0 16 0 F Null F F 200ae34 44106 -1 F F T 0 3 4400 PO0/1/1/0* 233.1.0.0 16 0 F Null F F 200ae34 44106 -1 F F T 0 3 4400 PO0/1/1/1* 233.1.0.0 16 0 F Null F F 200ae34 44106 -1 F F T 0 3 4400 PO0/1/1/3* 233.1.1.1 32 0 F Null F F 200a418 27205 -1 F F T 0 0 4400* 233.1.1.2 32 0 F Null F F 200a419 27206 -1 F F T 0 0 4400* 233.1.1.3 32 0 F Null F F 200a41c 27207 -1 F F T 0 0 4400* 233.1.1.4 32 0 F Null F F 200a41d 27208 -1 F F T 0 0 4400* 233.4.0.0 16 0 F Null F F 200ae3c 42043 -1 F F T 0 3 4500 PO0/1/1/0* 233.4.0.0 16 0 F Null F F 200ae3c 42043 -1 F F T 0 3 4500 PO0/1/1/3Table 18 describes the significant fields shown in the display.
Related Commands
show mfib hardware route olist
To display platform-specific Multicast Forwarding Information Base (MFIB) information for the output interface list (olist) stored in the hardware, use the show mfib hardware route olist command in EXEC mode.
show mfib [vrf vrf-name] [ipv4 | ipv6] hardware route olist [hash-tree-only | normal-tree-only] [detail | hex-dump] [* | source-address] [group-address [/prefix-length]] [location node-id]
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.
The show mfib hardware route olist command displays the output interface list (olist) for each route. The Multicast Forwarding (MFWD) process stores olist interfaces in a table lookup unit (TLU) block (in groups of three). As such, the command displays each route three times.
Task ID
Examples
The following is sample output from the show mfib hardware route olist command on the Cisco CRS-1 router for line card 0/1/CPU0 (the output fields are described in the header):
RP/0/RP0/CPU0:router# show mfib hardware route olist location 0/1/CPU0Source: Source addressGroup : Group AddressM : Mask LengthC : Directly connected check flagRPF : Accepting interface for non-bidir entriesS : Signal if packet arrived on RPF interfaceFU : For usFGID : Fabric Group IDP : Route PuntPF : Punt to CPU if packet is forwarded to the fabricBA : Check if boundary ACL is configured on incoming interfaceO_Null : Olist is emptyInterface: Output interface nameIC : Internal copy flagOP : Output Punt: Punt instead of forwarding outSource Group M C RPF S FU FGID P PF BA O_Null Interface IC OP* 224.0.0.0 4 T Null F F 41785 F F T True* 224.0.0.0 24 F Null F F 47206 F F T True* 224.0.1.39 32 F Null F F 47205 T F F True* 224.0.1.40 32 F Null F F 27202 T F F True* 232.0.0.0 8 F Null F F 47207 F F T True* 233.1.0.0 16 F Null F F 44106 F F T False NULL* 233.1.0.0 16 F Null F F 44106 F F T False NULL* 233.1.0.0 16 F Null F F 44106 F F T False PO0/1/1/0 F F* 233.1.1.1 32 F Null F F 27205 F F T False NULL* 233.1.1.1 32 F Null F F 27205 F F T False PO0/1/1/1 F F* 233.1.1.1 32 F Null F F 27205 F F T False PO0/1/1/0 F F* 233.1.1.2 32 F Null F F 27206 F F T False NULL* 233.1.1.2 32 F Null F F 27206 F F T False PO0/1/1/1 F F* 233.1.1.2 32 F Null F F 27206 F F T False PO0/1/1/0 F FThe following is sample output from the show mfib hardware route olist command on the Cisco XR 12000 Series Router for line card 0/3/CPU0:
RP/0/0/CPU0:router# show mfib hardware route olist 225.0.0.0 location 0/3/cpu0 (*,225.0.0.0)tlu_addr:0x001b8280l2:(14)01005E0000000012442551FD0800 gp:11 mtu:1500flags:0x02 uidb:0x0006 next:0x0e00dc16pkt/bytes:0/0tlu_addr:0x001b82c0l2:(14)01005E0000000012442552010800 gp:17 mtu:1500flags:0x02 uidb:0x000a next:0x00000000pkt/bytes:0/0tlu_addr - TLU addressl2: L2 encapulation stringgp: Gather profilemtu: Maximum transmission unit (MTU)uidb: UIDB indexnext: Next TLU addresspkt: Packet counterbytes: Byte counterRelated Commands
show mfib hardware route qos
To display the status of Multicast Forwarding Information Base (MFIB) quality of service (QoS) information, use the show mfib hardware route qos command in EXEC mode.
show mfib [vrf vrf-name] [ipv4] hardware route qos {* | source-address} {group-address [/prefix-length]} location node-id
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 is sample output from the show mfib hardware route qos command:
RP/0/0/CPU0:router# show mfib hardware route qos *Related Commands
show mfib hardware route statistics
To display platform-specific Multicast Forwarding Information Base (MFIB) information for the packet and byte counters for each route, use the show mfib hardware route statistics command in EXEC mode.
show mfib [vrf vrf-name] [ipv4 | ipv6] hardware route statistics [hash-tree-only | normal-tree-only] [detail | hex-dump] [* | source-address] [group-address [/prefix-length]] [location node-id]
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 show mfib hardware route statistics command to display the hardware packet and byte counter for a route. Route counters are kept for (S, G) routes only. A single set of counters is provided for all (*, G) routes.
This command displays the hardware packet and bytes count on a per-route basis. Per-route hardware counters are kept for (S, G) routes only. However, counters are managed dynamically and allocated on a priority basis and may not be available for each (S, G) route. There is a single set of counters for all
(*, G) routes. For example, interface counters and access list counters have higher priority than route counters.
Note
Task ID
Examples
The following is sample output from the show mfib hardware route statistics command for line card 0/1/CPU0.
The first four lines indicate that a total of 2709724 packets representing 184261232 bytes matched all (*, G) routes and were punted to line card CPU for further processing.
The second four lines indicate that 753 packets matched the route (10.1.1.9, 233.1.1.2), were accepted for forwarding, and were sent into the fabric by the ingress forwarding engine. The lines indicate that 749 packets and 47936 bytes were received by the egress forwarding engine from the fabric, matched (10.1.1.9, 233.1.1.2), and were sent out of at least one interface from the output interface list.
RP/0/RP0/CPU0:router# show mfib hardware route statistics location 0/1/CPU0(*,G) Counter: Ingress Counter = 0xe170 Egress Counter = 0x9110Ingress: Forward = (0 , 0) Punt = (2709724 , 184261232)Drop = (0 , 0)Egress: Forward = (0 , 0) Drop = (0 , 0)(10.1.1.9,233.1.1.1/64) Ingress Counter = 0xe173 Egress Counter = 0x9112Ingress: Forward = (753 , 51204) Punt = (0 , 0)Drop = (0 , 0)Egress: Forward = (749 , 47936) Drop = (0 , 0)Table 19 describes the significant fields shown in the display.
Related Commands
show mfib hardware route summary
To display summary platform-specific Multicast Forwarding Information Base (MFIB) hardware information for each route entry, use the show mfib hardware route summary command in EXEC mode.
show mfib [vrf vrf-name] [ipv4 | ipv6] hardware route summary [hash-tree-only | normal-tree-only] [location node-id]
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Release 3.4.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.5.0
The vrf vrf-name keyword and argument were added.
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 show mfib hardware summary command to display hardware information for the route of the node.
The longest-prefix match route is displayed depending on the provided source and group addresses.
Task ID
Examples
The following is sample output from the show mfib hardware route summary command:
RP/0/RP0/CPU0:router# show mfib hardware route summary location 0/1/cpu0H/W IP Multicast Forwarding Information Base SummaryNo. of (*,G) routes = 5No. of (S,G) routes = 0Table 20 describes the significant fields shown in the display.
Related Commands
show mfib interface
To display interface-related information used during software multicast switching in the Multicast Forwarding Information Base (MFIB) process, use the show mfib interface command in EXEC mode.
show mfib [vrf vrf-name] [ipv4 | ipv6] interface [type instance] [detail | route] [location node-id]
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.
The show mfib interface command displays counters for the number of packets and bytes that are handled by software switching. Counters for packets processed by hardware are displayed by the appropriate show mfib hardware command.
Task ID
Examples
The following is sample output from the show mfib interface command for the multicast route on node 0/2/CPU0 that is associated with the Packet-over-SONET/SDH (POS) interface 0/2/0/2:
RP/0/RP0/CPU0:router# show mfib interface pos 0/2/0/2 location 0/2/CPU0Interface : POS0/2/0/2 (Enabled)Mcast pkts in : 5839, Mcast pkts out : 0 TTL Threshold : 0 Ref Count : 18The following is sample output from the show mfib interface command with the detail and location keywords specified:
RP/0/RP0/CPU0:router# show mfib interface detail location 0/2/CPU0Interface : FINT0/2/CPU0 [0x3000000] (Disabled) PHYSICAL Create Unknown Mcast pkts in: 0, Mcast pkts out: 0 TTL Threshold : 0, VRF ID: 0x60000000, Multicast Adjacency Ref Count: 2, Route Count: 0, Handle: 0x3000000 Primary address : 0.0.0.0/32 Secondary address : 0.0.0.0/32Interface : POS0/2/0/2 [0x3000900] (Enabled) PHYSICAL Create Rcvd Mcast pkts in: 5844, Mcast pkts out: 0 TTL Threshold : 0, VRF ID: 0x60000000, Multicast Adjacency Ref Count: 18, Route Count: 15, Handle: 0x3000900 Primary address : 112.112.112.203/24 Secondary address : 0.0.0.0/32Table 21 describes the significant fields shown in the display.
Related Commands
show mfib nsf
To display the state of nonstop forwarding (NSF) operation for the Multicast Forwarding Information Base (MFIB) line cards, use the show mfib nsf command in EXEC mode.
show mfib [ipv4 | ipv6] nsf [location node-id]
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.
The show mfib nsf command displays the current multicast NSF state for the MFIB process contained on all line cards and route processors (RPs) in the router.
For multicast NSF, the state may be one of the following:
•
•
•
•
Task ID
Examples
The following is sample output from the show mfib nsf command:
RP/0/RP0/CPU0:router# show mfib nsfIP MFWD Non-Stop Forwarding Status:NSF Lifetime: 00:15:00On node 0/1/CPU0 :Multicast routing state: Non-Stop Forwarding is activatedNSF Time Remaining: 00:14:54On node 0/3/CPU0 :Multicast routing state: Non-Stop Forwarding is activatedNSF Time Remaining: 00:14:54On node 0/4/CPU0 :Multicast routing state: Non-Stop Forwarding is activatedNSF Time Remaining: 00:14:53On node 0/6/CPU0 :Multicast routing state: Non-Stop Forwarding is activatedNSF Time Remaining: 00:14:53Table 22 describes the significant fields shown in the display.
Related Commands
show mfib route
To display route entries in the Multicast Forwarding Information Base (MFIB) table, use the show mfib route command in EXEC mode.
show mfib [vrf vrf-name] [ipv4 | ipv6] route [[rate | statistics] [* | source-address] [group-address [/prefix-length] [detail | old-output] | summary] [location node-id]
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.
All entries in the MFIB table are derived from the Multicast Routing Information Base (MRIB). The flags have the same connotation as in the MRIB. The flags determine the forwarding and signaling behavior according to a set of forwarding rules for multicast packets. In addition to the list of interfaces and flags, each route entry shows various counters. Byte count is the number of total bytes forwarded. Packet count is the number of packets received for this entry.
The show mfib counter command displays global counters independent of the routes.
This command displays counters for the number of packets and bytes that are handled by software switching. Counters for packets processed by hardware are displayed by the appropriate show mfib hardware command.
Task ID
Examples
The following is sample output from the show mfib route command with the location keyword specified (the output fields are described in the header):
RP/0/RP0/CPU0:router# show mfib route location 0/1/CPU0Entry flags: C - Directly-Connected Check, S - Signal, D - Drop,IA - Inherit Accept, IF - Inherit From, MA - MDT Address,ME - MDT Encap, MD - MDT Decap, MT - MDT Threshold Crossed,MH - MDT interface handle, CD - Conditional Decap,DT - MDT Decap TrueInterface flags: F - Forward, A - Accept, IC - Internal Copy,NS - Negate Signal, DP - Don't Preserve, SP - Signal Present,EG - Egress, EI - Encapsulation Interface, MI - MDT InterfaceForwarding Counts: Packets in/Packets out/Bytes outFailure Counts: RPF / TTL / Empty Olist / Encap RL / Other(*,224.0.0.0/4), Flags: CLast Used: neverForwarding Counts: 0/0/0Failure Counts: 0/0/0/0DecapsPIM0 Flags: NS(*,224.0.0.0/24), Flags: DLast Used: neverForwarding Counts: 0/0/0Failure Counts: 0/0/0/0(*,224.0.1.39), Flags: SLast Used: neverForwarding Counts: 0/0/0Failure Counts: 0/0/0/0(*,224.0.1.40), Flags: SLast Used: neverForwarding Counts: 0/0/0Failure Counts: 0/0/0/0(*,238.1.1.1), Flags: CLast Used: neverForwarding Counts: 0/0/0Failure Counts: 0/0/0/0DecapsPIM0 Flags: APOS3/0 Flags: NS EGThe following is sample output from the show mfib route command with the summary and location keywords specified:
RP/0/RP0/CPU0:router# show mfib route summary location 0/1/CPU0IP Multicast Forwarding Information Base SummaryNo. of (*,G) routes = 20015No. of (S,G) routes = 20020The following is sample output from the show mfib route command with the statistics and location keywords specified. For route *, 239.1.1.1, the hardware counters show N/A, which means no hardware statistic blocks were assigned to the route *, 239.1.1.1. However, routes 200.180.161.9 and 239.1.1.1 show both hardware and software statistic blocks were assigned. The output fields are described in the header.
RP/0/RP0/CPU0:router# show mfib route statistics location 0/1/CPU0IP Multicast Forwarding Information BaseEntry flags: C - Directly-Connected Check, S - Signal, D - Drop,IA - Inherit Accept, IF - Inherit From, MA - MDT Address,ME - MDT Encap, MD - MDT Decap, MT - MDT Threshold Crossed,MH - MDT interface handle, CD - Conditional Decap,DT - MDT Decap TrueInterface flags: F - Forward, A - Accept, IC - Internal Copy,NS - Negate Signal, DP - Don't Preserve, SP - Signal Present,EG - Egress, EI - Encapsulation Interface, MI - MDT InterfaceSW/HW Forwarding Counts: Packets in/Packets out/Bytes outSW Failure Counts: RPF / TTL / Empty Olist / Encap RL / OtherHW Drop Counts: Ingress / EgressHW Forwarding Rates: bps In/pps In/bps Out/pps Out(*,224.0.0.0/4), Flags: CLast Used: 03:24:50SW Forwarding Counts: 9038/0/0SW Failure Counts: 0/0/0/0HW Forwarding Counts: N/A /N/A /N/AHW Drop Counts: N/A /N/AHW Forwarding Rates: N/A /N/A /N/A /N/A(*,224.0.0.0/24), Flags: DLast Used: neverSW Forwarding Counts: 0/0/0SW Failure Counts: 0/0/0/0HW Forwarding Counts: N/A /N/A /N/AHW Drop Counts: N/A /N/AHW Forwarding Rates: N/A /N/A /N/A /N/A(*,239.1.1.1), Flags: CLast Used: 03:24:48SW Forwarding Counts: 3/0/0SW Failure Counts: 0/0/0/0HW Forwarding Counts: N/A /N/A /N/AHW Drop Counts: N/A /N/AHW Forwarding Rates: N/A /N/A /N/A /N/APOS0/2/0/2 Flags: NS EGPOS0/2/0/1 Flags: NS EG(200.180.161.9,239.1.1.1), Flags:Last Used: 00:01:08SW Forwarding Counts: 146/0/0SW Failure Counts: 0/0/0/0HW Forwarding Counts: 61327/61327/3924928HW Drop Counts: 0/0HW Forwarding Rates: N/A /N/A /N/A /N/APOS0/2/0/2 Flags: NS EGPOS0/2/0/1 Flags: A EG(*,239.1.1.2), Flags: CLast Used: 03:24:37SW Forwarding Counts: 7/0/0SW Failure Counts: 0/0/0/0HW Forwarding Counts: N/A /N/A /N/AHW Drop Counts: N/A /N/AHW Forwarding Rates: N/A /N/A /N/A /N/ARelated Commands
show mfib table-info
To display Multicast Forwarding Information Base (MFIB) table information, use the show mfib table-info command in EXEC mode.
show mfib [ipv4 | ipv6] table-info {table-id | vrf-name} [location node-id]
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 is sample output from the show mfib table-info command:
RP/0/RP0/CPU0:router# show mfib table-info vrf-nameTable Name : defaultVRid/TID/VID : 0x0 / 0xe0000000 / 0x60000000Table type : TBL_TYPE_NAME_VIDActive/Linked : Y / YLocation : RemoteLocal ifcount : 18Default MDT Encap : (0.0.0.0, 0.0.0.0/32)MDT Master LC : NLoopback (Encap Src) : 0x0 (Ha0x0)Local EG intf cnt : 0Data MDT vrf ACL : - (-), 0 KppsTable 23 describes the significant fields shown in the display.
show mhost default-interface
To display the active default interface for the Multicast Host (MHost) process, use the show mhost default-interface command in EXEC mode.
show mhost [ipv4 | ipv6] default-interface
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.
The show mhost default-interface command is used to show both the configured and active MHost default interfaces. The configured interface is the one specified by the mhost default-interface command; otherwise, the configured interface is displayed as none.
The active interface is the one currently being used as the default. The active interface may differ from the one configured when multicast routing is enabled and the configured interface is not operational. This command is useful when applications such as automatic route processing (Auto-RP), ping, or MTrace are not functioning as expected.
Task ID
Examples
The following is sample output for the show mhost default-interface command that shows that loopback interface 0 was configured as the MHost default interface, and it is the active default interface:
RP/0/RP0/CPU0:router# show mhost default-interfacemhost configured default interface is 'Loopback0'mhost active default interface is 'Loopback0'Related Commands
Configures the default interface for IP multicast transmission and reception to and from the host stack.
show mhost groups
To display various multicast groups joined directly on the interface, use the show mhost groups command in EXEC mode.
show mhost [ipv4 | ipv6] groups type instance [location node-id]
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.
The show mhost groups command is used to display the groups joined by applications and verifies that the MHost application is functioning properly.
Task ID
Examples
The following is sample output from the show mhost groups command that shows the MHost groups 239.1.1.1, 224.0.0.22, 224.0.0.2, 224.0.0.1, 224.0.0.13, and 224.0.1.40 have joined on loopback 0 interface:
RP/0/RP0/CPU0:router# show mhost groups loopback 0Loopback 0239.1.1.1 : includes 1, excludes 0, mode INCLUDE33.3.3.3 : includes 1, excludes 0, active in INCLUDE filter224.0.0.22 : includes 0, excludes 1, mode EXCLUDE<no source filter>224.0.0.2 : includes 0, excludes 1, mode EXCLUDE<no source filter>224.0.0.1 : includes 0, excludes 1, mode EXCLUDE<no source filter>224.0.0.13 : includes 0, excludes 1, mode EXCLUDE<no source filter>224.0.1.40 : includes 0, excludes 2, mode EXCLUDE<no source filter>Table 24 describes the significant fields shown in the display.
Related Commands
show mrib client
To display the state of the Multicast Routing Information Base (MRIB) client connections, use the show mrib client command in EXEC mode.
show mrib [vrf vrf-name] [ipv4 | ipv6] [old-output] client [filter] [client-name]
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 is sample output from the show mrib client command using the filter option:
RP/0/RP0/CPU0:router# show mrib client filterIP MRIB client-connectionsigmp:417957 (connection id 0)ownership filter:interface attributes: II ID LI LDgroups:include 0.0.0.0/0interfaces:include Allpim:417959 (connection id 1)interest filter:entry attributes: Einterface attributes: SP II ID LI LDgroups:include 0.0.0.0/0interfaces:include Allownership filter:entry attributes: L S C IA IF Dinterface attributes: F A IC NS DP DI EIgroups:include 0.0.0.0/0interfaces:include Allbcdl_agent:1 (connection id 2) interest filter: entry attributes: S C IA IF D interface attributes: F A IC NS DP SP EI groups: include 0.0.0.0/0 interfaces: include All ownership filter: groups: include 0.0.0.0/0 interfaces: include AllTable 25 describes the significant fields shown in the display.
Related Commands
Displays the state of NSF operation in the MFIB.
Displays all entries in the MFIB table.
Displays the state of NSF operation in the MRIB.
show mrib nsf
To display the state of nonstop forwarding (NSF) operation in the Multicast Routing Information Base (MRIB), use the show mrib nsf command in EXEC mode.
show mrib [ipv4 | ipv6] [old-output] nsf
Syntax Description
ipv4
(Optional) Specifies IPv4 address prefixes.
ipv6
(Optional) Specifies IPv6 address prefixes.
old-output
(Optional) Displays the old show output—available for backward compatibility.
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.
The show mrib nsf command displays the current multicast NSF state for the MRIB. The state may be normal or activated for NSF. The activated state indicates that recovery is in progress due to a failure in MRIB or Protocol Independent Multicast (PIM). The total NSF timeout and time remaining are displayed until NSF expiration.
Task ID
Examples
The following is sample output from the show mrib nsf command:
RP/0/RP0/CPU0:router# show mrib nsfIP MRIB Non-Stop Forwarding Status:Multicast routing state: Non-Stop Forwarding ActivatedNSF Lifetime: 00:03:00NSF Time Remaining: 00:01:40Table 26 describes the significant fields shown in the display.
Related Commands
show mrib route
To display all entries in the Multicast Routing Information Base (MRIB) table, use the show mrib route command in EXEC mode.
show mrib [vrf vrf-name] [ipv4 | ipv6] [old-output] route [summary | [* | source-address] [group-address [/prefix-length]]] [detail]
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.
Each line card has an individual Multicast Forwarding Information Base (MFIB) table. The MFIB table maintains a subset of entries and flags updated from MRIB. The flags determine the forwarding and signaling behavior according to a set of forwarding rules for multicast packets. In addition to the list of interfaces and flags, each route entry shows various counters. Byte count is the number of total bytes forwarded. Packet count is the number of packets received for this entry.
The show mfib counter command displays global counters independent of the routes.
Task ID
Examples
The following is sample output from the show mrib route command (the output fields are described in the header):
RP/0/RP0/CPU0:router# show mrib routeIP Multicast Routing Information BaseEntry flags: L - Domain-Local Source, E - External Source to the Domain,C - Directly-Connected Check, S - Signal, IA - Inherit Accept,IF - Inherit From, D - Drop, MA - MDT Address, ME - MDT Encap,MD - MDT Decap, MT - MDT Threshold Crossed, MH - MDT interface handleCD - Conditional DecapInterface flags: F - Forward, A - Accept, IC - Internal Copy,NS - Negate Signal, DP - Don't Preserve, SP - Signal Present,II - Internal Interest, ID - Internal Disinterest, LI - Local Interest,LD - Local Disinterest, DI - Decapsulation InterfaceEI - Encapsulation Interface, MI - MDT Interface(*,224.0.0.0/4) RPF nbr: 10.11.1.20 Flags: L COutgoing Interface ListDecapstunnel0 Flags: NS(*,224.0.0.0/24) Flags: D(*,224.0.1.39) Flags: S(*,224.0.1.40) Flags: SOutgoing Interface ListPOS0/3/0/0 Flags: II LI(*,238.1.1.1) RPF nbr: 10.11.1.20 Flags: COutgoing Interface ListPOS0/3/0/0 Flags: F NS LIDecapstunnel0 Flags: A(*,239.1.1.1) RPF nbr: 10.11.1.20 Flags: COutgoing Interface ListPOS0/3/0/0 Flags: F NSDecapstunnel0 Flags: ARelated Commands
Configures the maximum time for the NSF timeout value on the IGMP.
Displays MFIB counter statistics for packets that have dropped.
show mrib route-collapse
To display the contents of the Multicast Routing Information Base (MRIB) route collapse database, use the show mrib route-collapse command in EXEC mode.
show mrib [vrf vrf-name] [ipv4 | ipv6] route-collapse [core-tree]
Syntax Description
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 is sample output from the show mrib route-collapse command:
RP/0/RP0/CPU0:router# show mrib route-collapse226.1.1.1 TID: 0xe0000038 TLC TID: 0xe0000038Customer route database count: 5(192.168.5.204,224.0.1.40/32)(*,226.226.226.226/32)(*,228.228.228.228/32)(192.168.113.17,228.228.228.228/32)(*,229.229.229.229/32)Core route database count: 4(*,226.1.1.1/32)(192.168.5.201,226.1.1.1/32)(192.168.5.202,226.1.1.1/32)(192.168.5.204,226.1.1.1/32)Core egress node database count: 1nodeid slot refcount0x20 0/2/CPU0 1192.168.27.1 TID: 0xe0000039 TLC TID: 0xe0000039Customer route database count: 1(192.168.113.33,227.227.227.227/32)Core route database count: 3(*,227.27.27.1/32)(192.168.5.201,227.27.27.1/32)(192.168.5.202,227.27.27.1/32)Core egress node database count: 1nodeid slot refcount0x20 0/2/CPU0 1192.168.28.1 TID: 0xe000003a TLC TID: 0xe000003aCustomer route database count: 2(192.168.5.204,224.0.1.40/32)(192.168.113.49,229.229.229.229/32)Core route database count: 3(192.168.5.201,228.28.28.1/32)(192.168.5.202,228.28.28.1/32)(192.168.5.204,228.28.28.1/32)Core egress node database count: 1nodeid slot refcount0x20 0/2/CPU0 1Related CommandsI
show mrib table-info
To display Multicast Routing Information Base (MRIB) table information, use the show mrib table-info command in EXEC mode.
show mrib [vrf vrf-name] [ipv4 | ipv6] table-info
Syntax Description
vrf vrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
ipv4
(Optional) Specifies IPv4 address prefixes.
ipv6
(Optional) Specifies IPv6 address prefixes.
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 is sample output from the show mrib table-info command:
RP/0/RP0/CPU0:router# show mrib table-infoVRF: default [tid 0xe0000000]Registered Client:igmp [ccbid: 0 cltid: 4485366]pim [ccbid: 1 cltid: 4485368]bcdl_agent [ccbid: 2 cltid: 1]msdp [ccbid: 3 cltid: 8827135]Related Commands
show mrib tlc
To display the contents of the Multicast Routing Information Base (MRIB) table-line card (TLC) database, use the show mrib tlc command in EXEC mode.
show mrib [vrf vrf-name] [ipv4 | ipv6] tlc
Syntax Description
vrf vrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
ipv4
(Optional) Specifies IPv4 address prefixes.
ipv6
(Optional) Specifies IPv6 address prefixes.
Defaults
IPv4 addressing is the default.
Command Modes
EXEC
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 is sample output from the show mrib tlc command:
RP/0/RP0/CPU0:router# show mrib tlcVRF: default [tid 0xe0000000]Master LC slot: Not selectedAssociated MDT group: 0Forwarding LC node: 0Table 27 describes the significant fields shown in the display.
Table 27 show msdp peer Field Descriptions
Associated MDT group
IP address of the MSDP peer.
Forwarding LC node
Autonomous system to which the peer belongs.
static-rpf
To configure a static Reverse Path Forwarding (RPF) rule for a specified prefix mask, use the static-rpf command in an appropriate configuration mode. To return to the default behavior, use the no form of this command.
static-rpf prefix-address prefix-mask type instance next-hop-address
no static-rpf
Syntax Description
Defaults
A static RPF rule for a specified prefix mask is not configured.
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 static-rpf command is used to configure incompatible topologies for unicast and multicast traffic.
Use the static-rpf command to configure a static route to be used for RPF checking in Protocol Independent Multicast (PIM) instead of using the unicast routing table.
Task ID
Examples
The following example shows how to configure the static RPF rule for IP address 10.0.0.1:
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# static-rpf 10.0.0.1 32 poS 0/0/5/0 10.1.1.1Related Commands
ttl-threshold (multicast)
To configure the time-to-live (TTL) threshold for packets being forwarded out an interface, use the ttl-threshold command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
ttl-threshold ttl
no ttl-threshold ttl
Syntax Description
Defaults
ttl: 0
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.
Only multicast packets with a TTL value greater than the threshold are forwarded out of the interface. The TTL threshold is compared to the TTL of the packet after it has been decremented by one and before being forwarded.
Configure the TTL threshold only on border routers.
Note
Task ID
Examples
The following example shows how to configure the TTL threshold to 23, which means that a multicast packet is dropped and not forwarded out of the POS 0/1/0/0 interface:
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)# ttl-threshold 23Related Commands
vrf (multicast)
To configure a VPN routing and forwarding (VRF) instance and enter VRF configuration mode, use the vrf command in multicast routing configuration mode. To remove the VRF instance from the configuration file and restore the system to its default condition, use the no form of this command.
vrf vrf-name
no vrf vrf-name
Syntax Description
Defaults
No default behavior or values
Command Modes
Multicast routing configuration
Command History
Release 3.5.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
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 vrf command to configure a VRF instance. A VRF instance is a collection of VPN routing and forwarding tables maintained at the provider edge (PE) router.
Task ID
Examples
The following example shows how to configure a VRF instance and enter VRF configuration mode:
RP/0/RP0/CPU0:router(config)# multicast-routingRP/0/RP0/CPU0:router(config-mcast)# vrf vrf_1RP/0/RP0/CPU0:router(config-mcast-vrf_1-ipv4)#
