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

5.2(1)N1(1)

This command was introduced.


Usage Guidelines

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

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.2(1)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/[QSFP-module/]port | port-channel channel-number[.sub_if-number] | vlan vlan-id] 
 
    
   
 Syntax Description
 
   
 
    
 
      
      
      
 
       
 ethernet slot/[QSFP-module/]port 
 		 
       
 (Optional) Specifies the Ethernet interface. The slot number is from 1 to 255. The QSFP-module number is from 1 to 4. The port number is from 1 to 128. 
 
 Note The QSFP-module number applies only to the QSFP+ Generic Expansion Module (GEM). 
 		 
      
 
      
 
       
 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 
        
 		 
      
 
      
 
       
 6.0(2)N1(2) 
 		 
       
 Support for the QSFP+ GEM was added. 
 		 
      
 
      
 
       
 5.2(1)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/[QSFP-module/]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/[QSFP-module/]port 
 		 
       
 Specifies the Ethernet interface and the slot number and port number. The slot number is from 1 to 255. The QSFP-module number is from 1 to 4. The port number is from 1 to 128. 
 
 Note The QSFP-module number applies only to the QSFP+ Generic Expansion Module (GEM). 
 		 
      
 
      
 
       
 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 
        
 		 
      
 
      
 
       
 6.0(2)N1(2) 
 		 
       
 Support for the QSFP+ GEM was added. 
 		 
      
 
      
 
       
 5.2(1)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.2(1)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.2(1)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.2(1)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.2(1)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.