8.1. IP Multicast-Routing Commands

8.1.1. ip multicast-routing

Command Purpose

Use this command to enable ip multicast routing.

To disable ip multicast routing, use the no form of this command.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

ip multicast-routing

no ip multicast-routing

Command Mode

Global Config

Default

Enable

Usage

None

Examples

This example shows how to enable ip multicast routing:

Switch# configure terminal
Switch(config)# ip multicast-routing

This example shows how to disable ip multicast routing:

Switch# configure terminal
Switch(config)# no ip multicast-routing

8.1.2. ip multicast route-limit

Command Purpose

Use this command to set the maximum number of the multicast routes.

To return it to default value, use the no form of this command.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

ip multicast route-limit ROUTE_NUMBER ( THRESHOLD_NUMBER | )

no ip multicast route-limit

Parameter

Parameter Description

Parameter Value

ROUTE_NUMBER

Max number of multicast route entries

1-2048

THRESHOLD_NUMBER

Threshold at which to generate warning message

1-2048

Command Mode

Global Config

Default

Default maximum number of the multicast routes is 2048.

Default threshold is same as the maximum number of multicast routes.

Usage

None

Examples

This example shows how to set the maximum number of the multicast routes to 512:

Switch# configure terminal
Switch(config)# ip multicast route-limit 512

This example shows how to return the maximum number of the multicast routes to default value:

Switch# configure terminal
Switch(config)# no ip multicast route-limit

Related Commands

show ip mroute route-limit

8.1.3. show ip mroute

Command Purpose

Use this command to display the ip multicast routing table information.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

show ip mroute ( sparse | ) ( count | summary | )

show ip mroute IP_ADDR ( sparse | ) ( count | summary | )

show ip mroute route-limit

Parameter

Parameter Description

Parameter Value

sparse

Show sparse multicast routes

-

count

Show number of multicast route entries

-

summary

Show abbreviated multicast route information

-

IP_ADDR

Show specify source or group address multicast route

IPv4 Address

route-limit

Show max route limit value

-

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display multicast routing table:

Switch# show ip mroute

IP Multicast Routing Table
Flags: I - Immediate Stat, T - Timed Stat, F - Forwarder installed
Timers: Uptime/Stat Expiry
Interface State: Interface (TTL)
(10.0.1.20, 228.1.1.1), uptime 00:35:46, stat expires 00:02:19
Owner PIM-SM, Flags: TF
  Incoming interface: eth-0-1
  Outgoing interface list:
    eth-0-2 (1)

This example shows how to display multicast routing table summary information:

Switch# show ip mroute summary 

IP Multicast Routing Table
Flags: I - Immediate Stat, T - Timed Stat, F - Forwarder installed
Timers: Uptime/Stat Expiry
Interface State: Interface (TTL)
(10.0.1.20, 228.1.1.1), 00:36:59/00:02:46, PIM-SM, Flags: TF

Related Commands

ip multicast route-limit

ip mroute-rpf

8.1.4. show ip mvif

Command Purpose

Use this command to display the multicast interface information.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

show ip mvif ( IFNAME | )

Parameter

Parameter Description

Parameter Value

IFNAME

Interface name

Support physical/aggregation/loopback/vlan/tunnel ports

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display multicast interface information:

Switch# show ip mvif

Interface Vif   Owner         TTL  Local            Remote           Uptime
          Idx   Module             Address          Address
eth-0-1   0     PIM-SM        1    10.0.1.1         0.0.0.0          00:42:56
eth-0-2   2     PIM-SM        1    10.0.2.1         0.0.0.0          00:42:53

Related Commands

ip pim sparse-mode

8.1.5. show ip multicast groups count

Command Purpose

Use this command to display the multicast group count.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

show ip multicast groups count

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display multicast group number:

Switch# show ip multicast groups count

multicast group record count: 1
multicast source record count: 0
multicast total record count: 1
multicast max record count: 2048

Related Commands

None

8.1.6. show resource mcast

Command Purpose

Use this command to display multicast resource information.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

show resource mcast

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display multicast resource information:

Switch# show resource mcast 

MCAST
Resource                         Used          Capability
=============================================================
Mcast Entry                      0             1023
Mcast Normal Member              0             2046
Mcast Vlan Member                0             1023

Related Commands

None

8.1.7. clear ip mroute

Command Purpose

Use this command to clear the multicast routing table information.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

clear ip mroute ( * | GRP_ADDR ( SRC_IP ) | )

Parameter

Parameter Description

Parameter Value

GRP_ADDR

Clear specify group address multicast route

IPv4 Address

SRC_ADDR

Clear specify source address multicast route

IPv4 Address

*

Clear all multicast routes

-

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to clear all multicast routing table information:

Switch# clear ip mroute * 

Related Commands

show ip mroute