Cisco Nexus 7000 Series NX-OS Multicast Routing Command Reference, Release 4.0
C Commands

Table Of Contents

C Commands

clear ip igmp interface statistics

clear ip igmp snooping statistics vlan

clear ip mroute

clear ip msdp peer

clear ip msdp policy statistics sa-policy

clear ip msdp route

clear ip msdp sa-cache

clear ip msdp statistics

clear ip pim interface statistics

clear ip pim policy statistics

clear ip pim statistics

clear ipv6 mroute

clear ipv6 pim interface statistics

clear ipv6 pim policy statistics

clear ipv6 pim statistics

clear routing ipv6 multicast

clear routing multicast


C Commands


This chapter describes the Cisco NX-OS multicast routing commands that begin with C.

clear ip igmp interface statistics

To clear the IGMP statistics for an interface, use the clear ip igmp interface statistics command.

clear ip igmp interface statistics [if-type if-number]

Syntax Description

if-type

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

if-number

(Optional) Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(3)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear IGMP statistics for an interface:

switch# clear ip igmp interface statistics ethernet 2/1
switch# 

Related Commands

Command
Description

show ip igmp interface

Displays information about IGMP interfaces.


clear ip igmp snooping statistics vlan

To clear the IGMP snooping statistics for VLANs, use the clear ip igmp snooping statistics vlan command.

clear ip igmp snooping statistics vlan {vlan-id | all}

Syntax Description

vlan-id

VLAN number. The range is from 1 to 3967 and 4048 to 4093.

all

Applies to all VLANs.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.

4.0(3)

The all keyword was added.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear IGMP snooping statistics for VLAN 1:

switch# clear ip igmp snooping statistics vlan 1
switch# 

Related Commands

Command
Description

show ip igmp snooping statistics vlan

Displays IGMP snooping statistics by VLAN.


clear ip mroute

To clear the multicast routing table, use the clear ip mroute command.

clear ip mroute {* | group-prefix | group [source]} [vrf {vrf-name | all}]

Syntax Description

*

Specifies all routes.

group-prefix

Group prefix.

group

Group address.

source

(Optional) Source (S, G) route.

vrf

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

vrf-name

VRF name.

all

Display information for all VRFs.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(3)

This command was introduced.


Usage Guidelines

The clear routing multicast command is an alternative form of this command.

This command does not require a license.

Examples

This example shows how to clear the multicast routing table:

switch(config)# clear ip mroute *
switch(config)# 

Related Commands

Command
Description

clear routing multicast

Clears the multicast routing table

show ip mroute

Displays information about the multicast routing table.


clear ip msdp peer

To clear a TCP connection to Multicast Source Discovery Protocol (MSDP) peers, use the clear ip msdp peer command.

clear ip msdp peer peer-address [vrf vrf-name]

Syntax Description

peer-address

IP address of MSDP peer.

vrf vrf-name

(Optional) Applies to a virtual routing and forwarding (VRF) instance name.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to clear a TCP connection to an MSDP peer:

switch# clear ip msdp peer 192.168.1.10
switch# 

Related Commands

Command
Description

show ip msdp peer

Displays information about MSDP peers.


clear ip msdp policy statistics sa-policy

To clear the Source-Active (SA) policy for Multicast Source Discovery Protocol (MSDP) peers, use the clear ip msdp policy statistics sa-policy command.

clear ip msdp policy statistics sa-policy peer-address {in | out} [vrf vrf-name]

Syntax Description

peer-address

IP address of MSDP peer for SA policy.

in

Specifies input policy.

out

Specifies output policy.

vrf vrf-name

(Optional) Applies to a virtual routing and forwarding (VRF) instance name.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to clear an SA policy for an MSDP peer:

switch# clear ip msdp policy statistics sa-policy
switch# 

Related Commands

Command
Description

show ip msdp peer

Displays information about MSDP peers.


clear ip msdp route


Note Effective with Cisco NX-OS Release 4.0(3), the clear ip msdp route command is not available in Cisco NX-OS software.


To clear routes matching group entries in the Multicast Source Discovery Protocol (MSDP) Source-Active (SA) cache, use the clear ip msdp route command.

clear ip msdp route [group] [vrf {vrf-name | all}]

Syntax Description

group

(Optional) All sources for group from the SA-cache.

vrf

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

vrf-name

VRF name.

all

Applies to all VRFs.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.

4.0(3)

This command was removed.


Usage Guidelines

You can also use the clear ip msdp sa-cache command for the same function.

This command requires the Enterprise Services license.

Examples

This example shows how to clear the MSDP SA cache:

switch# clear ip msdp route
switch# 

Related Commands

Command
Description

clear ip msdp sa-cache

Clears the MSDP SA cache.

show ip msdp route

Displays route information in the MSDP Source-Active cache.


clear ip msdp sa-cache


Note Effective with Cisco NX-OS Release 4.0(3), the clear ip msdp sa-cache command is not available in Cisco NX-OS software.


To clear routes matching group entries in the Multicast Source Discovery Protocol (MSDP) Source-Active (SA) cache, use the clear ip msdp sa-cache command.

clear ip msdp sa-cache [group] [vrf {vrf-name | all}]

Syntax Description

group

(Optional) All sources for group from the SA-cache.

vrf

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

vrf-name

VRF name.

all

Applies to all VRFs.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.

4.0(3)

This command was removed.


Usage Guidelines

You can also use the clear ip msdp route command for the same function.

This command requires the Enterprise Services license.

Examples

This example shows how to clear the MSDP SA cache:

switch# clear ip msdp sa-cache
switch# 

Related Commands

Command
Description

clear ip msdp route

Clears the MSDP SA cache.

show ip msdp sa-cache

Displays route information in the MSDP Source-Active cache.


clear ip msdp statistics

To clear statistics for Multicast Source Discovery Protocol (MSDP) peers, use the clear ip msdp statistics command.

clear ip msdp statistics [peer-address] [vrf vrf-name]

Syntax Description

peer-address

(Optional) IP address of the MSDP peer.

vrf vrf-name

(Optional) Applies to a virtual routing and forwarding (VRF) instance name.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to clear MSDP statistics for all MSDP peers:

switch# clear ip msdp statistics
switch# 

Related Commands

Command
Description

show ip msdp peer

Displays information about MSDP peers.


clear ip pim interface statistics

To clear Protocol Independent Multicast (PIM) counters for a specified interface, use the clear ip pim interface statistics command.

clear ip pim interface statistics [if-type if-number]

Syntax Description

if-type

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

if-number

(Optional) Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.

4.0(3)

The interface argument was made optional.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to clear the PIM counters for a specified interface:

switch# clear ip pim interface statistics ethernet 2/1
switch# 

Related Commands

Command
Description

show ip pim statistics

Displays PIM statistics.


clear ip pim policy statistics

To clear Protocol Independent Multicast (PIM) policy counters, use the clear ip pim policy statistics command.

clear ip pim policy statistics {jp-policy | neighbor-policy} if-type if-number

clear ip pim policy statistics {register-policy | bsr {bsr-policy | rp-candidate-policy} | auto-rp {rp-candidate-policy | mapping-agent-policy}} [vrf {vrf-name | all}]

Syntax Description

jp-policy

Specifies statistics for the join-prune policy.

neighbor-
policy

Specifies statistics for the neighbor policy.

if-type

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

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.

register-policy

Specifies statistics for the register policy.

bsr

Specifies the bootstrap protocol RP-distribution policy.

bsr-policy

Specifies the statistics for BSR messages.

rp-candidate-
policy

Specifies the statistics for RP candidate messages.

auto-rp

Specifies the statistics for Auto-RP messages.

mapping-
agent-policy

Specifies the statistics for mapping agent messages.

vrf

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

vrf-name

VRF name.

all

Specifies all VRFs.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to clear PIM register policy counters:

switch# clear ip pim policy statistics register-policy
switch# 

Related Commands

Command
Description

show ip pim policy statistics

Displays PIM policy statistics.


clear ip pim statistics

To clear Protocol Independent Multicast (PIM) statistics counters, use the clear ip pim statistics command.

clear ip pim statistics [vrf {vrf-name | all}]

Syntax Description

vrf

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

vrf-name

VRF name.

all

Specifies all VRFs.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to clear PIM statistics counters:

switch# clear ip pim statistics
switch# 

Related Commands

Command
Description

show ip pim statistics

Displays PIM statistics.


clear ipv6 mroute

To clear the IPv6 multicast routing table, use the clear ipv6 mroute command.

clear ipv6 mroute {* | group-prefix | group [source]} [vrf {vrf-name | all}]

Syntax Description

*

Specifies all routes.

group-prefix

Group prefix.

group

Group address.

source

(Optional) Source (S, G) route.

vrf

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

vrf-name

VRF name.

all

Specifies all VRFs.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(3)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the IPv6 multicast routing table:

switch(config)# clear ipv6 mroute *
switch(config)# 

Related Commands

Command
Description

show ipv6 mroute

Displays information about the IPv6 multicast routing table.


clear ipv6 pim interface statistics

To clear Protocol Independent Multicast for IPv6 (PIM6) counters for a specified interface, use the clear ipv6 pim interface statistics command.

clear ipv6 pim interface statistics [if-type if-number]

Syntax Description

if-type

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

if-number

(Optional) Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.

4.0(3)

The interface argument was made optional.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to clear PIM6 counters for a specified interface:

switch# clear ipv6 pim interface statistics ethernet 2/2
switch# 

Related Commands

Command
Description

show ipv6 pim statistics

Displays PIM6 statistics.


clear ipv6 pim policy statistics

To clear Protocol Independent Multicast for IPv6 (PIM6) policy counters, use the clear ipv6 pim policy statistics command.

clear ipv6 pim policy statistics {jp-policy | neighbor-policy} if-type if-number

Syntax Description

jp-policy

Specifies the statistics for join-prune policy.

neighbor-
policy

Specifies the statistics for neighbor policy.

if-type

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

if-number

Interface or subinterface number. For more information about the numbering syntax for your networking device, use the question mark (?) online help function.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to clear PIM6 join-prune policy counters:

switch(config)# clear ipv6 pim policy statistics jp-policy

Related Commands

Command
Description

show ipv6 pim policy statistics

Displays PIM6 policy statistics.


clear ipv6 pim statistics

To clear Protocol Independent Multicast for IPv6 (PIM6) statistics counters, use the clear ipv6 pim statistics command.

clear ipv6 pim statistics [vrf {vrf-name | all}]

Syntax Description

vrf

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

vrf-name

VRF name.

all

Specifies all VRFs.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(1)

This command was introduced.


Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to clear PIM6 statistics counters:

switch# clear ipv6 pim statistics

Related Commands

Command
Description

show ipv6 pim statistics

Displays PIM6 statistics.


clear routing ipv6 multicast

To clear the IPv6 multicast routing table, use the clear routing ipv6 multicast command.

clear routing ipv6 multicast {* | group-prefix | group [source]} [vrf {vrf-name | all}]

Syntax Description

*

Specifies routes.

group-prefix

Group prefix.

group

Group address.

source

(Optional) Source (S, G) route.

vrf

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

vrf-name

VRF name.

all

Specifies all VRFs.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(3)

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear the IPv6 multicast routing table:

switch(config)# clear routing ipv6 multicast *
switch(config)# 

Related Commands

Command
Description

show routing ipv6 multicast

Displays information about IPv6 multicast routes.


clear routing multicast

To clear the IPv4 multicast routing table, use the clear routing multicast command.

clear routing [ip | ipv4] multicast {* | group-prefix | group [source]} [vrf {vrf-name | all}]

Syntax Description

ip

(Optional) Clear IP commands.

ipv4

(Optional) Clear IP commands.

*

Specifies all routes.

group-prefix

Group prefix.

group

Group address.

source

(Optional) Source (S, G) route.

vrf

(Optional) Applies to a virtual routing and forwarding (VRF) instance.

vrf-name

VRF name.

all

Specifies all VRFs.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0(3)

This command was introduced.


Usage Guidelines

The clear ip mroute command is an alternative form of this command.

This command does not require a license.

Examples

This example shows how to clear the IPv4 multicast routing table:

switch(config)# clear routing multicast *
switch(config)# 

Related Commands

Command
Description

clear ip mroute

Clears the multicast routing table.

show routing ip multicast

Displays information about IPv4 multicast routes.