Table Of Contents
Multicast Distributed Switching Commands
Multicast Distributed Switching Commands
This chapter documents commands used to configure Multicast Distributed Switching in Cisco IOS software. For guidelines on configuring Multicast Distributed Switching, refer to the Cisco IOS Switching Services Configuration Guide.
Note
Beginning with Cisco IOS Release 11.3, all commands supported on the Cisco 7500 series routers are also supported on Cisco 7000 series routers.
clear ip mds forwarding
To clear all routes from a line card's MFIB table and resynchronize it with the RP, use the clear ip mds forwarding EXEC command.
clear ip mds forwarding
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command on a line card of a Cisco 7500 or Cisco 12000.
Examples
The following example clears the line card's MFIB table:
clear ip mds forwardingRelated Commands
clear ip mds linecard
To reset multicast distributed switching (MDS) line card information on the router, use the clear ip mds linecard command in privileged EXEC mode.
clear ip mds linecard {linecard-slot-number | *}
Syntax Description
linecard-slot-number
Slot number containing the line card to be reset.
*
Indicates that the reset should be executed on all line cards.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
When the * keyword is specified instead of the linecard-slot-number argument, all MDS information on all line cards is cleared and reset.
Examples
The following example clears and resets all MDS line card information on the router:
Router# clear ip mds linecard *
Related Commands
clear ip pim interface count
To clear all line card counts or packet counts, use the clear ip pim interface count EXEC command.
clear ip pim interface count
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command on an RP to delete all multicast distributed switching (MDS) statistics for the entire router.
Examples
The following example clears all the line card packets counts:
clear ip pim interface countRelated Commands
Clears all routes from the MFIB table of a line card and resynchronizes it with the RP.
ip mroute-cache
To configure IP multicast fast switching or multicast distributed switching (MDS), use the ip mroute-cache interface configuration command. To disable either of these features, use the no form of this command.
ip mroute-cache [distributed]
no ip mroute-cache [distributed]
Syntax Description
Defaults
On the RSP, IP multicast fast switching is enabled; MDS is disabled.
On the GSR, MDS is disabled.Command Modes
Interface configuration
Command History
10.0
This command was introduced.
11.2(11)GS
The distributed keyword was added.
Usage Guidelines
On the RSP
If multicast fast switching is disabled on an incoming interface for a multicast routing table entry, the packet will be sent at process level for all interfaces in the outgoing interface list.
If multicast fast switching is disabled on an outgoing interface for a multicast routing table entry, the packet is process level switched for that interface, but may be fast-switched for other interfaces in the outgoing interface list.
When multicast fast switching is enabled (like unicast routing), debug messages are not logged. If you want to log debug messages, disable fast switching.
If MDS is not enabled on an incoming interface that is capable of MDS, incoming multicast packets will not be distributed switched; they will be fast-switched at the RP as before. Also, if the incoming interface is not capable of MDS, packets will get fast-switched or process-switched at the RP as before.
If MDS is enabled on the incoming interface, but at least one of the outgoing interfaces cannot fast-switch, packets will be process-switched. So it is a good idea not to disable fast switching on any interface when MDS is enabled.
On the GSR
On the GSR, all interfaces should be configured for MDS because that is the only switching mode.
Examples
The following example enables IP multicast fast switching on the interface:
ip mroute-cacheThe following example disables IP multicast fast switching on the interface:
no ip mroute-cacheThe following example enables MDS on the interface:
ip mroute-cache distributedThe following example disables MDS and IP multicast fast switching on the interface:
no ip mroute-cache distributedip multicast-routing
To enable IP multicast routing or multicast distributed switching (MDS), use the ip multicast-routing global configuration command. To disable IP multicast routing and MDS, use the no form of this command.
ip multicast-routing [distributed]
no ip multicast-routing
Syntax Description
Defaults
Disabled
Command Modes
Global configuration
Command History
10.0
This command was introduced.
11.2(11)GS
The distributed keyword was introduced.
Usage Guidelines
When IP multicast routing is disabled, the Cisco IOS software does not forward any multicast packets.
Examples
The following example enables IP multicast routing:
ip multicast-routingThe following example disables IP multicast routing and MDS:
no ip multicast-routingRelated Commands
show interface stats
To display numbers of packets that were process switched, fast switched, and distributed switched, use the show interface stats EXEC command.
show interface type number stats
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
Use this command on the RP.
Note
Examples
The following is sample output from the show interface stats command:
Router# show interface fddi 3/0/0 statsFddi3/0/0Switching path Pkts In Chars In Pkts Out Chars OutProcessor 3459994 1770812197 4141096 1982257456Route cache 10372326 3693920448 439872 103743545Distributed cache 19257912 1286172104 86887377 1184358085Total 33090232 2455937453 91468345 3270359086Table 115 describes the fields in the display.
show ip mcache
To display the contents of the IP multicast fast-switching cache, use the show ip mcache EXEC command.
show ip mcache [group [source]]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
Use this command on the RP.
Examples
The following is sample output from the show ip mcache command. This entry shows a specific source (wrn-source 204.62.246.73) sending to the World Radio Network group (224.2.143.24).
Router# show ip mcache wrn wrn-sourceIP Multicast Fast-Switching Cache(204.62.246.73/32, 224.2.143.24), Fddi0, Last used: 00:00:00Ethernet0 MAC Header: 01005E028F1800000C1883D30800Ethernet1 MAC Header: 01005E028F1800000C1883D60800Ethernet2 MAC Header: 01005E028F1800000C1883D40800Ethernet3 MAC Header: 01005E028F1800000C1883D70800Table 116 describes the significant fields in the display.
The following is sample output from the show ip mcache command when MDS is in effect.
Router# show ip mcacheIP Multicast Fast-Switching Cache(*, 224.2.170.73), Fddi3/0/0, Last used: mdsTunnel3 MAC Header: 5000602F9C150000603E473F60AAAA030000000800 (Fddi3/0/0)Tunnel0 MAC Header: 5000602F9C150000603E473F60AAAA030000000800 (Fddi3/0/0)Tunnel1 MAC Header: 5000602F9C150000603E473F60AAAA030000000800 (Fddi3/0/0)show ip mds forwarding
On a line card, to display the MFIB table and forwarding information for multicast distributed switching (MDS), use the show ip mds forwarding EXEC command.
show ip mds forwarding [group-address] [source-address]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
Use this command on the line card. This command displays the MFIB table, forwarding information and related flags and counts.
Note
On a GSR only, line card commands can be executed from the RP using the following syntax: execute [slot slot-number | all] command
The command is any of the line card show commands, such as show ip mds summary and show ip mds forward.
Examples
The following is sample output from the show ip mds forwarding command:
Router# show ip mds forwarding IP multicast MDFS forwarding information and statistics:Flags: N - Not MDFS switchable, F - Not all MDFS switchable, O - OIF NullR - In-ratelimit, A - In-access, M - MTU mismatch, P - Register setInterface state: Interface, Next-Hop, Mac header(*, 224.2.170.73),Incoming interface: NullPkts: 0, last used: never, Kbps: 0, fast-flags: NOutgoing interface list: Null(128.97.62.86, 224.2.170.73) [31]Incoming interface: Fddi3/0/0Pkts: 3034, last used: 00:00:00, Kbps: 0, fast-flags: MOutgoing interface list:Table 117 describes the significant fields in the display.
show ip mds interface
To display the status of multicast distributed switching (MDS) interfaces, use the show ip mds interface EXEC command.
show ip mds interface
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command on the RP.
Examples
The following is sample output from the show ip mds interface command:
Router# show ip mds interfaceEthernet1/0/0 is up, line protocol is upEthernet1/0/1 is up, line protocol is upFddi3/0/0 is up, line protocol is upFastEthernet3/1/0 is up, line protocol is upTable 118 describes the fields in the display.
Table 118 show ip mds interface Field Descriptions
Ethernet1/0/0 is up
Status of interface.
line protocol is up
Status of line protocol.
show ip mds stats
To display switching statistics or line card statistics for multicast distributed switching (MDS), use the show ip mds stats EXEC command.
show ip mds stats [switching | linecard]
Syntax Description
switching
(Optional) Displays switching statistics.
linecard
(Optional) Displays line card statistics.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command on the RP.
Examples
The following is sample output from the show ip mds stats command with the switching keyword:
Router# show ip mds stats switchingSlot Total Switched Drops RPF Punts Failures(switch/clone)1 0 0 0 0 4 0/03 20260925 18014717 253 93 2247454 1/0Table 119 describes the fields in the display.
The following is sample output from the show ip mds stats command with the linecard keyword:
Router# show ip mds stats linecardSlot Status IPC(seq/max) Q(high/route) Reloads1 active 10560/10596 0/0 93 active 11055/11091 0/0 9Table 120 describes the fields in the display.
show ip mds summary
To display a summary of the MFIB table for multicast distributed switching (MDS), use the show ip mds summary EXEC command.
show ip mds summary
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command on a line card. On a GSR only, line card commands can be executed from the RP using the following syntax:
execute [slot slot-number | all] command
The command is any of the line card show commands, such as show ip mds summary and show ip mds forward.
Examples
The following is sample output from the show ip mds summary command:
Router# show ip mds summaryIP multicast MDFS forwarding information and statistics:Flags: N - Not MDFS switchable, F - Not all MDFS switchable, O - OIF NullR - In-ratelimit, A - In-access, M - MTU mismatch, P - Register setInterface state: Interface, Next-Hop, Mac header(*, 224.2.170.73),Incoming interface: NullPkts: 0, last used: never, Kbps: 0, fast-flags: N(128.97.62.86, 224.2.170.73) [31]Incoming interface: Fddi3/0/0Pkts: 3045, last used: 00:00:03, Kbps: 0, fast-flags: M(128.223.3.7, 224.2.170.73) [334]Incoming interface: Fddi3/0/0Pkts: 0, last used: never, Kbps: 0, fast-flags: MTable 121 describes the fields in the display.
show ip pim interface count
To display switching counts for multicast distributed switching (MDS) and other fast switching statistics, use the show ip pim interface count EXEC command.
show ip pim interface [type number] count
Syntax Description
type number
(Optional) Interface type and number. If these arguments are specified, information is displayed about that interface only.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command on the RP.
Examples
The following is sample output from the show ip pim interface count command:
Router# show ip pim interface countAddress Interface FS Mpackets In/Out128.223.224.8 Ethernet1/0/0 D 4/0128.223.225.1 Ethernet1/0/1 D 0/0128.223.222.8 Fddi3/0/0 D 20182993/56931128.223.156.1 FastEthernet3/1/0 D 59991/462385137.39.26.98 Tunnel0 * 394681/10686513128.223.90.13 Tunnel1 * 517821/7185605128.223.90.25 Tunnel3 * 26282/20027641128.223.90.29 Tunnel4 * 2415/8688961Table 122 describes the fields in the display.
