Cisco ASR 9000 Series Aggregation Services Router Multicast Command Reference
Multicast Routing and Forwarding Commands on Cisco ASR 9000 Series Routers

Table Of Contents

Multicast Routing and Forwarding Commands on Cisco ASR 9000 Series Router

accounting per-prefix

address-family (multicast)

boundary

clear mfib counter

clear mfib database

clear mfib hardware resource-counters

clear mfib hardware route statistics

disable (multicast)

enable (multicast)

interface (multicast)

interface all enable

interface-inheritance disable

log-traps

maximum disable

mhost default-interface

multicast-routing

multipath

nsf (multicast)

oom-handling

rate-per-route

show mfib connections

show mfib counter

show mfib encap-info

show mfib hardware interface

show mfib hardware resource-counters

show mfib hardware route accept-bitmap

show mfib hardware route internal

show mfib hardware route mofrr

show mfib hardware route olist

show mfib hardware route statistics

show mfib hardware route summary

show mfib hardware table

show mfib interface

show mfib nsf

show mfib route

show mfib table-info

show mhost default-interface

show mhost groups

show mrib client

show mrib nsf

show mrib platform trace

show mrib route

show mrib route-collapse

show mrib route outgoing-interface

show mrib table-info

show mrib tlc

static-rpf

ttl-threshold (multicast)

vrf (multicast)


Multicast Routing and Forwarding Commands on Cisco ASR 9000 Series Router


This module describes the commands used to configure and monitor multicast routing on Cisco ASR 9000 Series Aggregation Services Routers.

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 the Cisco ASR 9000 Series Aggregation Services Router 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 by default.

Command Modes

Multicast routing configuration
Multicast routing address family IPv4 configuration
Multicast VRF configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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 mfib route and the show mfib hardware route statistics commands. These commands display "N/A" for counters when no hardware statistics are available or whenthe accounting per-prefix command is disabled.

Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enable accounting for multicast routing:

RP/0/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# accounting per-prefix

Related Commands

Command
Description

clear mfib hardware route statistics

Resets all allocated counter values matching (S,G) or (*,G) criteria regardless of the MFIB hardware statistics mode.

show mfib hardware route statistics

Displays platform-specific MFIB information for the packet and byte counters for each route.

show mfib route

Displays entries in the MFIB table.


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 [vrf vrf-name] {ipv4}

no address-family [vrf vrf-name] {ipv4}

Defaults

No default behavior or values

Command Modes

Multicast routing configuration
Multicast VRF configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Use the address-family command either from multicast routing configuration mode or from multicast VRF configuration submode to enter multicast IPv4 address family configuration submode.In Cisco IOS XRSoftwareRelease 3.7.2 and later, basic multicast services start automatically when the multicast PIE is installed, without any explicit configuration required. The following multicast services are started automatically:

Multicast Routing Information Base (MRIB)

Multicast Forwarding Engine (MFWD)

Protocol Independent Multicast Sparse mode (PIM-SM)

Internet Group Management Protocol (IGMP)

Multicast Listener Discovery Protocol (MLD)

Other multicast services require explicit configuration before they start. For example, to start the Multicast Source Discovery Protocol (MSDP) process, you must enter the router msdp command and explicitly configure it.

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 The enable and disable keywords available under the IGMP and PIM interface configuration modes have no effect unless the interface is enabled in multicast routing configuration mode—either by default or by explicit interface configuration.


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
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enter IPv4 multicast routing configuration mode:

RP/0/RSP0/CPU0:router(config)# multicast-routing 
RP/0/RSP0/CPU0:router(config-mcast)# address-family ipv4
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4)# 

The following example shows how to enter IPv4 VRF multicast routing configuration submode:

RP/0/RSP0/CPU0:router(config)# multicast-routing 
RP/0/RSP0/CPU0:router(config-mcast)# vrf vrf-name address-family ipv4
RP/0/RSP0/CPU0:router(config-mcast-vrf-name-ipv4)# 

Related Commands

Command
Description

alias

Creates a command alias.

interface all enable

Enables multicast routing and forwarding on all new and existing interfaces.

interface-inheritance disable

Separates the disabling of multicast routing and forwarding.

interface (multicast)

Configures multicast interface properties.


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 routing VRF interface configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

The boundary command is used to set up a boundary to keep multicast packets from being forwarded.

Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to set up a boundary for all administratively scoped addresses:

RP/0/RSP00/CPU0:router# access-list 1 deny 239.0.0.0 0.255.255.255
RP/0/RSP00/CPU0:router# access-list 1 permit 224.0.0.0 15.255.255.255
RP/0/RSP00/CPU0:router(config)# multicast-routing
RP/0/RSP00/CPU0:router(config-mcast)# interface GigE 0/2/0/2
RP/0/RSP00/CPU0:router(config-mcast-default-ipv4-if)# boundary 1

clear 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] counter [group-address | source-address] [location {node-id | all}]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

group-address

(Optional) IP address of the multicast group.

source-address

(Optional) IP address of the source of the multicast route.

location node-id

(Optional) Clears route packet counters from the designated node.

all

The all keyword clears route packet counters on all nodes


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.

Release 3.9.1

Included the note under usage guidelines.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.


Note This command only clears MFIB route packet software counters. To clear MFIB hardware statistics counters use the clear mfib hardware route statistics command.


Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to clear MFIB route packet counters on all nodes:

RP/0/RSP0/CPU0:router# clear mfib counter location all 

clear mfib database

To clear the Multicast Forwarding Information Base (MFIB) database, use the clear mfib database command in EXEC mode.

clear mfib [ipv4] database [location {node-id | all}]

Syntax Description

ipv4

(Optional) Specifies IPv4 address prefixes.

location node-id

(Optional) Clears global resource counters from the designated node.

all

The all keyword clears all global resource counters.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read, write, execute


Examples

The following example shows how to clear the Multicast Forwarding Information Base (MFIB) database on all nodes:

RP/0/RSP0/CPU0:router# clear mfib database location all 

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] hardware resource-counters [location {node-id | all}]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

location node-id

(Optional) Clears global resource counters from the designated node.

all

The all keyword clears all global resource counters.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Use the clear mfib hardware resource-counters to estimate resource usage for an operation.

Task ID
Task ID
Operations

multicast

read, write, execute


Examples

The following example shows how to clear all global resource counters:

RP/0/RSP0/CPU0:router# clear mfib hardware resource-counters location all

Related Commands

Command
Description

show mfib hardware resource-counters

Displays platform-specific MFIB information for the packets and bytes counters for each route.


clear mfib hardware route statistics

To reset all allocated counter values matching (S,G) or (*,G) criteria , use the clear mfib hardware route statistics command in EXEC mode.

clear mfib [vrf vrf-name] [ipv4] hardware route statistics {ingress-and-egress}} [* | source-address] [group-address [/prefix-length]] [location {node-id | all}]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

ingress-and-egress

(Optional) Clears hardware statistics on both the incoming (ingress) and outgoing (egress) routes.

*

(Optional) Clears shared tree route statistics.

source-address

(Optional) IP address or hostname of the multicast route source.

group-address

(Optional) IP address or hostname of the multicast group.

/prefix-length

(Optional) Prefix length of the multicast group. A decimal value that indicates how many of the high-order contiguous bits of the address compose the prefix (the network portion of the address). A slash must precede the decimal value.

location

(Optional) Clears route packet counters from the designated node.

node-id

The node-id argument is entered in the rack/slot/module notation.

all

The all keyword clears route packet counters on all nodes


Defaults

If not specified, IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.

Release 3.9.1

Included the note under usage guidelines.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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.


Note This command only clears MFIB hardware statistics counters. To clear MFIB route packet software counters, use the clear mfib counter command.


Task ID
Task ID
Operations

multicast

read, write, execute


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/RSP0/CPU0:router# clear mfib ipv4 hardware route statistics ingress-and-egress 
location 0/1/CPU0

Related Commands

Command
Description

show mfib hardware route statistics

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 routingVRF interface configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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:

If the interface all enable command is configured:

The enable and no forms of the command have no additional effect on a specific interface.

The disable command disables multicast routing on a specific interface.

The no disable command enables a previously disabled interface.

If the interface all enable command is not configured:

The enable command enables multicast routing on a specific interface.

The no enable command enables the previously disabled interface.

The disable and no forms of the command have no additional effect on a specific interface.

Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enable multicast routing on all interfaces and disable the feature only on GigabitEthernet interface 0/1/0/0:

RP/0/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# interface all enable
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4)# interface GigE 0/1/0/0
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4-if)# disable

Related Commands

Command
Description

enable (multicast)

Enables multicast routing and forwarding on an interface.

interface all enable

Enables multicast routing and forwarding on all new and existing interfaces.


enable (multicast)

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 routing VRF interface configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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:

If the interface all enable command is configured:

The enable and no forms of the command have no additional effect on a specific interface.

The disable command disables multicast routing on a specific interface.

The no disable command enables a previously disabled interface.

If the interface all enable command is not configured:

The enable command enables multicast routing on a specific interface.

The no enable command enables a previously enabled interface.

The disable and no forms of the command have no additional effect on a specific interface.

Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enable multicast routing on a specific interface only:

RP/0/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# interface GigE 0/1/0/0
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4-if)# enable

Related Commands

Command
Description

disable (multicast)

Disables multicast routing and forwarding on an interface.

interface all enable

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 interface-path-id

no interface type interface-path-id

Syntax Description

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note Use the show interfaces command in EXEC mode to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

No default behavior or values

Command Modes

Multicast routing configuration
IPv4 or multicast routing configurationMulticast VRF configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Use the interface command to configure multicast routing properties for specific interfaces.

Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enable multicast routing on all interfaces and disable the feature only on GigabitEthernet interface 0/1/0/0:

RP/0/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# interface all enable
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4-if)# interface GigE 0/1/0/0
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4-if)# disable

Related Commands

Command
Description

disable (multicast)

Disables multicast routing and forwarding on an interface.

enable (multicast)

Enables multicast routing and forwarding on an interface.

interface all enable

Enables multicast routing and forwarding on all new and existing interfaces.


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 VRF configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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:

If the interface all enable command is configured:

The enable and no forms of the command have no additional effect on a specific interface.

The disable command disables multicast routing on a specific interface.

The no disable command enables a previously disabled interface.

If the interface all enable command is not configured:

The enable command enables multicast routing on a specific interface.

The no enable command enables a previously enabled interface.

The disable and no forms of the command have no additional effect on a specific interface.

Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enable multicast routing on all interfaces and disable the feature only on GigabitEthernet interface 0/1/0/0:

RP/0/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# interface all enable
RP/0/RSP0/CPU0:router(config-mcast)# interface GigE 0/1/0/0
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4-if)# disable

Related Commands

Command
Description

disable (multicast)

Disables multicast routing and forwarding on an interface.

enable (multicast)

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 submode. To restore the default functionality, use the no form of the command.

interface-inheritance disable

no interface-inheritance disable

Syntax Description

This command has no arguments or keywords.

Defaults

This feature is not enabled by default.

Command Modes

Multicast routing configuration
Address- family IPv4 configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Use of the interface-inheritance disable command together with the interface type interface-path-id or interface all enable command under multicast routing address-family IPv4 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 Although you can explicitly configure multicast routing functionality on individual interfaces, you cannot explicitly disable the functionality. You can only disable the functionality on all interfaces.


Used from the address-family ipv4 configuration submode, it prevents IGMP and PIM from inheriting the multicast-routing interface configuration.

Task ID
Task ID
Operations

multicast

read, write


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/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# address-family ipv4
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4)# interface-inheritance disable
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4)# interface loopback 1 enable
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4)# show run router pim

With the interface-inheritance disable command in use, IGMPand PIM configuration are enabled in the protocol configuration as follows:

router igmp
  interface loopback 0
    router enable
router pim
   interface loopback 0
     enable
router pim vrf default address-family ipv4
 interface Loopback0
  enable
 !
! 
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4)# show run router igmp
router igmp
 vrf default
  interface GigabitEthernet0/6/0/3
   router 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

This command is disabled by default.

Command Modes

Multicast routing configuration
Multicast routing address family IPv4 configuration
Multicast VRF configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enable logging of trap events:

RP/0/RSP0/CPU0:router# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# log-traps

maximum 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 routing address family IPv4 configuration
Multicast VRF configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Use the maximum disable command to override the default software limit on the number of multicast routes.

Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to disable maximum state limits:

RP/0/RSP0/CPU0:router# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# maximum disable

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 interface-path-id

no mhost {ipv4 | ipv6}} default-interface type interface-path-id

Syntax Description

ipv4

Specifies IPv4 address prefixes.

ipv6

Specifies IPv6 address prefixes.

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note Use the show interfaces command in EXEC mode to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

If no Multicast Host (MHost) default interface is configured, an arbitrary interface is selected as the active MHost default.

If multicast routing feature is enabled, a multicast-enabled interface is always selected as the MHost default interface.

Command Modes

Global configuration
Global VRF configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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.

The ping and mtrace features 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
Task ID
Operations

multicast

read, write


Examples

The following example shows how to configure Loopback interface 1 as the default interface:

RP/0/RSP0/CPU0:router(config)# mhost ipv4 default-interface loopback 1

Related Commands

Command
Description

show mhost default-interface

Displays the configured and active default interface for the MHost process.


multicast-routing

To enter multicast routing configuration mode, use the multicast-routing command in global configuration mode. To return to the default behavior, use the no form of this command.

multicast-routing

no multicast-routing

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Global configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

N o modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enter multicast routing configuration mode:

RP/0/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)

Related Commands

Command
Description

accounting per-prefix

Enables per-prefix counters only in hardware.

alias

Creates a command alias.

interface (multicast)

Configures multicast interface properties.

interface all enable

Enables multicast routing and forwarding on all new and existing interfaces.


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.

[address-family ipv4] multipath [hash {source | source next-hop}]

]

no multipath

Syntax Description

hash

(Optional) Enables multipath hashing.

source

Enables source-based multipath hashing.

source-nexthop

(Optional) Enables source with next-hop hashing.

Note This option is available only for IPv6 addressing.


Defaults

This command is disabled by default.

Command Modes

Multicast routing configuration
Multicast routing address-family ipv4
Multicast VRF configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

N o modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enable multipath functionality:

RP/0/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# multipath hash

nsf (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

This command is disabled by default.

Command Modes

Multicast routing configuration
Multicast routing address family ipv4 configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

N o modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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 For NSF to operate successfully in your multicast network, you must also enable NSF for the unicast protocols (such as Intermediate System-to-Intermediate System [IS-IS], Open Shortest Path First [OSPF] and Border Gateway Protocol [BGP]) that PIM relies on for Reverse Path Forwarding (RPF) information. See the appropriate configuration modules to learn how to configure NSF for unicast protocols.


Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enable NSF for the multicast routing system:

RP/0/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# nsf

Related Commands

Command
Description

nsf lifetime (IGMP)

Configures the maximum time for the NSF timeout value under IGMP.

nsf lifetime (PIM)

Configures the NSF timeout value for the PIM process.

show igmp nsf

Displays the state of NSF operation in IGMP.

show mfib nsf

Displays the state of NSF operation for the MFIB line cards.

show mrib nsf

Displays the state of NSF operation in the MRIB.

show pim nsf

Displays the state of NSF operation for PIM.


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 command is disabled by default.

Command Modes

Multicast routing configurationMulticast routing address family ipv4 configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

When the oom-handling command is enabled, and the router memory is low or in a warning state, the following states are not created:

Protocol Independent Multicast (PIM) route states in response to PIM join and prune messages, and register messages

Internet Group Management Protocol (IGMP) group states

External Source-Active (SA) states in Multicast Source Discovery Protocol (MSDP)

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
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enable the out-of-memory functionality:

RP/0/RSP0/CPU0:router# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# oom-handling

Related Commands

Command
Description

show pim topology

Displays PIM topology table information.


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 command is disabled by default.

Command Modes

Multicast routing configuration
Multicast routing address family ipv4 configurationMulticast VRF configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to enable individual route calculations:

RP/0/RSP0/CPU0:router# multicast-routing vrf vpn12 address-family ipv4
RP/0/RSP0/CPU0:router(config-mcast)# rate-per-route 

Related Commands

Command
Description

show mfib route

Displays cumulative multicast rates per route for one or for all line cards in the Multicast Forwarding Information Base (MFIB) table, depending on which keyword is used.


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 | ] connections [location node-id]

Syntax Description

ipv4

(Optional) Specifies IPv4 address prefixes.

location node-id

(Optional) Specifies MFIB connections associated with an interface of the designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Use the show mfib connections command to display a list of servers connected to the MFIB and the status of the connections.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mfib connections command:

RP/0/RSP0/CPU0:router# show mfib connections
Netio            : connected
IM               : connected
Pakman           : connected
MRIB             : connected
IFH              : connected
SysDB-Global     : connected
SysDB-Local      : connected
SysDB-NSF        : connected
SYSDB-EDM        : connected
SYSDB-Action     : connected
AIB              : connected
MLIB             : connected
IDB              : connected
IIR              : connected
IPARM            : connected
GSP              : connected

Related Commands

Command
Description

show mfib interface

Displays hardware switching interface information for the MFIB process.

show mfib route

Displays 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] counter [location node-id]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

location node-id

(Optional) Specifies MFIB counter statistics associated with an interface of the designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

The show mfib counter command displays packet drop statistics for packets that cannot be accounted for under route counters.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mfib counter command:

RP/0/RSP0/CPU0:router# show mfib counter location 0/1/CPU0
MFIB 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]   : 0
* Packets [MC disabled on input I/F (iarm nfn)]      : 0

Table 15 describes the significant fields shown in the display.

Table 15 show mfib counter Field Descriptions 

Field
Description

Packets [no input idb]

Packets dropped because no input interface information was found in the packet.

Packets [failed route lookup]

Packets dropped because of failure to match any multicast route.

Packets [Failed idb lookup]

Packets dropped because the descriptor block was not found for an interface (incoming or outgoing).

Packets [Mcast disabled on input I/F]

Packets dropped because arriving on an interface that was not enabled for the multicast routing feature.

Packets [encap drops due to ratelimit]

Packets dropped because of rate limit.

Packets [MC disabled on input I/F (iarm nfn)

 


Related Commands

Command
Description

show mfib interface

Displays hardware switching interface information for the MFIB process.

show mfib route

Displays entries in the MFIB table.


show mfib encap-info

To display the status of encapsulation information for Multicast Forwarding Information Base (MFIB), use the show mfib encap-info command in EXEC mode.

show mfib [vrf vrf-name] ipv4 encap-info [location node-id]

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.

location node-id

(Optional) Specifies MFIB connections associated with an interface of the designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mfib encap-info command:

RP/0/RSP0/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

Command
Description

show mfib interface

Displays hardware switching interface information for the MFIB process.

show mfib route

Displays 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] hardware interface [detail] [type interface-path-id] [location node-id]

Syntax DescriptionTo 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 Cisco IOS XR System Security Configuration Guide.

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

detail

(Optional) Displays detailed information about the MFIB interface.

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

interface-path-id

(Optional) Physical interface or virtual interface.

Note Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

location node-id

(Optional) Specifies an MFIB-designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

The show mfib hardware interface command displays multicast-specific information about the software switching interfaces of the router hardware.

Task ID
Task ID
Operations

multicast

read


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.

RP/0/RSP0/CPU0:router# show mfib hardware interface location 0/0/CPU0 
LC Type: Trident
--------------------------------------------------------------------
Interface       Handle     RefCnt TTL Routes uIDB  Enbld Comment
--------------------------------------------------------------------
Gi0/0/0/4       0x180      5      0   2      5     True   success
Gi0/0/0/5       0x1c0      27     0   0      6     True   success
Gi0/0/0/6       0x200      5      0   2      7     True   success
Gi0/0/0/7       0x240      25     0   0      8     True   success
Gi0/0/0/8       0x280      30     0   2      9     True   success
--------------------------------------------------------------------
ROUTE INFORMATION:
Legend:
 S: Source, G: Group, P: Prefix length, PI: Packets cn, PO: packets out,
 RF: RPF failures, TF: TTL failures, OF: OLIST failures, F: Other failures
Route flags - (Ingress)
 C: Chip ID, IC: BACL check, IP: Punt this packet to LC CPU,
 ID: Directly connected, IS: RPF interface signal, IU: Punt copy to RP,
 IF: Punt to LC CPU if forwarded, IM: Result match, IV: Valid entry,
 IR: RPF IF, IA: Fabric slotmask, IG: Mulicast group ID
Route flags - (Egress)
 ET: Table ID to be used for OLIST lookup, EO: OLIST count bit,
 ER: Route MGID to be used for OLIST/NRPF lookup, EM: Result match,
 EV: Valid entry, EC: Count of OLIST members on this chip,
 BS: Base of the statistics pointer
Interface: Gi0/0/0/4
  S:4.0.0.2 G:227.0.0.1 P:32 PI:1 PO:0 RF:0 TF:0 OF:0 F:0
  ---------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ---------------------------------------------------------------------------------
  0  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 0  F  6    T  T  0    0x5518a 
  1  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 0  F  6    T  T  0    0x5518a 
  2  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 0  F  6    T  T  0    0x5518a 
  3  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 1  T  6    T  T  3    0x555c2 
  ---------------------------------------------------------------------------------
  S:0.0.0.0 G:227.0.0.1 P:32 PI:4 PO:0 RF:0 TF:0 OF:0 F:0
  ---------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ---------------------------------------------------------------------------------
  0  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  1  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  2  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  3  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 1  T  5    T  T  3    0x555bd 
  ---------------------------------------------------------------------------------
Interface: Gi0/0/0/5
  This interface is not part of the olist of any route
Interface: Gi0/0/0/6
  S:4.0.0.2 G:227.0.0.1 P:32 PI:1 PO:0 RF:0 TF:0 OF:0 F:0
  ---------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ---------------------------------------------------------------------------------
  0  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 0  F  6    T  T  0    0x5518a 
  1  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 0  F  6    T  T  0    0x5518a 
  2  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 0  F  6    T  T  0    0x5518a 
  3  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 1  T  6    T  T  3    0x555c2 
  ---------------------------------------------------------------------------------
  S:0.0.0.0 G:227.0.0.1 P:32 PI:4 PO:0 RF:0 TF:0 OF:0 F:0
  ---------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ---------------------------------------------------------------------------------
  0  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  1  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  2  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  3  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 1  T  5    T  T  3    0x555bd 
  ---------------------------------------------------------------------------------
Interface: Gi0/0/0/7
  This interface is not part of the olist of any route
Interface: Gi0/0/0/8
  S:4.0.0.2 G:227.0.0.1 P:32 PI:1 PO:0 RF:0 TF:0 OF:0 F:0
  ---------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ---------------------------------------------------------------------------------
  0  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 0  F  6    T  T  0    0x5518a 
  1  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 0  F  6    T  T  0    0x5518a 
  2  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 0  F  6    T  T  0    0x5518a 
  3  F  F  F  F  F  F  T  T  0x180      0x1    0x8006 1  T  6    T  T  3    0x555c2 
  ---------------------------------------------------------------------------------
  S:0.0.0.0 G:227.0.0.1 P:32 PI:4 PO:0 RF:0 TF:0 OF:0 F:0
  ---------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ---------------------------------------------------------------------------------
  0  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  1  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  2  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  3  F  F  T  F  F  F  T  T  0x0        0x1    0x8004 1  T  5    T  T  3    0x555bd 
---------------------------------------------------------------------------------

Table 16 describes the significant fields shown in the display.

Table 16 show mfib hardware interface Field Descriptions 

Field
Description

Interface

MFIB interface name.

Handle

A 32-bit system-wide identifier of the MFIB interface.

RefCnt

Number of times various data structures referred to this MFIB interface structure.

TTL

Multicast time-to-live threshold that was configured on this MFIB interface.

Routes

The number of routes that include this interface as a member.

uIDB

The ucode Interface Descriptor Block index.

Enbld

If true, multicast is enabled on the MFIB interface.

Comment

Indicates whether there were problems when reading hardware information.


Related Commands

Command
Description

show mfib interface

Displays hardware switching interface information for the MFIB process.


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] hardware resource-counters {location node-id}

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

location node-id

Specifies an MFIB-designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Use the show mfib hardware resource-counters command to understand the table lookup unit (TLU) resource usage by MFIB.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mfib hardware resource-counters command:

RP/0/RSP0/CPU0:router# show mfib hardware resource-counters location 0/0/CPU0
LC Type: Trident
prm_stat success calls: ingress: 4250,4092       egress: 0,0 
prm_stat failure calls: ingress: 0,0     egress: 0,0 
Memory alloc stats
-----------------------------------------------------
   Type              Allocated     Freed     Delta
-----------------------------------------------------
global                       0         0         0
table extension              0         0         0
route extension            187       180         7
interface extension        221       215         6
idb extension               52        47         5
kmrs                       159       159         0
kmrs key                   652       652         0
kmrs result                488       488         0
uidb data                  437       437         0
EDM bag data                 5         3         2
-----------------------------------------------------

Table 17 describes the significant fields shown in the display.

Table 17 show mfib hardware resource counters Field Descriptions 

Field
Description

prm_stat success calls

The number of successful calls to allocate and free statistics blocks, for ingress and egress statistics.

prm_stat failure calls

The number of failed calls to allocate and free statistics blocks, for ingress and egress statistics.

Type

Describes the structure type.

Allocated

The number of blocks allocated per structure type.

Freed

The number of blocks freed per structure type.

Delta

The difference between allocated and freed blocks per structure type.


Related Commands

Command
Description

clear mfib hardware resource-counters

Clears the resource counters.

show mfib interface

Displays hardware switching interface information for the MFIB process.


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] hardware route accept-bitmap [*] [group-address [/prefix-length]] [detail] [location node-id]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

*

(Optional) Displays shared tree entry.

group-address

(Optional) IP address or hostname of the multicast group.

/prefix-length

(Optional) Prefix length of the multicast group. A decimal value that indicates how many of the high-order contiguous bits of the address compose the prefix (the network portion of the address). A slash must precede the decimal value.

detail

(Optional) Detailed list of the routing database.

location node-id

(Optional) Specifies an MFIB-designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read


Examples

In the following example, the bidirectional range is configured as:

RP/0/RSP0/CPU0:router# show mfib hardware route accept-bitmap detail location 0/0/CPU0 
LC Type: Trident
Source: Source address   Group: Group Address    M: Mask Length
        iQoS  : Ingress QoS tag                  C    : Directly connected check flag
        RPF   : Accepting interface for non-bidir entries
        S     : Signal on RPF interface          FU   : For us
        FGID  : Fabric Group ID
        oQoS  : Output QoS tag
        FGID2 : Secondary Fabric Group ID
        A_num    : Number of I/Fs in the accepting list
Interface: Accepting interface name
Source          Group           M  
Source: *               Group: 224.0.0.0       Mask length: 24 
Source: *               Group: 224.0.1.39      Mask length: 32 
Source: *               Group: 224.0.1.40      Mask length: 32 
Source: *               Group: 227.0.0.1       Mask length: 32 
Source: 4.0.0.2         Group: 227.0.0.1       Mask length: 64 
Source: *               Group: 230.0.0.0       Mask length: 8  
Source: *               Group: 232.0.0.0       Mask length: 8  

Related Commands

Command
Description

show mfib interface

Displays hardware switching interface information for the MFIB process.


show mfib hardware route internal

To display the route internal structures for the platform-specific Multicast Forwarding Information Base (MFIB) in the hardware, use the show mfib hardware route internal command in EXEC mode.

show mfib [vrf vrf-name] [ipv4 ] hardware route internal [*] [source-address] [group-address [/prefix-length]] [detail] [location node-id]

Syntax Description

*

(Optional) Displays shared tree entries.

A.B.C.D

(Optional) Source IP address or hostname of the MFIB route.

A.B.C.D/length

(Optional) Group IP address or hostname of the MFIB route and the prefix length. Prefix length of the MFIB group address is a decimal value that indicates how many of the high-order contiguous bits of the address compose the prefix (the network portion of the address). A slash must precede the decimal value.

detail

(Optional) Details of each route (requires 140 columns).

location node-id

(Optional) Specifies the MFIB location.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.9.1

This command was introduced on Cisco ASR 9000 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. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read


Examples

The following example shows a sample output of the show mfib hardware route internal command:

RP/0/RSP0/CPU0:router# show mfib hardware route internal detail location 0/1/CPU0
LC Type: Trident
--------------------------------------------------------------------------
Legend:
Route Information - (Ingress)
 NP: Network Processor, IC: BACL check, IP: Punt this packet to LC CPU,
 ID: Directly connected, IS: RPF interface signal, IU: Punt copy to RP,
 IF: Punt to LC CPU if forwarded, IM: Result match, IV: Valid entry,
 IR: RPF IF, IA: Fabric slotmask, IG: Multicast group ID
Route Information - (Egress)
 ET: Table ID to be used for OLIST lookup, EO: OLIST count bit,
 ER: Route MGID to be used for OLIST/NRPF lookup, EM: Result match,
 EV: Valid entry, EC: Count of OLIST members on this chip,
 BS: Base of the statistics pointer
Route Information - (MDT)
 TU: Tunnel Route, TE: Tunnel Encap, TD: Tunnel Decap,
 CD: Conditional Decap, MI: MVET Index
MDT Encap Information
 NP: Network Processor, UC: Use Customer ToS,
 Csum: IP Checksum, TID: Table ID, UIDB: Tunnnel UIDB,
 T-ifh: Tunnel Interface Handle, StatP: Tunnnel Stat Ptr,
 CMG: Core Route Multicast Group ID, TMTU: Tunnnel MTU
Software Route Information (PD)
 T: Tunnel Route, E: Encap, D: Decap, CD: Conditional Decap,
 MVET-ID: MDT Encap Table ID, MVD: MVET Entry Dirty,
 TUS: Tunnel UIDB Set, TID: Table ID, UIDB: Tunnnel UIDB
 TMTU: Tunnnel MTU
--------------------------------------------------------------------------
Source: *               Group: 224.0.0.0       Mask length: 4   RPF Int: None   
  Route Information
  -----------------
  ------------------------------------------------------------------------------
  N  I I I I I I I I I          I      I      E E E    E E E    B        T T T  
  P  C P D S U F M V R          A      G      T O R    M V C    S        U E D  
  ------------------------------------------------------------------------------
  0  T F T F F F T T 0x0        0x0    0x8080 0 F 3    T T 0    0x3640f  F F F  
  1  T F T F F F T T 0x0        0x0    0x8080 0 F 3    T T 0    0x3640f  F F F  
  2  T F T F F F T T 0x0        0x0    0x8080 0 F 3    T T 0    0x3640f  F F F  
  3  T F T F F F T T 0x0        0x0    0x8080 0 F 3    T T 0    0x3640f  F F F  
  Software Route Information (PD)
  -------------------------------
  T E D CD MVET-ID MVD TUS TID        UIDB   T-ifh      TMTU 
  -----------------------------------------------------------
  F F F F  0x0     F   F   0x0        0x0    0x0        0    
  -----------------------------------------------------------
Source: *               Group: 224.0.0.0       Mask length: 24  RPF Int: None   
  Route Information
  -----------------
  ------------------------------------------------------------------------------
  N  I I I I I I I I I          I      I      E E E    E E E    B        T T T  
  P  C P D S U F M V R          A      G      T O R    M V C    S        U E D  
  ------------------------------------------------------------------------------
  0  T F F F F F T T 0x0        0x0    0x8084 0 F 0    T T 0    0x36400  F F F  
  1  T F F F F F T T 0x0        0x0    0x8084 0 F 0    T T 0    0x36400  F F F  
  2  T F F F F F T T 0x0        0x0    0x8084 0 F 0    T T 0    0x36400  F F F  
  3  T F F F F F T T 0x0        0x0    0x8084 0 F 0    T T 0    0x36400  F F F  
  Software Route Information (PD)
  -------------------------------
  T E D CD MVET-ID MVD TUS TID        UIDB   T-ifh      TMTU 
  -----------------------------------------------------------
  F F F F  0x0     F   F   0x0        0x0    0x0        0    
  -----------------------------------------------------------
Source: *               Group: 224.0.1.39      Mask length: 32  RPF Int: None   
  Route Information
  -----------------
  ------------------------------------------------------------------------------
  N  I I I I I I I I I          I      I      E E E    E E E    B        T T T  
  P  C P D S U F M V R          A      G      T O R    M V C    S        U E D  
  ------------------------------------------------------------------------------
  0  F T F F F F T T 0x0        0x0    0x8085 0 F 1    T T 0    0x36405  F F F  
  1  F T F F F F T T 0x0        0x0    0x8085 0 F 1    T T 0    0x36405  F F F  
  2  F T F F F F T T 0x0        0x0    0x8085 0 F 1    T T 0    0x36405  F F F  
  3  F T F F F F T T 0x0        0x0    0x8085 0 F 1    T T 0    0x36405  F F F  
  Software Route Information (PD)
  -------------------------------
  T E D CD MVET-ID MVD TUS TID        UIDB   T-ifh      TMTU 
  -----------------------------------------------------------
  F F F F  0x0     F   F   0x0        0x0    0x0        0    
  -----------------------------------------------------------
Source: *               Group: 224.0.1.40      Mask length: 32  RPF Int: None   
  Route Information
  -----------------
  ------------------------------------------------------------------------------
  N  I I I I I I I I I          I      I      E E E    E E E    B        T T T  
  P  C P D S U F M V R          A      G      T O R    M V C    S        U E D  
  ------------------------------------------------------------------------------
  0  F T F F F F T T 0x0        0x0    0x8086 0 F 7    T T 0    0x36423  F F F  
  1  F T F F F F T T 0x0        0x0    0x8086 0 F 7    T T 0    0x36423  F F F  
  2  F T F F F F T T 0x0        0x0    0x8086 0 F 7    T T 0    0x36423  F F F  
  3  F T F F F F T T 0x0        0x0    0x8086 0 F 7    T T 0    0x36423  F F F  
  Software Route Information (PD)
  -------------------------------
  T E D CD MVET-ID MVD TUS TID        UIDB   T-ifh      TMTU 
  -----------------------------------------------------------
  F F F F  0x0     F   F   0x0        0x0    0x0        0    
  -----------------------------------------------------------
Source: *               Group: 232.0.0.0       Mask length: 8   RPF Int: None   
  Route Information
  -----------------
  ------------------------------------------------------------------------------
  N  I I I I I I I I I          I      I      E E E    E E E    B        T T T  
  P  C P D S U F M V R          A      G      T O R    M V C    S        U E D  
  ------------------------------------------------------------------------------
  0  T F F F F F T T 0x0        0x0    0x8087 0 F 2    T T 0    0x3640a  F F F  
  1  T F F F F F T T 0x0        0x0    0x8087 0 F 2    T T 0    0x3640a  F F F  
  2  T F F F F F T T 0x0        0x0    0x8087 0 F 2    T T 0    0x3640a  F F F  
  3  T F F F F F T T 0x0        0x0    0x8087 0 F 2    T T 0    0x3640a  F F F  
  Software Route Information (PD)
  -------------------------------
  T E D CD MVET-ID MVD TUS TID        UIDB   T-ifh      TMTU 
  -----------------------------------------------------------
  F F F F  0x0     F   F   0x0        0x0    0x0        0    
  -----------------------------------------------------------
Source: *               Group: 239.60.0.0      Mask length: 16  RPF Int: Gi0/1/ 
  Route Information
  -----------------
  ------------------------------------------------------------------------------
  N  I I I I I I I I I          I      I      E E E    E E E    B        T T T  
  P  C P D S U F M V R          A      G      T O R    M V C    S        U E D  
  ------------------------------------------------------------------------------
  0  T F F F F F T T 0x2000500  0x0    0x8081 0 F 6    T T 0    0x3641e  F F F  
  1  T F F F F F T T 0x2000500  0x0    0x8081 0 F 6    T T 0    0x3641e  F F F  
  2  T F F F F F T T 0x2000500  0x0    0x8081 0 F 6    T T 0    0x3641e  F F F  
  3  T F F F F F T T 0x2000500  0x0    0x8081 0 F 6    T T 0    0x3641e  F F F  
  Software Route Information (PD)
  -------------------------------
  T E D CD MVET-ID MVD TUS TID        UIDB   T-ifh      TMTU 
  -----------------------------------------------------------
  F F F F  0x0     F   F   0x0        0x0    0x0        0    
  -----------------------------------------------------------
Source: *               Group: 239.60.60.60    Mask length: 32  RPF Int: None   
  Route Information
  -----------------
  ------------------------------------------------------------------------------
  N  I I I I I I I I I          I      I      E E E    E E E    B        T T T  
  P  C P D S U F M V R          A      G      T O R    M V C    S        U E D  
  ------------------------------------------------------------------------------
  0  T F F F F F T T 0x0        0x40   0x8089 0 F 5    T T 0    0x36419  F F F  
  1  T F F F F F T T 0x0        0x40   0x8089 0 F 5    T T 0    0x36419  F F F  
  2  T F F F F F T T 0x0        0x40   0x8089 0 F 5    T T 0    0x36419  F F F  
  3  T F F F F F T T 0x0        0x40   0x8089 0 F 5    T T 0    0x36419  F F F  
  Software Route Information (PD)
  -------------------------------
  T E D CD MVET-ID MVD TUS TID        UIDB   T-ifh      TMTU 
  -----------------------------------------------------------
  F F F F  0x0     F   F   0x0        0x0    0x0        0    
  -----------------------------------------------------------
Source: *               Group: 239.60.62.62    Mask length: 32  RPF Int: None   
  Route Information
  -----------------
  ------------------------------------------------------------------------------
  N  I I I I I I I I I          I      I      E E E    E E E    B        T T T  
  P  C P D S U F M V R          A      G      T O R    M V C    S        U E D  
  ------------------------------------------------------------------------------
  0  T F F F F F T T 0x0        0x40   0x8088 0 F 4    T T 0    0x36414  F F F  
  1  T F F F F F T T 0x0        0x40   0x8088 0 F 4    T T 0    0x36414  F F F  
  2  T F F F F F T T 0x0        0x40   0x8088 0 F 4    T T 0    0x36414  F F F  
  3  T F F F F F T T 0x0        0x40   0x8088 0 F 4    T T 0    0x36414  F F F  
  Software Route Information (PD)
  -------------------------------
  T E D CD MVET-ID MVD TUS TID        UIDB   T-ifh      TMTU 
  -----------------------------------------------------------
  F F F F  0x0     F   F   0x0        0x0    0x0        0    
  -----------------------------------------------------------
Source: *               Group: 239.60.64.64    Mask length: 32  RPF Int: None   
  Route Information
  -----------------
  ------------------------------------------------------------------------------
  N  I I I I I I I I I          I      I      E E E    E E E    B        T T T  
  P  C P D S U F M V R          A      G      T O R    M V C    S        U E D  
  ------------------------------------------------------------------------------
  0  T F F F F F T T 0x0        0x2    0x8082 0 F 8    T T 0    0x36428  F F F  
  1  T F F F F F T T 0x0        0x2    0x8082 1 T 8    T T 1    0x36428  F F F  
  2  T F F F F F T T 0x0        0x2    0x8082 0 F 8    T T 0    0x36428  F F F  
  3  T F F F F F T T 0x0        0x2    0x8082 0 F 8    T T 0    0x36428  F F F  
  Software Route Information (PD)
  -------------------------------
  T E D CD MVET-ID MVD TUS TID        UIDB   T-ifh      TMTU 
  -----------------------------------------------------------
  F F F F  0x0     F   F   0x0        0x0    0x0        0    
  -----------------------------------------------------------
Source: *               Group: 239.60.66.66    Mask length: 32  RPF Int: None   
  Route Information
  -----------------
  ------------------------------------------------------------------------------
  N  I I I I I I I I I          I      I      E E E    E E E    B        T T T  
  P  C P D S U F M V R          A      G      T O R    M V C    S        U E D  
  ------------------------------------------------------------------------------
  0  T F F F F F T T 0x0        0x2    0x8083 0 F 9    T T 0    0x3642d  F F F  
  1  T F F F F F T T 0x0        0x2    0x8083 1 T 9    T T 1    0x3642d  F F F  
  2  T F F F F F T T 0x0        0x2    0x8083 0 F 9    T T 0    0x3642d  F F F  
  3  T F F F F F T T 0x0        0x2    0x8083 0 F 9    T T 0    0x3642d  F F F  
  Software Route Information (PD)
  -------------------------------
  T E D CD MVET-ID MVD TUS TID        UIDB   T-ifh      TMTU 
  -----------------------------------------------------------
  F F F F  0x0     F   F   0x0        0x0    0x0        0    
  -----------------------------------------------------------

show mfib hardware route mofrr

To display the platform-specific Multicast Forwarding Information Base (MFIB) information for the MoFRR (multicast only fast reroute)- enabled list stored in the hardware, use the show mfib hardware route mofrr command in EXEC mode.

show mfib hardware route mofrr {[*] [source-address] [group-address [detail]} location node-id

Syntax Description

*

(Optional) Displays all the MoFRR routes configured in the platform.

source-address

(Optional) IP address or hostname of the multicast route source.

group-address

(Optional) IP address or hostname of the multicast group.

detail

(Optional) Displays a detailed list of the MoFRR routing database.

location node-id

Specifies the Node ID for an MFIB-designated node.


Defaults

IPv4 addressing is the default. Currently, MoFRR in Cisco ASR 9000 Series Router supports only IPv4 routes.

Command Modes

EXEC

Command History

Release
Modification

Release 3.9.0

This command was introduced on the Cisco ASR 9000 Series Router.


Usage Guidelines

TTo use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

MoFRR is a mechanism in which two copies of the same multicast stream flow through disjoint paths in the network. At the point in the network (usually the PE closer to the receivers) where the two streams merge, one of the streams is accepted and forwarded on the downstream links, while the other stream is discarded. When a failure is detected in the primary stream due to a link or node failure in the network, MoFRR instructs the forwarding plane to start accepting packets from the backup stream (which now becomes the primary stream).

MoFRR is triggered when the hardware detects traffic loss on the primary path of a given flow or route. Traffic loss is defined as no data packet having been received for 30 ms. When MoFRR is triggered, the primary and secondary reverse-path forwarding (RPF) interfaces are exposed to the forwarding plane and switchover occurs entirely at the hardware level.

The show mfib hardware route mofrr command displays the output MoFRR route list of the platform. If there is no MoFRR route enabled in the platform, then the output result is "There are no MoFRR routes configured".

Task ID
Task ID
Operations

multicast

read


Examples

The following is a sample output from the show mfib hardware route mofrr command:

RP/0/RSP0/CPU0:router# show mfib hardware route mofrr location 0/0/cpu0 
LC Type: Trident
--------------------------------------------------------------------------
Legend:
Route MoFRR Information
 A: Active RPF interface, MS: Monitoring State,
 WDI: Watchdog Count Index, NP: Network Processor,
--------------------------------------------------------------------------
Source: 20.20.20.1      Group: 225.0.0.1       Mask length: 64  RPF Int: Gi0/0/0/8
  -----------------------------------------------------
  RPFS       Interface       A  MS  WDI
  -----------------------------------------------------
  Primary:   Gi0/0/0/8       T  2   1846768
  Backup:    Gi0/0/0/18      F  0   1846769
  -----------------------------------------------------
  OIFS
  ---------------
  NP  Intf
  ---------------
  1   Gi0/0/0/28
  ---------------
  Sequence num: 1  Num of switchovers: 0
  WatchDog Counters:
  -----------------------------------------------------------
             NP   Profile   Valid   Current-Cnt   Last-cnt
  -----------------------------------------------------------
  Prim WDC    0         0       0          3848         12
  Prim WDC    1         0       0          3848         12
  Prim WDC    2         0       0          3848         12
  Prim WDC    3         1       1          3848         12
  Back WDC    0         0       0          3848         12
  Back WDC    1         0       0          3848         12
  Back WDC    2         0       0          3848         12
  Back WDC    3         0       0          3848         12
  -----------------------------------------------------------
  MoFRR Statistics:
  -----------------------------------------------------------
  NP   Prim pkt rx   Back pkt rx    Interrupts         Punts
  -----------------------------------------------------------
   0             0             0             0             0
   1             0             0             0             0
   2             0             0             0             0
   3        406213             0             1             1
  -----------------------------------------------------------
Source: 20.20.20.1      Group: 225.0.0.2       Mask length: 64  RPF Int: Gi0/0/0/8
  -----------------------------------------------------
  RPFS       Interface       A  MS  WDI
  -----------------------------------------------------
  Primary:   Gi0/0/0/8       T  2   1846770
  Backup:    Gi0/0/0/18      F  0   1846771
  -----------------------------------------------------
  OIFS
  ---------------
  NP  Intf
  ---------------
  1   Gi0/0/0/28
  ---------------
  Sequence num: 1  Num of switchovers: 0
  WatchDog Counters:
  -----------------------------------------------------------
             NP   Profile   Valid   Current-Cnt   Last-cnt
  -----------------------------------------------------------
  Prim WDC    0         0       0          3848         12
  Prim WDC    1         0       0          3848         12
  Prim WDC    2         0       0          3848         12
  Prim WDC    3         1       1          3848         12
  Back WDC    0         0       0          3848         12
  Back WDC    1         0       0          3848         12
  Back WDC    2         0       0          3848         12
  Back WDC    3         0       0          3848         12
  -----------------------------------------------------------
  MoFRR Statistics:
  -----------------------------------------------------------
  NP   Prim pkt rx   Back pkt rx    Interrupts         Punts
  -----------------------------------------------------------
   0             0             0             0             0
   1             0             0             0             0
   2             0             0             0             0
   3        406212        0             1             1
  -----------------------------------------------------------

The following is sample output from the show mfib hardware route MoFRR command with only one multicast group:

RP/0/RSP0/CPU0:router# show mfib hardware route mofrr 225.0.0.1 location 0/0/CPU0
LC Type: Trident
--------------------------------------------------------------------------
Legend:
Route MoFRR Information
 A: Active RPF interface, MS: Monitoring State,
 WDI: Watchdog Count Index, NP: Network Processor,
--------------------------------------------------------------------------
Source: 20.20.20.1      Group: 225.0.0.1       Mask length: 64  RPF Int: Gi0/0/0/8
  -----------------------------------------------------
  RPFS       Interface       A  MS  WDI
  -----------------------------------------------------
  Primary:   Gi0/0/0/8       T  2   1846772
  Backup:    Gi0/0/0/18      F  0   1846773
  -----------------------------------------------------
  OIFS
  ---------------
  NP  Intf
  ---------------
  1   Gi0/0/0/28
  ---------------
  Sequence num: 1  Num of switchovers: 0
  WatchDog Counters:
  -----------------------------------------------------------
             NP   Profile   Valid   Current-Cnt   Last-cnt
  -----------------------------------------------------------
  Prim WDC    0         0       0          3848         12
  Prim WDC    1         0       0          3848         12
  Prim WDC    2         0       0          3848         12
  Prim WDC    3         1       1          3848         12
  Back WDC    0         0       0          3848         12
  Back WDC    1         0       0          3848         12
  Back WDC    2         0       0          3848         12
  Back WDC    3         0       0          3848         12
  -----------------------------------------------------------
  MoFRR Statistics:
  -----------------------------------------------------------
  NP   Prim pkt rx   Back pkt rx    Interrupts         Punts
  -----------------------------------------------------------
   0             0             0             0             0
   1             0             0             0             0
   2             0             0             0             0
   3        400465             0             1             1
  -----------------------------------------------------------

The following is sample output from the show mfib hardware route MoFRR command with only one multicast source:

RP/0/RSP0/CPU0:router# show mfib hardware route mofrr 20.20.20.1 location 0/0/CPU0
LC Type: Trident
--------------------------------------------------------------------------
Legend:
Route MoFRR Information
 A: Active RPF interface, MS: Monitoring State,
 WDI: Watchdog Count Index, NP: Network Processor,
--------------------------------------------------------------------------
Source: 20.20.20.1      Group: 225.0.0.1       Mask length: 64  RPF Int: Gi0/0/0/8
  -----------------------------------------------------
  RPFS       Interface       A  MS  WDI
  -----------------------------------------------------
  Primary:   Gi0/0/0/8       T  2   1846772
  Backup:    Gi0/0/0/18      F  0   1846773
  -----------------------------------------------------
  OIFS
  ---------------
  NP  Intf
  ---------------
  1   Gi0/0/0/28
  ---------------
  Sequence num: 1  Num of switchovers: 0
  WatchDog Counters:
  -----------------------------------------------------------
             NP   Profile   Valid   Current-Cnt   Last-cnt
  -----------------------------------------------------------
  Prim WDC    0         0       0          3848         12
  Prim WDC    1         0       0          3848         12
  Prim WDC    2         0       0          3848         12
  Prim WDC    3         1       1          3848         12
  Back WDC    0         0       0          3848         12
  Back WDC    1         0       0          3848         12
  Back WDC    2         0       0          3848         12
  Back WDC    3         0       0          3848         12
  -----------------------------------------------------------
  MoFRR Statistics:
  -----------------------------------------------------------
  NP   Prim pkt rx   Back pkt rx    Interrupts         Punts
  -----------------------------------------------------------
   0             0             0             0             0
   1             0             0             0             0
   2             0             0             0             0
   3             0             0             1             1
  -----------------------------------------------------------
Source: 20.20.20.1      Group: 225.0.0.2       Mask length: 64  RPF Int: Gi0/0/0/8
  -----------------------------------------------------
  RPFS       Interface       A  MS  WDI
  -----------------------------------------------------
  Primary:   Gi0/0/0/8       T  2   1846774
  Backup:    Gi0/0/0/18      F  0   1846775
  -----------------------------------------------------
  OIFS
  ---------------
  NP  Intf
  ---------------
  1   Gi0/0/0/28
  ---------------
  Sequence num: 1  Num of switchovers: 0
  WatchDog Counters:
  -----------------------------------------------------------
             NP   Profile   Valid   Current-Cnt   Last-cnt
  -----------------------------------------------------------
  Prim WDC    0         0       0          3848         12
  Prim WDC    1         0       0          3848         12
  Prim WDC    2         0       0          3848         12
  Prim WDC    3         1       1          3848         12
  Back WDC    0         0       0          3848         12
  Back WDC    1         0       0          3848         12
  Back WDC    2         0       0          3848         12
  Back WDC    3         0       0          3848         12
  -----------------------------------------------------------
  MoFRR Statistics:
  -----------------------------------------------------------
  NP   Prim pkt rx   Back pkt rx    Interrupts         Punts
  -----------------------------------------------------------
   0             0             0             0             0
   1             0             0             0             0
   2             0             0             0             0
   3             0             0             1             1
  -----------------------------------------------------------

Table 18 describes the significant fields shown in the display.

Table 18 show mfib hardware route mofrr Field Descriptions 

Field
Description

RPFS

Primary and backup RPF of the route.

A

Currently active RPF for forwarding the traffic to the egress (OLIST). T: means true, F: means false.

MS

Monitoring state. It has three states. MS=0, indicates that the monitoring state disabled. MS=1, indicates that active RPF is monitoring traffic activity. MS=2, indicates that active RPF is monitoring traffic loss.

WDI

Watchdog Count Index. Each MoFRR route has two Line card specific watchdog indexes, associated with primary and backup RPF, respectively.

OIFS

Output Interfaces in the local line card.

Sequence num

MoFRR specific route sequence number.

Num of switchovers

Total number of switchovers triggered by traffic loss detection in the data plane.

Watchdog Counters

Internal Hardware watchdog counters

MoFRR Statistics

Internal software watchdog counters


If there is no MoFRR route enabled in the platform, the output result will be as follows:

RP/0/RSP0/CPU0:router# show mfib hardware route mofrr location 0/0/CPU0
LC Type: Trident
No matching routes in MFIB
There are no MoFRR routes configured.

Related Commands

Command
Description

show mfib hardware route olist

Displays platform-specific MFIB information for the output interface list stored in the hardware.

show mfib hardware route statistics

Displays platform-specific MFIB information for the packets and bytes counters for each route.

show mfib hardware route summary

Displays platform-specific MFIB hardware information for each route entry.

show mfib route

Displays entries in the MFIB table.

show mrib route

Displays entries in the MRIB table.


show mfib hardware route olist

To display platform-specific Multicast Forwarding Information Base (MFIB) information in 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] hardware route olist {[*]| [source-address] [group-address [/prefix-length]] [detail]} [location node-id]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

*

(Optional) Displays shared tree entries.

source-address

(Optional) IP address or hostname of the multicast route source.

group-address

(Optional) IP address or hostname of the multicast group.

/prefix-length

(Optional) Prefix length of the multicast group. A decimal value that indicates how many of the high-order contiguous bits of the address compose the prefix (the network portion of the address). A slash must precede the decimal value.

detail

(Optional) Displays a detailed list of the routing database. Requires 140 columns. This option is available on the Cisco CRS-1 router only.

location node-id

Specifies an MFIB-designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mfib hardware route olist command. (The output fields are described in the header.)

RP/0/RSP0/CPU0:router# show mfib hardware route olist location 0/0/CPU0 
LC Type: Trident
--------------------------------------------------------------------------
Legend:
Route Information - (Ingress)
 C: Chip ID, IC: BACL check, IP: Punt this packet to LC CPU,
 ID: Directly connected, IS: RPF interface signal, IU: Punt copy to RP,
 IF: Punt to LC CPU if forwarded, IM: Result match, IV: Valid entry,
 IR: RPF IF, IA: Fabric slotmask, IG: Multicast group ID
Route Information - (Egress)
 ET: Table ID to be used for OLIST lookup, EO: OLIST count bit,
 ER: Route MGID to be used for OLIST/NRPF lookup, EM: Result match,
 EV: Valid entry, EC: Count of OLIST members on this chip,
 BS: Base of the statistics pointer
Hardware Information
 C: Chip ID; T: Table ID; M: Member ID; Intf: Interface, U: uIDB index,
 I: HW IC flag, B: HW BACL bit, Base: Base of statistics pointer
--------------------------------------------------------------------------
Source: *               Group: 224.0.0.0       Mask length: 24 
  Route Information
  ----------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ----------------------------------------------------------------------------------
  0  T  F  F  F  F  F  T  T  0x0        0x0    0x8002 0  F  2    T  T  0    0x5516c 
  1  T  F  F  F  F  F  T  T  0x0        0x0    0x8002 0  F  2    T  T  0    0x5516c 
  2  T  F  F  F  F  F  T  T  0x0        0x0    0x8002 0  F  2    T  T  0    0x5516c 
  3  T  F  F  F  F  F  T  T  0x0        0x0    0x8002 0  F  2    T  T  0    0x555a4 
  ----------------------------------------------------------------------------------
Source: *               Group: 224.0.1.39      Mask length: 32 
  Route Information
  ----------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ----------------------------------------------------------------------------------
  0  F  T  F  F  F  F  T  T  0x0        0x0    0x8000 0  F  0    T  T  0    0x55162 
  1  F  T  F  F  F  F  T  T  0x0        0x0    0x8000 0  F  0    T  T  0    0x55162 
  2  F  T  F  F  F  F  T  T  0x0        0x0    0x8000 0  F  0    T  T  0    0x55162 
  3  F  T  F  F  F  F  T  T  0x0        0x0    0x8000 0  F  0    T  T  0    0x5559a 
  ----------------------------------------------------------------------------------
Source: *               Group: 224.0.1.40      Mask length: 32 
  Route Information
  ----------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ----------------------------------------------------------------------------------
  0  F  T  F  F  F  F  T  T  0x0        0x0    0x8001 0  F  1    T  T  0    0x55167 
  1  F  T  F  F  F  F  T  T  0x0        0x0    0x8001 0  F  1    T  T  0    0x55167 
  2  F  T  F  F  F  F  T  T  0x0        0x0    0x8001 0  F  1    T  T  0    0x55167 
  3  F  T  F  F  F  F  T  T  0x0        0x0    0x8001 0  F  1    T  T  0    0x5559f 
  ----------------------------------------------------------------------------------
Source: *               Group: 227.0.0.0       Mask length: 16 
  Route Information
  ----------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ----------------------------------------------------------------------------------
  0  T  F  F  F  F  F  T  T  0x280      0x0    0x8009 0  F  6    T  T  0    0x55199 
  1  T  F  F  F  F  F  T  T  0x280      0x0    0x8009 0  F  6    T  T  0    0x55199 
  2  T  F  F  F  F  F  T  T  0x280      0x0    0x8009 0  F  6    T  T  0    0x55199 
  3  T  F  F  F  F  F  T  T  0x280      0x0    0x8009 0  F  6    T  T  0    0x555d1 
  ----------------------------------------------------------------------------------
Source: *               Group: 227.0.0.1       Mask length: 32 
  Route Information
  ----------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ----------------------------------------------------------------------------------
  0  T  F  F  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  1  T  F  F  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  2  T  F  F  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  3  T  F  F  F  F  F  T  T  0x0        0x1    0x8004 1  T  5    T  T  3    0x555bd 
  ----------------------------------------------------------------------------------
  Interface Information
  -----------------------------------------------------
  C  T  M  Intf            U    I  B  Base    
  -----------------------------------------------------
  3  1  0  Gi0/0/0/8       9    F  F  0x5540c 
  3  1  1  Gi0/0/0/4       5    F  F  0x5540f 
  3  1  2  Gi0/0/0/6       7    F  F  0x55412 
  -----------------------------------------------------
Source: *               Group: 230.0.0.0       Mask length: 8  
  Route Information
  ----------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ----------------------------------------------------------------------------------
  0  T  F  T  F  F  F  T  T  0x0        0x0    0x8005 0  F  4    T  T  0    0x55176 
  1  T  F  T  F  F  F  T  T  0x0        0x0    0x8005 0  F  4    T  T  0    0x55176 
  2  T  F  T  F  F  F  T  T  0x0        0x0    0x8005 0  F  4    T  T  0    0x55176 
  3  T  F  T  F  F  F  T  T  0x0        0x0    0x8005 0  F  4    T  T  0    0x555ae 
  ----------------------------------------------------------------------------------
Source: *               Group: 232.0.0.0       Mask length: 8  
  Route Information
  ----------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ----------------------------------------------------------------------------------
  0  T  F  F  F  F  F  T  T  0x0        0x0    0x8003 0  F  3    T  T  0    0x55171 
  1  T  F  F  F  F  F  T  T  0x0        0x0    0x8003 0  F  3    T  T  0    0x55171 
  2  T  F  F  F  F  F  T  T  0x0        0x0    0x8003 0  F  3    T  T  0    0x55171 
  3  T  F  F  F  F  F  T  T  0x0        0x0    0x8003 0  F  3    T  T  0    0x555a9 
  ----------------------------------------------------------------------------------
Source: *               Group: 233.1.0.0       Mask length: 16 
  Route Information
  ----------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ----------------------------------------------------------------------------------
  0  T  F  F  F  F  F  T  T  0x180      0x0    0x8007 0  F  7    T  T  0    0x5518f 
  1  T  F  F  F  F  F  T  T  0x180      0x0    0x8007 0  F  7    T  T  0    0x5518f 
  2  T  F  F  F  F  F  T  T  0x180      0x0    0x8007 0  F  7    T  T  0    0x5518f 
  3  T  F  F  F  F  F  T  T  0x180      0x0    0x8007 0  F  7    T  T  0    0x555c7 
  ----------------------------------------------------------------------------------
Source: *               Group: 233.4.0.0       Mask length: 16 
  Route Information
  ----------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ----------------------------------------------------------------------------------
  0  T  F  F  F  F  F  T  T  0x180      0x0    0x8008 0  F  8    T  T  0    0x55194 
  1  T  F  F  F  F  F  T  T  0x180      0x0    0x8008 0  F  8    T  T  0    0x55194 
  2  T  F  F  F  F  F  T  T  0x180      0x0    0x8008 0  F  8    T  T  0    0x55194 
  3  T  F  F  F  F  F  T  T  0x180      0x0    0x8008 0  F  8    T  T  0    0x555cc 
  ----------------------------------------------------------------------------------

The following is sample output from the show mfib hardware route olist command with only one multicast group:

RP/0/RSP0/CPU0:router# show mfib hardware route olist 227.0.0.1 location 0/0/CPU0 
--------------------------------------------------------------------------
Legend:
Route Information - (Ingress)
 C: Chip ID, IC: BACL check, IP: Punt this packet to LC CPU,
 ID: Directly connected, IS: RPF interface signal, IU: Punt copy to RP,
 IF: Punt to LC CPU if forwarded, IM: Result match, IV: Valid entry,
 IR: RPF IF, IA: Fabric slotmask, IG: Multicast group ID
Route Information - (Egress)
 ET: Table ID to be used for OLIST lookup, EO: OLIST count bit,
 ER: Route MGID to be used for OLIST/NRPF lookup, EM: Result match,
 EV: Valid entry, EC: Count of OLIST members on this chip,
 BS: Base of the statistics pointer
Hardware Information
 C: Chip ID; T: Table ID; M: Member ID; Intf: Interface, U: uIDB index,
 I: HW IC flag, B: HW BACL bit, Base: Base of statistics pointer
--------------------------------------------------------------------------
Source: *               Group: 227.0.0.1       Mask length: 32 
  Route Information
  ----------------------------------------------------------------------------------
  C  IC IP ID IS IU IF IM IV IR         IA     IG     ET EO ER   EM EV EC   BS      
  ----------------------------------------------------------------------------------
  0  T  F  F  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  1  T  F  F  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  2  T  F  F  F  F  F  T  T  0x0        0x1    0x8004 0  F  5    T  T  0    0x55185 
  3  T  F  F  F  F  F  T  T  0x0        0x1    0x8004 1  T  5    T  T  3    0x555bd 
  ----------------------------------------------------------------------------------
  Interface Information
  -----------------------------------------------------
  C  T  M  Intf            U    I  B  Base    
  -----------------------------------------------------
  3  1  0  Gi0/0/0/8       9    F  F  0x5540c 
  3  1  1  Gi0/0/0/4       5    F  F  0x5540f 
  3  1  2  Gi0/0/0/6       7    F  F  0x55412 
  -----------------------------------------------------

Related Commands

Command
Description

show mfib hardware route accept-bitmap

Displays platform-specific MFIB information for the interface list that accepts bidirectional routes.

show mfib hardware route statistics

Displays platform-specific MFIB information for the packets and bytes counters for each route.

show mfib hardware route summary

Displays platform-specific MFIB hardware information for each route entry.

show mfib route

Displays entries in the MFIB table.


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] hardware route statistics [detail] [* ] [source-address] [group-address [/prefix-length]] [location node-id]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

*

(Optional) Displays shared tree entries.

source-address

(Optional) IP address or hostname of the multicast route source.

group-address

(Optional) IP address or hostname of the multicast group.

/prefix-length

(Optional) Prefix length of the multicast group. A decimal value that indicates how many of the high-order contiguous bits of the address compose the prefix (the network portion of the address). A slash must precede the decimal value.

detail

(Optional) Displays a detailed list of the routing database.

location node-id

(Optional) Specifies an MFIB-designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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 Route counters are local to each line card.


Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mfib hardware route statistics command.

RP/0/RSP0/CPU0:router# show mfib hardware route statistics location 0/0/CPU0 
LC Type: Trident
Legend:
 S: Source, G: Group, Pr: Prefix Length, C: Chip ID, R: Received,
 P: Punted to CPU, F: Forwarded, ID: Ingress Drop, ED: Egress Drop 
S: *  G: 224.0.0.0  Pr:24
  -----------------------------------------------------------------------
  C     R(packets:bytes)/F(packets:bytes)/P(packets)/ID(packets)/ED(packets)
  -----------------------------------------------------------------------
  0     0:0 / 0:0 / 0 / 0 / 0
  1     0:0 / 0:0 / 0 / 0 / 0
  2     0:0 / 0:0 / 0 / 0 / 0
  3     0:0 / 0:0 / 0 / 0 / 0
  -----------------------------------------------------------------------
  No OLIST interfaces found for this route
S: *  G: 224.0.1.39  Pr:32
  -----------------------------------------------------------------------
  C     R(packets:bytes)/F(packets:bytes)/P(packets)/ID(packets)/ED(packets)
  -----------------------------------------------------------------------
  0     0:0 / 0:0 / 0 / 0 / 0
  1     0:0 / 0:0 / 0 / 0 / 0
  2     0:0 / 0:0 / 0 / 0 / 0
  3     0:0 / 0:0 / 0 / 0 / 0
  -----------------------------------------------------------------------
  No OLIST interfaces found for this route
S: *  G: 224.0.1.40  Pr:32
  -----------------------------------------------------------------------
  C     R(packets:bytes)/F(packets:bytes)/P(packets)/ID(packets)/ED(packets)
  -----------------------------------------------------------------------
  0     0:0 / 0:0 / 0 / 0 / 0
  1     0:0 / 0:0 / 0 / 0 / 0
  2     0:0 / 0:0 / 0 / 0 / 0
  3     0:0 / 0:0 / 0 / 0 / 0
  -----------------------------------------------------------------------
  No OLIST interfaces found for this route
S: *  G: 227.0.0.1  Pr:32
  -----------------------------------------------------------------------
  C     R(packets:bytes)/F(packets:bytes)/P(packets)/ID(packets)/ED(packets)
  -----------------------------------------------------------------------
  0     0:0 / 0:0 / 0 / 0 / 0
  1     0:0 / 0:0 / 0 / 0 / 0
  2     0:0 / 0:0 / 0 / 0 / 0
  3     504844:30290640 / 504843:23222778 / 504856 / 0 / 0
  -----------------------------------------------------------------------
  Interface Statistics:
  -----------------------------------------------------------------------
  Interface       F/P/D (packets:bytes)
  -----------------------------------------------------------------------
  Gi0/0/0/8       504843:23222778 / 0:0 / 0:0
  Gi0/0/0/4       0:0 / 0:0 / 0:0
  Gi0/0/0/6       504843:23222778 / 0:0 / 0:0
  -----------------------------------------------------------------------
S: 4.0.0.2  G: 227.0.0.1  Pr:64
  -----------------------------------------------------------------------
  C     R(packets:bytes)/F(packets:bytes)/P(packets)/ID(packets)/ED(packets)
  -----------------------------------------------------------------------
  0     0:0 / 0:0 / 0 / 0 / 0
  1     0:0 / 0:0 / 0 / 0 / 0
  2     0:0 / 0:0 / 0 / 0 / 0
  3     3869:232140 / 3869:177974 / 0 / 0 / 0
  -----------------------------------------------------------------------
  Interface Statistics:
  -----------------------------------------------------------------------
  Interface       F/P/D (packets:bytes)
  -----------------------------------------------------------------------
  Gi0/0/0/4       0:0 / 0:0 / 0:0
  Gi0/0/0/8       3869:177974 / 0:0 / 0:0
  Gi0/0/0/6       3869:177974 / 0:0 / 0:0
  -----------------------------------------------------------------------
S: *  G: 230.0.0.0  Pr:8
  -----------------------------------------------------------------------
  C     R(packets:bytes)/F(packets:bytes)/P(packets)/ID(packets)/ED(packets)
  -----------------------------------------------------------------------
  0     0:0 / 0:0 / 0 / 0 / 0
  1     0:0 / 0:0 / 0 / 0 / 0
  2     0:0 / 0:0 / 0 / 0 / 0
  3     0:0 / 0:0 / 0 / 0 / 0
  -----------------------------------------------------------------------
  No OLIST interfaces found for this route
S: *  G: 232.0.0.0  Pr:8
  -----------------------------------------------------------------------
  C     R(packets:bytes)/F(packets:bytes)/P(packets)/ID(packets)/ED(packets)
  -----------------------------------------------------------------------
  0     0:0 / 0:0 / 0 / 0 / 0
  1     0:0 / 0:0 / 0 / 0 / 0
  2     0:0 / 0:0 / 0 / 0 / 0
  3     0:0 / 0:0 / 0 / 0 / 0
  -----------------------------------------------------------------------
  No OLIST interfaces found for this route

Table 19 describes the significant fields shown in the display.

Table 19 show mfib hardware route statistics Field Descriptions

Field
Description

Ingress Counter

Unique identifier of the ingress counter.

Egress Counter

Unique identifier of the egress counter.

Forward

Number of forwarded packets and bytes.

Punt

Number of bytes punted from the line card CPU.

Drop

Number of dropped bytes.


Related Commands

Command
Description

show mfib hardware route accept-bitmap

Displays platform-specific MFIB information for the interface list that accepts bidirectional routes.

show mfib hardware route olist

Displays platform-specific MFIB information for the output interface list stored in the hardware.

show mfib hardware route summary

Displays platform-specific MFIB hardware information for each route entry.

show mfib route

Displays entries in the MFIB table.


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] hardware route summary {location node-id}

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

location node-id

(Optional) Specifies an MFIB-designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Use the show mfib hardware summary command to display hardware information for the route of the node.

The hardware information of MoFRR (multicast only fast reroute) enabled routes are also displayed. In IOS XR Software Release 3.9.0, the maximum platform supported MoFRR routes are 1024.

The longest-prefix match route is displayed depending on the provided source and group addresses.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mfib hardware route summary command:

RP/0/RSP0/CPU0:router# show mfib hardware route summary location 0/0/CPU0
LC Type: Trident
H/W IP Multicast Forwarding Information Base Summary
  No. of (*,G) routes = 6
  No. of (S,G) routes = 5
  No. of (S,G) MoFRR routes = 0,   Maximum supported MoFRR routes = 1024

If there is no MoFRR configured in the platform:

RP/0/RSP0/CPU0:router# show mfib hardware route summary location 0/0/CPU0
LC Type: Trident
H/W IP Multicast Forwarding Information Base Summary
No. of (*,G) routes = 6
  No. of (S,G) routes = 5
  No. of (S,G) MoFRR routes = 0,   Maximum supported MoFRR routes = 1024

Table 20 describes the significant fields shown in the display.

Table 20 show mfib hardware route summary Field Descriptions

Field
Description

No. of (*,G) routes

Number of (*,G) routes installed in hardware.

No. of (S,G) routes

Number of (S,G) routes installed in hardware.

No. of (S,G) MoFRR routes

Number of MoFRR (S,G) routes installed in hardware.

Maximum supported MoFRR routes

Maximum number of MoFRR routes supported in hardware.


Related Commands

Command
Description

show mfib hardware route accept-bitmap

Displays platform-specific MFIB information for the interface list that accepts bidirectional routes.

show mfib hardware route mofrr

Displays platform-specific MFIB information for the MoFRR enabled route list stored in the hardware.

show mfib hardware route olist

Displays platform-specific MFIB information for the output interface list stored in the hardware.

show mfib hardware route statistics

Displays platform-specific MFIB information for the packets and bytes counters for each route.

show mfib hardware route summary

Displays platform-specific MFIB hardware information for each route entry.

show mfib route

Displays entries in the MFIB table.


show mfib hardware table

To display the platform-specific multicast table information for the Multicast Forwarding Information Base (MFIB) in the hardware, use the show mfib hardware table command in EXEC mode.

show mfib [vrf vrf-name] [ipv4 | ipv6] hardware table [detail] [location node-id]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

detail

(Optional) Displays detailed platform-specific multicast table information.

location node-id

(Optional) Specifies the MFIB location.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.9.1

This command was introduced on Cisco ASR 9000 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. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read

cisco-support

read


Examples

The following example shows a sample output of the show mfib hardware table command:

RP/0/RSP0/CPU0:router#show mfib hardware table detail location 0/1/CPU0
LC Type: Trident
-------------------------------------------------------------------
Legend:
 NP: Network Processor, MNP: Master NP, SW OC: Software OLIST Count
 TID: Table ID, MLC: Master Linecard (PD Flag)
 MNP_id: Master NP ID, C_NP_MASK: Composite NP Mask
-------------------------------------------------------------------
---------------
NP MNP SW OC   
---------------
0  F   0       
1  F   0       
2  F   0       
3  F   0       
---------------
---------------------------
TID    MLC MNP_id C_NP_MASK 
---------------------------
0x0    F   0      0x0       
---------------------------

Table 21 describes the significant fields shown in the display.

Table 21 show mfib hardware table Field Descriptions

Field
Description

NP

Specifies the network processor.

MNP

Specifies the master network processor.

SW OC

Specifies the software OLIST count.

TID

Specifies the Table ID.


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] interface [type interface-path-id] [detail | route] [location node-id]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

interface-path-id

(Optional) Physical interface or virtual interface.

Note Use the show interfaces command in EXEC mode to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

detail

(Optional) Specifies detailed information for packet statistics on interfaces.

route

(Optional) Specifies a list of routes associated with the interface. This option is available if an interface type and instance are specified.

location node-id

(Optional) Specifies packet statistics associated with an interface of the designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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
Task ID
Operations

multicast

read


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 Gigabit Ethernet interface 0/2/0/2:

RP/0/RSP0/CPU0:router# show mfib interface GigE 0/2/0/2 location 0/2/CPU0 
Interface : GigE0/2/0/2 (Enabled)
Mcast pkts in : 5839, Mcast pkts out : 0 TTL Threshold : 0 Ref Count : 18

The following is sample output from the show mfib interface command with the detail and location keywords specified:

RP/0/RSP0/CPU0:router# show mfib interface detail location 0/2/CPU0 
Interface : 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/32 
Interface : GigE0/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/32 

Table 22 describes the significant fields shown in the display.

Table 22 show mfib interface Field Descriptions

Field
Description

Interface

Interface name. Enabled if the interface is configured for multicast routing. The word "PHYSICAL" is displayed if the interface is a nonvirtual interface.

Mcast pkts in

Number of incoming multicast packets entering the interface during software switching.

Mcast pkts out

Number of outgoing multicast packets exiting the interface during software switching.

TTL Threshold

Number of multicast packets that reach the configured multicast time-to-live threshold.

VRF ID

 

Handle

 

Ref Count

Number of references to this interface structure in the MFIB process.

Route Count

 

Handle

 

Primary address

Primary IP address of the interface.

Secondary address

Secondary IP address of the interface.


Related Commands

Command
Description

show mfib hardware interface

Displays platform-specific MFIB hardware interface information.


show mfib nsf

To display the state of a 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 | ] nsf [location node-id]

Syntax Description

ipv4

(Optional) Specifies IPv4 address prefixes.

location node-id

(Optional) Specifies the MFIB NSF designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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:

Normal—Normal operation: The MFIBs in the card contain only up-to-date MFIB entries.

Boot Card Booting—Card is initializing and has not yet determined its NSF state.

Not Forwarding—Multicast Forwarding Disabled: Multicast routing failed to recover from a failure-induced NSF state prior to the MFIB NSF timeout.

Non-stop Forwarding Activated—Multicast NSF active: The router is operating in NSF mode while attempting to recover from a control-plane failure. In this mode, data is forwarded based on MFIB entries that are either updated by the recovered Multicast Routing Information Base (MRIB), or MFIB entries that were marked stale when NSF mode began. The times remaining until multicast NSF and multicast-unicast NSF expiration are displayed.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mfib nsf command:

RP/0/RSP0/CPU0:router# show mfib nsf 
IP MFWD Non-Stop Forwarding Status:
  NSF Lifetime: 00:15:00
On node 0/1/CPU0 :
Multicast routing state: Non-Stop Forwarding is activated
NSF Time Remaining: 00:14:54
On node 0/3/CPU0 :
Multicast routing state: Non-Stop Forwarding is activated
NSF Time Remaining: 00:14:54
On node 0/4/CPU0 :
Multicast routing state: Non-Stop Forwarding is activated
NSF Time Remaining: 00:14:53
On node 0/6/CPU0 :
Multicast routing state: Non-Stop Forwarding is activated
NSF Time Remaining: 00:14:53

Table 23 describes the significant fields shown in the display.

Table 23 show mfib nsf Field Descriptions

Field
Description

IP MFWD Non-Stop Forwarding Status

MFIB NSF status of each node in the system: booting, normal, not forwarding, or activated.

NSF Time Remaining

If MSB NSF is activated, the time remaining until NSF fails and all routes are deleted displays. Before timeout, MRIB signals that NSF (in the control plane) is finished and new, updated routes are populated in the MFIB (which makes the transition to Normal status).


Related Commands

Command
Description

nsf lifetime (IGMP)

Configures the maximum time for the NSF timeout value under IGMP.

nsf (multicast)

Configures the NSF capability for the multicast routing system.

nsf lifetime (PIM)

Configures the NSF timeout value for the PIM process.

show igmp nsf

Displays the state of NSF operation in IGMP.

show mrib nsf

Displays the state of NSF operation in the MRIB.

show pim nsf

Displays the state of NSF operation for PIM.


show mfib route

To display route entries in the Multicast Forwarding Information Base (MFIB), use the show mfib route command in EXEC mode.

show mfib [vrf vrf-name] [ipv4] route [rate | * | source-IP-address | group-IP-address /prefix-length | detail | summary| location node-id]

Syntax Description

*

(Optional) Display shared tree entries.

source-IP-address

(Optional) IP address or hostname of the multicast route source. Format is:

A.B.C.D

group-IP-address

(Optional) IP address or hostname of the multicast group. Format is:

A.B.C.D

/prefix-length

(Optional) Group IP prefix length of the multicast group. A decimal value that indicates how many of the high-order contiguous bits of the address compose the prefix (the network portion of the address). Format is:
A.B.C.D/length

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

ipv6

(Optional) Specifies IPv6 address prefixes.

detail

(Optional) Specifies detailed route information.

location node-id

(Optional) Specifies an MFIB-designated node.

rate

(Optional) Displays individual (S, G) rates.

sources-only

(Optional) Restricts display of any shared-tree entries.

summary

(Optional) Displays a brief list of the routing database.

tech-support

(Optional) Displays technical support information.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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.

The command displays the cumulative rates per route for all line cards in the Multicast Forwarding Information Base (MFIB) table when the rate keyword is used with the source and group IP addresses.

The command displays the rate per route for one line card in Multicast Forwarding Information Base (MFIB) table when the statistics keyword is used.

Task ID
Task ID
Operations

multicast

read


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/RSP0/CPU0:router# show mfib route location 0/1/CPU0
IP Multicast Forwarding Information Base
Entry 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 True
Interface 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 Interface
Forwarding Counts: Packets in/Packets out/Bytes out
Failure Counts: RPF / TTL / Empty Olist / Encap RL / Other
(*,224.0.0.0/24),   Flags:  D 
  Up: 02:16:52
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Failure Counts: 0/0/0/0/0
(*,224.0.1.39),   Flags:  S 
  Up: 02:16:52
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Failure Counts: 0/0/0/0/0
(*,224.0.1.40),   Flags:  S 
  Up: 02:16:52
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Failure Counts: 0/0/0/0/0
(*,227.0.0.1),   Flags:  C 
  Up: 02:16:51
  Last Used: 02:16:50
  SW Forwarding Counts: 282/0/0
  SW Failure Counts: 205/0/0/0/0
  GigabitEthernet0/0/0/4 Flags:  NS EG, Up:02:16:46
  GigabitEthernet0/0/0/8 Flags:  NS EG, Up:02:16:50
  GigabitEthernet0/0/0/6 Flags:  NS EG, Up:02:16:50
(4.0.0.2,227.0.0.1),   Flags:  
  Up: 02:16:50
  Last Used: 00:00:12
  SW Forwarding Counts: 125/0/0
  SW Failure Counts: 0/0/0/0/0
  GigabitEthernet0/0/0/8 Flags:  NS EG, Up:02:16:50
  GigabitEthernet0/0/0/6 Flags:  NS EG, Up:02:16:50
  GigabitEthernet0/0/0/4 Flags:  A EG, Up:02:16:50
(*,232.0.0.0/8),   Flags:  D 
  Up: 02:16:52
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Failure Counts: 0/0/0/0/0

The following is sample output from the show mfib route command with the summary and location keywords specified:

RP/0/RSP0/CPU0:router# show mfib route summary location 0/0/CPU0 
IP Multicast Forwarding Information Base Summary for VRF default
  No. of (*,G) routes = 5
  No. of (S,G) routes = 1

The following is sample output from the show mfib route command with the statistics and location keywords specified. If the hardware counters show N/A, it means no hardware statistic blocks were assigned to the route. However, routes may show that both hardware and software statistic blocks are assigned. The output fields are described in the header.

RP/0/RSP0/CPU0:router# show mfib route statistics location 0/0/CPU0 
IP Multicast Forwarding Information Base
Entry 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 True
Interface 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 Interface
SW/HW Forwarding Counts: Packets in/Packets out/Bytes out
SW Failure Counts: RPF / TTL / Empty Olist / Encap RL / Other
HW Drop Counts: Ingress / Egress
HW Forwarding Rates: bps In/pps In/bps Out/pps Out
(*,224.0.0.0/24),   Flags:  D 
  Up: 02:21:15
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Failure Counts: 0/0/0/0
  HW Forwarding Counts: 0/0/0
  HW Drop Counts: 0/0
  HW Forwarding Rates: N/A /N/A /N/A /N/A 
(*,224.0.1.39),   Flags:  S 
  Up: 02:21:15
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Failure Counts: 0/0/0/0
  HW Forwarding Counts: 0/0/0
  HW Drop Counts: 0/0
  HW Forwarding Rates: N/A /N/A /N/A /N/A 
(*,224.0.1.40),   Flags:  S 
  Up: 02:21:15
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Failure Counts: 0/0/0/0
  HW Forwarding Counts: 0/0/0
  HW Drop Counts: 0/0
  HW Forwarding Rates: N/A /N/A /N/A /N/A 
(*,227.0.0.1),   Flags:  C 
  Up: 02:21:14
  Last Used: 02:21:14
  SW Forwarding Counts: 282/0/0
  SW Failure Counts: 205/0/0/0
  HW Forwarding Counts: 0/0/0
  HW Drop Counts: 0/0
  HW Forwarding Rates: N/A /N/A /N/A /N/A 
  GigabitEthernet0/0/0/4 Flags:  NS EG, Up:02:21:10
  GigabitEthernet0/0/0/8 Flags:  NS EG, Up:02:21:14
  GigabitEthernet0/0/0/6 Flags:  NS EG, Up:02:21:14
(4.0.0.2,227.0.0.1),   Flags:  
  Up: 02:21:14
  Last Used: 00:01:06
  SW Forwarding Counts: 128/0/0
  SW Failure Counts: 0/0/0/0
  HW Forwarding Counts: 8474282/8474283/389817018
  HW Drop Counts: 0/0
  HW Forwarding Rates: N/A /N/A /N/A /N/A 
  GigabitEthernet0/0/0/8 Flags:  NS EG, Up:02:21:14
  GigabitEthernet0/0/0/6 Flags:  NS EG, Up:02:21:14
  GigabitEthernet0/0/0/4 Flags:  A EG, Up:02:21:14
(*,232.0.0.0/8),   Flags:  D 
  Up: 02:21:15
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Failure Counts: 0/0/0/0
  HW Forwarding Counts: 0/0/0
  HW Drop Counts: 0/0
  HW Forwarding Rates: N/A /N/A /N/A /N/A

The following is a sample output for MoFRR enabled route without and with the detail keyword:

RP/0/RSP0/CPU0:router# show mfib route
IP Multicast Forwarding Information Base
Entry 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 True, EX - Extranet
  MoFE - MoFRR Enabled, MoFS - MoFRR State
Interface 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 Interface,
  EX - Extranet, A2 - Secondary Accept
Forwarding/Replication Counts: Packets in/Packets out/Bytes out
Failure Counts: RPF / TTL / Empty Olist / Encap RL / Other
(20.20.20.1,225.0.0.1),   Flags:  MoFE MoFS
  Up: 03:22:30
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Replication Counts: 0/0/0
  SW Failure Counts: 0/0/0/0/0
  GigabitEthernet0/0/0/8 Flags:  A, Up:03:22:30
  GigabitEthernet0/0/0/18 Flags:  A2, Up:03:22:30
  GigabitEthernet0/0/0/28 Flags:  NS, Up:03:22:30
(20.20.20.1,225.0.0.2),   Flags:  MoFE MoFS
  Up: 03:22:30
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Replication Counts: 0/0/0
  SW Failure Counts: 0/0/0/0/0
  GigabitEthernet0/0/0/8 Flags:  A, Up:03:22:30
  GigabitEthernet0/0/0/18 Flags:  A2, Up:03:22:30
  GigabitEthernet0/0/0/28 Flags:  NS, Up:03:22:30

In the above command, A flag represents the primary RPF of the MoFRR route, and A2 flag represents the backup RPF of the MoFRR route.

RP/0/RSP0/CPU0:router# show mfib route detail
IP Multicast Forwarding Information Base
Entry 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 True, EX - Extranet
  MoFE - MoFRR Enabled, MoFS - MoFRR State
Interface 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 Interface,
  EX - Extranet, A2 - Secondary Accept
Forwarding/Replication Counts: Packets in/Packets out/Bytes out
Failure Counts: RPF / TTL / Empty Olist / Encap RL / Other
(20.20.20.1,225.0.0.1),   Flags:  MoFE MoFS
  Up: 03:25:31
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Replication Counts: 0/0/0
  SW Failure Counts: 0/0/0/0/0
  Route ver: 0x4a13
  MVPN Info :-
    MDT Handle: 0x0, MDT Probe:N [N], Rate:N, Acc:N
    MDT SW Ingress Encap V4/V6, Egress decap: 0 / 0, 0
  MOFRR State: Inactive Sequence No 1
  GigabitEthernet0/0/0/8 Flags:  A, Up:03:25:31
  GigabitEthernet0/0/0/18 Flags:  A2, Up:03:25:31
  GigabitEthernet0/0/0/28 Flags:  NS, Up:03:25:31
(20.20.20.1,225.0.0.2),   Flags:  MoFE MoFS
  Up: 03:25:31
  Last Used: never
  SW Forwarding Counts: 0/0/0
  SW Replication Counts: 0/0/0
  SW Failure Counts: 0/0/0/0/0
  Route ver: 0x443e
  MVPN Info :-
    MDT Handle: 0x0, MDT Probe:N [N], Rate:N, Acc:N
    MDT SW Ingress Encap V4/V6, Egress decap: 0 / 0, 0
  MOFRR State: Inactive Sequence No 1
  GigabitEthernet0/0/0/8 Flags:  A, Up:03:25:31
  GigabitEthernet0/0/0/18 Flags:  A2, Up:03:25:31
  GigabitEthernet0/0/0/28 Flags:  NS, Up:03:25:31

The detail option illustrates the MoFRR state of each MoFRR route. At any moment, only one RPF forwards the traffic to the egress. The inactive state means the primary RPF forwards the traffic to the egress. The active state means that the backup RPF forwards the traffic to the egress. The sequence number reflects the number of switchovers of the MoFRR route.


Related Commands

Command
Description

show mfib counter

Displays MFIB counter statistics for packets that have dropped.

show mfib hardware route accept-bitmap

Displays platform-specific MFIB information for the interface list that accepts bidirectional routes.

show mfib hardware route olist

Displays platform-specific MFIB information for the output interface list stored in the hardware.

show mfib hardware route statistics

Displays platform-specific MFIB information for the packets and bytes counters for each route.

show mfib interface

Displays hardware switching interface information for the MFIB process.

show mrib route

Displays all entries in the MRIB table.


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] table-info {table-id | vrf-name} [local | remote] [location node-id]

Syntax Description

ipv4

(Optional) Specifies IPv4 address prefixes.

ipv6

(Optional) Specifies IPv6 address prefixes.

table-id

Specifies the table identifier. Range is 0 to 4294967295.

vrf-name

Specifies the VRF name.

local

Specifies local tables only.

remote

Specifies remote tables only.

location node-id

(Optional) Specifies MFIB connections associated with an interface of the designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mfib table-info command:

RP/0/RSP0/CPU0:router# show mfib table-info table-id location 0/0/CPU0
Table Name           : default
VRid/TID/VID         : 0x0 / 0xe0000000 / 0x60000000
Table type           : TBL_TYPE_TID
Active/Linked        : Y / Y
Prev Table ID        : 0x0
Location             : Local
Local ifcount        : 16
Default MDT Encap    : (*, */32)
MDT Master LC        : N
Loopback (Encap Src) : 0x0 (Ha0x0)
Local EG intf cnt    : 6
Data MDT             : Acl - (-), All vrf routes N, 0 Kbps


Table 24 describes the significant fields shown in the display.

Table 24 show mfib table-info Field Descriptions

Field
Description

Table Name

Name of the MFIB table.

VRid/TID/VID

Table identifiers.

Table type

Type of MFIB table.

Active/Linked

Table is active and linked.

Location

Location of the MFIB table.

Local ifcount

Local interface count.

Child routes

Child routes shows the number of extranet routes in receiver VRFs that reference this source VRF.

Default MDT Encap

Default MDT encapsulation.

Default MDT Handle

Default MDT interface handle for this VRF.

MDT Master LC

Field contains "Y" if this line card is a master line card for this VRF.

Loopback (Encap Src)

Loopback (encapsulation source).

Local EG intf cnt

Shows the number of local egress interfaces for this VRF and location.

Data MDT

Routes for which multicast data for a multicast distribution tree (MDT) was triggered.


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] default-interface

Syntax Description

ipv4

(Optional) Specifies IPv4 address prefixes.

ipv6

(Optional) Specifies IPv6 address prefixes.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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 ping, or MTrace are not functioning as expected.

Task ID
Task ID
Operations

network

read


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/RSP0/CPU0:router# show mhost default-interface
mhost configured default interface is 'Loopback0'
mhost active default interface is 'Loopback0'

Related Commands

Command
Description

mhost default-interface

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 | ] groups type interface-path-id [location node-id]

Syntax Description

ipv4

(Optional) Specifies IPv4 address prefixes.

ipv6

(Optional) Specifies IPv6 address prefixes.

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note Use the show interfaces command in EXEC mode to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

location node-id

(Optional) Specifies a designated node.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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
Task ID
Operations

network

read


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/RSP0/CPU0:router# show mhost groups loopback 0
Loopback 0
239.1.1.1 : includes 1, excludes 0, mode INCLUDE 
33.3.3.3 : includes 1, excludes 0, active in INCLUDE filter 
224.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 25 describes the significant fields shown in the display.

Table 25 show mhost groups Field Descriptions

Field
Description

includes

Number of source addresses in the include list.

excludes

Number of source addresses in the exclude list.

mode

Multicast socket filter mode: include or exclude.

33.3.3.3

Source address list to be included or excluded based on the multicast filter mode.


Related Commands

Command
Description

show mfib hardware route accept-bitmap

Displays platform-specific MFIB information for the interface list that accepts bidirectional routes.

show mfib hardware route olist

Displays platform-specific MFIB information for the output interface list stored in the hardware.

show mfib hardware route statistics

Displays platform-specific MFIB information for the packets and bytes counters for each route.

show mfib hardware route summary

Displays platform-specific MFIB hardware information for each route entry.

show mfib route

Displays cumulative multicast rates per route for one or for all line cards in the Multicast Forwarding Information Base (MFIB) table, depending on which keyword is used.


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] ] client [filter] [client-name]

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.

filter

(Optional) Displays route and interface level flag changes that various MRIB clients have registered and shows what flags are owned by the MRIB clients.

client-name

(Optional) Name of a multicast routing protocol that acts as a client of MRIB, such as Protocol Independent Multicast (PIM) or Internet Group Management Protocol (IGMP).


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mrib client command using the filter option:

RP/0/RSP0/CPU0:router# show mrib client filter 
IP MRIB client-connections 
igmp:417957 (connection id 0) 
 ownership filter: 
  interface attributes: II ID LI LD 
  groups:
   include 0.0.0.0/0
  interfaces: 
   include All
pim:417959 (connection id 1)
 interest filter:
  entry attributes: E
  interface attributes: SP II ID LI LD
  groups:
   include 0.0.0.0/0
  interfaces:
   include All
 ownership filter:
  entry attributes: L S C IA IF D
  interface attributes: F A IC NS DP DI EI
  groups:
   include 0.0.0.0/0
  interfaces:
   include All
bcdl_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 All

Table 26 describes the significant fields shown in the display.

Table 26 show mrib client Field Descriptions

Field
Description

igmp

Name of the client.

417957

Personal identifier (PID) or a unique ID assigned by MRIB.

(connection id 0)

Unique client connection identifier.

ownership filter:

Specifies all the route entry and interface-level flags that are owned by the client. As the owner of the flag, only the client can add or remove the flag. For example, only the Internet Group Management Protocol (IGMP) client can add the II flag on an interface. MRIB does not allow a non-owner to register or modify the same flag.

groups: include 0.0.0.0/0
interfaces: include All

Groups and interfaces registered by the clients consisting of two lists. One is an include list (items for which the client requests to be notified.) The use of "All" implies all interfaces and 0.0.0.0/0 to indicate all groups. Not shown in this example is the exclude list. This list contains items for which the client requests not to be notified when modifications occur.

interface attributes:

II ID LI LD

Interface-level flags set on the interface belong to a route.

 

interest filter:

Specifies all the flags, groups, and interfaces from which the client requests information. When a flag of interest for a client is modified, the client is notified.

entry attributes:

S C IA IF D

Entry-level flags that are set on the route.

 


Related Commands

Command
Description

show mfib nsf

Displays the state of NSF operation in the MFIB.

show mfib route

Displays cumulative multicast rates per route for one or for all line cards in the Multicast Forwarding Information Base (MFIB) table, depending on which keyword is used.

show mrib nsf

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] nsf

Syntax Description

ipv4

(Optional) Specifies IPv4 address prefixes.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mrib nsf command:

RP/0/RSP0/CPU0:router# show mrib nsf 
IP MRIB Non-Stop Forwarding Status: 
Multicast routing state: Non-Stop Forwarding Activated 
NSF Lifetime: 00:03:00 
NSF Time Remaining: 00:01:40 

Table 27 describes the significant fields shown in the display.

Table 27 show mrib nsf Field Descriptions 

Field
Description

Multicast routing state

Multicast NSF status of the MRIB (Normal or NSF Activated).

NSF Lifetime

Timeout for MRIB NSF, computed as the maximum of the PIM and Internet Group Management Protocol (IGMP) NSF lifetimes, plus 60 seconds.

NSF Time Remaining

If MRIB NSF state is activated, the time remaining until MRIB reverts to Normal mode displays. Before this timeout, MRIB receives notifications from IGMP and PIM, triggering a successful end of NSF and cause the transition to normal state. If notifications are not received, the timer triggers a transition back to normal mode, causing new routes to download to MFIB and old routes to be deleted.


Related Commands

Command
Description

nsf (multicast)

Configures the NSF capability for the multicast routing system.

nsf lifetime (IGMP)

Configures the maximum time for the NSF timeout value under IGMP .

nsf lifetime (PIM)

Configures the NSF timeout value for the PIM process.

show igmp nsf

Displays the state of NSF operation in IGMP.

show mfib nsf

Displays the state of NSF operation in the MFIB line cards.

show pim nsf

Displays the state of NSF operation for PIM.


show mrib platform trace

To display platform-specific data for the Multicast Routing Information Base (MRIB), use the show mrib platform trace command in EXEC mode.

show mrib [vrf vrf-name] [ipv4 ] platform trace [file | hexdump | last | reverse | stats | tailf | unique | verbose | wrapping] [location all | node-id]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

file

(Optional) Specifies the filename.

hexdump

(Optional) Displays the traces in hexadecimal form.

last

(Optional) Displays the last n entries.

reverse

(Optional) Displays the traces in reverse order.

stats

(Optional) Displays statistics.

tailf

(Optional) Displays new traces as they are added.

unique

(Optional) Displays unique entries with counts.

verbose

(Optional) Displays internal debugging information.

wrapping

(Optional) Displays wrapping entries.

location node -id

(Optional) Specifies the location of the trace.

location all

(Optional) Specifies that the trace be performed for all locations.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read


Examples

The following example shows a sample output of show mrib platform trace command:

RP/0/RSP0/CPU0:router# show mrib platform trace 
2 wrapping entries (512 possible, 0 filtered, 2 total)

show mrib route

To display all entries in the Multicast Routing Information Base (MRIB), use the show mrib route command in EXEC mode.

show mrib [vrf vrf-name] [ipv4 | ipv6] [old-output] route [summary| outgoing-interface | [* | source-address] [group-address [/prefix-length]]] [detail]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

*

(Optional) Displays shared tree entries.

source-address

(Optional) Source IP address or hostname of the MRIB route. Format is:

A.B.C.D

group-address

(Optional) Group IP address or hostname of the MRIB route. F ormat is:

A.B.C.D

/prefix-length

(Optional) Prefix length of the MRIB group address. A decimal value that indicates how many of the high-order contiguous bits of the address compose the prefix (the network portion of the address). A slash must precede the decimal value. Format is:

A.B.C.D

outgoing-interface

(Optional) Displays the outgoing-interface information.

summary

(Optional) Displays a summary of the routing database.

detail

(Optional) Displays the routing database with the platform data.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on the Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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
Task ID
Operations

multicast

read


Examples

The following sample output shows the show mrib route command without the detail keyword:

RP/0/RSP0/CPU0:router# show mrib route
IP Multicast Routing Information Base
Entry 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 handle
    CD - Conditional Decap, MPLS - MPLS Decap, MF - MPLS Encap, EX - Extranet
    MoFE - MoFRR Enabled, MoFS - MoFRR State
Interface 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 Interface
    EI - Encapsulation Interface, MI - MDT Interface, LVIF - MPLS Encap,
    EX - Extranet, A2 - Secondary Accept
(*,224.0.0.0/24) Flags: D
  Up: 12:08:54
(*,224.0.1.39) Flags: S
  Up: 12:08:54
(*,224.0.1.40) Flags: S
  Up: 12:08:54
  Outgoing Interface List
    GigabitEthernet0/0/0/8 Flags: II LI, Up: 03:31:26
(20.20.20.1,225.0.0.1) RPF nbr: 20.20.20.1 Flags: MoFE MoFS
  Up: 03:31:21
  MOFRR State: Inactive Sequence No 1
  Incoming Interface List
    GigabitEthernet0/0/0/18 Flags: A2, Up: 03:31:21
    GigabitEthernet0/0/0/8 Flags: A, Up: 03:31:21
  Outgoing Interface List
    GigabitEthernet0/0/0/28 Flags: F NS LI, Up: 03:31:21
(20.20.20.1,225.0.0.2) RPF nbr: 20.20.20.1 Flags: MoFE MoFS
  Up: 03:31:21
  MOFRR State: Inactive Sequence No 1
  Incoming Interface List
    GigabitEthernet0/0/0/18 Flags: A2, Up: 03:31:21
    GigabitEthernet0/0/0/8 Flags: A, Up: 03:31:21
  Outgoing Interface List
    GigabitEthernet0/0/0/28 Flags: F NS LI, Up: 03:31:21
(*,232.0.0.0/8) Flags: D
  Up: 12:08:54

The following sample output shows the show mrib route command with the detail keyword:

RP/0/RSP0/CPU0:router# show mrib route detail
IP Multicast Routing Information Base
Entry 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 handle
    CD - Conditional Decap, MPLS - MPLS Decap, MF - MPLS Encap, EX - Extranet
    MoFE - MoFRR Enabled, MoFS - MoFRR State
Interface 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 Interface
    EI - Encapsulation Interface, MI - MDT Interface, LVIF - MPLS Encap,
    EX - Extranet, A2 - Secondary Accept
(*,224.0.0.0/24) Ver: 0x7380 Flags: D, FMA: 0x501b4944
  Up: 12:09:55
(*,224.0.1.39) Ver: 0x1b11 Flags: S, FMA: 0x501b4938
  Up: 12:09:55
(*,224.0.1.40) Ver: 0x4521 Flags: S, FMA: 0x501b492c
  Up: 12:09:55
  Outgoing Interface List
    GigabitEthernet0/0/0/8 Flags: II LI, Up: 03:32:28
(20.20.20.1,225.0.0.1) Ver: 0x4a13 RPF nbr: 20.20.20.1 Flags: MoFE MoFS, FMA: 0x501b4914
  Up: 03:32:22
  MOFRR State: Inactive Sequence No 1
  Incoming Interface List
    GigabitEthernet0/0/0/18 Flags: A2, Up: 03:32:22
    GigabitEthernet0/0/0/8 Flags: A, Up: 03:32:22
  Outgoing Interface List
    GigabitEthernet0/0/0/28 Flags: F NS LI, Up: 03:32:22
(20.20.20.1,225.0.0.2) Ver: 0x443e RPF nbr: 20.20.20.1 Flags: MoFE MoFS, FMA: 0x501b4908
  Up: 03:32:22
  MOFRR State: Inactive Sequence No 1
  Incoming Interface List
    GigabitEthernet0/0/0/18 Flags: A2, Up: 03:32:22
    GigabitEthernet0/0/0/8 Flags: A, Up: 03:32:22
  Outgoing Interface List
    GigabitEthernet0/0/0/28 Flags: F NS LI, Up: 03:32:22
(*,232.0.0.0/8) Ver: 0x3338 Flags: D, FMA: 0x501b4920
  Up: 12:09:55

Related Commands

Command
Description

nsf lifetime (IGMP)

Configures the maximum time for the NSF timeout value on the IGMP.

show mfib counter

Displays MFIB counter statistics for packets that have dropped.

show mrib route-collapse

Displays the contents of the MRIB route collapse database.

show mfib route

Displays all entries in the MFIB table.


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 ] route-collapse [core-tree]

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.

core-tree

(Optional) IPv4 Multicast Distribution Tree (MDT) group address.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mrib route-collapse command:

RP/0/RSP0/CPU0:router# show mrib route-collapse 
226.1.1.1  TID: 0xe0000038   TLC TID: 0xe0000038
  Customer 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: 1
    nodeid        slot            refcount
    0x20          0/2/CPU0        1       
192.168.27.1  TID: 0xe0000039   TLC TID: 0xe0000039
  Customer 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: 1
    nodeid        slot            refcount
    0x20          0/2/CPU0        1       
192.168.28.1  TID: 0xe000003a   TLC TID: 0xe000003a
  Customer 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: 1
    nodeid        slot            refcount
    0x20          0/2/CPU0        1 

Related CommandsI

Command
Description

show mrib route

Displays all entries in the MRIB table.


show mrib route outgoing-interface

To display the outgoing-interface information on the Multicast Routing Information Base (MRIB), use the show mrib route outgoing-interface command in EXEC mode.

show mrib route outgoing-interface [* | source-address] [group-address [/prefix-length]]

Syntax Description

*

(Optional) Displays shared tree entries.

A.B.C.D

(Optional) Source IP address or hostname of the MRIB route. Format is:

A.B.C.D

A.B.C.D

(Optional) Group IP address or hostname of the MRIB route and the prefix length.

/prefix-length

(Optional) Prefix length of the MRIB group address. A decimal value that indicates how many of the high-order contiguous bits of the address compose the prefix (the network portion of the address). A slash must precede the decimal value. Format is:

A.B.C.D


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.9.0

This command was introduced on the Cisco ASR 9000 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. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mrib route outgoing-interface command:

RP/0/RSP0/CPU0:router# show mrib route outgoing-interface
IP Multicast Routing Information Base
Entry 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 handle
    CD - Conditional Decap, MPLS - MPLS Decap, MF - MPLS Encap, EX - Extranet
    MoFE - MoFRR Enabled, MoFS - MoFRR State
(*,224.0.0.0/4), Up:6d10h, OIF count:0, flags: C
(*,224.0.0.0/24), Up:6d10h, OIF count:0, flags: D
(*,224.0.1.39), Up:6d10h, OIF count:3, flags: S
(10.1.1.1,224.0.1.39), Up:6d10h, OIF count:11, flags:
(10.2.2.2,224.0.1.39), Up:6d10h, OIF count:11, flags:
(10.3.3.3,224.0.1.39), Up:6d10h, OIF count:11, flags:
(10.4.4.4,224.0.1.39), Up:6d10h, OIF count:11, flags:
(10.5.5.5,224.0.1.39), Up:6d10h, OIF count:11, flags:
(10.6.6.6,224.0.1.39), Up:6d10h, OIF count:11, flags:
(10.7.7.7,224.0.1.39), Up:00:04:17, OIF count:11, flags:
(10.8.8.8,224.0.1.39), Up:6d10h, OIF count:11, flags:
(10.9.9.9,224.0.1.39), Up:6d10h, OIF count:11, flags:
(10.10.10.10,224.0.1.39), Up:6d10h, OIF count:11, flags:
(10.21.21.21,224.0.1.39), Up:6d06h, OIF count:11, flags:
(*,224.0.1.40), Up:6d10h, OIF count:2, flags: S
(10.1.1.1,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.2.2.2,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.6.6.6,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.13.4.3,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.14.4.4,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.14.8.4,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.21.21.21,224.0.1.40), Up:6d06h, OIF count:11, flags:
(10.23.4.3,224.0.1.40), Up:00:02:38, OIF count:11, flags:
(10.23.8.3,224.0.1.40), Up:00:02:38, OIF count:11, flags:
(10.34.4.3,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.34.8.3,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.35.4.3,224.0.1.40), Up:00:02:38, OIF count:11, flags:
(10.35.4.5,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.38.4.8,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.45.4.5,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.49.4.9,224.0.1.40), Up:6d10h, OIF count:11, flags:
(10.105.4.10,224.0.1.40), Up:6d10h, OIF count:11, flags:
(*,225.0.0.0/8), Up:6d06h, OIF count:0, flags: C
(*,226.0.0.0/8), Up:6d06h, OIF count:0, flags: C
(*,232.0.0.0/8), Up:6d10h, OIF count:0, flags: D
(10.6.6.6,232.1.1.1), Up:6d10h, OIF count:3, flags:
(10.7.7.7,232.1.1.1), Up:6d10h, OIF count:2, flags:
(10.8.8.8,232.1.1.1), Up:6d10h, OIF count:2, flags:
(10.9.9.9,232.1.1.1), Up:6d10h, OIF count:2, flags:
(10.10.10.10,232.1.1.1), Up:6d10h, OIF count:2, flags:
(10.21.21.21,232.1.1.1), Up:6d06h, OIF count:3, flags:

Related CommandsI

Command
Description

show mrib route

Displays all entries in the MRIB table.


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 ] table-info

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mrib table-info command:

RP/0/RSP0/CPU0:router# show mrib table-info
VRF: 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

Command
Description

show mrib tlc

Displays the contents of the MRIB table-line card (TLC).


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] tlc

Syntax Description

vrf vrf-name

(Optional) Specifies a VPN routing and forwarding (VRF) instance.

ipv4

(Optional) Specifies IPv4 address prefixes.


Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

Task ID
Task ID
Operations

multicast

read


Examples

The following is sample output from the show mrib tlc command:

RP/0/RSP0/CPU0:router# show mrib tlc 
VRF: default [tid 0xe0000000]
Master LC slot: Not selected
Associated MDT group: 0
Forwarding LC node: 0

Table 28 describes the significant fields shown in the display.

Table 28 show msdp peer Field Descriptions 

Field
Description

Associated MDT group

IP address of the MSDP peer.

Master LC slot

Indicates whether the master LC slot has been selected.

Forwarding LC node

Autonomous system to which the peer belongs.

Associated MDT group

Indicates the number of associated MDT groups.


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 path-id next-hop-address

no static-rpf

Syntax Description

prefix-address

IP address of a prefix for an address range.

prefix-mask

Prefix mask for an address range. Range is 0 to 32 for IPv4 .

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note Use the show interfaces command in EXEC mode to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

next-hop-address

IP address for an RPF neighbor.


Defaults

A static RPF rule for a specified prefix mask is not configured.

Command Modes

Multicast routing configuration
Multicast VRF configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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
Task ID
Operations

multicast

read, write


Examples

The following example configures the static RPF rule for IP address 10.0.0.1:

RP/0/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# vrf green
RP/0/RSP0/CPU0:router(config-mcast)# static-rpf 10.0.0.1 32 GigE 0/0/5/0 10.1.1.1

Related Commands

Command
Description

show pim context

Displays reverse path forwarding (RPF) table information configured for a VRF context.


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

ttl

Time to live value. Range is 1 to 255.


Defaults

ttl: 0

Command Modes

Multicast routing interface configuration
Multicast routing VRF interface configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

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 Do not confuse this command with the ttl-threshold (MSDP) command in router MSDP configuration mode that is used to confine the multicast data packet TTL to be sent by an Multicast Source Discovery Protocol (MSDP) Source-Active (SA) message.


Task ID
Task ID
Operations

multicast

read, write


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 GigE 0/1/0/0 interface:

RP/0/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# interface GigE 0/1/0/CPU0
RP/0/RSP0/CPU0:router(config-mcast-default-ipv4-if)# ttl-threshold 23

Related Commands

Command
Description

ttl-threshold (MSDP)

Limits which multicast data packets are sent in SA messages to an MSDP peer.


vrf (multicast)

To configure a virtual routing and forwarding (VRF) instance for a VPN table, 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 [ipv4]

no vrf vrf-name [ipv4]

Syntax Description

vrf-name

Name of the VRF instance. The following names cannot be used: all, default, and global.

ipv4

(Optional) Configures IPv4 address prefixes.


Defaults

No default behavior or values.

Command Modes

Multicast routing configuration

Command History

Release
Modification

Release 3.7.2

This command was introduced on Cisco ASR 9000 Series Router.

Release 3.9.0

No modification.

Release 3.9.1

Included the mdt options in command example.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator.

A VRF instance is a collection of VPN routing and forwarding tables maintained at the provider edge (PE) router.

Task ID
Task ID
Operations

multicast

read, write


Examples

The following example shows how to configure a VRF instance and enter VRF configuration mode:

RP/0/RSP0/CPU0:router(config)# multicast-routing
RP/0/RSP0/CPU0:router(config-mcast)# vrf vrf_1
RP/0/RSP0/CPU0:router(config-mcast-vrf_1-ipv4)# mdt ?
data     Data MDT group configuration
default  MDT default group address
mtu      MDT mtu configuration
source   Interface used to set MDT source address

Related Commands

Command
Description

boundary

Configures a boundary to keep multicast packets from being forwarded.

accounting per-prefix

Enables per-prefix counters only in hardware.

interface (multicast)

Configures multicast interface properties.

log-traps

Enables logging of trap events.

multipath

Enables Protocol Independent Multicast (PIM) to divide the multicast load among several equal-cost paths.

rate-per-route

Enables individual (source, group [S, G]) rate calculations.

ssm

Defines the Protocol Independent Multicast (PIM)-Source Specific Multicast (SSM) range of IP multicast addresses.

static-rpf

Configures a static Reverse Path Forwarding (RPF) rule for a specified prefix mask.