C Commands

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

clear ip mroute

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

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

 
Syntax Description

*

Specifies all routes.

group

Group address in the format A. B. C. D.

source

(Optional) Source (S, G) route.

group-prefix

Group prefix in the format A. B. C. D / length.

vrf

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

vrf-name

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

all

Specifies that all VRF entries be cleared from the multicast routing table.

default

Specifies that the default VRF entry be cleared from the multicast routing table.

management

Specifies that the management VRF entry be cleared from the multicast routing table.

 
Command Default

None

 
Command Modes

Any command mode

 
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.

The clear ip mroute command is used for debugging purposes. However, this command is not supported for group-prefix option, i.e., subnet routes.

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 pim event-history

To clear information in the IPv4 Protocol Independent Multicast (PIM) event history buffers, use the clear ip pim event-history command.

clear ip pim event-history

 
Syntax Description

This command has no arguments or keywords.

 
Command Default

None

 
Command Modes

Any command mode

 
Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to clear information in the PIM event history buffers:

switch(config)# clear ip pim event-history
switch(config)#
 

 
Related Commands

Command
Description

ip pim event-history

Configures the size of the PIM event history buffers.

show ip pim event-history

Displays information in the PIM event history buffers.

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 [ ethernet slot / port | port-channel channel-number [. sub_if-number ] | vlan vlan-id ]

 
Syntax Description

ethernet slot/port

(Optional) Specifies the Ethernet interface. The slot number is from 1 to 255, and the port number is from 1 to 128.

port-channel number

(Optional) Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

sub_if-number

(Optional) Subinterface number. The range is from 1 to 4093.

vlan vlan-id

(Optional) Specifies the VLAN. The range is from 1 to 4094.

 
Command Default

None

 
Command Modes

Any command mode

 
Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the LAN Base 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 } { ethernet slot / port | port-channel channel-number [. sub_if-number ] | vlan vlan-id }

clear ip pim policy statistics register-policy [ vrf { vrf-name | all | default | management }]

 
Syntax Description

jp-policy

Specifies statistics for the join-prune policy.

neighbor-
policy

Specifies statistics for the neighbor policy.

ethernet slot/port

Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255, and the port number is from 1 to 128.

port-channel number

Specifies the EtherChannel interface and EtherChannel number. The range is from 1 to 4096.

sub_if-number

(Optional) Subinterface number. The range is from 1 to 4093.

vlan

Specifies the VLAN.

vlan-id

VLAN number. The range is from 1 to 4094.

register-policy

Specifies statistics for the register policy.

vrf

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

vrf-name

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

all

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

default

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

management

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

 
Command Default

None

 
Command Modes

Any command mode

 
Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the LAN Base 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 route

To clear routes specific to Protocol Independent Multicast (PIM) for IPv4, use the clear ip pim route command.

clear ip pim route { * | group [ source ] | group-prefix } [ vrf { vrf-name | all | default | management }]

 
Syntax Description

*

Specifies all routes.

group

Group address in the format A. B. C. D.

source

(Optional) Source (S, G) route.

group-prefix

Group prefix in the format A. B. C. D / length.

vrf

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

vrf-name

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

all

Specifies that all VRF entries be cleared from the multicast routing table.

default

Specifies that the default VRF entry be cleared from the multicast routing table.

management

Specifies that the management VRF entry be cleared from the multicast routing table.

 
Command Default

None

 
Command Modes

Any command mode

 
Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to clear the all the routes specific to PIM:

switch(config)# clear ip pim route *
switch(config)#
 

 
Related Commands

Command
Description

show ip pim route

Displays information about PIM specific routes.

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 | default | management }]

 
Syntax Description

vrf

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

vrf-name

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

all

Specifies that all VRF entries be cleared from the multicast routing table.

default

Specifies that the default VRF entry be cleared from the multicast routing table.

management

Specifies that the management VRF entry be cleared from the multicast routing table.

 
Command Default

None

 
Command Modes

Any command mode

 
Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the LAN Base 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 ip routing multicast event-history

To clear information in the IPv4 Multicast Routing Information Base (MRIB) event history buffers, use the clear ip routing multicast event-history command.

clear ip routing multicast event-history { cli | mfdm-debugs | mfdm-events | mfdm-stats | rib | vrf }

 
Syntax Description

cli

Clears the CLI event history buffer.

mfdm-debugs

Clears the multicast FIB distribution (MFDM) debug history buffer.

mfdm-events

Clears the MFDM events history buffer.

mfdm-stats

Clears the MFDM sum event history buffer.

rib

Clears the RIB event history buffer.

vrf

Clears the virtual routing and forwarding (VRF) event history buffer.

 
Command Default

None

 
Command Modes

Any command mode

 
Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to clear information in the MRIB RIB event history buffer:

switch(config)# clear ip routing multicast event-history rib
switch(config)#
 

 
Related Commands

Command
Description

ip routing multicast event-history

Configures the size of the IPv4 MRIB event history buffers.

show routing ip multicast event-history

Displays information in the IPv4 MRIB event history buffers.

clear routing multicast

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

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

 
Syntax Description

ip

(Optional) Clears IP commands.

ipv4

(Optional) Clears IPv4 commands.

*

Specifies all routes.

group

Group address in the format A. B. C. D.

source

(Optional) Source (S, G) route.

group-prefix

Group prefix in the format A. B. C. D / length.

vrf

(Optional) Clears the virtual routing and forwarding (VRF) instance information.

vrf-name

VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

all

Specifies that all VRF entries be cleared from the IPv4 multicast routing table.

default

Specifies that the default VRF entry be cleared from the IPv4 multicast routing table.

management

Specifies that the management VRF entry be cleared from the IPv4 multicast routing table.

 
Command Default

None

 
Command Modes

Any command mode

 
Command History

Release
Modification

5.0(3)N1(1)

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.