Cisco Nexus 5600 Series NX-OS Multicast Routing Command Reference

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents
Find Matches in This Book

Results

Updated:
March 16, 2014

Chapter: Show Commands

Show Commands

This chapter describes the Cisco NX-OS PIM show commands.

show ip mroute

To display information about IPv4 multicast routes, use the show ip mroute command.

show ip mroute { group | { source group } | { group [ source ]}} [ summary [ software-forwarded ]] [ vrf { vrf-name | all }]

 
Syntax Description

group

Group address for route.

source

Source address for route.

summary

(Optional) Displays route counts and packet rates.

software-
forwarded

(Optional) Displays software-switched route counts only.

vrf

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

vrf-name

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

all

Specifies all VRFs.

 
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 display information about IPv4 multicast routes:

switch(config)# show ip mroute
IP Multicast Routing Table for VRF "default"
 
(*, 232.0.0.0/8), uptime: 04:18:55, pim ip
Incoming interface: Null, RPF nbr: 0.0.0.0
Outgoing interface list: (count: 0)
 
switch(config)#
 

The display specifies the interface established for each one and shows the router owners. In the case of the first paragraph in the display, the route owner is igmp ip pim. iod is an internal representation the device uses for the interface.

 
Related Commands

Command
Description

show ip mroute summary

Displays summary information about IPv4 multicast routes.

 

show ip mroute summary

To display summary information about IPv4 multicast routes, use the show ip mroute summary command.

show ip mroute summary [ count | software-forwarded ] [ vrf { vrf-name | all }]

show ip mroute [ group ] summary [ software-forwarded ] [ vrf { vrf-name | all }]

 
Syntax Description

count

(Optional) Displays only route counts.

software-
forwarded

(Optional) Displays software-switched route counts only.

vrf

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

vrf-name

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

all

Specifies all VRFs.

group

(Optional) Specifies a group address for a route.

 
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 display summary information about IPv4 multicast routes:

switch(config)# show ip mroute summary
IP Multicast Routing Table for VRF "default"
 
Total number of routes: 1
Total number of (*,G) routes: 0
Total number of (S,G) routes: 0
Total number of (*,G-prefix) routes: 1
Group count: 0, rough average sources per group: 0.0
 
Group: 232.0.0.0/8, Source count: 0
Source packets bytes aps pps bit-rate oifs
(*,G) 0 0 0 0 0.000 bps 0
 
switch(config)#
 

This example shows how to display the number of IPv4 multicast routes:

switch# show ip mroute summary count
IP Multicast Routing Table for VRF "default"
 
Total number of routes: 2
Total number of (*,G) routes: 1
Total number of (S,G) routes: 0
Total number of (*,G-prefix) routes: 1
Group count: 1, rough average sources per group: 0.0
switch#
 

 
Related Commands

Command
Description

show ip mroute

Displays information about IPv4 multicast routes.

 

show ip netstack mroute

To show IPv4 multicast routes in the Network Stack cache, use the show ip netstack mroute command.

show ip netstack mroute [ vrf vrf-name ]

 
Syntax Description

vrf vrf-name

(Optional) Specifies the VRF name. The name can be a maximum of 32 alphanumeric characters and is case sensitive.

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
Command History

Release
Modification

 

This command was introduced.

 
Usage Guidelines

This command does not require a license.

Examples

This example shows how to display multicast routes in the Network Stack cache:

switch(config)# show ip netstack mroute
(0.0.0.0/0, 225.1.1.1/32)
Software switched packets: 1, bytes: 84
(4.1.1.2/32, 225.1.1.1/32), data-created
Software switched packets: 2, bytes: 168
(0.0.0.0/0, 225.1.1.2/32)
Software switched packets: 0, bytes: 0
(4.1.1.2/32, 225.1.1.2/32), data-created
Software switched packets: 5, bytes: 420
(0.0.0.0/0, 225.1.1.3/32)
Software switched packets: 0, bytes: 0
(4.1.1.2/32, 225.1.1.3/32), data-created
Software switched packets: 2, bytes: 168
(0.0.0.0/0, 225.1.1.4/32)
Software switched packets: 0, bytes: 0
(4.1.1.2/32, 225.1.1.4/32), data-created
Software switched packets: 2, bytes: 168
(0.0.0.0/0, 225.1.1.5/32)
Software switched packets: 0, bytes: 0
(4.1.1.2/32, 225.1.1.5/32), data-created
Software switched packets: 2, bytes: 168
(0.0.0.0/0, 226.1.1.1/32)
Software switched packets: 0, bytes: 0
(0.0.0.0/0, 226.2.2.2/32)
Software switched packets: 0, bytes: 0
(0.0.0.0/0, 232.0.0.0/8)
Software switched packets: 0, bytes: 0
switch(config)#
 

show ip pim df

To display information about the designated forwarders (DFs) for IPv4 Protocol Independent Multicast (PIM), use the show ip pim df command.

show ip pim df [ rp-or-group ] [ vrf { vrf-name | all }]

 
Syntax Description

rp-or-group

(Optional) RP or group address.

vrf

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

vrf-name

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

all

Specifies all VRFs.

 
Command Default

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
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 display information about PIM DFs:

switch(config)# show ip pim df
 

show ip pim event-history

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

show ip pim event-history { errors | msgs | statistics }

 
Syntax Description

errors

Displays events of type error.

msgs

Displays events of type msg.

statistics

Displays events of type statistics.

 
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 display information in the IPv4 PIM msgs event history buffer:

switch(config)# show ip pim event-history msgs
 
Msg events for PIM Process
1) Event:E_DEBUG, length:38, at 165671 usecs after Sat Apr 12 08:35:02 2008
[100] : nvdb: transient thread created
 
2) Event:E_DEBUG, length:38, at 165018 usecs after Sat Apr 12 08:35:02 2008
[100] : nvdb: create transcient thread
 
3) Event:E_DEBUG, length:79, at 165014 usecs after Sat Apr 12 08:35:02 2008
[100] : comp-mts-rx opc - from sap 3061 cmd pim_show_internal_event_hist_com
mand
4) Event:E_DEBUG, length:35, at 63168 usecs after Sat Apr 12 08:34:25 2008
[100] : nvdb: terminate transaction
 
5) Event:E_DEBUG, length:46, at 62809 usecs after Sat Apr 12 08:34:25 2008
[100] : nvdb: pim_show_df_command returned 0x0
 
6) Event:E_DEBUG, length:38, at 62676 usecs after Sat Apr 12 08:34:25 2008
[100] : nvdb: transient thread created
 
7) Event:E_DEBUG, length:38, at 61971 usecs after Sat Apr 12 08:34:25 2008
[100] : nvdb: create transcient thread
 
8) Event:E_DEBUG, length:62, at 61966 usecs after Sat Apr 12 08:34:25 2008
[100] : comp-mts-rx opc - from sap 3055 cmd pim_show_df_command
9) Event:E_DEBUG, length:50, at 771336 usecs after Sat Apr 12 06:14:41 2008
[100] : nvdb: _cli_send_my_if_command returned 0x0
 
10) Event:E_DEBUG, length:63, at 771105 usecs after Sat Apr 12 06:14:41 2008
[100] : comp-mts-rx opc - from sap 0 cmd _cli_send_my_if_command
<--Output truncated-->
switch(config)#
 

 
Related Commands

Command
Description

clear ip pim event-history

Clears the contents of the PIM event history buffers.

ip pim event-history

Configures the size of PIM event history buffers.

show ip pim group-range

To display information about the group ranges for IPv4 Protocol Independent Multicast (PIM), use the show ip pim group-range command.

show ip pim group-range [ group ] [ vrf { vrf-name | all | default | management }]

 
Syntax Description

group

(Optional) Group address.

vrf

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

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 display information about IPv4 PIM group ranges:

switch(config)# show ip pim group-range
PIM Group-Range Configuration for VRF "default"
Group-range Mode RP-address Shared-tree-only range
232.0.0.0/8 SSM - -
switch(config)#
 

 

show ip pim interface

To display information about the enabled interfaces for IPv4 Protocol Independent Multicast (PIM), use the show ip pim interface command.

show ip pim interface [ brief ] [ vrf { vrf-name | all | default | management }]

show ip pim interface ethernet { slot / port | port-channel channel-number [. sub_if-number ] | vethernet veth-id | vlan vlan-id }

 
Syntax Description

brief

(Optional) Specifies a brief format for display.

vrf

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

vrf-name

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

all

Specifies all VRFs.

default

Specifies the default VRF.

management

Specifies the management VRF.

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.

vethernet veth-id

Specifies the virtual Ethernet interface. The range is from 1 to 1,048,575.

vlan vlan-id

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.

5.0(2)

Information on Bidirectional Forwarding Detection (BFD) was added.

 
Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display brief information about IPv4 PIM-enabled interfaces:

switch# show ip pim interface brief
PIM Interface Status for VRF "default"
Interface IP Address PIM DR Address Neighbor Border
Count Interface
Vlan100 192.0.2.252 192.0.2.252 0 no
port-channel2000 192.0.2.1 192.0.2.1 1 no
port-channel2001 192.0.2.8 192.0.2.8 1 no
Ethernet1/26 192.0.2.2 192.0.2.2 1 no
Ethernet2/5 192.0.2.3 192.0.2.3 1 no
Ethernet2/6 192.0.2.4 192.0.2.4 1 no
Ethernet2/7 192.0.2.5 192.0.2.5 1 no
Ethernet3/11 192.0.2.6 192.0.2.6 1 no
Ethernet3/12 192.0.2.7 192.0.2.7 1 no
switch#
 

This example shows how to display information about PIM-enabled interfaces:

switch# show ip pim interface ethernet 2/5
PIM Interface Status for VRF "default"
Ethernet2/5, Interface status: protocol-up/link-up/admin-up
IP address: 192.0.2.3, IP subnet: 192.0.2.0/24
PIM DR: 192.0.2.3, DR's priority: 1
PIM neighbor count: 1
PIM hello interval: 30 secs, next hello sent in: 00:00:20
PIM neighbor holdtime: 105 secs
PIM configured DR priority: 1
PIM border interface: no
PIM GenID sent in Hellos: 0x36a7d6d1
PIM Hello MD5-AH Authentication: disabled
PIM Neighbor policy: none configured
PIM Join-Prune inbound policy: none configured
PIM Join-Prune outbound policy: none configured
PIM BFD enabled: no
PIM Interface Statistics, last reset: never
General (sent/received):
Hellos: 454/453, JPs: 4/0, Asserts: 0/0
Grafts: 0/0, Graft-Acks: 0/0
DF-Offers: 0/0, DF-Winners: 0/0, DF-Backoffs: 0/0, DF-Passes: 0/0
Errors:
Checksum errors: 0, Invalid packet types/DF subtypes: 0/0
Authentication failed: 0
Packet length errors: 0, Bad version packets: 0, Packets from self: 0
Packets from non-neighbors: 0
JPs received on RPF-interface: 0
(*,G) Joins received with no/wrong RP: 0/0
(*,G)/(S,G) JPs received for SSM/Bidir groups: 0/0
JPs filtered by inbound policy: 0
JPs filtered by outbound policy: 0
switch#
 

 

show ip pim neighbor

To display information about IPv4 Protocol Independent Multicast (PIM) neighbors, use the show ip pim neighbor command.

show ip pim neighbor {[ ethernet slot / port | port-channel channel-number [. sub_if-number ] | vethernet veth-id | vlan vlan-id ] | [ neighbor-addr ]} [ vrf { vrf-name | all | default | management }]

 
Syntax Description

ethernet slot / port

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

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

vethernet veth-id

(Optional) Specifies the virtual Ethernet interface. The range is from 1 to 1,048,575.

vlan vlan-id

Specifies the VLAN. The range is from 1 to 4094.

neighbor-addr

(Optional) IP address of a neighbor.

vrf

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

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.

5.0(2)

Information on Bidirectional Forwarding Detection (BFD) was added.

 
Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about PIM neighbors:

switch(config)# show ip pim neighbor
PIM Neighbor Status for VRF "default"
Neighbor Interface Uptime Expires DR Bidir- BFD
Priority Capable State
192.0.2.2 port-channel2000 03:43:40 00:01:21 1 no n/a
192.0.2.9 port-channel2001 03:43:41 00:01:35 1 no n/a
192.0.2.1 Ethernet1/26 03:43:44 00:01:33 1 no n/a
192.0.2.2 Ethernet2/5 03:43:45 00:01:34 1 no n/a
192.0.2.3 Ethernet2/6 03:43:45 00:01:19 1 no n/a
192.0.2.4 Ethernet2/7 03:43:45 00:01:39 1 no n/a
192.0.2.5 Ethernet3/11 03:43:46 00:01:35 1 no n/a
192.0.2.6 Ethernet3/12 03:43:46 00:01:34 1 no n/a
switch(config)#
 

 

show ip pim oif-list

To display information about IPv4 Protocol Independent Multicast (PIM) interfaces for a group, use the show ip pim oif-list command.

show ip pim oif-list group [ source ] [ vrf { vrf-name | all | default | management }]

 
Syntax Description

group

Group address.

source

(Optional) Source address.

vrf

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

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.

4.1(3)

Changed output to include vPC information.

 
Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display IPv4 PIM interfaces for a group:

switch(config)# show ip pim oif-list 232.0.0.0
PIM OIF-List for VRF default
(*, 232.0.0.0/8)
Incoming interface: Null0, RPF nbr 0.0.0.0
Timeout interval: 66 secs left
Oif-list (count: 0):
Timeout-list (count: 0):
Immediate-list (count: 0):
Immediate-timeout-list (count: 0):
Assert-lost-list (count: 0):
switch(config)#
 

 

show ip pim policy statistics auto-rp

To display information about the Auto-RP policy statistics for IPv4 Protocol Independent Multicast (PIM), use the show ip pim policy statistics auto-rp command.

show ip pim policy statistics auto-rp { rp-candidate-policy | mapping-agent-policy } [ vrf { vrf-name | all | default | management }]

 
Syntax Description

rp-candidate-
policy

Specifies candidate-RP messages.

mapping-
agent-policy

Specifies mapping agent messages.

vrf

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

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 display information about IPv4 PIM policy statistics:

switch(config)# show ip pim policy statistics auto-rp rp-candidate-policy
 

 

show ip pim policy statistics bsr

To display information about the bootstrap router (BSR) policy statistics for IPv4 Protocol Independent multicast (PIM), use the show ip pim policy statistics bsr command.

show ip pim policy statistics bsr { bsr-policy | rp-candidate-policy } [ vrf { vrf-name | all | default | management }]

 
Syntax Description

bsr-policy

Specifies BSR messages.

rp-candidate-
policy

Specifies candidate-RP messages.

vrf

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

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 display information about IPv4 PIM policy statistics:

switch(config)# show ip pim policy statistics bsr bsr-policy
 

show ip pim policy statistics jp-policy

To display information about the join-prune policy statistics for IPv4 Protocol Independent Multicast (PIM), use the show ip pim policy statistics jp-policy command.

show ip pim policy statistics jp-policy { ethernet slot / port | port-channel channel-number [. sub_if-number ] | vethernet veth-id | vlan vlan-id }

 
Syntax Description

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.

vethernet veth-id

Specifies the virtual Ethernet interface. The range is from 1 to 1,048,575.

vlan vlan-id

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 display information about PIM policy statistics:

switch(config)# show ip pim policy statistics jp-policy ethernet 2/12
 

show ip pim policy statistics neighbor-policy

To display information about the neighbor policy statistics for IPv4 Protocol Independent Multicast (PIM), use the show ip pim policy statistics neighbor-policy command.

show ip pim policy statistics neighbor-policy { ethernet slot / port | port-channel channel-number [. sub_if-number ] | vethernet veth-id | vlan vlan-id }

 
Syntax Description

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.

vethernet veth-id

Specifies the virtual Ethernet interface. The range is from 1 to 1,048,575.

vlan vlan-id

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 display information about IPv4 PIM policy statistics:

switch(config)# show ip pim policy statistics neighbor-policy ethernet 2/12
 

 

show ip pim policy statistics register-policy

To display information about the register policy statistics for IPv4 Protocol Independent Multicast (PIM), use the show ip pim policy statistics register-policy command.

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

 
Syntax Description

vrf

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

vrf-name

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

all

Specifies all VRFs.

default

Specifies the default VRF.

management

Specifies the management VRF.

 
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 display information about PIM policy statistics:

switch(config)# show ip pim policy statistics register-policy vrf all
 

show ip pim route

To display information about the routes for IPv4 Protocol Independent Multicast (PIM), use the show ip pim route command.

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

 
Syntax Description

source

Source address.

group

Group address.

vrf

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

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 display IPv4 PIM routes:

switch(config)# show ip pim route 232.0.0.0
PIM Routing Table for VRF "default" - 1 entries
 
(*, 232.0.0.0/8), expires 00:02:15
Incoming interface: Null0, RPF nbr 0.0.0.0
Oif-list: (0) 00000000, timeout-list: (0) 00000000
Immediate-list: (0) 00000000, timeout-list: (0) 00000000
Timeout-interval: 3, JP-holdtime round-up: 3
 
switch(config)#
 

 

show ip pim rp

To display information about the rendezvous points (RPs) for IPv4 Protocol Independent Multicast (PIM), use the show ip pim rp command.

show ip pim rp [ group ] [ vrf { vrf-name | all | default | management }]

 
Syntax Description

group

(Optional) Group address.

vrf

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

vrf-name

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

all

Specifies all VRFs.

default

Specifies the default VRF.

management

Specifies the management VRF.

 
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 display information about IPv4 PIM RPs:

switch(config)# show ip pim rp
PIM RP Status Information for VRF "default"
BSR disabled
Auto-RP disabled
BSR RP Candidate policy: None
BSR RP policy: None
Auto-RP Announce policy: None
Auto-RP Discovery policy: None
 
switch(config)#
 

 

show ip pim rp-hash

To display information about the RP-hash values for IPv4 Protocol Independent Multicast (PIM), use the show ip pim rp-hash command.

show ip pim rp-hash group [ vrf { vrf-name | all | default | management }]

 
Syntax Description

group

Group address for RP lookup.

vrf

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

vrf-name

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

all

Specifies all VRFs.

default

Specifies the default VRF.

management

Specifies the management VRF.

 
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 display information about IPv4 PIM RP-hash values:

switch(config)# show ip pim rp-hash 224.1.1.1
 

 

show ip pim statistics

To display information about the packet counter statistics for IPv4 Protocol Independent Multicast (PIM), use the show ip pim statistics command.

show ip pim statistics [ vrf { vrf-name | all | default | management }]

 
Syntax Description

vrf

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

vrf-name

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

all

Specifies all VRFs.

default

Specifies the default VRF.

management

Specifies the management VRF.

 
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.

4.1(3)

Changed output to include vPC information when PIM is in vPC mode.

 
Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 PIM statistics (if PIM is not in vPC mode, the vPC statistics are not displayed):

switch(config)# show ip pim statistics
PIM Global Counter Statistics for VRF:default, last reset: never
Register processing (sent/received):
Registers: 0/0, Null registers: 0/0, Register-Stops: 0/0
Registers received and not RP: 0
Registers received for SSM groups: 0
BSR processing (sent/received):
Bootstraps: 0/0, Candidate-RPs: 0/0
BSs from non-neighbors: 0, BSs from border interfaces: 0
BS length errors: 0, BSs which RPF failed: 0
BSs received but not listen configured: 0
Cand-RPs from border interfaces: 0
Cand-RPs received but not listen configured: 0
Auto-RP processing (sent/received):
Auto-RP Announces: 0/0, Auto-RP Discoveries: 0/0
Auto-RP RPF failed: 0, Auto-RP from border interfaces: 0
Auto-RP invalid type: 0, Auto-RP TTL expired: 0
Auto-RP received but not listen configured: 0
General errors:
Control-plane RPF failure due to no route found: 0
Data-plane RPF failure due to no route found: 0
Data-plane no multicast state found: 0
Data-plane create route state count: 0
vPC packet stats:
assert requests sent: 0
assert requests received: 0
assert request send error: 0
assert response sent: 0
assert response received: 0
assert response send error: 0
assert stop sent: 0
assert stop received: 0
assert stop send error: 0
rpf-source metric requests sent: 0
rpf-source metric requests received: 0
rpf-source metric request send error: 0
rpf-source metric response sent: 0
rpf-source metric response received: 0
rpf-source metric response send error: 0
rpf-source metric rpf change trigger sent: 0
rpf-source metric rpf change trigger received: 0
rpf-source metric rpf change trigger send error: 0
switch(config)#
 

 

show ip pim vrf

To display information about IPv4 Protocol Independent Multicast (PIM) by virtual routing and forwarding (VRF) instance, use the show ip pim vrf command.

show ip pim vrf [ vrf-name | all | default | detail | management ]

 
Syntax Description

vrf-name

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

all

(Optional) Specifies all VRFs.

default

(Optional) Specifies the default VRF.

detail

(Optional) Displays detailed PIM VRF information.

management

(Optional) Specifies the management VRF.

 
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.

5.0(2)

Information on Bidirectional Forwarding Detection (BFD) was added.

 
Usage Guidelines

This command requires the LAN Base Services license.

Examples

This example shows how to display information about IPv4 PIM by VRF:

switch(config)# show ip pim vrf
PIM Enabled VRF
VRF Name VRF Table Interface BFD
ID ID Count Enabled
default 1 0x00000001 1 no
switch(config)#
 

This example shows how to display the detailed information about IPv4 PIM by VRF:

switch# show ip pim vrf detail
PIM Enabled VRF
VRF Name VRF Table Interface BFD
ID ID Count Enabled
default 1 0x00000001 1 no
State Limit: None
Register Rate Limit: none
Shared tree ranges: none
(S,G)-expiry timer: not configured
(S,G)-list policy: none
(S,G)-expiry timer config version 0, active version 0
 
Pre-build SPT for all (S,G)s in VRF: disabled
switch#
 

 

show ip static-route

To display static routes from the unicast Routing Information Base (RIB), use the show ip static-route command.

show ip static-route [ vrf { vrf-name | all | default | management }]

 
Syntax Description

vrf vrf-name

(Optional) Specifies the virtual routing and forwarding (VRF) context name. The name can be any case-sensitive, alphanumeric string up to 32 characters.

all

(Optional) Specifies all VRF instances.

default

(Optional) Specifies the default VRF.

management

(Optional) Specifies the management VRF.

 
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 display the static routes:

switch(config)# show ip static-route
Static-route for VRF "default"(1)
 
IPv4 Unicast Static Routes:
 
Total number of routes: 0, unresolved: 0
switch(config)#
 

 
Related Commands

Command
Description

ip route

Configures a static route.

 

show ipv6 mroute

To display information about IPv6 multicast routes, use the show ipv6 mroute command.

show ipv6 mroute { group | { source group } | { group [ source ]}} [ summary [ software-forwarded ]] [ vrf { vrf-name | all }]

 
Syntax Description

group

Group address for route.

source

Source address for route.

summary

(Optional) Displays route counts and packet rates.

software-
forwarded

(Optional) Displays software-switched route counts only.

vrf

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

vrf-name

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

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about multicast routes:

switch(config)# show ipv6 mroute
IPv6 Multicast Routing Table for VRF "default"
 
(*, ff30::/32), uptime: 1d02h, pim6 ipv6
Incoming interface: Null, RPF nbr: 0::
Outgoing interface list: (count: 0)
 
switch(config)#

 
Related Commands

Command
Description

show ipv6 mroute summary

Displays summary information about IPv6 multicast routes.

show ipv6 mroute summary

To display summary information about IPv6 multicast routes, use the show ipv6 mroute summary command.

show ipv6 mroute summary [ count | software-forwarded ]] [ vrf { vrf-name | all }]

show ipv6 mroute { group ] summary [ software-forwarded ] [ vrf { vrf-name | all }]

 
Syntax Description

count

(Optional) Displays only route counts.

software-
forwarded

(Optional) Displays software-switched route counts only.

vrf

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

vrf-name

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

all

Specifies all VRFs.

group

Specifies a group address for a route.

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display summary information about multicast routes:

switch(config)# show ipv6 mroute summary
IPv6 Multicast Routing Table for VRF "default"
 
Total number of routes: 1
Total number of (*,G) routes: 0
Total number of (S,G) routes: 0
Total number of (*,G-prefix) routes: 1
Group count: 0, rough average sources per group: 0.0
 
Group: ff30::/32, Source count: 0
Source packets bytes aps pps bit-rate oifs
(*,G) 0 0 0 0 0 bps 0
switch(config)#

 
Related Commands

Command
Description

show ipv6 mroute

Displays information about IPv6 multicast routes.

show ipv6 pim df

To display information about the designated forwarders (DFs) for IPv6 Protocol Independent Multicast (PIM6), use the show ipv6 pim df command.

show ipv6 pim df [ rp-or-group ] [ vrf { vrf-name | all }]

 
Syntax Description

rp-or-group

(Optional) RP or group address.

vrf

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

vrf-name

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

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about PIM6 DFs:

switch(config)# show ipv6 pim df
Bidir-PIM6 Designated Forwarder Information for VRF "default"
 
RP Address (ordinal) RP Metric Group Range
0001::0001 (7)
[0/0] ff00::/8
 
Interface DF Address DF State DF Metric DF Uptime
* Lo1 0:: Lose [0/0] 00:00:02
switch(config)#

show ipv6 pim event-history

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

show ipv6 pim event-history { errors | msgs | statistics }

 
Syntax Description

errors

Displays events of type error.

msgs

Displays events of type msg.

statistics

Displays events of type statistics.

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
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 display information in the PIM6 msgs event history buffer:

switch(config)# show ipv6 pim event-history msgs
Note: PIM6 process currently not running
switch(config)#
 

 
Related Commands

Command
Description

clear ipv6 pim event-history

Clears the contents of the PIM6 event history buffers.

ipv6 pim event-history

Configures the size of PIM6 event history buffers.

show ipv6 pim group-range

To display information about IPv6 Protocol Independent Multicast (PIM6) group ranges, use the show ipv6 pim group-range command.

show ipv6 pim group-range [ group ] [ vrf { vrf-name | all }]

 
Syntax Description

group

(Optional) Group address.

vrf

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

vrf-name

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

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about PIM6 group ranges:

switch(config)# show ipv6 pim group-range
PIM6 Group-Range Configuration for VRF "default"
Group-range Mode RP-address Shared-tree-only range
ff30::/32 SSM - -
ff1e:abcd:def1::/96 ASM 2001:0db8:0000:abcd::0001
-
switch(config)#

show ipv6 pim interface

To display information about the enabled interfaces for IPv6 Protocol Independent Multicast (PIM6), use the show ipv6 pim interface command.

show ipv6 pim interface [ brief ] [ vrf { vrf-name | all }]

show ipv6 pim interface if-type if-number

 
Syntax Description

brief

(Optional) Specifies a brief format for display.

vrf

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

vrf-name

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

all

Specifies all VRFs.

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about PIM6-enabled interfaces:

switch(config)# show ipv6 pim interface
PIM6 Interface Status for VRF "default"
Ethernet2/12, Interface status: protocol-down/link-down/admin-down
IPv6 address: none
PIM6 DR: 0::, DR's priority: ?
PIM6 neighbor count: 0
PIM6 hello interval: 23 secs (configured 22222 ms), next hello sent in: 00:00:08
PIM6 neighbor holdtime: 81 secs
PIM6 configured DR priority: 1
PIM6 border interface: no
PIM6 GenID sent in Hellos: 0x144b4667
PIM6 Hello MD5-AH Authentication: disabled
PIM6 Neighbor policy: none configured
PIM6 Join-Prune policy: none configured
PIM6 Interface Statistics, last reset: never
General (sent/received):
Hellos: 0/0, JPs: 0/0, Asserts: 0/0
Grafts: 0/0, Graft-Acks: 0/0
DF-Offers: 0/0, DF-Winners: 0/0, DF-Backoffs: 0/0, DF-Passes: 0/0
Errors:
Checksum errors: 0, Invalid packet types/DF subtypes: 0/0
Authentication failed: 0
Packet length errors: 0, Bad version packets: 0, Packets from self: 0
Packets from non-neighbors: 0
JPs received on RPF-interface: 0
(*,G) Joins received with no/wrong RP: 0/0
(*,G)/(S,G) JPs received for SSM/Bidir groups: 0/0
JPs policy filtered: 0
switch(config)#

show ipv6 pim neighbor

To display information about IPv6 Protocol Independent Multicast (PIM6) neighbors, use the show ipv6 pim neighbor command.

show ipv6 pim neighbor {[ if-type if-number ] | [ neighbor-addr ]} [ vrf { vrf-name | all }]

 
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.

neighbor-addr

(Optional) IPv6 address of a neighbor.

vrf

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

vrf-name

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

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about PIM6 neighbors:

switch(config)# show ipv6 pim neighbor
PIM6 Neighbor Status for VRF "default"
Neighbor Address Interface Uptime Expires DR Bidir
Pri
fe80::0230:48ff:fe34:0d67 Eth2/1 00:00:39 00:01:34 1 yes
Secondary addresses:
0001::0002
switch(config)#

show ipv6 pim oif-list

To display information about IPv6 Protocol Independent Multicast (PIM6) interfaces for a group, use the show ipv6 pim oif-list command.

show ipv6 pim oif-list group [ source ] [ vrf { vrf-name | all }]

 
Syntax Description

group

Group address.

source

(Optional) Source address.

vrf

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

vrf-name

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

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display PIM6 interfaces for a group:

switch(config)# show ipv6 pim oif-list ff1e::0002
PIM6 OIF-List for VRF default
(*, ff1e::0002/128)
Incoming interface: Ethernet2/2, RPF nbr 0002::0002
Timeout interval: 45 secs left
Oif-list (count: 2):
Ethernet8/11, uptime: 00:01:18, pim6
Ethernet8/11, uptime: 00:01:18, pim6
Timeout-list (count: 0):
Immediate-list (count: 0):
Immediate-timeout-list (count: 0):
switch(config)#
 

show ipv6 pim policy statistics jp-policy

To display information about the join-prune policy statistics for IPv6 Protocol Independent Multicast (PIM6), use the show ipv6 pim policy statistics j-policy command.

show ipv6 pim policy statistics jp-policy if-type if-number

 
Syntax Description

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about PIM6 policy statistics:

switch(config)# show ipv6 pim policy statistics jp-policy ethernet 2/2
C: No. of comparisions, M: No. of matches
 
route-map rmap1 permit 10
match ipv6 multicast group ff1e::/128 C: 0 M: 0
 
Total accept count for policy: 2
Total reject count for policy: 0
switch(config)#
 

show ipv6 pim policy statistics neighbor-policy

To display information about the neighbor policy statistics for IPv6 Protocol Independent Multicast (PIM6), use the show ipv6 pim policy statistics neighbor-policy command.

show ipv6 pim policy statistics neighbor-policy if-type if-number

 
Syntax Description

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about PIM6 policy statistics:

switch(config)# show ipv6 pim policy statistics neighbor-policy ethernet 2/2
C: No. of comparisions, M: No. of matches
 
route-map rmap2 permit 10
match ipv6 multicast group ff1e::/128 C: 0 M: 0
 
Total accept count for policy: 2
Total reject count for policy: 0
switch(config)#
 

show ipv6 pim route

To display information about IPv6 Protocol Independent Multicast (PIM6) routes, use the show ipv6 pim route command.

show ipv6 pim route { source group | group [ source ]} [ vrf { vrf-name | all }]

 
Syntax Description

source

Source address.

group

Group address.

vrf

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

vrf-name

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

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display PIM6 routes:

switch(config)# show ipv6 pim route
PIM6 Routing Table for VRF "default" - 1 entries
 
(*, ff30::/32), expires 00:02:33
Incoming interface: Null, RPF nbr 0::
Oif-list: (0) 00000000, timeout-list: (0) 00000000
Immediate-list: (0) 00000000, timeout-list: (0) 00000000
Timeout-interval: 2, JP-holdtime round-up: 3
 
switch(config)#

show ipv6 pim rp

To display information about IPv6 Protocol Independent Multicast (PIM) RPs, use the show ipv6 pim rp command.

show ipv6 pim rp [ group ] [ vrf { vrf-name | all }]

 
Syntax Description

group

(Optional) Group address.

vrf

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

vrf-name

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

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about PIM6 RPs:

switch(config)# show ipv6 pim rp
PIM6 RP Status Information for VRF "default"
BSR: 0::, uptime: 1d01h, expires: now,
priority: 0, hash-length: 0
Auto-RP disabled
BSR RP Candidate policy: None
BSR RP policy: None
Auto-RP Announce policy: None
Auto-RP Discovery policy: None
 
RP: 2001:0db8:0000:abcd::0001, (0), uptime: 1d01h, expires: 0.000000,
priority: 0, RP-source: (local), group ranges:
ff1e:abcd:def1::/96
switch(config)#

show ipv6 pim rp-hash

To display information about the RP-hash values for IPv6 Protocol Independent Multicast (PIM6), use the show ipv6 pim rp-hash command.

show ipv6 pim rp-hash group [ vrf { vrf-name | all }]

 
Syntax Description

group

Group address for the RP lookup.

vrf

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

vrf-name

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

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about PIM6 RP-hash values:

switch(config)# show ipv6 pim rp-hash
PIM6 Hash Information for VRF "default"
PIM6 RPs for group ff1e::0001, using hash-length: 126 from BSR: 0001::0001
RP 0002::0001, hash: 1329585728 (selected)
 
show ip igmp snooping explicit-tracking
----------------------------------------
switch# show ip igmp snooping explicit-tracking vlan 33
IGMPv3 Snooping Explicit-tracking information
Source/Group Intf Reporter Uptime Last-Join Expires
1.1.1.1 232.1.1.1 Eth2/1 3.3.3.3 00:01:33 00:04:27
switch(config)#

show ipv6 pim statistics

To display information about the packet counter statistics for IPv6 Protocol Independent Multicast (PIM6), use the show ipv6 pim statistics command.

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

 
Syntax Description

vrf

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

vrf-name

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

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about PIM6 statistics:

switch(config)# show ipv6 pim statistics
PIM6 Global Counter Statistics for VRF:default, last reset: never
Register processing (sent/received):
Registers: 0/0, Null registers: 0/0, Register-Stops: 0/0
Registers received and not RP: 0
Registers received for SSM/Bidir groups: 0/0
BSR processing (sent/received):
Bootstraps: 0/0, Candidate-RPs: 0/0
BSs from non-neighbors: 0, BSs from border interfaces: 0
BS length errors: 0, BSs which RPF failed: 0
BSs received but not listen configured: 0
Cand-RPs from border interfaces: 0
Cand-RPs received but not listen configured: 0
Auto-RP processing (sent/received):
Auto-RP Announces: 0/0, Auto-RP Discoveries: 0/0
Auto-RP RPF failed: 0, Auto-RP from border interfaces: 0
Auto-RP invalid type: 0, Auto-RP TTL expired: 0
Auto-RP received but not listen configured: 0
General errors:
Control-plane RPF failure due to no route found: 1
Data-plane RPF failure due to no route found: 0
Data-plane no multicast state found: 0
Data-plane create route state count: 0
switch(config)#

show ipv6 pim vrf

To display information about IPv6 Protocol Independent Multicast (PIM6) by virtual routing and forwarding (VRF) instance, use the show ipv6 pim vrf command.

show ipv6 pim vrf [ vrf-name | all ]

 
Syntax Description

vrf-name

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

all

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

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about PIM6 by VRF:

switch(config)# show ipv6 pim vrf
 
switch(config)#

show routing ip multicast event-history

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

show routing ip multicast event-history { cli | errors | mfdm-debugs | mfdm-stats | msgs | rib | statistics | vrf }

 
Syntax Description

cli

Displays the event history buffer of type CLI.

errors

Displays the event history buffer of type errors.

mfdm-debugs

Displays the event history buffer of type multicast FIB distribution (MFDM).

mfdm-stats

Displays the event history buffer of type MFDM sum.

msgs

Displays the event history buffer of type msgs.

rib

Displays the event history buffer of type RIB.

statistics

Displays information about the event history buffers.

vrf

Displays the event history buffer of type virtual routing and forwarding (VRF).

 
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 display information in the MRIB msgs event history buffer:

switch(config)# show routing ip multicast event-history msgs
 
Msg events for MRIB Process
1) Event:E_DEBUG, length:38, at 932956 usecs after Sat Apr 12 09:09:41 2008
[100] : nvdb: transient thread created
 
2) Event:E_DEBUG, length:38, at 932269 usecs after Sat Apr 12 09:09:41 2008
[100] : nvdb: create transcient thread
 
3) Event:E_DEBUG, length:75, at 932264 usecs after Sat Apr 12 09:09:41 2008
[100] : comp-mts-rx opc - from sap 3210 cmd mrib_internal_event_hist_command
4) Event:E_MTS_RX, length:60, at 362578 usecs after Sat Apr 12 09:08:51 2008
[RSP] Opc:MTS_OPC_MFDM_V4_ROUTE_STATS(75785), Id:0X000F217E, Ret:SUCCESS
Src:0x00000101/214, Dst:0x00000101/1203, Flags:None
HA_SEQNO:0X00000000, RRtoken:0x000F217B, Sync:NONE, Payloadsize:148
Payload:
0x0000: 01 00 00 00 05 00 01 00 00 04 00 00 00 00 00 00
5) Event:E_MTS_RX, length:60, at 352493 usecs after Sat Apr 12 09:07:51 2008
[RSP] Opc:MTS_OPC_MFDM_V4_ROUTE_STATS(75785), Id:0X000F188B, Ret:SUCCESS
Src:0x00000101/214, Dst:0x00000101/1203, Flags:None
HA_SEQNO:0X00000000, RRtoken:0x000F1888, Sync:NONE, Payloadsize:148
Payload:
0x0000: 01 00 00 00 05 00 01 00 00 04 00 00 00 00 00 00
6) Event:E_MTS_RX, length:60, at 342641 usecs after Sat Apr 12 09:06:51 2008
[RSP] Opc:MTS_OPC_MFDM_V4_ROUTE_STATS(75785), Id:0X000F0DF0, Ret:SUCCESS
Src:0x00000101/214, Dst:0x00000101/1203, Flags:None
HA_SEQNO:0X00000000, RRtoken:0x000F0DED, Sync:NONE, Payloadsize:148
Payload:
0x0000: 01 00 00 00 05 00 01 00 00 04 00 00 00 00 00 00
7) Event:E_MTS_RX, length:60, at 332954 usecs after Sat Apr 12 09:05:51 2008
[RSP] Opc:MTS_OPC_MFDM_V4_ROUTE_STATS(75785), Id:0X000F0493, Ret:SUCCESS
<--Output truncated-->
switch(config)#
 

 
Related Commands

Command
Description

ip routing multicast event-history

Configures the size of the IPv4 MRIB event history buffers.

clear ip routing multicast event-history

Clears information in the IPv4 MRIB event history buffers.

show hardware proxy layer-3 detail

To display detail proxy Layer 3 forwarding information, use the show hardware proxy layer-3 detail command.

show hardware proxy layer-3 detail

 
Syntax Description

This command has no arguments or keywords.

 
Defaults

None

 
Command Modes

EXEC

 
Supported User Roles

network-admin
vdc-admin

 
Command History

Release
Modification

5.1(1)

This command was introduced.

 
Usage Guidelines

This command does not require a license.

This command applies only to Cisco Nexus 7000 Series chassis that contain an F1 Series module or an M1 Series module. This command applies when you are running either FabricPath or Ethernet interfaces.

Examples

This example shows how to display detail proxy Layer 3 forwarding information:

switch# show hardware proxy layer-3 detail

switch#

 
Related Commands

Command
Description

show hardware proxy layer-3 detail

Displays detailed information on the proxy Layer 3 functionality.

show routing ipv6 multicast

To display information about IPv6 multicast routes, use the show routing ipv6 multicast command.

show routing ipv6 multicast [ vrf { vrf-name | all }] {{ source group } | { group [ source ]}}

 
Syntax Description

vrf

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

vrf-name

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

all

Specifies all VRFs.

source

Source address for routes.

group

Group address for routes.

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about IPv6 multicast routes:

switch(config)# show routing ipv6 multicast
IPv6 Multicast Routing Table for VRF "default"
switch(config)#

show routing ipv6 multicast clients

To display information about IPv6 multicast routing clients, use the show routing ipv6 multicast clients command.

show routing ipv6 multicast clients [ client-name ]

 
Syntax Description

client-name

(Optional) One of the following multicast routing client names:

  • m6rib
  • icmpv6
  • ipv6
  • static
  • pim6

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about IPv6 multicast routing clients:

switch(config)# show routing ipv6 multicast clients icmpv6
IPv6 Multicast Routing Client information
 
Client: icmpv6, client-id: 2, pid: 3742, mts-sap: 282
Shared-memory: icmpv6, wants notifications
Protocol is join-group owner
Join notifications: sent 1, fail 0, ack rcvd 1
Prune notifications: sent 0, fail 0, ack rcvd 0
RPF notifications: sent 0, fail 0, ack rcvd 0
Delete notifications: sent 0, fail 0, ack rcvd 0
Clear mroute notifications: sent 0, fail 0
Add route requests: rcvd 0, ack sent 0, ack fail 0
Delete route requests: rcvd 0, ack sent 0, ack fail 0
 
switch(config)#

show routing ipv6 multicast event-history

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

show routing ipv6 multicast event-history { cli | errors | mfdm | mfdm-stats | msgs | rib | statistics | vrf }

 
Syntax Description

cli

Displays the event history buffer of type CLI.

errors

Displays the event history buffer of type errors.

mfdm

Displays the event history buffer of type multicast FIB distribution (MFDM).

mfdm-stats

Displays the event history buffer of type MFDM sum.

msgs

Displays the event history buffer of type msgs.

rib

Displays the event history buffer of type RIB.

statistics

Displays information about the event history buffers.

vrf

Displays the event history buffer of type virtual routing and forwarding (VRF).

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
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 display information in the M6RIB msgs event history buffer:

switch(config)# show routing ipv6 multicast event-history msgs
 
Msg events for M6RIB Process
1) Event:E_DEBUG, length:38, at 269000 usecs after Tue Jan 6 18:45:50 2009
[100] : nvdb: transient thread created
 
2) Event:E_DEBUG, length:38, at 267467 usecs after Tue Jan 6 18:45:50 2009
[100] : nvdb: create transcient thread
 
3) Event:E_DEBUG, length:76, at 267461 usecs after Tue Jan 6 18:45:50 2009
[100] : comp-mts-rx opc - from sap 3389 cmd m6rib_internal_event_hist_command
4) Event:E_MTS_RX, length:60, at 335251 usecs after Tue Jan 6 18:45:21 2009
[RSP] Opc:MTS_OPC_MFDM_V6_ROUTE_STATS(75786), Id:0X00049141, Ret:SUCCESS
Src:0x00000901/214, Dst:0x00000901/1606, Flags:None
HA_SEQNO:0X00000000, RRtoken:0x0004913F, Sync:NONE, Payloadsize:268
Payload:
0x0000: 01 00 00 80 05 00 01 00 00 08 00 00 00 00 00 00
5) Event:E_MTS_RX, length:60, at 325401 usecs after Tue Jan 6 18:44:21 2009
[RSP] Opc:MTS_OPC_MFDM_V6_ROUTE_STATS(75786), Id:0X000489A2, Ret:SUCCESS
Src:0x00000901/214, Dst:0x00000901/1606, Flags:None
HA_SEQNO:0X00000000, RRtoken:0x000489A0, Sync:NONE, Payloadsize:268
Payload:
0x0000: 01 00 00 80 05 00 01 00 00 08 00 00 00 00 00 00
6) Event:E_MTS_RX, length:60, at 315289 usecs after Tue Jan 6 18:43:21 2009
[RSP] Opc:MTS_OPC_MFDM_V6_ROUTE_STATS(75786), Id:0X00048457, Ret:SUCCESS
Src:0x00000901/214, Dst:0x00000901/1606, Flags:None
HA_SEQNO:0X00000000, RRtoken:0x00048455, Sync:NONE, Payloadsize:268
Payload:
0x0000: 01 00 00 80 05 00 01 00 00 08 00 00 00 00 00 00
7) Event:E_MTS_RX, length:60, at 305189 usecs after Tue Jan 6 18:42:21 2009
[RSP] Opc:MTS_OPC_MFDM_V6_ROUTE_STATS(75786), Id:0X00047EFD, Ret:SUCCESS
Src:0x00000901/214, Dst:0x00000901/1606, Flags:None
HA_SEQNO:0X00000000, RRtoken:0x00047EFB, Sync:NONE, Payloadsize:268
Payload:
0x0000: 01 00 00 80 05 00 01 00 00 08 00 00 00 00 00 00
8) Event:E_MTS_RX, length:60, at 295210 usecs after Tue Jan 6 18:41:21 2009
[RSP] Opc:MTS_OPC_MFDM_V6_ROUTE_STATS(75786), Id:0X0004794F, Ret:SUCCESS
Src:0x00000901/214, Dst:0x00000901/1606, Flags:None
HA_SEQNO:0X00000000, RRtoken:0x0004794D, Sync:NONE, Payloadsize:268
Payload:
0x0000: 01 00 00 80 05 00 01 00 00 08 00 00 00 00 00 00
switch(config)#

 
Related Commands

Command
Description

ipv6 routing multicast event-history

Configures the size of the IPv6 M6RIB event history buffers.

clear ipv6 routing multicast event-history

Clears information in the IPv6 M6RIB event history buffers.

show routing multicast

To display information about IPv4 multicast routes, use the show routing multicast command.

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

 
Syntax Description

ip

(Optional) Specifies IPv4 routes.

ipv4

(Optional) Specifies IPv4 routes.

vrf

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

vrf-name

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

all

Specifies all VRFs.

default

Specifies the default VRF.

management

Specifies the management VRF.

source

Source address for routes.

group

Group address for routes.

 
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 display information about IPv4 multicast routes:

switch(config)# show routing multicast
IP Multicast Routing Table for VRF "default"
 
(*, 232.0.0.0/8), uptime: 05:11:19, pim ip
Incoming interface: Null, RPF nbr: 0.0.0.0
Outgoing interface list: (count: 0)
 
switch(config)#
 

 

show routing multicast clients

To display information about IPv4 multicast routing clients, use the show routing multicast clients command.

show routing [ ip | ipv4 ] multicast clients [ client-name ]

 
Syntax Description

ip

(Optional) Specifies IPv4 multicast clients.

ipv4

(Optional) Specifies IPv4 multicast clients.

client-name

(Optional) One of the following multicast routing client names:

  • mrib
  • igmp
  • static
  • msdp
  • ip
  • pim

 
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 display information about IPv4 multicast clients:

switch(config)# show routing multicast clients pim
IP Multicast Routing Client information
 
Client: pim, client-id: 5, pid: 5296, mts-sap: 310
Shared-memory: pim, Notifications: joins prunes rpf delete repopulate
Protocol is ssm owner, bidir owner, shared-only mode owner,
Join notifications: sent 1, fail 0, ack rcvd 1
Prune notifications: sent 0, fail 0, ack rcvd 0
RPF notifications: sent 0, fail 0, ack rcvd 0
Delete notifications: sent 0, fail 0, ack rcvd 0
Repopulate notifications: sent 0, fail 0, ack rcvd 0
Clear mroute notifications: sent 0, fail 0
Add route requests: rcvd 2, ack sent 2, ack fail 0
Delete route requests: rcvd 0, ack sent 0, ack fail 0
Update route requests: rcvd 0, ack sent 0, ack fail 0
MTS update route requests: rcvd 0, ack sent 0, ack fail 0
Per VRF notification markers: 1
 
switch(config)#
 

 

show running-config pim

To display information about the running-system configuration for IPv4 Protocol Independent Multicast (PIM), use the show running-config pim command.

show running-config pim [ all ]

 
Syntax Description

all

(Optional) Displays configured and default information.

 
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 display information about the IPv4 PIM running-system configuration:

Need new output1

switch(config)# show running-config pim
 
!Command: show running-config pim
!Time: Sat Apr 12 09:15:11 2008
 
version 5.0(3)N1(1)
feature pim
 
ip pim ssm range 232.0.0.0/8
 
interface Vlan20
ip pim sparse-mode
 
switch(config)#
 

 

show running-config pim6

To display information about the running-system configuration for IPv6 Protocol Independent Multicast (PIM6), use the show running-config pim6 command.

show running-config pim6 [ all ]

 
Syntax Description

all

(Optional) Displays configured and default information.

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about the PIM6 running-system configuration:

switch(config)# show running-config pim6
version 4.0(3)
feature pim6
ipv6 pim bidir-rp-limit 3
ipv6 pim rp-address 2001:0db8::abcd:0000:0000:0000:0001 group-list ff1e:abcd:def1::/96
ipv6 pim rp-candidate Ethernet2/11 group-list ff1e:abcd:def1::/24
ipv6 pim register-policy my_register_policy
ipv6 pim ssm range ff30::/32
ipv6 pim flush-routes
 
interface Ethernet2/12
ipv6 pim sparse-mode
ipv6 pim hello-interval 22222
 
switch(config)#

show startup-config pim

To display information about the startup-system configuration for IPv4 Protocol Independent Multicast (PIM), use the show startup-config pim command.

show startup-config pim [ all ]

 
Syntax Description

all

(Optional) Displays configured and default information.

 
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 display information about the startup-system configuration for IPv4 PIM:

switch(config)# show startup-config pim
 

show startup-config pim6

To display information about the startup-system configuration for IPv6 Protocol Independent Multicast (PIM6), use the show startup-config pim6 command.

show startup-config pim6 [ all ]

 
Syntax Description

all

(Optional) Displays configured and default information.

 
Defaults

None

 
Command Modes

Any command mode

 
Supported User Roles

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

 
Command History

Release
Modification

5.0(3)N1(1)

This command was introduced.

 
Usage Guidelines

This command requires the Enterprise Services license.

Examples

This example shows how to display information about the startup-system configuration for PIM6:

switch(config)# show startup-config pim6
version 4.0(3)
feature pim6
ipv6 pim bidir-rp-limit 3
ipv6 pim rp-address 2001:0db8::abcd:0000:0000:0000:0001 group-list ff1e:abcd:def1::/96
ipv6 pim rp-candidate Ethernet2/11 group-list ff1e:abcd:def1::/24
ipv6 pim register-policy my_register_policy
ipv6 pim ssm range ff30::/32
ipv6 pim flush-routes
 
interface Ethernet2/12
ipv6 pim sparse-mode
ipv6 pim hello-interval 22222
 
switch(config)#

 

Was this Document Helpful?

FeedbackFeedback

Contact Cisco