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

 
Supported User Roles

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

 
Command History

Release
Modification

6.0(2)N1(1)

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

 
Supported User Roles

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

 
Command History

Release
Modification

6.0(2)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

 
Supported User Roles

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

 
Command History

Release
Modification

6.0(2)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 }]

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.

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.

loopback if_number

(Optional) Specifies the loopback interface. The loopback interface number is from 0 to 1023.

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.

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) 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

 
Supported User Roles

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

 
Command History

Release
Modification

6.0(2)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

 
Supported User Roles

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

 
Command History

Release
Modification

6.0(2)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

 
Supported User Roles

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

 
Command History

Release
Modification

6.0(2)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 | mfdm-stats | rib | vrf }

 
Syntax Description

cli

Clears the CLI event history buffer.

mfdm

Clears the multicast FIB distribution (MFDM) 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

 
Supported User Roles

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

 
Command History

Release
Modification

6.0(2)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 ipv6 mroute

To clear routes in 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 all the routes in 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 routing multicast event-history

To clear information in the IPv6 Multicast Routing Information Base (M6RIB) event history buffers, use the clear ipv6 routing multicast event-history command.

clear ipv6 routing multicast event-history { cli | mfdm | mfdm-stats | rib | vrf }

 
Syntax Description

cli

Clears the CLI event history buffer.

mfdm

Clears the multicast FIB distribution (MFDM event 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.

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
Command History

Release
Modification

4.1(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

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

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

 
Related Commands

Command
Description

ipv6 routing multicast event-history

Configures the size of the IPv6 M6RIB event history buffers.

show routing ipv6 multicast event-history

Displays information in the IPv6 M6RIB event history buffers.

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 [ 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

 
Supported User Roles

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

 
Command History

Release
Modification

6.0(2)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.

 

clear ipv6 pim event-history

To clear information in the IPv6 Protocol Independent Multicast (PIM6) event history buffers, use the clear ipv6 pim event-history command.

clear ipv6 pim event-history

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
Command History

Release
Modification

4.1(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

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

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

 
Related Commands

Command
Description

ipv6 pim event-history

Configures the size of the PIM6 event history buffers.

show ipv6 pim event-history

Displays information in the PIM6 event history buffers.

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 route

To clear routes specific to Protocol Independent Multicast for IPv6 (PIM6), use the clear ipv6 pim route command.

clear ipv6 pim route { * | 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.1(2)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

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

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

 
Related Commands

Command
Description

show ipv6 pim route

Displays information about PIM6 specific routes.

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 ipv6 routing multicast event-history

To clear information in the IPv6 Multicast Routing Information Base (M6RIB) event history buffers, use the clear ipv6 routing multicast event-history command.

clear ipv6 routing multicast event-history { cli | mfdm | mfdm-stats | rib | vrf }

 
Syntax Description

cli

Clears the CLI event history buffer.

mfdm

Clears the multicast FIB distribution (MFDM event 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.

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
Command History

Release
Modification

4.1(2)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

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

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

 
Related Commands

Command
Description

ipv6 routing multicast event-history

Configures the size of the IPv6 M6RIB event history buffers.

show routing ipv6 multicast event-history

Displays information in the IPv6 M6RIB event history buffers.