Cisco IOS IP Multicast Command Reference
show ip igmp ssm-mapping through udp-port

Table Of Contents

show ip igmp ssm-mapping

show ip igmp static-group class-map

show ip igmp udlr

show ip mfib

show ip mfib active

show ip mfib count

show ip mfib interface

show ip mfib route

show ip mfib status

show ip mfib summary

show ip mcache

show ip mrm interface

show ip mrm manager

show ip mrm status-report

show ip mpacket

show ip mrib client

show ip mrib route

show ip mrib route summary

show ip mroute

show ip msdp count

show ip msdp peer

show ip msdp rpf-peer

show ip msdp sa-cache

show ip msdp summary

show ip multicast

show ip multicast limit

show ip multicast redundancy state

show ip multicast redundancy statistics

show ip multicast rpf tracked

show ip pgm host defaults

show ip pgm host sessions

show ip pgm host traffic

show ip pgm router

show ip pim bsr-router

show ip pim interface

show ip pim interface df

show ip pim mdt bgp

show ip pim mdt history

show ip pim mdt receive

show ip pim mdt send

show ip pim neighbor

show ip pim rp

show ip pim rp mapping

show ip pim rp-hash

show ip pim rp-hash (BSR)

show ip pim snooping

show ip pim tunnel

show ip pim vc

show ip rpf

show ip rpf events

show ip rpf select

show ip sap

show ip sdr

show mls ip multicast

show mls ip multicast bidir

show mls ip multicast consistency-check

show mls ip multicast rp-mapping

show mls ip multicast sso

show router-guard

snmp-server enable traps mvpn

tunnel udlr address-resolution

tunnel udlr receive-only

tunnel udlr send-only

udp-port


show ip igmp ssm-mapping

To display information about Source Specific Multicast (SSM) mapping or to display the sources that SSM mapping uses for a particular group, use the show ip igmp ssm-mapping command in user EXEC or privileged EXEC mode.

show ip igmp [vrf vrf-name] ssm-mapping [group-address]

Syntax Description

vrf

(Optional) Supports the multicast Virtual Private Network (VPN) routing and forwarding (VRF) instance.

vrf-name

(Optional) Name assigned to the VRF.

group-address

(Optional) Address of the group about which to display SSM mapping information.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.3(2)T

This command was introduced.

12.2(18)S

This command was integrated into Cisco IOS Release 12.2(18)S.

12.2(18) SXD3

This command was integrated into Cisco IOS Release 12.2(18)SXD3.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

Use this command to display the sources that SSM mapping is using for a particular group, or would use for a group if SSM mapping were configured. If no SSM mapping is known for the specified group, and Domain Name System (DNS)-based SSM mapping is enabled, this command sends out a DNS query for the group. The DNS query initiates DNS-based SSM mapping for this group. If no SSM mapping group is specified by the group-address argument, this command displays the configured SSM mapping state.

Use the vrf vrf-name keyword and argument to displays SSM mapping information for a particular VRF.

Examples

The following example shows how to display information about the configured SSM mapping state:

Router# show ip igmp ssm-mapping

SSM Mapping  : Enabled
DNS Lookup   : Enabled
Mcast domain : ssm-map.cisco.com
Name servers : 10.0.0.0
               10.0.0.1

Table 17 describes the significant fields shown in the display.

Table 17 show ip igmp ssm-mapping Field Descriptions 

Field
Description

SSM Mapping  : Enabled

The SSM Mapping feature is enabled.

DNS Lookup   : Enabled

DNS-based SSM mapping is enabled.

Mcast domain : ssm-map.cisco.com

Multicast domain.

Name servers : 10.0.0.0

                        10.0.0.1

Addresses of the configured named servers.


The following example shows how to display information about the configured DNS-based SSM mapping:

Router# show ip igmp ssm-mapping 232.1.1.4

Group address: 232.1.1.4
Database     : DNS
DNS name     : 4.1.1.232.ssm-map.cisco.com
Expire time  : 860000
Source list  : 172.16.8.5
             :172.16.8.6

Table 18 describes the significant fields shown in the display.

Table 18 show ip igmp ssm-mapping Field Descriptions 

Field
Description

Group address: 232.1.1.4

The router has mapped group 232.1.1.4.

Database     : DNS

Group mapping is performed via DNS.

DNS name     : 4.1.1.232.ssm-map.cisco.com

Name of the DNS that performs group mapping.

Expire time  : 860000

Cache time of the DNS registration record on the DNS server, in milliseconds.

Source list  : 172.16.8.5

               :172.16.8.6

The group address is mapped via DNS to these source addresses.


The following example shows how to display information about the configured static SSM mapping:

Router# show ip igmp ssm-mapping 232.1.1.4

Group address: 232.1.1.4
Database     : Static
Source list  : 172.16.8.5
             : 172.16.8.6

Table 19 describes the significant fields shown in the display.

Table 19 show ip igmp ssm-mapping Field Descriptions 

Field
Description

Group address: 232.1.1.4

The address of the group with SSM mapping to the router.

Database     : Static

Static SSM mapping is configured.

Source list  : 172.16.8.5

                  : 172.16.8.6

Source addresses configured for static SSM mapping.


The following is sample output from the show ip igmp ssm-mapping command when no SSM mappings can be found:

Router# show ip igmp ssm-mapping 232.1.1.4

Can't resolve %i to source-mapping

Related Commands

Command
Description

ip igmp ssm-map enable

Enables SSM mapping for groups in a configured SSM range.

show ip igmp group

Displays the multicast groups with receivers that are directly connected to the router and that were learned through IGMP.


show ip igmp static-group class-map

To display the contents of Internet Group Management Protocol (IGMP) static group class map configurations and the interfaces using class maps, use the show ip igmp static-group class-map command in user EXEC or privileged EXEC mode.

show ip igmp static-group class-map [interface [type number]]

Syntax Description

interface

(Optional) Filters the output to display only the interfaces using class maps.

type number

(Optional) Interface type and number entered to filter the output to display only the class map attached to a particular interface.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.2(18)SXF5

This command was introduced.

15.0(1)M

This command was integrated into Cisco IOS Release 15.0(1)M.


Usage Guidelines

Use this command to display the contents of IGMP static group class map configurations and the interfaces using class maps.

Use this command with the optional interface keyword to filter the output to display only the interfaces using class maps.

Use this command with the optional interface keyword and type number arguments to filter the output to display only the class map attached to a particular interface.

Examples

The following is sample output from the show ip igmp static-group class-map command. The output is self-explanatory:

Router# show ip igmp static-group class-map

Class-map static1
  Group address range 228.8.8.7 to 228.8.8.9
  Group address 232.8.8.7, source address 10.1.1.10
  Interfaces using the classmap:
    Loopback0

Class-map static
  Group address range 232.7.7.7 to 232.7.7.9, source address 10.1.1.10
  Group address 227.7.7.7
  Group address range 227.7.7.7 to 227.7.7.9
  Group address 232.7.7.7, source address 10.1.1.10
  Interfaces using the classmap:
    Ethernet3/1

The following is sample output from the show ip igmp static-group command with the interface keyword. The output is self-explanatory.

Router# show ip igmp static-group class-map interface 

Loopback0
  Class-map attached: static1

Ethernet3/1
  Class-map attached: static

The following is sample output from the show ip igmp static-group command with the interface keyword and type number arguments. The output is self-explanatory.

Router# show ip igmp static-group class-map interface Ethernet 3/1

Ethernet3/1
  Class-map attached: static

Related Commands

Command
Description

class-map type multicast-flows

Enters multicast-flows class-map configuration mode to create or modify IGMP static group class maps.

group (multicast-flows)

Defines the group entries to be associated with a IGMP static group class map.

ip igmp static-group

Configures static group membership entries on an interface.


show ip igmp udlr

To display unidirectional link routing (UDLR) information for directly connected multicast groups on interfaces that have a unidirectional link (UDL) helper address configured, use the show ip igmp udlr command in user EXEC or privileged EXEC mode.

show ip igmp udlr [group-name | group-address | interface-type interface-number]

Syntax Description

group-name | group-address

(Optional) Name or address of the multicast group for which to show UDLR information.

interface-type interface-number

(Optional) Interface type and number for which to show UDLR information.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.0(3)T

This command was introduced.

12.2(17d)SXB1

Support for this command was introduced on the Supervisor Engine 720.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

This command displays which groups are being forwarded and received over the UDL.

On the upstream router, this command shows which interface is a UDL interface and which IP multicast groups are being forwarded out that interface. The UDL Reporter is the IP address of the downstream interface on the receiving router. If there is more than one downstream router, this field shows which downstream router forwarded the IGMP host report to the upstream router over the ground-based network. This report is forwarded over the UDL so that all downstream routers know which groups have already been requested by other downstream routers and additional IGMP host reports are suppressed.

On the downstream router, this command (in the Interface field) shows which local interface received an IGMP host report (from a directly connected host for a specific group). The UDL Reporter is the IP address of the router that had forwarded the IGMP host report to the upstream router over the ground-based network. The UDL Interfaces column shows the interface on which IP multicast packets are being received.

Examples

The following is sample output of the show ip igmp udlr command on an upstream router:

upstream-rtr# show ip igmp udlr

IGMP UDLR Status, UDL Interfaces: Serial0
Group Address    Interface            UDL Reporter     Reporter Expires
224.2.127.254    Serial0              10.0.0.2         00:02:12
224.0.1.40       Serial0              10.0.0.2         00:02:11
225.7.7.7        Serial0              10.0.0.2         00:02:15

The following is sample output of the show ip igmp udlr command on a downstream router:

downstream-rtr# show ip igmp udlr

IGMP UDLR Status, UDL Interfaces: Serial0
Group Address    Interface            UDL Reporter     Reporter Expires
224.2.127.254    Serial0              10.0.0.2         00:02:49
224.0.1.40       Serial0              10.0.0.2         00:02:48
225.7.7.7        Serial0              10.0.0.2         00:02:52

Table 20 describes the significant fields shown in the first display.

Table 20 show ip igmp udlr Field Descriptions 

Field
Description

Group Address

All groups helpered by the UDL Reporter on the interface.

Interface

Interface type and number to which the group is connected.

UDL Reporter

IP address of the router on the UDL network that is IGMP helpering for the group.

Reporter Expires

How soon the UDL Reporter will become inactive, in hours:minutes:seconds. This can occur under the following conditions:

The UDL Reporter has become nonoperational.

The link or network to the reporter has become nonoperational.

The group member attached to the UDL Reporter has left the group.


show ip mfib

To display the forwarding entries and interfaces in the IPv4 Multicast Forwarding Information Base (MFIB), use the show ip mfib command in user EXEC or privileged EXEC mode.

show ip mfib [vrf {vrf-name | * }] [all | linkscope | group-address/mask | group-address [source-address] | source-address group-address] [verbose]

Syntax Description

vrf {vrf-name | * }

(Optional) Displays forwarding entries and interfaces in the IPv4 MFIB associated with Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instances.

After specifying the optional vrf keyword, you must specify either:

vrf-name—Name of an MVRF. Displays forwarding entries and interfaces in the IPv4 MFIB associated with the MVRF specified for the vrf-name argument.

*—Displays forwarding entries and interfaces in the IPv4 MFIB associated with all tables (all MVRF tables and the global table).

all

Displays forwarding entries and interfaces in the IPv4 MFIB for both linkscope (reserved) and non-linkscope (non-reserved) groups.

linkscope

Displays forwarding entries and interfaces in the IPv4 MFIB for linkscope (reserved) groups.

group-address/mask

(Optional) Multicast group address followed by a forward slash (/) and group mask, in dotted decimal notation, which is referred to as a (*, G/mask) entry.

group-address

(Optional) Multicast group address.

source-address

(Optional) Multicast source address.

verbose

(Optional) Includes hardware-related IPv4 MFIB flags and CEF-related adjacency information.


Command Default

If no optional keywords or arguments are entered, forwarding entries and interfaces in the IPv4 MFIB associated with non-linkscope multicast groups are displayed.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

15.0(1)M

This command was introduced.


Usage Guidelines

Use the show ip mfib command to display IPv4 MFIB forwarding entries and interfaces.

A forwarding entry in the IPv4 MFIB has flags that determine the default forwarding and signaling behavior to use for packets matching the entry. The entry also has per-interface flags that further specify the forwarding behavior for packets received or forwarded on specific interfaces.


Note For a description of the significant MFIB and MRIB forwarding entries and interface flags, see the "Multicast Forwarding Information Base (MFIB) Overview" module.


Examples

The following is sample output from the show ip mfib command:

Router# show ip mfib 232.1.1.1

 (192.168.1.2,232.1.1.1) Flags:
   SW Forwarding: 3786/10/28/2, Other: 0/0/0
   Serial1/0 Flags: A
   Ethernet0/0 Flags: F NS
     Pkts: 3786/0

Table 21describes the significant fields shown in the display.

Table 21 show ip mfib Field Descriptions 

Field
Description

SW Forwarding:

Statistics on the packets that are received from and forwarded out of at least one interface (packet count/packets per second/average packet size/kbits per second).

Other:

Statistics on received packets. These counters include statistics about the packets received and forwarded and packets received but not forwarded.

Pkts

Total number of packets received and forwarded since the creation of the multicast forwarding state to which this counter applies.


show ip mfib active

To display the rate at which active multicast sources are sending to multicast groups, use the show ip mfib active command in user EXEC or privileged EXEC mode.

show ip mfib [vrf {vrf-name | * }] [all | linkscope | group-address/mask | group-address [source-address] } | source-address group-address] active [kpbs]

Syntax Description

vrf {vrf-name | * }

(Optional) Displays the rate at which active multicast sources are sending to multicast groups associated with Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instances.

After specifying the optional vrf keyword, you must specify either:

vrf-name—Name of an MVRF. Displays the rate at which active multicast sources are sending to multicast groups associated with the MVRF specified for the vrf-name argument.

*—Displays the rate at which active multicast sources are sending to multicast groups for all tables (all MVRF tables and the global table).

all

(Optional) Displays the rate at which active multicast sources are sending to both linkscope (reserved) and non-linkscope (non-reserved) groups.

linkscope

(Optional) Displays the rate at which active multicast sources are sending to linkscope (reserved) groups.

group-address/mask

(Optional) Multicast group address followed by a forward slash (/) and group mask, in dotted decimal notation, which is referred to as a (*, G/mask) entry.

group-address

(Optional) Multicast group address.

source-address

(Optional) Multicast source address.

kpbs

(Optional) Kilobits per second (kpbs).


Command Default

If no optional keywords or arguments are entered, all active sources sending to non-linkscope multicast groups at a rate greater than or less than 4 kpbs are displayed.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

15.0(1)M

This command was introduced.


Usage Guidelines

Use the show ip mfib active command to display active multicast streams forwarding at a rate greater than or equal to the value specified for the optional kpbs argument. If no value is specified for the optional kpbs argument, this command will display all active sources sending to non-linkscope (non-reserved) multicast groups at a rate greater than or equal to 4 kpbs.


Note In some cases, you may need to specify a sufficiently low value for the kpbs argument to ensure that low data rate streams are displayed (multicast streams sending traffic at a rate less than 4 kpbs).


Examples

The following is sample output from the show ip mfib active command. In this example, the output displays the active multicast sources that are sending traffic to non-linkscope multicast groups at a rate greater than or equal to 1 kbps on a router participating in a multicast network.

Router# show ip mfib active 1

Active Multicast Sources - sending >= 1 kbps
Default
Group: 239.1.1.1
  Source: 192.168.1.2,
   SW Rate: 10 pps/2 kbps(1sec), 2 kbps(last 121 sec)


Table 22 describes the significant fields shown in the display.

Table 22 show ip mfib active Field Descriptions 

Field
Description

Active Multicast Sources - sending >=

Active multicast sources sending traffic at a rate greater than or equal to the value specified after the equal (=) sign, in kbps.

Group:

Multicast group address.

Source:

Multicast source address.

SW Rate:

Rate at which active sources are sending traffic to multicast groups.


show ip mfib count

To display a summary of traffic statistics from the IPv4 Multicast Forwarding Information Base (MFIB) about multicast sources and groups, use the show ip mfib count command in user EXEC or privileged EXEC mode.

show ip mfib [vrf {vrf-name | * }] [all | linkscope | group-address/mask | group-address [source-address] } | source-address group-address] count

Syntax Description

vrf {vrf-name | * }

(Optional) Displays a summary of traffic statistics from the IPv4 MFIB about multicast sources and groups associated with Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instances.

After specifying the optional vrf keyword, you must specify either:

vrf-name—Name of an MVRF. Displays a summary of traffic statistics from the IPv4 MFIB for sources and groups associated with the MVRF specified for the vrf-name argument.

*—Displays a summary of traffic statistics from the IPv4 MFIB for sources and groups associated with all tables (all MVRF tables and the global table).

all

Displays a summary of traffic statistics from the IPv4 MFIB about multicast sources sending to both linkscope (reserved) and non-linkscope (non-reserved) groups.

linkscope

Displays a summary of traffic statistics from the IPv4 MFIB about multicast sources sending to linkscope (reserved) groups.

group-address/mask

(Optional) Multicast group address followed by a forward slash (/) and group mask, in dotted decimal notation, referred to as a (*, G/mask) entry.

group-address

(Optional) Multicast group address.

source-address

(Optional) Multicast source address.


Command Default

If no optional keywords or arguments are entered, a summary of traffic statistics from the IPv4 MFIB about multicast sources sending traffic to non-reserved (non-linkscope) multicast groups are displayed.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

15.0(1)M

This command was introduced.


Usage Guidelines

Use the show ip mfib count command to display a summary of traffic statistics from the IPv4 MFIB about multicast sources and groups, including number of packets, packets per second, average packet size, and kilobytes per second.

Examples

The following is sample output from the show ip mfib count command:

Router# show ip mfib count

Forwarding Counts: Pkt Count/Pkts per second/Avg Pkt Size/Kilobits per second
Other counts:      Total/RPF failed/Other drops(OIF-null, rate-limit etc)
Default
 15 routes, 9 groups, 0.33 average sources per group
Group: 224.0.0.0/4
  RP-tree,
   SW Forwarding: 0/0/0/0, Other: 0/0/0
Group: 224.0.1.39
  RP-tree,
   SW Forwarding: 0/0/0/0, Other: 0/0/0
  Source: 192.168.6.6,
   SW Forwarding: 0/0/0/0, Other: 0/0/0
  Totals - Source count: 1, Packet count: 0
Group: 224.0.1.40
  RP-tree,
   SW Forwarding: 0/0/0/0, Other: 0/0/0
  Source: 192.168.6.6,
   SW Forwarding: 0/0/0/0, Other: 0/0/0
  Totals - Source count: 1, Packet count: 0
Group: 232.0.0.0/8
  RP-tree,
   SW Forwarding: 0/0/0/0, Other: 0/0/0
Group: 239.1.1.1
  RP-tree,
   SW Forwarding: 0/0/0/0, Other: 0/0/0
  Source: 192.168.1.2,
   SW Forwarding: 25044/10/28/2, Other: 1/1/0
  Totals - Source count: 1, Packet count: 25044

Table 23describes the significant fields shown in the display.

Table 23 show ip mfib count Field Descriptions 

Field
Description

Forwarding Counts

Statistics on the packets that are received and forwarded out an interface.

This section tracks the following statistics:

Pkt Count/—Total number of packets received and forwarded since the multicast forwarding state to which this counter applies was created.

Pkts per second/—Number of packets received and forwarded per second.

Avg Pkt Size/ —Total number of bytes divided by the total number of packets for this multicast forwarding state. There is no direct display for the total number of bytes. You can calculate the total number of bytes by multiplying the average packet size by the packet count.

Kilobits per second—Bytes per second divided by packets per second divided by 1000.

Other counts

Statistics on the received packets. These counters include statistics about the packets received and forwarded and packets received but not forwarded.

This section tracks the following statistics:

Total/—Total number of packets received.

RPF failed/—Number of packets not forwarded due to a failed Reverse Path Forwarding (RPF) or acceptance check (when bidirectional PIM is configured).

Other drops(OIF-null, rate-limit etc)—Number of packets not forwarded for reasons other than an RPF failure or acceptance check (such as the outgoing interface [OIF] list was empty or because the packets were discarded because of a configuration that was enabled).

Group:

Summary information about counters for (*, G) and the range of (S, G) states for one particular group G. The following RP-tree: and Source: output fields contain information about the individual states belonging to this group.

Note For Source Specific Multicast (PIM-SSM) range groups, the Group: displays are statistical. All SSM range (S, G) states are individual, unrelated SSM channels.

RP-tree:

Counters for the (*, G) state of this group G. These counters are displayed only for groups that have a forwarding mode that do not forward packets on the shared tree. These (*, G) groups are bidirectional PIM and PIM sparse mode (PIM-SM) groups. There are no RP-tree displays for PIM SSM range groups.

SW Forwarding:

Statistics on the packets that are received from and forwarded to at least one interface.

Other:

Statistics on received packets. These counters include statistics about the packets received and forwarded and packets received but not forwarded.

Totals -

This section tracks the following statistics:

Source count—Total number of multicast sources sending to multicast groups in the IPv4 MFIB.

Packet count—Total number of packets received and forwarded. This count is cumulative for all sources in the source count.


show ip mfib interface

To display IPv4 MFIB-related information about interfaces and their forwarding status, use the show ip mfib interface command in user EXEC or privileged EXEC mode.

show ip mfib interface [control | data] [type number]

Syntax Description

control

(Optional) Displays interfaces in the IPv4 MFIB, and any associated control information.

data

(Optional) Displays IPv4 MFIB forwarding information about interfaces.

type number

(Optional) Interface type and number.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

15.0(1)M

This command was introduced.


Examples

The following is sample output from the show ip mfib interface command:

Router# show ip mfib interface

IPv4 Multicast Forwarding (MFIB) status:
    Configuration Status: enabled
    Operational Status: running
    Initialization State: MFIB Init Running
    Total signalling packets queued: 0
    Process Status: may enable - 3 - pid 202
    Tables 1/1/0 (active/mrib/io)
MFIB interface             status    CEF-based output   
                                  [configured,available]
Ethernet0/0                up     [yes       ,yes      ]
Ethernet0/1                down   [yes       ,no       ]
Ethernet0/2                down   [yes       ,no       ]
Ethernet0/3                down   [yes       ,no       ]
Ethernet1/0                up     [yes       ,yes      ]
Ethernet1/1                down   [yes       ,no       ]
Ethernet1/2                down   [yes       ,no       ]
Ethernet1/3                down   [yes       ,no       ]
Serial2/0                  down   [yes       ,no       ]
Serial2/1                  down   [yes       ,no       ]
Serial2/2                  down   [yes       ,no       ]
Serial2/3                  down   [yes       ,no       ]
Serial3/0                  down   [yes       ,no       ]
Serial3/1                  down   [yes       ,no       ]
Serial3/2                  down   [yes       ,no       ]
Serial3/3                  down   [yes       ,no       ]
Loopback0                  up     [yes       ,yes      ]
Tunnel0                    up     [yes       ,yes      ]


Table 24describes the significant fields shown in the display.

Table 24 show ip mfib interface Field Descriptions 

Field
Description

IPv4 Multicast Forwarding (MFIB) status:

Displays the status of interfaces in the IPv4 MFIB.

Configuration Status

IPv4 MFIB configuration status on the interface.

Initialization State

Intialization state of the IPv4 MFIB.

MFIB interface

Lists available interfaces for which to display IPv4 MFIB status.

status

Status of the interface.

CEF-based output

Provides information about the status of Cisco Express Forwarding (CEF) on the MFIB interface. This section tracks whether CEF has been configured and whether it is available on the interface.


The following is sample output from the show ip mfib interface control command:

Router# show ip mfib interface control 

                                                 MFIB Forwarding
MFIB interface                    IP   PIM     Process        CEF
                                             (Conf/Oper)  (Conf/Oper)
Ethernet0/0                       up   on     yes  yes     yes  yes
Ethernet0/1                       off  off    yes  no      yes  no 
Ethernet0/2                       off  off    yes  no      yes  no 
Ethernet0/3                       off  off    yes  no      yes  no 
Ethernet1/0                       up   on     yes  yes     yes  yes
Ethernet1/1                       off  off    yes  no      yes  no 
Ethernet1/2                       off  off    yes  no      yes  no 
Ethernet1/3                       off  off    yes  no      yes  no 
Serial2/0                         off  off    yes  no      yes  no 
Serial2/1                         off  off    yes  no      yes  no 
Serial2/2                         off  off    yes  no      yes  no 
Serial2/3                         off  off    yes  no      yes  no 
Serial3/0                         off  off    yes  no      yes  no 
Serial3/1                         off  off    yes  no      yes  no 
Serial3/2                         off  off    yes  no      yes  no 
Serial3/3                         off  off    yes  no      yes  no 
Loopback0                         up   on     yes  yes     yes  yes
Tunnel0                           up   reg    yes  out     yes  out

Table 25 describes the significant fields shown in the display.

Table 25 show ip mfib interface control Field Descriptions 

Field
Description

MFIB interface

Lists available interfaces for which to display IPv4 MFIB status.

IP

Lists the status of IP on the available interfaces.

PIM

Lists the status of PIM on the available interfaces.

Process

Lists the configuration and operational status of the IPv4 MFIB on the available interfaces.

CEF

Lists the configuration and operational status of CEF on the available interfaces.


The following is sample output from the show ip mfib interface data command:

Router# show ip mfib interface data

                                                    MFIB Forwarding
MFIB interface                           Type    Process         CEF
                                                           (Active/Available)
 Ethernet0/0                             None    yes        yes    yes
 Ethernet1/0                             None    yes        yes    yes
 Loopback0                               None    yes        yes    yes
 Tunnel0                                 None    out        out    out

Table 26 describes the significant fields shown in the display.

Table 26 show ip mfib interface data Field Descriptions 

Field
Description

MFIB interface

Lists available interfaces for which to display IPv4 MFIB forwarding status.

Type

Next hop type value (for example, IPv4, IPv6, MDTv4, MDTv6, LSM, LSM NBMA, v4Dec, and v6Dec).

Process

Lists the status of the IPv4 MFIB process.

CEF

Lists the status of CEF (whether it is active and available) for IPv4 MFIB interfaces.


show ip mfib route

To display the forwarding entries and interfaces in the IPv4 Multicast Forwarding Information Base (MFIB) without packet header information and forwarding counters, use the show ip mfib route command in user EXEC or privileged EXEC mode.

show ip mfib [vrf {vrf-name | * }] route [all | linkscope | group-address/mask | group-address [source-address] } | source-address group-address] [detail | internal]

Syntax Description

vrf {vrf-name | * }

(Optional) Displays the forwarding entries and interfaces in the IPv4 MFIB associated with Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instances.

After specifying the optional vrf keyword, you must specify either:

vrf-name—Name of an MVRF. Displays the forwarding entries and interfaces in the IPv4 MFIB associated with the MVRF specified for the vrf-name argument.

*—Displays the forwarding entries and interfaces in the IPv4 MFIB associated with all tables (all MVRF tables and the global table).

all

(Optional) Displays the forwarding entries and interfaces in the IPv4 MFIB for both linkscope (reserved) and non-linkscope (non-reserved) groups.

linkscope

(Optional) Displays the forwarding entries and interfaces in the IPv4 MFIB for linkscope (reserved) groups.

group-address/mask

(Optional) Multicast group address followed by a forward slash (/) and group mask, in dotted decimal notation (referred to as a (*, G/mask) entry).

group-address

(Optional) Multicast group address.

source-address

(Optional) Multicast source address.

detail

(Optional; for use by Cisco technical support) Displays detailed information about the routes in the IPv4 MFIB.

internal

(Optional; for use by Cisco technical support) Displays the internal data structures for the routes in the IPv4 MFIB.


Command Default

If no optional keywords or arguments are entered, forwarding entries and interfaces in the IPv4 MFIB associated with non-linkscope multicast groups are displayed.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

15.0(1)M

This command was introduced.


Usage Guidelines

Use the show ip mfib route command to display the forwarding entries and interfaces in the IPv4 MFIB. Unlike the show ip mfib command, the output from this command does not display packet header information and IPv4 MFIB packet and forwarding counters.


Note For a description of the significant MFIB and MRIB forwarding entries and interface flags, see the "Multicast Forwarding Information Base (MFIB) Overview" module.


Examples

The following is sample output from the show ip mfib route command:

Router# show ip mfib route

Default
 (*,224.0.0.0/4) C
 (*,224.0.1.39) C
   Loopback0 NS
   Ethernet1/0 F NS
   Ethernet0/0 NS
 (192.168.6.6,224.0.1.39)
   Ethernet1/0 A NS
 (*,224.0.1.40) C
   Loopback0 F IC NS
   Ethernet1/0 F NS
 (192.168.6.6,224.0.1.40)
   Loopback0 F IC NS
   Ethernet1/0 A
 (*,232.0.0.0/8)
 (*,239.1.1.1) C
   Ethernet1/0 A
 (192.168.1.2,239.1.1.1)
   Ethernet1/0 F NS
   Ethernet0/0 A

Related Commands

Command
Description

show ip mfib

Displays the forwarding entries and interfaces in the IPv4 MFIB.


show ip mfib status

To display the general IPv4 Multicast Forwarding Information Base (MFIB) configuration and operational status, use the show ip mfib status command in user EXEC or privileged EXEC mode.

show ip mfib status

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

15.0(1)M

This command was introduced.


Usage Guidelines

Use the show ip mfib status to find such information as whether or not the IPv4 MFIB is enabled and running.

Examples

The following is sample output from the show ip mfib status command:

Router# show ip mfib status

IPv4 Multicast Forwarding (MFIB) status:
    Configuration Status: enabled
    Operational Status: running
    Initialization State: MFIB Init Running
    Total signalling packets queued: 0
    Process Status: may enable - 3 - pid 202
    Tables 1/1/0 (active/mrib/io)

show ip mfib summary

To display summary information about the number of IPv4 Multicast Forwarding Information Base (MFIB) entries (including linkscope groups) and interfaces, use the show ip mfib summary command in user EXEC or privileged EXEC mode.

show ip mfib [vrf {vrf-name | * }] summary [detail | internal]

Syntax Description

vrf {vrf-name | * }

(Optional) Displays summary information about the number of IPv4 MFIB entries and interfaces associated with Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instances.

After specifying the optional vrf keyword, you must specify either:

vrf-name—Name of an MVRF. Displays summary information about the number of IPv4 MFIB entries and interfaces associated with the MVRF specified for the vrf-name argument.

*—Displays summary information about the number of IPv4 MFIB entries and interfaces associated with all tables (all MVRF tables and the global table).

detail

(Optional; for use by Cisco technical support) Displays more detailed information about the IPv4 MFIB entries and interfaces in the summary of the IPv4 MFIB.

internal

(Optional; for use by Cisco technical support) Displays internal data structures associated with IPv4 MFIB entries and interfaces in the summary of the IPv4 MFIB.


Command Default

If no optional keywords or arguments are entered, this command displays summary information about the number of IPv4 MFIB entries and interfaces from the global table.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

15.0(1)M

This command was introduced.


Usage Guidelines

The show ip mfib summary command shows the IPv4 multicast routing table in abbreviated form. The command displays only the number of IPv4 MFIB entries, the number of (*, G), (S, G), and (*, G/m) entries and the number of IPv4 MFIB interfaces .

The show ip mfib summary command counts all entries, including linkscope entries.

Examples

The following is sample output from the show ip mfib summary command:

Router# show ip mfib summary

Default
 15 prefixes (15/0/0 fwd/non-fwd/deleted)
 28 ioitems (28/0/0 fwd/non-fwd/deleted)
 Forwarding prefixes: [3 (S,G), 9 (*,G), 3 (*,G/m)]
 Table id 0x0, instance 0x4B23B54
 Database: epoch 0

Table 27 describes the significant fields shown in the display.

Table 27 show ip mfib summary Field Descriptions 

Field
Description

15 prefixes (15/0/0 fwd/non-fwd/deleted)

Number of prefixes in the IPv4 MFIB and a summary of the status of the prefixes (forwarded/non-forwarded/deleted), including linkscope prefixes.

28 ioitems (28/0/0 fwd/non-fwd/deleted)

Number of interfaces in the IPv4 MFIB.

Forwarding prefixes: [3 (S,G), 9 (*,G), 3 (*,G/m)]

Total number of (S, G), (*, G) and (*, G/m) prefixes in the IPv4 MFIB.


show ip mcache


Note Effective with Cisco IOS Release 15.0(1)M, the show ip mcache command is not available in Cisco IOS software.


To display the contents of the IP fast-switching cache, use the show ip mcache command in user EXEC or privileged EXEC mode.

show ip mcache [vrf vrf-name] [group-address | group-name] [source-address | source-name]

Syntax Description

vrf vrf-name

(Optional) Displays the contents of the IP fast-switching cache associated with the Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.

group-address | group-name

(Optional) The address or name of the group for which to display the fast-switching cache. Can be either a Class D IP address or a Domain Name System (DNS) name.

source-address | source-name

(Optional) The specified source address or name for which to display a single multicast cache entry. Can be either a unicast IP address or a DNS name.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

11.0

This command was introduced.

12.0(23)S

The vrf keyword and vrf-name argument were added.

12.2(13)T

The vrf keyword and vrf-name argument were added.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720 only.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

15.0(1)M

This command was removed.


Examples

The following is sample output from the show ip mcache privileged EXEC command when multicast distributed switching (MDS) is in effect:

Router# show ip mcache

IP Multicast Fast-Switching Cache
(*, 239.2.3.4), Fddi3/0/0, Last used: mds
  Tunnel3         MAC Header: 5000602F9C150000603E473F60AAAA030000000800 (Fddi3/0/0)
  Tunnel0         MAC Header: 5000602F9C150000603E473F60AAAA030000000800 (Fddi3/0/0)
  Tunnel1         MAC Header: 5000602F9C150000603E473F60AAAA030000000800 (Fddi3/0/0)

Table 28 describes the significant fields shown in the display.

Table 28 show ip mcache Field Descriptions 

Field
Description

*

Source address or source wildcard (*).

239.2.3.4

Destination address.

Fddi

Incoming or expected interface on which the packet should be received.

Last used:

Latest time the entry was accessed for a packet that was successfully fast switched. The word "Semi-fast" indicates that the first part of the outgoing interface list is fast switched and the rest of the list is process level switched.

Tunnel0

MAC Header:

Outgoing interface list and respective MAC header that is used when rewriting the packet for output. If the interface is a tunnel, the MAC header will show the real next hop MAC header and then, in parentheses, the real interface name.


show ip mrm interface

To display Multicast Routing Monitor (MRM) information related to interfaces, use the show ip mrm interface command in user EXEC or privileged EXEC mode.

show ip mrm interface [type number]

Syntax Description

type number

(Optional) Interface type and number for which to display MRM interface information.


Command Default

If no interface is specified for the type and number arguments, information about all interfaces participating in MRM is displayed.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.0(5)T

This command was integrated into Cisco IOS Release 12.0(5)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Use this command to display which interfaces are participating in MRM, in which roles, and whether the interfaces are up or down.

Examples

The following is sample output from the show ip mrm interface command:

Router# show ip mrm interface

Interface           Address          Mode                  Status
Ethernet0           10.0.0.1         Test-Sender           Up
Ethernet1           10.0.0.10        Test-Receiver         Up

Table 29 describes the fields shown in the display.

Table 29 show ip mrm interface Field Descriptions

Field
Description

Interface

List of interfaces on this router that serve as a Test Sender or Test Receiver.

Address

IP address of the interface.

Mode

Role that the interface plays in MRM, either Test Sender or Test Receiver.

Status

Status of the interface.


Related Commands

Command
Description

ip mrm

Configures an interface to operate as a Test Sender or Test Receiver, or both, for MRM.


show ip mrm manager

To display information about a Multicast Routing Monitor (MRM) test, use the show ip mrm manager command in user EXEC or privileged EXEC mode.

show ip mrm manager [test-name]

Syntax Description

test-name

(Optional) Name of the MRM test for which to display information.


Command Default

If no test name is specified for the test-name argument, information about all Managers is displayed.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.0(5)T

This command was integrated into Cisco IOS Release 12.0(5)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Use this command to display status information and the parameters configured for an MRM test.

Examples

The following is sample output from the show ip mrm manager command executed at two different times:

Router# show ip mrm manager test

Manager:test/10.0.0.0 is running, expire:1d00h
  Beacon interval/holdtime/ttl:60/86400/32
  Group:239.1.2.3, UDP port test-packet/status-report:16384/65535
  Test senders: 
    10.0.0.1 /Ack
  Test receivers: 
    10.0.0.2 /Ack

Router# show ip mrm manager test

Manager:test/10.0.0.0 is not running
  Beacon interval/holdtime/ttl:60/86400/32
  Group:239.1.2.3, UDP port test-packet/status-report:16384/65535
  Test senders: 
    10.0.0.1
  Test receivers: 
    10.0.0.2

Table 30 describes the fields shown in the display.

Table 30 show ip mrm manager Field Descriptions

Field
Description

Manager

Status of the test.

Beacon interval/holdtime/ttl

The interval at which beacon messages are sent (Beacon interval), the duration of the test period (holdtime), and the time-to-live value of beacon messages.

Note Beacon parameters are controlled with the beacon command. By default, beacon messages are sent at an interval of 60 seconds; the duration of the test period is 86400 seconds (1 day); and the time-to-live of beacon messages is 32 hops.

Group

IP multicast group that the Test Receiver will listen to, as configured by the manager command.

UDP port test-packet/status-report

User Datagram Protocol (UDP) port number to which test packets are sent by a Test Sender and status reports are sent by a Test Receiver.

Note The UDP port numbers to which test packets are sent by a Test Sender and status reports are sent by a Test Receiver are controlled with the udp-port command. By default, the Test Sender uses UDP port number 16834 to send test packets, and the Test Receiver uses UDP port number 65535 to send status reports.

Test senders

IP address of Test Senders.

Test receivers

IP address of Test Receivers.


Related Commands

Command
Description

beacon

Changes the frequency, duration, or scope of beacon messages that the Manager sends to the Test Sender and Test Receiver.

ip mrm manager

Specifies the name of an MRM test to be created or modified, and enters MRM manager configuration mode.

manager

Specifies that an interface is the Manager for MRM, and specifies the multicast group address the Test Receiver will listen to.

udp-port

Changes the UDP port numbers to which the Test Sender sends test packets or the Test Receiver sends status reports.


show ip mrm status-report

To display the status reports in the Multicast Routing Monitor (MRM) status report cache, use the show ip mrm status-report command in user EXEC or privileged EXEC mode.

show ip mrm status-report [ip-address]

Syntax Description

ip-address

(Optional) IP address of a Test Receiver for which to display status reports.


Command Default

If no IP address is specified for the optional ip-address argument, all status reports in the MRM status report cache are displayed.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.0(5)S

This command was introduced.

12.0(5)T

This command was integrated into Cisco IOS Release 12.0(5)T.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Use the show ip mrm status-report command during your MRM test period to learn if any errors are reported. The Manager immediately displays error reports and sends error reports, if any, to the circular status report cache. The cache holds up to 1024 lines, with one line for each error report.

No errors reported indicates that the Test Receiver is receiving test packets without loss or duplicates from the Test Sender.

Use the show ip mrm status-report command with the optional ip-address argument to restrict the output to display only status reports sent by the Test Receiver at the specified IP address. If no IP address is specified for the optional ip-address argument, all status reports in the MRM status report cache are displayed.

Use the clear ip mrm status-report command to clear the MRM status report cache.

Examples

The following is sample output from the show ip mrm status-report command:

Router# show ip mrm status-report

IP MRM status report cache:
Timestamp        Manager         Test Receiver   Pkt Loss/Dup (%)      Ehsr
*Apr 20 07:36:08 10.0.0.0        10.0.0.1        5            (20%)    0
*Apr 20 07:36:09 10.0.0.0        10.0.0.1        10           (40%)    0
*Apr 20 07:36:10 10.0.0.0        10.0.0.1        15           (60%)    0

Table 31 describes the fields shown in the display.

Table 31 show ip mrm status-report Field Descriptions 

Field
Description

Timestamp

Time when the status report arrived in the cache. Month and date, hours:minutes:seconds.

Manager

IP address of the Manager.

Test Receiver

IP address of the Test Receiver.

Pkt Loss/Dup

Number of packets lost or duplicated.

(%)

Percentage of packets lost or duplicated. Loss percentage is calculated based on the packet-delay value of the senders command, which defaults to 200 milliseconds (or 5 packets per second). If the default for the window keyword (5 seconds) is not changed, then the Test Receiver expects 5 packets per second for 5 seconds = 25 packets. If the Test Receiver receives only 15 packets, then 25 - 15 = 10 lost packets. Lost packets divided by packets expected equals loss percentage; 10/25 equals a loss percentage of 40 percent.

A negative percentage indicates duplicate packets were received.

If the packet loss reaches 100 percent, the Test Receiver will not send periodic reports until the packet loss decreases to less than 100 percent.

Ehsr

Extended highest sequence number received from Real-Time Transport Protocol (RTP).


Related Commands

Command
Description

clear ip mrm status-report

Clears the MRM status report cache.


show ip mpacket


Note Effective with Cisco IOS Release 15.0(1)M, the show ip mpacket is not available in Cisco IOS software.


To display the contents of the circular cache-header buffer, use the show ip mpacket command in privileged EXEC mode.

show ip mpacket [vrf vrf-name] [group-address | group-name] [source-address | source-name] [detail]

Syntax Description

vrf vrf-name

(Optional) Displays the contents of the circular cache-header buffer associated with the Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.

group-address | group-name

(Optional) The specified group address or group name for which matching cache headers are displayed.

source-address | source-name

(Optional) The specified source address or source name for which matching cache headers are displayed.

detail

(Optional) Displays summary information and displays the rest of the IP header fields on an additional line, plus the first 8 bytes after the IP header (usually the User Datagram Protocol [UDP] port numbers).


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.1

This command was introduced.

12.0(23)S

The vrf keyword and vrf-name argument were added.

12.2(13)T

The vrf keyword and vrf-name argument were added.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720 only.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

15.0(1)M

This command was removed.


Usage Guidelines

This command is applicable only when the ip multicast cache-headers command is in effect.

Each time this command is entered, a new buffer is allocated. The summary display (when the detail keyword is omitted) shows the IP packet identifier, time-to-live (TTL) value, source and destination IP addresses, and a local time stamp when the packet was received.

The three arguments and two keywords can be used in the same command in any combination.

Examples

The following is sample output from the show ip mpacket command with the group-name argument:

Router# show ip mpacket smallgroup

IP Multicast Header Cache - entry count:6, next index: 7
Key: id/ttl timestamp (name) source group

D782/117 206416.908 (company1.company.com) 192.168.228.10 224.5.6.7
7302/113 206417.908 (school.edu) 172.16.2.17 224.5.6.7
6CB2/114 206417.412 (company2.company.com) 172.16.19.40 224.5.6.7
D782/117 206417.868 (company1.company.com) 192.168.228.10 224.5.6.7
E2E9/123 206418.488 (company3.com) 239.1.8.10 224.5.6.7
1CA7/127 206418.544 (company4.company.com) 192.168.6.10 224.5.6.7

Table 32 describes the significant fields shown in the display.

Table 32 show ip mpacket Field Descriptions 

Field
Description

entry count

Number of packets cached (one packet for each line in the display). The cache has lines numbered from 0 to 1024.

next index

The index for the next element in the cache.

id

Identification number of the IP packet.

ttl

Current TTL of the packet.

timestamp

Time-stamp sequence number of the packet.

(name)

Domain Name System (DNS) name of the source sending to the group. Name appears in parentheses.

source

IP address of the source sending to the group.

group

Multicast group address to which the packet is sent. In this example, the group address is the group name smallgroup.


Related Commands

Command
Description

ip multicast cache-headers

Allocates a circular buffer to store IP multicast packet headers that the router receives.


show ip mrib client

To display information about the clients of the IPv4 Multicast Routing Information Base (MRIB), use the show ip mrib client command in user EXEC or privileged EXEC mode.

show ip mrib [vrf vrf-name] client [filter][name client-name [:connection-id]]

Syntax Description

vrf vrf-name

(Optional) Displays information about clients of the IPv4 MRIB associated with the Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) specified for the vrf-name argument.

filter

(Optional) Displays information about the IPv4 MRIB flags each client owns and the flags each client is interested in.

name client-name

(Optional) The name an IPv4 MRIB client.

Note The names of the MRIB clients that can be specified for the client-name argument can be found by entering the show ip mrib client command with no optional keywords or arguments.

:connection-id

(Optional) The connection ID associated with the IPv4 MRIB client. The colon is required.

Note The connection ID is typically the Process ID (PID) value associated with the MRIB client.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

15.0(1)M

This command was introduced.


Usage Guidelines

Use the show ip mrib client command to display information about the clients of the IPv4 MRIB. When this command is entered with the optional filter keyword, the output will display additional information, including the IPv4 MRIB flags each clients owns and the flags each client is interested in.


Note For a description of the significant MFIB and MRIB forwarding entries and interface flags, see the "Multicast Forwarding Information Base (MFIB) Overview" module.


Examples

The following is sample output from the show ip mrib client command:

Router# show ip mrib client

IP MRIB client-connections
MRIB Trans for MVRF #0     table:199    (connection id 1)
IPv4_mfib(0x5474934):7.196       (connection id 2)

The following is sample output from the show ip mrib client command with the filter and name keywords and client-name and :connection-id arguments:

Router# show ip mrib client filter name IPv4_mfib(0x5474934):7.196

IP MRIB client-connections
IPv4_mfib(0x5474934):7.196      (connection id 2)
  interest filter:
    entry attributes:  S C IA K ET DDE
    interface attributes:  A DP F IC NS SP
    groups:
      include 0.0.0.0/0
    interfaces:
      include All
  ownership filter:
    groups:
      include 0.0.0.0/0
    interfaces:
      include All

show ip mrib route

To display the IPv4 Multicast Routing Information Base (MRIB) table, use the show ip mrib route command in user EXEC or privileged EXEC mode.

show ip mrib [vrf vrf-name] route [reserved | [source-address | *] [group-address[/mask]]]

Syntax Description

vrf vrf-name

(Optional) Displays routes in the IPv4 MRIB associated with the Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.

reserved

(Optional) Displays routes in the IPv4 MRIB associated with linkscope groups.

source-address

(Optional) Multicast source address.

*

(Optional) Displays shared tree entries in the IPv4 MRIB.

group-address

(Optional) Multicast group address.

group-address/mask

(Optional) Multicast group address followed by a forward slash (/) and group mask, in dotted decimal notation, which is referred to as a (*, G/mask) entry.


Command Default

If this command is entered without the optional reserved keyword, the output only displays routes in the IPv4 MRIB associated with non-reserved (non-linkscope) groups.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

15.0(1)M

This command was introduced.


Usage Guidelines

Use the show ip mrib route command to display the IPv4 MRIB table. All entries are created by various clients of the IPv4 MRIB, such as, PIM and the IPv4 MFIB. The flags on each entry or interface act as communication mechanism between the various clients of the IPv4 MRIB.


Note For a description of the significant MFIB and MRIB forwarding entries and interface flags, see the "Multicast Forwarding Information Base (MFIB) Overview" module.


Examples

The following is sample output from the show ip mrib route command:

Router# show ip mrib route

IP Multicast Routing Information Base
Entry flags: L - Domain-Local Source, E - External Source to the Domain,
    C - Directly-Connected Check, S - Signal, IA - Inherit Accept, D - Drop
    ET - Data Rate Exceeds Threshold,K - Keepalive,DDE - Data Driven Event
Interface flags: F - Forward, A - Accept, IC - Internal Copy,
    NS - Negate Signal, DP - Don't Preserve, SP - Signal Present,
    II - Internal Interest, ID - Internal Disinterest, LI - Local Interest,
    LD - Local Disinterest, MD - mCAC Denied
(*,224.0.0.0/4) Flags: C
(*,224.0.1.39) RPF nbr: 0.0.0.0 Flags: C
  Ethernet1/0 Flags: F NS
  Ethernet0/0 Flags: NS
  Loopback0 Flags: NS
(*,224.0.1.40) RPF nbr: 0.0.0.0 Flags: C
  Ethernet1/0 Flags: F NS
  Loopback0 Flags: F IC NS
(*,232.0.0.0/8) Flags:
(192.168.6.6,224.0.1.39) RPF nbr: 192.168.123.2 Flags:
  Ethernet1/0 Flags: A NS
(192.168.6.6,224.0.1.40) RPF nbr: 192.168.123.2 Flags:
  Ethernet1/0 Flags: A
  Loopback0 Flags: F IC NS

show ip mrib route summary

To display the total number of routes and interfaces in the IPv4 Multicast Routing Information Base (MRIB), use the show ip mrib route summary command in user EXEC or privileged EXEC mode.

show ip mrib [vrf vrf-name] route summary

Syntax Description

vrf vrf-name

(Optional) Displays the total number of routes and interfaces in the IPv4 MRIB associated with the Multicast Virtual Private Network (MVPN) routing and forwarding instance (MVRF) specified for the vrf-name argument.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

15.0(1)M

This command was introduced.


Usage Guidelines

Use the show ip mrib summary command to display the total number of routes and interfaces in the IPv4 Multicast Routing Information Base (MRIB).


Note The total number of routes and interfaces displayed in the output includes routes and interfaces associated with both reserved (linkscope) and nonreserved multicast groups.


Examples

The following is sample out from the show ip mrib summary command:

Router# show ip mrib summary

MRIB Route-DB Summary 
  No. of (*,G) routes = 11
  No. of (S,G) routes = 2
  No. of Route x Interfaces (RxI) = 25

show ip mroute

To display the contents of the multicast routing (mroute) table, use the show ip mroute command in user EXEC or privileged EXEC mode.

show ip mroute [vrf vrf-name] [[active [kbps] [interface type number] | bidirectional | count [terse] | dense | interface type number | proxy | pruned | sparse | ssm | static | summary] | [group-address [source-address]] [count [terse] | interface type number | proxy | pruned | summary] | [source-address group-address] [count [terse] | interface type number | proxy | pruned | summary] | [group-address] active [kbps] [interface type number]]

Syntax Description

vrf vrf-name

(Optional) Filters the output to display only the contents of the mroute table that pertain to the Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.

active kbps

(Optional) Displays the rate that active sources are sending to multicast groups, in kilobits per second (kbps). Active sources are those sending at the kbps value or higher. The range is from 1 to 4294967295. The kbps default is 4 kbps.

interface type number

(Optional) Filters the output to display only mroute table information related to the interface specified for the type number arguments.

bidirectional

(Optional) Filters the output to display only information about bidirectional routes in the mroute table.

count

(Optional) Displays statistics about the group and source, including number of packets, packets per second, average packet size, and bytes per second.

terse

(Optional) Filters the output to display a subset of mroute statistics, excluding source and group statistics for each mroute entry in the mroute table.

dense

(Optional) Filters the output to display only information about dense mode routes in the mroute table.

proxy

(Optional) Displays information about Reverse Path Forwarding (RPF) vector proxies received on a multicast router.

pruned

(Optional) Filters the output to display only information about pruned routes in the mroute table.

sparse

(Optional) Filters the output to display only information about sparse mode routes in the mroute table.

ssm

(Optional) Filters the output to display only the Source Specific Multicast (SSM) routes in the mroute table.

static

(Optional) Filters the output to display only the static routes in the mroute table.

summary

(Optional) Filters the output to display a one-line, abbreviated summary of each entry in the mroute table.

group-address

(Optional) IP address or Domain Name System (DNS) name of a multicast group.

source-address

(Optional) IP address or DNS name of a multicast source.


Command Default

If you omit all optional arguments and keywords, the show ip mroute command displays all entries in the mroute table.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

10.0

This command was introduced.

12.0(5)T

This command was modified. The H flag for multicast multilayer switching (MMLS) was added in the output display.

12.1(3)T

This command was modified. The U, s, and I flags for Source Specific Multicast (SSM) were introduced.

12.0(23)S

This command was modified. The vrf keyword and vrf-name argument were added.

12.0(30)S

This command was modified. The proxy keyword, and the v and V flags were added for the Multicast VPN Inter-AS Support feature.

12.2(13)T

This command was modified. The vrf keyword and vrf-name argument were added.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S. The vrf keyword and vrf-name argument were added

12.3

This command was modified. The Z, Y, and y flags were introduced.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.4(6)T

This command was modified. The terse keyword was added.

12.4(7)

This command was modified. The terse keyword was added.

12.2(18)SXF2

This command was modified. The terse keyword was added.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA. The terse keyword was added. The proxy keyword, and the v and V flags were added for the Multicast VPN Inter-AS Support feature.

12.2(31)SB2

This command was modified. The E flag for the Multicast VPN Extranet Support feature was introduced. The proxy keyword, and the v and V flags were added for the Multicast VPN Inter-AS Support feature. The terse keyword was added.

12.2(33)SXH

This command was modified. The proxy keyword, and the v and V flags were added for the Multicast VPN Inter-AS Support feature.

12.2(33)SRC

This command was modified. The E flag for the Multicast VPN Extranet Support feature was introduced.

12.4(20)T

This command was modified. The proxy keyword, and the v and V flags were added for the Multicast VPN Inter-AS Support feature.

15.0(1)M

This command was modified. The E flag for the Multicast VPN Extranet Support feature was introduced.


Usage Guidelines

Use the show ip mroute command to display information about mroute entries in the mroute table. The Cisco IOS software populates the multicast routing table by creating (S, G) entries from (*, G) entries. The asterisk (*) refers to all source addresses, the "S" refers to a single source address, and the "G" is the destination multicast group address. In creating (S, G) entries, the software uses the best path to that destination group found in the unicast routing table (that is, through Reverse Path Forwarding [RPF]).

Use the clear ip mroute command to delete entries from the mroute table.

Examples

The following is sample output from the show ip mroute command for a router operating in sparse mode:

Router# show ip mroute

IP Multicast Routing Table
Flags: D - Dense, S - Sparse, B - Bidir Group, s - SSM Group, C - Connected,
       L - Local, P - Pruned, R - RP-bit set, F - Register flag,
       T - SPT-bit set, J - Join SPT, M - MSDP created entry,
       X - Proxy Join Timer Running, A - Candidate for MSDP Advertisement,
       U - URD, I - Received Source Specific Host Report, Z - Multicast Tunnel,
       Y - Joined MDT-data group, y - Sending to MDT-data group
Timers: Uptime/Expires
Interface state: Interface, Next-Hop, State/Mode

(*, 224.0.255.3), uptime 5:29:15, RP is 192.168.37.2, flags: SC
  Incoming interface: Tunnel0, RPF neighbor 10.3.35.1, Dvmrp
  Outgoing interface list:
    Ethernet0, Forward/Sparse, 5:29:15/0:02:57

(192.168.46.0/24, 224.0.255.3), uptime 5:29:15, expires 0:02:59, flags: C
  Incoming interface: Tunnel0, RPF neighbor 10.3.35.1
  Outgoing interface list:
    Ethernet0, Forward/Sparse, 5:29:15/0:02:57

The following is sample output from the show ip mroute command with the IP multicast group address 232.6.6.6 specified:

Router# show ip mroute 232.6.6.6

IP Multicast Routing Table
Flags: D - Dense, S - Sparse, B - Bidir Group, s - SSM Group, C - Connected,
       L - Local, P - Pruned, R - RP-bit set, F - Register flag,
       T - SPT-bit set, J - Join SPT, M - MSDP created entry,
       X - Proxy Join Timer Running, A - Candidate for MSDP Advertisement,
       U - URD, I - Received Source Specific Host Report, Z - Multicast Tunnel,
       Y - Joined MDT-data group, y - Sending to MDT-data group
Outgoing interface flags:H - Hardware switched
Timers:Uptime/Expires
Interface state:Interface, Next-Hop or VCD, State/Mode
(*, 232.6.6.6), 00:01:20/00:02:59, RP 224.0.0.0, flags:sSJP
  Incoming interface:Null, RPF nbr 224.0.0.0
  Outgoing interface list:Null
(10.2.2.2, 232.6.6.6), 00:01:20/00:02:59, flags:CTI
  Incoming interface:Ethernet3/3, RPF nbr 224.0.0.0
  Outgoing interface list:
    Ethernet3/1, Forward/Sparse-Dense, 00:00:36/00:02:35

The following is sample output from the show ip mroute command for a router operating in dense mode. This output displays the contents of the IP multicast routing table for the multicast group named cbone-audio.

Router# show ip mroute cbone-audio

IP Multicast Routing Table
Flags: D - Dense, S - Sparse, B - Bidir Group, s - SSM Group, C - Connected,
       L - Local, P - Pruned, R - RP-bit set, F - Register flag,
       T - SPT-bit set, J - Join SPT, M - MSDP created entry,
       X - Proxy Join Timer Running, A - Candidate for MSDP Advertisement,
       U - URD, I - Received Source Specific Host Report, Z - Multicast Tunnel,
       Y - Joined MDT-data group, y - Sending to MDT-data group
Timers: Uptime/Expires
Interface state: Interface, Next-Hop, State/Mode

(*, 224.0.255.1), uptime 0:57:31, expires 0:02:59, RP is 224.0.0.0, flags: DC
  Incoming interface: Null, RPF neighbor 224.0.0.0, Dvmrp
  Outgoing interface list:
    Ethernet0, Forward/Dense, 0:57:31/0:02:52
    Tunnel0, Forward/Dense, 0:56:55/0:01:28

(192.168.37.100, 224.0.255.1), uptime 20:20:00, expires 0:02:55, flags: C
  Incoming interface: Tunnel0, RPF neighbor 10.20.37.33, Dvmrp
  Outgoing interface list:
    Ethernet0, Forward/Dense, 20:20:00/0:02:52

The following is sample output from the show ip mroute command that shows the virtual circuit descriptor (VCD) value, because an ATM interface with Protocol Independent Multicast (PIM) multipoint signaling is enabled:

Router# show ip mroute 224.1.1.1

IP Multicast Routing Table
Flags: D - Dense, S - Sparse, B - Bidir Group, s - SSM Group, C - Connected,
       L - Local, P - Pruned, R - RP-bit set, F - Register flag,
       T - SPT-bit set, J - Join SPT, M - MSDP created entry,
       X - Proxy Join Timer Running, A - Candidate for MSDP Advertisement,
       U - URD, I - Received Source Specific Host Report, Z - Multicast Tunnel,
       Y - Joined MDT-data group, y - Sending to MDT-data group
Timers: Uptime/Expires
Interface state: Interface, Next-Hop or VCD, State/Mode

(*, 224.1.1.1), 00:03:57/00:02:54, RP 172.16.0.0, flags: SJ
  Incoming interface: Null, RPF nbr 224.0.0.0224.0.0.0
  Outgoing interface list:
    ATM0/0, VCD 14, Forward/Sparse, 00:03:57/00:02:53


The following is sample output from the show ip mroute command with the summary keyword:

Router# show ip mroute summary

IP Multicast Routing Table
Flags: D - Dense, S - Sparse, B - Bidir Group, s - SSM Group, C - Connected,
       L - Local, P - Pruned, R - RP-bit set, F - Register flag,
       T - SPT-bit set, J - Join SPT, M - MSDP created entry,
       X - Proxy Join Timer Running, A - Candidate for MSDP Advertisement,
       U - URD, I - Received Source Specific Host Report, Z - Multicast Tunnel,
       Y - Joined MDT-data group, y - Sending to MDT-data group
Timers: Uptime/Expires
Interface state: Interface, Next-Hop, State/Mode

(*, 224.255.255.255), 2d16h/00:02:30, RP 172.16.10.13, flags: SJPC

(*, 224.2.127.253), 00:58:18/00:02:00, RP 172.16.10.13, flags: SJC

(*, 224.1.127.255), 00:58:21/00:02:03, RP 172.16.10.13, flags: SJC

(*, 224.2.127.254), 2d16h/00:00:00, RP 172.16.10.13, flags: SJCL
  (172.16.160.67, 224.2.127.254), 00:02:46/00:00:12, flags: CLJT
  (172.16.244.217, 224.2.127.254), 00:02:15/00:00:40, flags: CLJT
  (172.16.8.33, 224.2.127.254), 00:00:25/00:02:32, flags: CLJT
  (172.16.2.62, 224.2.127.254), 00:00:51/00:02:03, flags: CLJT
  (172.16.8.3, 224.2.127.254), 00:00:26/00:02:33, flags: CLJT
  (172.16.60.189, 224.2.127.254), 00:03:47/00:00:46, flags: CLJT


The following is sample output from the show ip mroute command with the active keyword:

Router# show ip mroute active 4

Active IP Multicast Sources - sending >= 4 kbps

Group: 224.2.127.254, (sdr.cisco.com)
   Source: 192.168.28.69 (mbone.ipd.anl.gov)
     Rate: 1 pps/4 kbps(1sec), 4 kbps(last 1 secs), 4 kbps(life avg)

Group: 224.2.201.241, ACM 97
   Source: 192.168.52.160 (webcast3-e1.acm97.interop.net)
     Rate: 9 pps/93 kbps(1sec), 145 kbps(last 20 secs), 85 kbps(life avg)

Group: 224.2.207.215, ACM 97
   Source: 192.168.52.160 (webcast3-e1.acm97.interop.net)
     Rate: 3 pps/31 kbps(1sec), 63 kbps(last 19 secs), 65 kbps(life avg)

Table 33 describes the significant fields shown in the displays.

Table 33 show ip mroute Field Descriptions 

Field
Description

Flags:

Provides information about the entry.

D—Dense. Entry is operating in dense mode.

S—Sparse. Entry is operating in sparse mode.

B—Bidir Group. Indicates that a multicast group is operating in bidirectional mode.

s—SSM Group. Indicates that a multicast group is within the SSM range of IP addresses. This flag is reset if the SSM range changes.

C—Connected. A member of the multicast group is present on the directly connected interface.

 

L—Local. The router itself is a member of the multicast group. Groups are joined locally by the ip igmp join-group command (for the configured group), the ip sap listen command (for the well-known session directory groups), and rendezvous point (RP) mapping (for the well-known groups 224.0.1.39 and 224.0.1.40). Locally joined groups are not fast switched.

P—Pruned. Route has been pruned. The Cisco IOS software keeps this information so that a downstream member can join the source.

R—RP-bit set. Indicates that the (S, G) entry is pointing toward the RP. This flag typically indicates a prune state along the shared tree for a particular source.

F—Register flag. Indicates that the software is registering for a multicast source.

T—SPT-bit set. Indicates that packets have been received on the shortest path source tree.

J—Join SPT. For (*, G) entries, indicates that the rate of traffic flowing down the shared tree is exceeding the SPT-Threshold set for the group. (The default SPT-Threshold setting is 0 kbps.) When the J - Join shortest path tree (SPT) flag is set, the next (S, G) packet received down the shared tree triggers an (S, G) join in the direction of the source, thereby causing the router to join the source tree.

Flags: (continued)

For (S, G) entries, indicates that the entry was created because the SPT-Threshold for the group was exceeded. When the J - Join SPT flag is set for (S, G) entries, the router monitors the traffic rate on the source tree and attempts to switch back to the shared tree for this source if the traffic rate on the source tree falls below the SPT-Threshold of the group for more than 1 minute.

 

Note The router measures the traffic rate on the shared tree and compares the measured rate to the SPT-Threshold of the group once every second. If the traffic rate exceeds the SPT-Threshold, the J - Join SPT flag is set on the (*, G) entry until the next measurement of the traffic rate. The flag is cleared when the next packet arrives on the shared tree and a new measurement interval is started.

If the default SPT-Threshold value of 0 kbps is used for the group, the J - Join SPT flag is always set on (*, G) entries and is never cleared. When the default SPT-Threshold value is used, the router immediately switches to the shortest path source tree when traffic from a new source is received.

M—MSDP created entry. Indicates that a (*, G) entry was learned through a Multicast Source Discovery Protocol (MSDP) peer. This flag is applicable only for an RP running MSDP.

 

E—Extranet source mroute entry. Indicates that a (*, G) or (S, G) entry in the VRF routing table is a source Multicast VRF (MVRF) entry and has extranet receiver MVRF entries linked to it.

X—Proxy Join Timer Running. Indicates that the proxy join timer is running. This flag is set only for (S, G) entries of an RP or "turnaround" router. A "turnaround" router is located at the intersection of a shared path (*, G) tree and the shortest path from the source to the RP.

A—Candidate for MSDP Advertisement. Indicates that an (S, G) entry was advertised through an MSDP peer. This flag is applicable only for an RP running MSDP.

U—URD. Indicates that a URL Rendezvous Directory (URD) channel subscription report was received for the (S, G) entry.

Flags: (continued)

I—Received Source Specific Host Report. Indicates that an (S, G) entry was created by an (S, G) report. This (S, G) report could have been created by Internet Group Management Protocol Version 3 (IGMPv3), URD, or IGMP v3lite. This flag is set only on the designated router (DR).

Z—Multicast Tunnel. Indicates that this entry is an IP multicast group that belongs to the Multicast Distribution Tree (MDT) tunnel. All packets received for this IP multicast state are sent to the MDT tunnel for decapsulation.

Y—Joined MDT-data group. Indicates that the traffic was received through an MDT tunnel that was set up specifically for this source and group. This flag is set in Virtual Private Network (VPN) mroute tables only.

 

y—Sending to MDT-data group. Indicates that the traffic was sent through an MDT tunnel that was set up specifically for this source and group. This flag is set in VPN mroute tables only.

Outgoing interface flags:

Provides information about the entry.

H—Hardware switched. Indicates that a multicast Multilayer Switching (MMLS) forwarding path has been established for this entry.

Timers:Uptime/Expires

"Uptime" indicates per interface how long (in hours, minutes, and seconds) the entry has been in the IP multicast routing table. "Expires" indicates per interface how long (in hours, minutes, and seconds) until the entry will be removed from the IP multicast routing table.

Interface state:

Indicates the state of the incoming or outgoing interface.

Interface. Indicates the type and number of the interface listed in the incoming or outgoing interface list.

Next-Hop or VCD. "Next-hop" specifies the IP address of the downstream neighbor. "VCD" specifies the virtual circuit descriptor number. "VCD0" means the group is using the static map virtual circuit.

State/Mode. "State" indicates that packets will either be forwarded, pruned, or null on the interface depending on whether there are restrictions due to access lists or a time-to-live (TTL) threshold. "Mode" indicates whether the interface is operating in dense, sparse, or sparse-dense mode.

(*, 224.0.255.1) and (192.168.37.100, 224.0.255.1)

Entry in the IP multicast routing table. The entry consists of the IP address of the source followed by the IP address of the multicast group. An asterisk (*) in place of the source router indicates all sources.

Entries in the first format are referred to as (*, G) or "star comma G" entries. Entries in the second format are referred to as (S, G) or "S comma G" entries. (*, G) entries are used to build (S, G) entries.

RP

Address of the RP router. For routers and access servers operating in sparse mode, this address is always 224.0.0.0.

flags:

Information about the entry.

Incoming interface:

Expected interface for a multicast packet from the source. If the packet is not received on this interface, it is discarded.

RPF neighbor or RPF nbr

IP address of the upstream router to the source. Tunneling indicates that this router is sending data to the RP encapsulated in register packets. The hexadecimal number in parentheses indicates to which RP it is registering. Each bit indicates a different RP if multiple RPs per group are used. If an asterisk (*) appears after the IP address in this field, the RPF neighbor has been learned through an assert.

Outgoing interface list:

Interfaces through which packets will be forwarded. When the ip pim nbma-mode command is enabled on the interface, the IP address of the Protocol Independent Multicast (PIM) neighbor is also displayed.


The following is sample output from the show ip mroute command with the count keyword:

Router# show ip mroute count

IP Multicast Statistics
4045 routes using 2280688 bytes of memory
41 groups, 97.65 average sources per group
Forwarding Counts:Pkt Count/Pkts per second/Avg Pkt Size/Kilobits per second
Other counts:Total/RPF failed/Other drops(OIF-null, rate-limit etc)

Group:239.0.18.1, Source count:200, Packets forwarded:348232, Packets received:348551
  RP-tree:Forwarding:12/0/218/0, Other:12/0/0
  Source:10.1.1.1/32, Forwarding:1763/1/776/9, Other:1764/0/1
  Source:10.1.1.2/32, Forwarding:1763/1/777/9, Other:1764/0/1
  Source:10.1.1.3/32, Forwarding:1763/1/783/10, Other:1764/0/1
  Source:10.1.1.4/32, Forwarding:1762/1/789/10, Other:1763/0/1
  Source:10.1.1.5/32, Forwarding:1762/1/768/10, Other:1763/0/1
  Source:10.1.1.6/32, Forwarding:1793/1/778/10, Other:1794/0/1
  Source:10.1.1.7/32, Forwarding:1793/1/763/10, Other:1794/0/1
  Source:10.1.1.8/32, Forwarding:1793/1/785/10, Other:1794/0/1
  Source:10.1.1.9/32, Forwarding:1793/1/764/9, Other:1794/0/1
  Source:10.1.1.10/32, Forwarding:1791/1/774/10, Other:1792/0/1
  Source:10.1.2.1/32, Forwarding:1689/1/780/10, Other:1691/0/2
  Source:10.1.2.2/32, Forwarding:1689/1/782/10, Other:1691/0/2
  Source:10.1.2.3/32, Forwarding:1689/1/776/9, Other:1691/0/2
.
.
.
Group:239.0.18.132, Source count:0, Packets forwarded:8810, Packets received:8810
  RP-tree:Forwarding:8810/7/780/49, Other:8810/0/0

Group:239.0.17.132, Source count:0, Packets forwarded:704491, Packets received:704491
  RP-tree:Forwarding:704491/639/782/4009, Other:704491/0/0

Group:239.0.17.133, Source count:0, Packets forwarded:704441, Packets received:704441
  RP-tree:Forwarding:704441/639/782/3988, Other:704441/0/0

Group:239.0.18.133, Source count:0, Packets forwarded:8810, Packets received:8810
  RP-tree:Forwarding:8810/8/786/49, Other:8810/0/0

Group:239.0.18.193, Source count:0, Packets forwarded:0, Packets received:0

Group:239.0.17.193, Source count:0, Packets forwarded:0, Packets received:0

Group:239.0.18.134, Source count:0, Packets forwarded:8803, Packets received:8803
  RP-tree:Forwarding:8803/8/774/49, Other:8803/0/0

Note The RP-tree field is displayed only for non-SSM groups that have a (*, G) entry and a positive packet received count.


The following is sample output from the show ip mroute command with the count and terse keywords:

Router# show ip mroute count terse

IP Multicast Statistics
4 routes using 2610 bytes of memory
3 groups, 0.33 average sources per group

Table 34 describes the significant fields shown in the displays.

Table 34 show ip mroute count Field Descriptions 

Field
Description

Group:

Summary statistics for traffic on an IP multicast group G. This row is displayed only for non-SSM groups.

Forwarding Counts:

Statistics on the packets that are received and forwarded to at least one interface.

Note There is no specific command to clear only the forwarding counters; you can clear only the actual multicast forwarding state with the clear ip mroute command. Issuing this command will cause interruption of traffic forwarding.

Pkt Count/

Total number of packets received and forwarded since the multicast forwarding state to which this counter applies was created.

Pkts per second/

Number of packets received and forwarded per second. On an IP multicast fast-switching platform, this number is the number of packets during the last second. Other platforms may use a different approach to calculate this number. Please refer to the platform documentation for more information.

Avg Pkt Size/

Total number of bytes divided by the total number of packets for this multicast forwarding state. There is no direct display for the total number of bytes. You can calculate the total number of bytes by multiplying the average packet size by the packet count.

Kilobits per second

Bytes per second divided by packets per second divided by 1000. On an IP multicast fast-switching platform, the number of packets per second is the number of packets during the last second. Other platforms may use a different approach to calculate this number. Please refer to the platform documentation for more information.

Other counts:

Statistics on the received packets. These counters include statistics about the packets received and forwarded and packets received but not forwarded.

Total/

Total number of packets received.

RPF failed/

Number of packets not forwarded due to a failed RPF or acceptance check (when bidir-PIM is configured).

Other drops (OIF-null, rate-limit etc)

Number of packets not forwarded for reasons other than an RPF or acceptance check (such as the OIF list was empty or because the packets were discarded because of a configuration, such as ip multicast rate-limit, was enabled).

Group:

Summary information about counters for (*, G) and the range of (S, G) states for one particular group G. The following RP-tree: and Source: output fields contain information about the individual states belonging to this group.

Note For SSM range groups, the groups displayed after the Group output field are statistical. All SSM range (S, G) states are individual, unrelated SSM channels.

Source count:

Number of (S, G) states for this group G. Individual (S, G) counters are detailed in the output field rows.

Packets forwarded:

The sum of the packets detailed in the Forwarding Counts fields for this IP multicast group G. This field is the sum of the RP-tree and all Source fields for this group G.

Packets received:

The sum of packets detailed in the Other counts fields for this IP multicast group G. This field is the sum of the Other counts and Pkt Count fields of the RP-tree and Source rows for this group G.

RP-tree:

Counters for the (*, G) state of this group G. These counters are displayed only for groups that have a forwarding mode that do not forward packets on the shared tree. These (*, G) groups are bidir-PIM and PIM sparse mode (PIM-SM) groups. There are no RP-tree displays for PIM dense mode (PIM-DM) and SSM range groups.

Source:

Counters for an individual (S, G) state of this group G. There are no (S, G) states for bidir-PIM groups.


Related Commands

Command
Description

clear ip mroute

Deletes entries from the mroute table.


show ip msdp count

To display the number of sources and groups originated in Multicast Source Discovery Protocol (MSDP) Source-Active (SA) messages and the number of SA messages from an MSDP peer in the SA cache, use the show ip msdp count command in user EXEC or privileged EXEC mode.

show ip msdp [vrf vrf-name] count [as-number]

Syntax Description

vrf

(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name assigned to the VRF.

as-number

(Optional) The number of sources and groups originated in SA messages from the specified autonomous system number.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.0(7)T

This command was introduced.

12.1(7)

This command was modified to display information about the number of SA messages from each MSDP peer in the SA cache.

12.0(23)S

The vrf keyword and vrf-name argument were added.

12.2(13)T

The vrf keyword and vrf-name argument were added.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720 only.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

The ip msdp cache-sa-state command must be configured for this command to have any output.

Examples

The following is sample output from the show ip msdp count command:

Router# show ip msdp count

SA State per Peer Counters, <Peer>: <# SA learned>
 224.135.250.116: 24
 172.16.240.253: 3964
 172.16.253.19: 10
 172.16.170.110: 11

SA State per ASN Counters, <asn>: <# sources>/<# groups>
 Total entries: 4009
 ?: 192/98, 9: 1/1, 14: 107/57, 17: 7/5
 18: 4/3, 25: 23/17, 26: 39/27, 27: 2/2
 32: 19/7, 38: 2/1, 52: 4/4, 57: 1/1
 68: 4/4, 73: 12/8, 81: 19/1, 87: 9/6
 .
 .
 .

Table 35 describes the significant fields shown in the display.

Table 35 show ip msdp count Field Descriptions 

Field
Description

224.135.250.116: 24

MSDP peer with IP address 224.135.250.116: 24 SA messages from the MSDP peer in the SA cache.

Total entries

Total number of SA entries in the SA cache.

9: 1/1

Autonomous system 9: 1 source/1 group.


Related Commands

Command
Description

ip msdp cache-sa-state

Enables the router to create SA state.


show ip msdp peer

To display detailed information about Multicast Source Discovery Protocol (MSDP) peers, use the show ip msdp peer command in user EXEC or privileged EXEC mode.

show ip msdp [vrf vrf-name] peer [peer-address | peer-name] [accepted-sas | advertised-sas]

Syntax Description

vrf vrf-name

(Optional) Displays information about MSDP peers associated with the Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.

peer-address | peer-name

(Optional) Domain Name System (DNS) name or IP address of the MSDP peer for which information is displayed.

accepted-sas

(Optional) Displays information about Source-Active (SA) messages received by the MSDP peer.

advertised-sas

(Optional) Displays information about SA messages advertised to the MSDP peer.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.0(7)T

This command was introduced.

12.1(7)

This command was modified to display information about the Source Active (SA) message limit configured using the ip msdp sa-limit command.

12.0(23)S

The vrf keyword and vrf-name argument were added.

12.2(13)T

The vrf keyword and vrf-name argument were added.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720 only.

12.4(2)T

This command was modified to display whether an MSDP peer has message digest 5 (MD5) password authentication enabled.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.


Examples

The following is sample output from the show ip msdp peer command:

Router# show ip msdp peer 224.135.250.116

MSDP Peer 224.135.250.116 (rtp5-rp1.cisco.com), AS 109 (configured AS)
Description:
 Connection status:
   State: Up, Resets: 9, Connection source: Loopback2 (228.69.199.17)
   Uptime(Downtime): 1d10h, Messages sent/received: 436765/429062
   Output messages discarded: 0
   Connection and counters cleared 1w2d     ago
 SA Filtering:
   Input (S,G) filter: none, route-map: none
   Input RP filter: none, route-map: none
   Output (S,G) filter: none, route-map: none
   Output RP filter: none, route-map: none
 SA-Requests:
   Input filter: none
   Sending SA-Requests to peer: disabled
 Peer ttl threshold: 0
 SAs learned from this peer: 32, SAs limit: 500
 Input queue size: 0, Output queue size: 0

Table 36 describes the significant fields shown in the display.

Table 36 show ip msdp peer Field Descriptions 

Field
Description

MSDP Peer

IP address of the MSDP peer.

AS

Autonomous system to which the MSDP peer belongs.

State:

State of the MSDP peer.

Connection source:

Interface used to obtain the IP address for the TCP local connection address.

Uptime (Downtime):

Days and hours the MSDP peer is up or down. If the time is less than 24 hours, it is shown in terms of hours:minutes:seconds.

Messages sent/received:

Number of SA messages sent to the MSDP peer/number of SA messages received from the MSDP peer.

SA Filtering:

Information regarding access list filtering of SA input and output, if any.

SA-Requests:

Information regarding access list filtering of SA requests, if any.

SAs learned from this peer:

Number of SA messages from the MSDP peer in the SA cache.

SAs limit:

SA message limit for this MSDP peer.


Related Commands

Command
Description

ip msdp peer

Configures an MSDP peer.


show ip msdp rpf-peer

To display the unique Multicast Source Discovery Protocol (MSDP) peer information from which a router will accept Source-Active (SA) messages originating from the specified rendezvous point (RP), use the show ip msdp rpf-peer command in user EXEC or privileged EXEC mode.

show ip msdp [vrf vrf-name] rpf-peer rp-address

Syntax Description

vrf vrf-name

(Optional) Displays MSDP information about a peer from which the router will accept SA messages that originated from an RP associated with Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.

rp-address

Address of the rendezvous point (RP).


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.3(4)T

This command was introduced.

12.0(27)S

This command was integrated into Cisco IOS Release 12.0(27)S.

12.2(25)S

This command was integrated into Cisco IOS Release 12.2(25)S.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.


Usage Guidelines

Use this command when you need MSDP information about a peer from which the router will accept SA messages that originated from an RP. The ip msdp rfc-3618 rpf-rules command must be configured for the show ip msdp rpf-peer command to generate output.

Examples

The following is sample output for the show ip msdp rpf-peer command:

Router# show ip msdp rpf-peer 10.0.0.0

RPF peer information for ? (25.8.8.8) 
RPF peer: ? (2.2.2.3) 
RPF route/mask: 0.0.0.0/0 
RPF rule: Peer is IGP next hop of best route 
RPF type: unicast (rip) 

Table 37 describes the significant fields shown in the display.

Table 37 show ip msdp rpf Field Descriptions 

Field
Description

RPF peer information for

Reverse Path Forwarding (RPF) peer address for the specified RP address. The question mark (?) indicates that the system does not find a name for that particular address.

RPF peer:

Peer address from which this device would accept MSDP SAs originated by the specified RP address. The question mark (?) indicates that the system does not find a name for that particular address.

RPF route/mask:

Network and mask of the RP address that the system determines from the route lookups that it used to choose the RPF peer.

RPF rule:

Rule used to determine the RPF peer for the specified RP address.

RPF type:

Route lookup or protocol used to choose the RPF peer for the specified RP address.


Related Commands

Command
Description

ip msdp rpf rfc3618

Enables IETF RFC 3618-compliant MSDP peer-RPF forwarding rules.


show ip msdp sa-cache

To display the (S,G) state learned from Multicast Source Discovery Protocol (MSDP) peers, use the show ip msdp sa-cache command in user EXEC or privileged EXEC mode.

show ip msdp [vrf vrf-name] sa-cache [group-address | source-address | group-name | source-name] [group-address | source-address | group-name | source-name] [as-number] [rejected-sa [detail] [read-only]]

Syntax Description

vrf

(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name assigned to the VRF.

group-address | source-address | group-name | source-name

(Optional) Group address, source address, group name, or source name of the group or source about which (S, G) state information is displayed. If two addresses or names are specified, an (S, G) entry corresponding to those addresses is displayed. If only one group address is specified, all sources for that group are displayed.

If no options are specified, the entire Source-Active (SA) cache is displayed.

as-number

(Optional) Autonomous system (AS) number from which the SA message originated.

rejected-sa

(Optional) Displays the most recently received and rejected MSDP SA messages.

detail

(Optional) Displays detailed information about the IP address of the MSDP peer that sent the SA message and the reason that the SA message was rejected.

read-only

(Optional) Checkpoints the rejected SA cache. Once checkpointed, the rejected SA cache is emptied.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.0(7)T

This command was introduced.

12.0(23)S

The vrf keyword and vrf-name argument were added.

12.2(13)T

The vrf keyword and vrf-name argument were added.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

By default, (S,G) state is cached.

Rejected SA messages are cached only if the ip msdp cache-rejected-sa command is configured.

Use the show ip msdp sa-cache with the optional rejected-sa keyword to display SA messages stored in the rejected SA cache. When the detail keyword is added to the command string, the output includes the IP address of the MSDP peer router that sent the SA message and the reason that the SA message was rejected.

When the optional read-only keyword is added to the command string, the router checkpoints the rejected SA cache, which ensures that a consistent snapshot of the rejected SA cache is displayed in the output. After being checkpointed, the rejected SA cache is cleared.


Note Checkpointing the rejected SA cache requires that the router make a second copy of the rejected SA cache, which could cause the command to fail if the router is low on memory.


When the optional read-only keyword is not added to the command string, the router displays rejected MSDP SA messages out of the active rejected SA cache, which could result in inconsistent display output if rejected SA message entries are overwritten by rejected SA message entries that are captured as the output is being processed for display.

Examples

The following is sample output from the show ip msdp sa-cache command:

Router# show ip msdp sa-cache

MSDP Source-Active Cache - 2398 entries
(172.16.41.33, 238.105.148.0), RP 172.16.3.111, MBGP/AS 704, 2d10h/00:05:33
(172.16.112.8, 224.2.0.1), RP 192.168.200.65, MBGP/AS 10888, 00:03:21/00:02:38
(172.16.10.13, 227.37.32.1), RP 192.168.3.92, MBGP/AS 704, 05:22:20/00:03:32
(172.16.66.18, 233.0.0.1), RP 192.168.3.111, MBGP/AS 704, 2d10h/00:05:35
(172.16.66.148, 233.0.0.1), RP 192.168.3.111, MBGP/AS 704, 2d10h/00:05:35
(172.16.10.13, 227.37.32.2), RP 192.168.3.92, MBGP/AS 704, 00:44:30/00:01:31
(172.16.70.203, 224.2.236.2), RP 192.168.253.7, MBGP/AS 3582, 02:34:16/00:05:49
(172.18.42.104, 236.195.56.2), RP 192.168.3.92, MBGP/AS 704, 04:21:13/00:05:22
(172.16.10.13, 227.37.32.3), RP 192.168.3.92, MBGP/AS 704, 00:44:30/00:02:31
(172.18.15.43, 224.0.92.3), RP 192.168.200.65, MBGP/AS 10888, 6d09h/00:05:35
(172.18.15.111, 224.0.92.3), RP 192.168.200.65, MBGP/AS 10888, 16:18:08/00:05:35
(172.18.21.45, 224.0.92.3), RP 192.168.200.65, MBGP/AS 10888, 16:18:08/00:05:35
(172.18.15.75, 224.0.92.3), RP 192.168.200.65, MBGP/AS 10888, 08:40:52/00:05:35
(172.18.15.100, 224.0.92.3), RP 192.168.200.65, MBGP/AS 10888, 08:40:52/00:05:35
(172.16.10.13, 227.37.32.6), RP 192.168.3.92, MBGP/AS 704, 00:45:30/00:05:31
(172.18.41.33, 224.247.228.10), RP 192.168.3.111, MBGP/AS 704, 2d10h/00:05:35
(172.18.222.210, 224.2.224.13), RP 192.168.3.92, MBGP/AS 704, 01:51:53/00:05:22
(172.18.41.33, 229.231.124.13), RP 192.168.3.111, MBGP/AS 704, 2d10h/00:05:33
(172.18.32.138, 224.2.200.23), RP 192.168.253.7, MBGP/AS 3582, 21:33:40/00:05:49
(172.18.75.244, 224.2.200.23), RP 192.168.253.7, MBGP/AS 3582, 21:33:40/00:05:49

Table 38 describes the significant fields shown in the display.

Table 38 show ip msdp sa-cache Field Descriptions 

Field
Description

(172.16.41.33, 238.105.148.0)

Indicates that the first address (source) is sending to the second address (group).

RP 172.16.3.111

IP address of the Rendezvous point (RP) where the SA message originated.

MBGP/AS 704

Indicates that the RP from which the SA message originated is in AS 704 according to multiprotocol Border Gateway Protocol (BGP).

2d10h/00:05:33

The route has been cached for 2 days and 10 hours. If no SA message is received in 5 minutes and 33 seconds, the route will be removed from the SA cache.


The following is sample output from the show ip msdp sa-cache command with the rejected, detail, and read-only keywords specified:

Router# show ip msdp sa-cache rejected detail read-only

MSDP Rejected SA Cache
 35 rejected SAs received over 02:50:01, cache size: 50 entries
 Timestamp (source, group)
 2832.248, (10.10.10.4, 227.7.7.12), RP: 10.10.10.4, Peer: 10.10.10.4,
     Reason: sa-limit-exceeded
 2915.232, (10.10.10.8, 224.1.1.1), RP: 10.11.11.11, Peer: 10.10.10.8,
     Reason: in-filter
 3509.584, (10.12.12.2, 225.5.5.5), RP: 10.15.15.1, Peer: 10.12.12.2,
            Reason: rpf-fail
 .
 .
 .

Table 39 describes the significant fields shown in the display.

Table 39 show ip msdp sa-cache rejected detail read-only Field Descriptions 

Field
Description

35 rejected SAs received over 02:50:01

The number of rejected SA message entries received in the length of time indicated in HH:MM:SS.

cache size:

Indicates the size of the rejected SA cache. This field is controlled by the ip msdp rejected-sa-cache command. If the rejected SA cache overflows, entries are overwritten, starting from the first entry.

Timestamp

Indicates the router uptime in seconds.milliseconds.

(source, group)

The (S, G) information advertised in the rejected SA message.

RP:

Indicates the IP address of the Rendezvous Point (RP) that originated the SA message.

Peer:

Indicates the IP address of the MSDP peer that sent the rejected SA message.

Reason:

Indicates the reason that the router rejected the SA message.

The possible reasons are as follows:

autorp-group—Indicates that the SA message was rejected because it included one of the two AutoRP groups (224.0.1.39 and 224.0.1.40).

in-filter—Indicates that the SA message was rejected because it was filtered by a configured incoming filter list (configured by the ip msdp sa-filter in command).

no-memory—Indicates that the SA message was rejected because the router ran out of memory while allocating storage for the MSDP SA message.

rpf-fail—Indicates that the SA message was rejected because it failed the Reverse Path Forwarding (RPF) check.

rp-filter—Indicates that the SA message was rejected because it was filtered by a configured incoming RP filter list (configured by the ip msdp sa-filter in command).

sa-limit-exceededIndicates that the SA message was rejected because the maximum number of SA cache entries (controlled by the ip msdp sa-limit command) was already exhausted when the SA message was received.

ssm-range—Indicates that the SA message was rejected because it indicated a group in the SSM range.


Related Commands

Command
Description

clear ip msdp sa-cache

Clears MSDP SA cache entries.

ip msdp cache-sa-state

Enables the router to create SA state.


show ip msdp summary

To display Multicast Source Discovery Protocol (MSDP) peer status, use the show ip msdp summary command in user EXEC or privileged EXEC mode.

show ip msdp [vrf vrf-name] summary

Syntax Description

vrf

(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.

vrf-name

(Optional) Name assigned to the VRF.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.0(7)T

This command was introduced.

12.1(7)

This command was modified to display information about the number of Source-Active (SA) messages from each MSDP peer in the SA cache.

12.0(23)S

The vrf keyword and vrf-name argument were added.

12.2(13)T

The vrf keyword and vrf-name argument were added.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720 only.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.


Examples

The following is sample output from the show ip msdp summary command:

Router# show ip msdp summary

MSDP Peer Status Summary
Peer Address     AS    State    Uptime/  Reset SA    Peer Name
                                Downtime Count Count
224.135.250.116  109   Up       1d10h    9     111   rtp5-rp1
*172.20.240.253 1239  Up       14:24:00 5     4010  sl-rp-stk
172.16.253.19    109   Up       12:36:17 5     10    shinjuku-rp1
172.16.170.110   109   Up       1d11h    9     12    ams-rp1

Table 40 describes the significant fields shown in the display.

Table 40 show ip msdp summary Field Descriptions 

Field
Description

Peer Address

IP address of the MSDP peer.

AS

Autonomous system to which the MSDP peer belongs.

State

State of the MSDP peer.

Uptime/Downtime

Days and hours the MSDP peer is up or down, per state shown in the previous column. If the time is less than 24 hours, it is shown in terms of hours:minutes:seconds.

SA Count

Number of SA messages from this MSDP peer in the SA cache.

Peer Name

Name of the MSDP peer.


show ip multicast

To display general information about IP multicast, including information about interfaces configured for IP multicast and information about mroute state limits configured on interfaces, use the show ip multicast command in user EXEC or privileged EXEC mode.

show ip multicast [vrf vrf-name] [interface | limit] [type number]

Syntax Description

vrf vrf-name

(Optional) Restricts the output to the Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.

interface

(Optional) Displays IP multicast-related information about interfaces configured for IP multicast.

limit

(Optional) Displays information about mroute state limiters configured on interfaces.

type number

(Optional) Interface type and number for which to display IP multicast information.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.3(14)T

This command was introduced.

12.2(33)SRB

This command was integrated into Cisco IOS Release 12.2(33)SRB.


Usage Guidelines

Use the show ip multicast command with no optional keywords or arguments to display general information about the state of IP multicast on the router.

Use the show ip multicast command with the interface keyword to display information about interfaces configured for IP multicast.

Use the show ip multicast command with the limit keyword to display counters related to mroute state limiters configured on an interface. When mroute state limiters are configured on interfaces, each time the state for an mroute is created or deleted and each time an outgoing interface list (olist) member is added or removed, the counters that are displayed in the output of the show ip multicast limit command are increased or decreased accordingly. The output for this command also accounts for each time an mroute is denied due to an mroute state limit being reached.

Use the clear ip multicast limit command to clear mroute state limit exceeded counters.

Examples

The following is sample output from the show ip multicast command. The output is self-explanatory.

Router# show ip multicast

   Multicast Routing: enabled
   Multicast Multipath: disabled
   Multicast Route limit: No limit
   Multicast Triggered RPF check: enabled

The following is sample output from the show ip multicast command with the interface keyword and type number arguments. The output is self-explanatory.

Router# show ip multicast interface ethernet 1/0 

Ethernet1/0 is up, line protocol is up
  Internet address is 10.1.1.1/24
  Multicast routing: enabled
  Multicast switching: fast
  Multicast packets in/out: 0/0
  Multicast TTL threshold: 0
  Multicast Tagswitching: disabled

The following is sample output from show ip multicast command with the limit keyword and type number arguments. In this example, information about mroute state limits configured on Ethernet interface 1/0 are displayed.

Router# show ip multicast limit ethernet 1/0

Interface Ethernet1/0
 Multicast Access Limits
out acl out-list (1 < max 32) exceeded 0
rpf acl rpf-list (6 < max 32) exceeded 0
con acl conn-list (0 < max 32) exceeded 0

The following is sample output from the show ip multicast command with the limit keyword and type number arguments. In this example, the output displays information about the mroute state limits configured on Ethernet interface 0/2. The "exceeded" counter indicates that the state for 36 mroutes has been denied due to the mroute limit being reached for a configured mroute state limit.

Router# show ip multicast limit ethernet 0/2

Interface Ethernet0/2

 Multicast Access Limits
i+o acl std-list (15 < max 16) exceeded 36

Related Commands

Command
Description

clear ip multicast limit

Resets exceeded counters for mroute state limiters.

debug ip mrouting limits

Displays debugging information for mroute state limiters configured on interfaces.

ip multicast limit

Configures mroute state limiters on an interface.

ip multicast limit cost

Applies costs to mroute state limiters.


show ip multicast limit

To display statistics about configured per interface mroute state limiters, use the show ip multicast limit command in user EXEC or privileged EXEC mode.

show ip multicast limit [type number]

Syntax Description

type number

(Optional) Interface type and number for which to display information about configured per interface mroute state limiters.


Command Default

Statistics about all per interface mroute state limiters configured on all interfaces on the router are displayed.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.3(14)T

This command was introduced.

12.2(33)SRB

This command was integrated into Cisco IOS Release 12.2(33)SRB.

12.2(33)SXI

This command was integrated into Cisco IOS Release 12.2(33)SXI.


Usage Guidelines

Use the show ip multicast limit command to display counters related to per interface mroute state limiters (configured with the ip multicast limit command).

For each per interface mroute state limiter shown in the output, the following information is displayed:

The direction of traffic that the per mroute state limiter is limiting.

The access control list (ACL) referenced by the per interface mroute state limiter that defines the IP multicast traffic being limited.

Statistics, enclosed in parenthesis, that track the current number of mroutes being limited less the configured limit. Each time the state for an mroute is created or deleted and each time an outgoing interface list (olist) member is added or removed, the counters for matching per interface mroute state limiters are increased or decreased accordingly.

The exceeded counter, which tracks the total number of times that the limit configured for the per interface mroute state limiter has been exceeded., Each time an mroute is denied due to limit configured for being reached, the exceeded counter is increased by a value of 1.

Issuing the show ip multicast limit command with the optional type and number argument restricts the output to displaying only statistics about per interface mroute state limiters configured on the specified interface.

Use the clear ip multicast limit command to reset the exceeded counter for per interface mroute state limiters.

Examples

The following is sample output from show ip multicast limit command with an interface specified for the optional type number arguments. In this example, statistics about per interface mroute state limiters configured on Gigabit Ethernet interface 1/0 are displayed.

Router# show ip multicast limit GigabitEthernet 1/0

Interface GigabitEthernet1/0
 Multicast Access Limits
out acl out-list (1 < max 32) exceeded 0
rpf acl rpf-list (6 < max 32) exceeded 0
con acl conn-list (0 < max 32) exceeded 0

The following is sample output from the show ip multicast limit command with an interface specified for the optional type number arguments. In this example, the output displays information about per interface mroute state limiters configured on Gigabit Ethernet interface 0/2. The output shows that the configured limit has been exceeded 36 times since it was last reset.

Router# show ip multicast limit GigabitEthernet 0/2

Interface GigabitEthernet0/2

 Multicast Access Limits
i+o acl std-list (15 < max 16) exceeded 36

Related Commands

Command
Description

clear ip multicast limit

Resets the exceeded counter for per interface mroute state limiters.

debug ip mrouting limits

Displays debugging information about configured per interface mroute state limiters and bandwidth-based multicast CAC policies.

ip multicast limit

Configures per interface mroute state limiters.

ip multicast limit cost

Applies costs to per interface mroute state limiters.


show ip multicast redundancy state

To display information about the current IP multicast redundancy state, use the show ip multicast redundancy state command in user EXEC or privileged EXEC mode.

show ip multicast redundancy state

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SXI

This command was introduced.


Usage Guidelines

Use this command to display the current IP multicast redundancy state of the Route Processors (RPs). The output displays information about the current multicast redundancy state of the RPs and the current synchronization state of the standby RP.

Examples

The following example shows sample output from the show ip multicast redundancy state command:

Router# show ip multicast redundancy state

Multicast Redundancy state:   SSO
Sync message epoch:           0
Sync message sequence number: 11
Stale NSF state flush timeout: 30000 ms
Current sync state: Synched

Table 41 describes the fields shown in the display.

Table 41 show ip multicast redundancy state Field Descriptions 

Field
Description

Multicast Redundancy state:

Indicates the current redundancy state of the RPs.

Sync message epoch:

Internal qualifier for the synchronization message sequence number.

Sync message sequence number:

Internal sequence number assigned to a synchronization message within a synchronization message epoch.

Stale NSF state flush timeout:

Indicates the nonstop forwarding (NSF) state flush timeout period.

Note In the event of an RP switchover, this timeout period occurs after unicast and multicast reconvergence. The timeout period is the delay between the downloading of refreshed multicast control plane route information to the forwarding plane and the flushing of stale (NSF) forwarding plane information that was retained from before the RP switchover. The default timeout period is 30000 milliseconds (ms).

Current sync state:

Current synchronization state of the standby RP.


Related Commands

Command
Description

debug ip multicast redundancy

Displays information about IP multicast redundancy events.

show ip multicast redundancy statistics

Displays IP multicast redundancy statistics.


show ip multicast redundancy statistics

To display IP multicast redundancy statistics, use the show ip multicast redundancy statistics command in user EXEC or privileged EXEC mode.

show ip multicast redundancy statistics

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SXI

This command was introduced.


Usage Guidelines

Use the show ip multicast redundancy statistics command to display IP multicast redundancy statistics. The output displays the following information:

Statistics about the internal multicast forwarding databases that are synchronized between the active and standby Route Processor (RP), including the number of updates that required standby RP synchronization, number of updates synchronized by the standby RP, and number of updates that failed synchronization.

Statistics about internal synchronization message requests for updates between the active and standby RPs.

Statistics that measure the load on the internal synchronization message sending mechanism.

Use the clear ip multicast redundancy statistics command to reset IP multicast redundancy statistics.

Examples

The following example shows sample output from the show ip multicast redundancy statistics command:

Router# show ip multicast redundancy statistics

Multicast Redundancy Statistics
Sync Type              Updates       Syncs        Sync failures

RP mapping              4            4            0           
Bidir. RP route info    0            0            0           
Bootstrap cache         4            4            0           
Autorp discovery IDB    4            4            0           
RPDF                    0            0            0           
MDT tunnel              3            3            0           
PIM register tunnel     0            0            0           

Requests Awaiting Sync Msg Transmission: 0
Requests Awaiting Sync Msg Acknowledgement: 0
Average Sync Wait Time = 0 ms
Average Sync Ack Time = 71 ms

Table 42 describes the significant fields shown in the display.

Table 42 show ip multicast redundancy statistics Field Descriptions 

Field
Description

Sync Type

Displays statistics about the internal multicast forwarding databases that are synchronized between the active and standby RP.

The following internal multicast forwarding databases are synchronized between the active and standby RPs:

RP mapping—Internal database that stores group-to-RP mapping information for synchronization.

Bidir. RP route info—Internal database that stores bidir-PIM RP route information for synchronization.

Bootstrap cache—Internal database that stores BSR candidate information for synchronization.

AutoRP discovery IDB—Internal database that stores AutoRP discovery message information for synchronization.

RPDF—Internal database that stores bidir-PIM information for synchronization.

MDT tunnel—Internal database that stores MVPN Multicast Distribution Tree (MDT) tunnel information for synchronization.

PIM register tunnel—Internal database that stores Protocol Independent Multicast (PIM) register tunnel information for synchronization.

Updates

Tracks the number of updates that required standby RP synchronization for each of the internal multicast forwarding databases.

If the number of updates displayed under the "Updates" column for an internal multicast forwarding database matches the number of synchronizations displayed under the "Syncs" column, it can be inferred that the standby RP is currently synchronized.

Note Over time, however, the number of updates for a given multicast forwarding database is expected to exceed the number of synchronizations. In normal operating conditions, this disparity is usually due to update bundling: when several updates are sent simultaneously (or within a relatively short period of time), the Cisco IOS software will bundle the updates together when synchronizing data on the standby RP.

 

Note If the number of updates exceeds the number of synchronizations because of a synchronization failure, then the number displayed under "Sync failures" will also increment.

Syncs

Number of times that the data for a given internal multicast forwarding database has been synchronized on the standby RP.

Sync failures

Number of times that synchronization of data for a given internal multicast forwarding database failed on the standby RP.

Tip The show ip multicast redundancy state command can be used to determine the synchronization state after a synchronization failure. When the standby RP has been resynchronized after a failure, the current state shown in the "Current sync state" field will display "Synched."

Note Whether the standby RP has been resynchronized on the standby RP can also be inferred by the output of the show ip multicast redundancy statistics command. For example, if the number displayed under the "Syncs" column increments after a synchronization failure, then it can be inferred that the standby RP has been resynchronized.

Note An alternative way to determine whether the standby RP has been resynchronized is to examine the "Requests Awaiting Sync Msg Transmission" and the "Requests Awaiting Sync Msg Acknowledgement" fields. The value displayed for these fields will normally be zero (except in situations where the system is under heavy load). In the event of a synchronization failure, the number of synchronization message requests for updates awaiting transmission and acknowledgement will begin accumulating in the queue; the values displayed for those fields, thus, will increment accordingly. After the standby RP recovers from the failure and resynchronizes, the value displayed for those fields will return to zero.

Requests Awaiting Sync Msg Transmission:

Synchronization message requests that are in the queue for transmission from the active RP to the standby RP.

Requests Awaiting Sync Msg Acknowledgement:

Synchronization message requests that are in transit awaiting acknowledgement from the standby RP.

Average Sync Wait Time =

Displays the average time, in milliseconds (ms), that a synchronization message request for an update waits in the queue before being sent to the standby RP.

Note Both this field and the "Average Sync Ack Time =" field can be interpreted as a measure of how heavy the load is on the synchronization message sending mechanism. The average wait time for a synchronization message request in the queue will generally be very low (even on a heavily loaded system). On a lightly loaded system, the value displayed for this field may even appear as 0 ms (when the wait time is less than half of a millisecond, the system will round down to zero).

Average Sync Ack Time =

Displays the average roundtrip time of synchronization message requests for updates, in milliseconds (ms). The average for the roundtrip time is based on the time between when messages are sent to the standby RP for acknowledgement to time at which the active RP receives acknowledgements from the standby RP for those messages.

Note The average time that is displayed for this field will always be higher than the average time displayed for the "Average Sync Wait Time" field; however—even on a heavily loaded system—the average time displayed for this field will generally be very low.


Related Commands

Command
Description

clear ip multicast redundancy statistics

Resets IP multicast redundancy statistics.

debug ip multicast redundancy

Displays information about IP multicast redundancy events.


show ip multicast rpf tracked

To display IP multicast Return Path Forwarding (RPF) tracked information, use the show ip multicast rpf tracked command in user EXEC or privileged EXEC mode.

show ip multicast rpf tracked

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

15.0(1)M

This command was introduced.


Examples

The following is sample output from the show ip multicast rpf tracked command.

Router# show ip multicast rpf tracked

RPF interface: Ethernet0
  RPF neighbor: ? (10.0.10.2)
  RPF route/mask: 10.0.33.0/16
  RPF type: unicast (eigrp 1)
  RPF recursion count: 0

Related Commands

Command
Description

debug ip multicast rpf tracked

Displays information about IP multicast rpf tracked events.


show ip pgm host defaults


Note Support for the PGM Host feature has been removed. Use of this command is not recommended.


To display the default values for Pragmatic General Multicast (PGM) Host traffic, use the show ip pgm host defaults command in user EXEC or privileged EXEC mode.

show ip pgm host defaults

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.1(1)T

This command was introduced.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

The default values displayed in the show ip pgm host defaults command output are applied to every new host connection that is opened.

Examples

The following is sample output from the show ip pgm host defaults user EXEC command:

Router> show ip pgm host defaults

Source Session Default Values :
 
    spm-ambient-ivl (6000), txw-adv-secs (6000)
    txw-adv-timeout-max (3600000), txw-rte (16384), txw-secs (30000)
    ncf-max (infinite), spm-rpt-ivl (3000), ihb-min (1000)
    ihb-max (10000), join (0), tpdu-size (16384)
    txw-adv-method (time), tx-buffer-mgmt (return)
 
Receiver Session Default Values :
 
    nak-gen-ivl (60000), nak-rb-ivl (500), nak-rdata-ivl (2000)
    nak-rpt-ivl (2000), rx-buffer-mgmt (minimum), rx-local-retrans (none)
 
Common Default Values:
 
    stream-type (apdu), ttl (255)

Address used to source packets:(10.1.1.1)

Table 43 describes the fields and default values in the sample output.

Table 43 show ip pgm host defaults Field Descriptions 

Field
Description

Source Session Default Values

Displays the values for source-specific PGM Host traffic defaults.

spm-ambient-ivl (6000)

Amount of time, in milliseconds, the PGM Host waits for a PGM source path message (SPM) ambient data packet. The default is 6000 ms.

txw-adv-secs (6000)

Amount of time, in milliseconds, of the advanced transmit window for the PGM Host. The default is 6000 ms.

txw-adv-timeout-max (3600000)

Amount of time, in milliseconds, the PGM Host waits for data packets, even if the PGM Host receives PGM NAK data packets. The default is 3600000 ms.

txw-rte (16384)

The data transmit rate, in bytes-per-second, for the PGM Host. The default is 16384 bytes per second.

txw-secs (30000)

Data transmit window size, in milliseconds, for the PGM Host. The default is 30000 ms.

ncf-max (infinite)

Maximum number of PGM NAK confirmation data packets (NAK NCFs), in packets per second, the PGM Host sends per second. The default is infinite.

spm-rpt-ivl (3000)

Amount of time, in milliseconds, the PGM Host waits for a PGM SPM repeat data packet. The default is 3000 ms.

ihb-min (1000)

SPM interheartbeat timer minimum, in milliseconds. The default is 1000 ms.

ihb-max (10000)

SPM interheartbeat timer maximum, in milliseconds. The default is 10000 milliseconds (ms).

join (0)

Amount of time, in milliseconds, the PGM Host waits, when running in router mode, for client requests. The default is 0 ms.

tpdu-size (16384)

Size of the source transport data unit (TPDU) for the PGM Host. The available range is 41 through 16384 bytes. The default is 1400 bytes.

tx-adv-method (time)

Type of advanced transmit window method (data or time) for the PGM Host. The default is time.

tx-buffer-mgmt (return)

Type of transmit data buffers (keep or return) for the PGM Host. The default is return.

Receiver Session Default Values

Displays the values for receiver-specific PGM Host traffic defaults.

nak-gen-ivl (60000)

Amount of time, in milliseconds, the PGM Host waits for a PGM negative acknowledgment (NAK) data packet. The default is 60000 ms.

nak-rb-ivl (500)

Amount of time, in milliseconds, the PGM Host waits before sending a PGM NAK data packet. The default is 500 ms.

nak-rdata-ivl (2000)

Amount of time, in milliseconds, the PGM Host waits for a re-sent PGM NAK (NAK RDATA) data packet. The default is 2000 ms.

nak-rpt-ivl (2000)

Amount of time, in milliseconds, the PGM Host waits for a PGM NAK confirmation (NAK NCF) data packet. The default is 2000 ms.

rx-buffer-mgmt (minimum)

Type of receive data buffers (full or minimum) for the PGM Host. The default is minimum.

rx-local-retrans (none)

Specifies whether a receiver has to do local retransmissions or not if it sees NAKs.

Common Default Values

Displays the values for PGM Host traffic defaults that are common between a source and a receiver.

stream-type (apdu)

Data stream type (apdu or byte) for the PGM Host. The default is apdu.

ttl (255)

Time-to-live (TTL) value on the PGM Host for sent multicast data packets. The default is 255 hops. The TTL value for a packet is decremented by 1 as the packet passes through a router.

Address used to source packets

The unicast IP address that the virtual host is using to originate PGM packets.


Related Commands

Command
Description

clear ip pgm host

Resets PGM Host connections to their default values and clears traffic statistics.

ip pgm host

Enables PGM Host.

show ip pgm host sessions

Displays open PGM Host traffic sessions.

show ip pgm host traffic

Displays PGM Host traffic statistics.


show ip pgm host sessions


Note Support for the PGM Host feature has been removed. Use of this command is not recommended.


To display open Pragmatic General Multicast (PGM) Host traffic sessions, use the show ip pgm host sessions command in user EXEC or privileged EXEC mode.

show ip pgm host sessions [session-number | group-address]

Syntax Description

session-number

(Optional) PGM Host traffic session number.

group-address

(Optional) PGM Host multicast group address.


Defaults

No default behavior or values

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.1(1)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

If a session number or multicast group address is not specified, all open traffic sessions are displayed.

Examples

The following user EXEC example shows all open traffic sessions:

Router> show ip pgm host sessions

Idx  GSI           Source Port  Type     State   Dest Port  Mcast Address
1    000000000000  0            receiver listen  48059      224.3.3.3
2    9CD72EF099FA  1025         source   conn    48059      224.1.1.1

The following user EXEC example shows traffic information for traffic session number 2:

Router> show ip pgm host sessions 2

Idx  GSI           Source Port  Type     State   Dest Port  Mcast Address
2    9CD72EF099FA  1025         source   conn    48059      224.1.1.1
 
    stream-type (apdu), ttl (255)
 
    spm-ambient-ivl (6000), txw-adv-secs (6000)
    txw-adv-timeout-max (3600000), txw-rte (16384), txw-secs (30000)
    ncf-max (infinite), spm-rpt-ivl (3000), ihb-min (1000)
    ihb-max (10000), join (0), tpdu-size (16384)
    txw-adv-method (time), tx-buffer-mgmt (return)
 
    ODATA packets sent                       0
          bytes sent                         0
    RDATA packets sent                       0
          bytes sent                         0
    Total bytes sent                         0
    ADPUs sent                               0
    APDU  transmit memory errors             0
    SPM   packets sent                       6
    NCF   packets sent                       0
    NAK   packets received                   0
          packets received in error          0
    General bad packets                      0
    TX window lead                           0
    TX window trail                          0

The following user EXEC example shows traffic information for multicast group address 244.1.1.1:

Router> show ip pgm host sessions 244.1.1.1

Idx  GSI           Source Port  Type     State   Dest Port  Mcast Address
2    9CD72EF099FA  1025         source   conn    48059      224.1.1.1
 
    stream-type (apdu), ttl (255)
 
    spm-ambient-ivl (6000), txw-adv-secs (6000)
    txw-adv-timeout-max (3600000), txw-rte (16384), txw-secs (30000)
    ncf-max (infinite), spm-rpt-ivl (3000), ihb-min (1000)
    ihb-max (10000), join (0), tpdu-size (16384)
    txw-adv-method (time), tx-buffer-mgmt (return)
 
    ODATA packets sent                       0
          bytes sent                         0
    RDATA packets sent                       0
          bytes sent                         0
    Total bytes sent                         0
    ADPUs sent                               0
    APDU  transmit memory errors             0
    SPM   packets sent                       6
    NCF   packets sent                       0
    NAK   packets received                   0
          packets received in error          0
    General bad packets                      0
    TX window lead                           0
    TX window trail                          0

Table 44 describes the significant fields shown in the displays.

Table 44 show ip pgm host sessions Field Descriptions 

Field
Description

Idx

The local index for the traffic session.

GSI

The global source identifier for the traffic session.

Source Port

The source port for the traffic session.

Type

Source or receiver session.

State

The state of the session. For example, connected or listening.

Dest Port

The destination port for the traffic session.

Mcast Address

The IP multicast address for the traffic session.

ODATA

Normal data packet.

RDATA

Re-sent data packet.

ADPUs

Application data units.

SPM

Source path message.

NCF

Negative acknowledgment (NAK) confirmation packet.

NAK

NAK packet.


Related Commands

Command
Description

clear ip pgm host

Resets PGM Host connections to their default values and clears traffic statistics.

ip pgm host

Enables PGM Host.

show ip pgm host defaults

Displays the default values for PGM Host traffic.

show ip pgm host traffic

Displays PGM Host traffic statistics.


show ip pgm host traffic


Note Support for the PGM Host feature has been removed. Use of this command is not recommended.


To display Pragmatic General Multicast (PGM) Host traffic statistics, use the show ip pgm host traffic command in user EXEC or privileged EXEC mode.

show ip pgm host traffic

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.1(1)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Usage Guidelines

Use this command to display traffic statistics at the PGM transport layer.

Examples

The following is sample output from the show ip pgm host traffic user EXEC command:

Router> show ip pgm host traffic

General Statistics :
 
    Sessions in                              0
             out                             0
    Bytes    in                              0
             out                             0
 
Source Statistics :
 
    ODATA packets sent                       0
          bytes sent                         0
    RDATA packets sent                       0
          bytes sent                         0
    Total bytes sent                         0
    ADPUs sent                               0
    APDU  transmit memory errors             0
    SPM   packets sent                       0
    NCF   packets sent                       0
    NAK   packets received                   0
          packets received in error          0
 
Receiver Statistics :
          
    ODATA packets received                   0
          packets received in error          0
          valid bytes received               0
    RDATA packets received                   0
          packets received in error          0
          valid bytes received               0
    Total valid bytes received               0
    Total bytes received in error            0
    ADPUs received                           0
    SPM   packets received                   0
          packets received in error          0
    NCF   packets received                   0
          packets received in error          0
    NAK   packets received                   0
          packets received in error          0
          packets sent                       0
    Undeliverable packets                    0
    General bad packets                      0
    Bad checksum packets                     0

Table 45 describes the significant fields shown in the display.

Table 45 show ip pgm host traffic Field Descriptions

Field
Description

General Statistics

Displays statistics that relate to both the traffic source and the receiver.

Source Statistics

Displays statistics that relate to the traffic source.

Receiver Statistics

Displays statistics that relate to the traffic receiver.


Related Commands

Command
Description

clear ip pgm host

Resets PGM Host connections to their default values and clears traffic statistics.

ip pgm host

Enables PGM Host.

show ip pgm host defaults

Displays the default values for PGM Host traffic.

show ip pgm host sessions

Displays open PGM Host traffic sessions.


show ip pgm router

To display Pragmatic General Multicast (PGM) Reliable Transport Protocol state and statistics, use the show ip pgm router command in privileged EXEC mode.

show ip pgm router [interface [interface-type interface-number] | state [group-address] | [traffic [interface-type interface-number]] [verbose]

Syntax Description

interface [interface-type interface-number]

(Optional) Displays interfaces on which PGM Router Assist is configured.

state [group-address]

(Optional) Displays designated local repairer (DLR) information and PGM resend state information per transport session identifier (TSI). If no group address is specified, resend state for all groups is shown.

traffic [interface-type interface-number]

(Optional) Displays PGM packet counters. If no interface type and number are specified, traffic on all interfaces is displayed. These statistics do not reflect the number of PGM data packets (ODATA) that are forwarded in a session, because these are forwarded transparently by IP multicast.

verbose

(Optional) Displays extended information about outgoing interface lists, timers, and Forward Error Connections (FECs).


Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(5)T

This command was introduced.

12.2(13)T

The output display for this command was updated to include DLR information.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.


Examples

The following is sample output from the show ip pgm router command with the interface keyword:

Router# show ip pgm router interface

Address	        Interface
10.1.0.2       Ethernet1/0/0 (measured drop rate 0%)
10.3.0.2       Ethernet1/0/4 (measured drop rate 0%)

Table 46 describes the significant fields shown in the display.

Table 46 show ip pgm router Field Descriptions

Field
Description

Address

IP address of the interface running PGM Router Assist.

Interface

Interface type and number on the router that is running PGM Router Assist, plus the drop rate measured on the interface.


The following is sample output from the show ip pgm router command with the traffic keyword. An RDATA fragment is a part of an RDATA packet that has been fragmented at the IP layer while in transit. The PGM network element has seen two RDATA packets that were each fragmented into three IP fragments.

Router# show ip pgm router traffic

FastEthernet0/0
  NAKs received                  2
  NCFs transmitted               2
 RDATA forwarded                 2
 RDATA frags forwarded           6
  SPMs received                  4
       used                      4
  SPMs forwarded                33
Serial0/0
  NAKs forwarded                 2
  NAKs retransmitted             2
  NCFs received                  4
 RDATA received                  2
 RDATA frags received            6
  SPMs received                 33
       used                     33

The following is sample output from the show ip pgm router command with the state and verbose keywords. The timer associated with each session is an idle timer; the TSI state is deleted when this timer expires. The measured loss rates are indicated as follows:

link_lr: worst reported link loss rate

path_lr: worst reported path loss rate

receiver_lr: worst reported receiver loss rate

cr_lead: sequence number associated with worst receiver loss rate

cr_worst_rec: IP address that reported worst loss rate

Router# show ip pgm router state verbose

TSI                Group            Neighbor        TGSIZE
0A0700C85555-1000  227.7.7.7        rpf/source       N/A        00:04:25
  (link_lr 7%, path_lr 4%, receiver_lr 10% 
  cr_lead 6256421, cr_worst_rec 134.45.0.126)

The following sample output shows state after receivers have reported loss of certain packets. Negative acknowledgments (NAKs) have been received for each of the two sessions in the previous example. After the loss, the router has state for the lost packets. The "sqn 1990" indicates that a receiver lost a packet with sequence number 1990 and is requesting that it be re-sent.

Router# show ip pgm router state verbose

TSI                Group            Neighbor        TGSIZE
0A0700C85555-1000  227.7.7.7        rpf/source       N/A        00:04:55
   sqn        1990            age   4 ELIM TMR
       Ethernet1/0/0
   sqn        1991            age    5 (anticipated)
0A0700C85555-2000 234.4.3.2         rpf/source       16         00:04:55
   sqn (       125,          7) age   10
       Serial5/0 prty # 7

For the selective TSI, the output shows resend state for sequence number 1990. This state was created by a NAK received on Ethernet interface 1/0/0. "ELIM TMR" indicates that the state is eliminating duplicates of any NAK that is pending and any new NAKs for this sequence number will not be forwarded.

State shown for sequence 1991 is anticipated state, indicating that it was created by a NAK confirmation (NCF) for a NAK sent by some other PGM router with the same PGM upstream neighbor as this router.

For the TSI with parity, the state shown was created by a parity NAK for seven packets of the Transmission Group 125. This state was received on serial interface 5/0; "# 7" indicates that seven parity packets must be forwarded out this interface.

Related Commands

Command
Description

clear ip pgm router

Clears PGM traffic statistics.

ip pgm router

Enables PGM Router Assist and thereby allows PGM to operate more efficiently on the router.


show ip pim bsr-router

To display information about a bootstrap router (BSR), use the show ip pim bsr-router command in user EXEC or privileged EXEC mode.

show ip pim [vrf vrf-name] bsr-router

Syntax Description

vrf vrf-name

(Optional) Displays information about a BSR associated with the multicast VPN (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

11.3 T

This command was introduced.

12.0(23)S

The vrf keyword and vrf-name argument were added.

12.2(13)T

The vrf keyword and vrf-name argument were added.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

The output includes elected BSR information and information about the locally configured candidate rendezvous point (RP) advertisement.

Examples

The following is sample output from the show ip pim bsr-router command:

Router# show ip pim bsr-router

PIMv2 Bootstrap information
This system is the Bootstrap Router (BSR)
  BSR address: 172.16.143.28 
  Uptime: 04:37:59, BSR Priority: 4, Hash mask length: 30
  Next bootstrap message in 00:00:03 seconds

Next Cand_RP_advertisement in 00:00:03 seconds. 
  RP: 172.16.143.28(Ethernet0), Group acl: 6

Table 47 describes the significant fields shown in the display.

Table 47 show ip pim bsr-router Field Descriptions 

Field
Description

BSR address

IP address of the BSR.

Uptime

Length of time that this router has been up (in hours, minutes, and seconds).

BSR Priority

Priority as configured with the ip pim bsr-candidate command.

Hash mask length

Length of a mask (32 bits maximum) that is to be ANDed with the group address before the hash function is called. This value is configured with the ip pim bsr-candidate command.

Next bootstrap message in

Time (in hours, minutes, and seconds) in which the next bootstrap message is due from this BSR.

Next Cand_RP_advertisement in

Time (in hours, minutes, and seconds) in which the next candidate RP advertisement will be sent.

RP

List of RP IP addresses.

Group acl

Standard IP access list number that defines the group prefixes that are advertised in association with the RP address. This value is configured with the ip pim rp-candidate command.


Related Commands

Command
Description

ip pim bsr-candidate

Configures the router to announce its candidacy as a BSR.

ip pim rp-candidate

Configures the router to advertise itself as a PIM Version 2 candidate RP to the BSR.

show ip pim rp

Displays active RPs that are cached with associated multicast routing entries.

show ip pim rp-hash

Displays which RP is being selected for a specified group.


show ip pim interface

To display information about interfaces configured for Protocol Independent Multicast (PIM), use the show ip pim interface command in user EXEC or privileged EXEC mode.

show ip pim [vrf vrf-name] interface [interface-type interface-number] [df | count] [rp-address] [detail] [stats]

Syntax Description

vrf vrf-name

(Optional) Displays information about PIM interfaces associated with the Multicast Virtual Private Network (MVPN) virtual routing and forwarding (MVRF) instance specified for the vrf-name argument.

interface-type interface-number

(Optional) Interface type and number.

df

(Optional) When bidirectional PIM (bidir-PIM) is used, displays the IP address of the elected designated forwarder (DF) for each rendezvous point (RP) of an interface.

count

(Optional) Specifies the number of packets received and sent out the interface.

rp-address

(Optional) RP IP address.

detail

(Optional) Displays PIM details of each interface.

stats

(Optional) Displays multicast PIM interface octet counts.


Command Default

If no interface is specified, all interfaces are displayed.

Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

10.0

This command was introduced.

11.2(11)GS

This command was integrated into Cisco IOS Release 11.2(11)GS.

12.0(5)T

The flag "H" was added in the output display to indicate that an outgoing interface is hardware-switched in the case of IP multicast Multilayer Switching (MMLS).

12.0(18)ST

This command was integrated into Cisco IOS Release 12.0(18)ST.

12.1(2)T

The df keyword and rp-address argument were added.

12.1(5)T

The detail keyword was added.

12.0(22)S

The command output changed to show when the query interval is set to milliseconds.

12.0(23)S

The vrf keyword and vrf-name argument were added.

12.2(13)T

The vrf keyword and vrf-name argument were added.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(31)S

The stats keyword was added.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.3(17)

The stats keyword was added.

12.4(7)

The stats keyword was added.

12.4(6)T

The stats keyword was added.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

15.0(1)M

This command was modified. The "FS" column was removed from the output of the show ip pim interface count command due to the introduction of the IPv4 MFIB architecture.


Usage Guidelines

Use the show ip pim interface count command to display switching counts for Multicast Distributed Switching (MDS) and other switching statistics.


Note In Cisco IOS releases that support the IPv4 Multicast Forwarding Information Base (MFIB), use the show ip mfib interface command to display MFIB-related information about interfaces and their forwarding status.


Examples

The following is sample output from the show ip pim interface command:

Router# show ip pim interface

Address          Interface                Ver/   Nbr    Query  DR     DR
                                          Mode   Count  Intvl  Prior
10.1.0.1         GigabitEthernet0/0       v2/SD  0      30     1      10.1.0.1
10.6.0.1         GigabitEthernet0/1       v2/SD  1      30     1      10.6.0.2
10.2.0.1         ATM1/0.1                 v2/SD  1      30     1      0.0.0.0

The following is sample output from the show ip pim interface command when an interface is specified:

Router# show ip pim interface Ethernet1/0

Address          Interface                Ver/   Nbr    Query  DR     DR
                                          Mode   Count  Intvl  Prior
172.16.1.4       Ethernet1/0              v2/S   1      100 ms 1      172.16.1.4

The following is sample output from the show ip pim interface command when the count keyword is specified:

Router# show ip pim interface count

Address          Interface          FS  Mpackets In/Out
172.16.121.35    Ethernet0          *   548305239/13744856
172.16.121.35    Serial0.33         *   8256/67052912
192.168.12.73    Serial0.1719       *   219444/862191

The following is sample output from the show ip pim interface command when the count keyword is specified and IP MMLS is enabled. The example lists the PIM interfaces that are fast switched and process switched, and the packet counts for these interfaces. The H flag is added to interfaces where IP MMLS is enabled.

Router# show ip pim interface count

States: FS - Fast Switched, H - Hardware Switched
Address          Interface          FS  Mpackets In/Out
192.168.10.2       Vlan10             * H 40886/0
192.168.11.2       Vlan11             * H 0/40554
192.168.12.2       Vlan12             * H 0/40554
192.168.23.2       Vlan23             *   0/0
192.168.24.2       Vlan24             *   0/0

The following is sample output from the show ip pim interface command when the stats keyword is specified:

Router# show ip pim interface stats


Interface        Mpackets In    Mpackets Out         Octets In        Octets Out

Loopback0                  0               0                 0                 0
Loopback1                  0               0                 0                 0
Ethernet0/0                0               0                 0                 0
Ethernet0/3                0               0                 0                 0
Ethernet1/1                0               0                 0                 0

For all of the count descriptions, a packet is counted as a multicast packet if either of the following two conditions are met:

The IP address contained in the IP header of the packet specifies a multicast (class D) IP address.

The IP address contained in the IP header of the packet specifies an IP address located on this router and the packet contains an encapsulated packet for which the IP header of the encapsulated packet specifies a multicast (class D) IP address.

Table 48 describes the significant fields shown in the display.

Table 48 show ip pim interface stats Field Descriptions 

Field
Description

Mpackets In

The number of multicast packets received on each interface listed in the output.

Mpackets Out

The number of multicast packets sent on each interface listed in the output.

Octets In

Cumulative byte count for data bytes (including IP header bytes) contained within multicast packets received on each interface listed in the output.

Octets Out

Cumulative byte count for data bytes (including IP header bytes) contained within multicast packets sent on each interface listed in the output.


The following are two sample outputs from the show ip pim interface command when the df keyword is specified:

Router# show ip pim interface df

Interface          RP               DF Winner        Metric          Uptime
Ethernet3/3        10.10.0.2        10.4.0.2         0               00:03:49
                   10.10.0.3        10.4.0.3         0               00:01:49
                   10.10.0.5        10.4.0.4         409600          00:01:49
Ethernet3/4        10.10.0.2        10.5.0.2         0               00:03:49
                   10.10.0.3        10.5.0.2         409600          00:02:32
                   10.10.0.5        10.5.0.2         435200          00:02:16
Loopback0          10.10.0.2        10.10.0.2        0               00:03:49
                   10.10.0.3        10.10.0.2        409600          00:02:32
                   10.10.0.5        10.10.0.2        435200          00:02:16

Router# show ip pim interface Ethernet3/3 df 10.10.0.3

Designated Forwarder election for Ethernet3/3, 10.4.0.2, RP 10.10.0.3
  State                           Non-DF
  Offer count is                  0
  Current DF ip address           10.4.0.3
  DF winner up time               00:02:33
  Last winner metric preference   0
  Last winner metric              0

Table 49 describes the significant fields shown in the displays.

Table 49 show ip pim interface Field Descriptions 

Field
Description

Address

Interface IP address of the next hop router.

Interface

Interface type and number that is configured to run PIM.

Ver/Mode

PIM version and multicast mode in which the Cisco IOS software is operating.

Nbr Count

Number of PIM neighbors that have been discovered through this interface. If the Neighbor Count is 1 for a DVMRP tunnel, the neighbor is active (receiving probes and reports).

Query Interval

Frequency, in seconds, of PIM hello messages, as set by the ip pim query-interval interface configuration command. The default is 30 seconds.

DR

IP address of the designated router (DR) on a network.

Note Point-to-point interfaces do not have designated routers, so the IP address would be shown as 0.0.0.0.

FS

An asterisk (*) in this column indicates that fast switching is enabled.

Mpackets In/Out

Number of packets into and out of the interface since the router has been up.

RP

IP address of the RP.

DF Winner

IP address of the elected DF.

Metric

Unicast routing metric to the RP announced by the DF.

Uptime

Length of time the RP has been up, in days and hours. If less than 1 day, time is shown in hours:minutes:seconds.

State

Indicates whether the specified interface is an elected DF.

Offer count is

Number of PIM DF election offer messages that the router has sent out the interface during the current election interval.

Current DF ip address

IP address of the current DF.

DF winner up time

Length of time the current DF has been up, in days and hours. If less than 1 day, time is shown in hours:minutes:seconds.

Last winner metric preference

The preference value used for selecting the unicast routing metric to the RP announced by the DF.

Last winner metric

Unicast routing metric to the RP announced by the DF.


The following is sample output from the show ip pim interface command with the detail keyword for Fast Ethernet interface 0/1:

Router# show ip pim interface fastethernet 0/1 detail

FastEthernet0/1 is up, line protocol is up
  Internet address is 172.16.8.1/24
  Multicast switching:process
  Multicast packets in/out:0/0
  Multicast boundary:not set
  Multicast TTL threshold:0
  PIM:enabled
    PIM version:2, mode:dense
    PIM DR:172.16.8.1 (this system)
    PIM neighbor count:0
    PIM Hello/Query interval:30 seconds
	PIM State-Refresh processing:enabled
	PIM State-Refresh origination:enabled, interval:60 seconds
    PIM NBMA mode:disabled
    PIM ATM multipoint signalling:disabled
    PIM domain border:disabled
  Multicast Tagswitching:disabled

Table 50 describes the significant fields shown in the display.

Table 50 show ip pim interface detail Field Descriptions 

Field
Description

Internet address

IP address of the specified interface.

Multicast switching:

The type of multicast switching enabled on the interface: process, fast, or distributed.

Multicast boundary:

Indicates whether an administratively scoped boundary is configured.

Multicast TTL threshold:

The time-to-live (TTL) threshold of multicast packets being forwarded out the interface.

PIM:

Indicates whether PIM is enabled or disabled.

PIM version:

Indicates whether PIM version 1 or version 2 is configured.

PIM mode:

Indicates whether PIM sparse mode, dense mode, or sparse-dense mode is configured.

PIM DR:

The IP address of the DR.

PIM State-Refresh processing:

Indicates whether the processing of PIM state refresh control messages is enabled.

PIM State-Refresh origination:

Indicates whether the origination of the PIM state refresh control messages is enabled.

interval:

Indicates the configured interval for the origination of the PIM state refresh control messages. The available interval range is from 4 to 100 seconds.

PIM NBMA mode:

Indicates whether the interface is enabled for nonbroadcast multiaccess (NBMA) mode.

PIM ATM multipoint signalling:

Indicates whether the interface is enabled for ATM multipoint signaling.

PIM domain border:

Indicates whether the interface is enabled as a PIM domain border.

Multicast Tagswitching:

Indicates whether multicast tag switching is enabled.


Related Commands

Command
Description

ip pim

Enables PIM on an interface.

ip pim query-interval

Configures the frequency of PIM router query messages.

ip pim state-refresh disable

Disables the processing and forwarding of PIM dense mode state refresh control messages on a PIM router.

ip pim state-refresh origination-interval

Configures the origination of and the interval for PIM dense mode state refresh control messages on a PIM router.

show ip mfib interface

Displays MFIB-related information about interfaces and their forwarding status.

show ip pim neighbor

Displays information about PIM neighbors.


show ip pim interface df

To display information about the designated forwarder interface, use the show ip pim interface df command in user EXEC or privileged EXEC mode.

show ip pim [vrf vrf-name] interface df [rp-address]

Syntax Description

vrf vrf-name

(Optional) Specifies the name that is assigned to the multicast VPN routing and forwarding (VRF) instance.

rp-address

(Optional) Hostname or IP address of the designated forwarder.


Defaults

If you do not specify rp-address, all designated forwarders are displayed.

Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.2(14)SX

Support for this command was introduced on the Supervisor Engine 720.

12.2(18)SXE

This command was changed to add the vrf vrf-name keyword and argument on the Supervisor Engine 720 only.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.

Examples

This example shows how to display the information about the DF interface:

Router# show ip pim interface df 10.18.1.31

Interface                RP               DF Winner        Metric     Uptime
Vlan70                   10.18.1.31       10.70.1.55       0          14:16:24
FastEthernet5/5          10.18.1.31       10.16.1.30       0          14:16:24
FastEthernet5/6          10.18.1.31       10.18.1.31       0          14:16:24

show ip pim mdt bgp

To show details about the Border Gateway Protocol (BGP) advertisement of the route distinguisher (RD) for the multicast distribution tree (MDT) default group, use the show ip pim mdt bgp command in user EXEC or privileged EXEC mode.

show ip pim [vrf vrf-name] mdt bgp

Syntax Description

vrf vrf-name

(Optional) Displays information about the BGP advertisement of the RD for the MDT default group associated with Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.


Command Modes

User EXEC
Privileged EXEC

Command History

Release
Modification

12.0(23)S

This command was introduced.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

Use this command to show detailed BGP advertisement of the RD for the MDT default group.

Examples

The following is sample output from the show ip pim mdt bgp command:

Router# show ip pim mdt bgp

MDT-default group 232.2.1.4
 rid:10.1.1.1 next_hop:10.1.1.1

Table 51 describes the significant fields shown in the display.

Table 51 show ip pim mdt bgp Field Descriptions 

Field
Description

MDT-default group

The MDT default groups that have been advertised to this router.

rid:10.1.1.1

The BGP router ID of the advertising router.

next_hop:10.1.1.1

The BGP next hop address that was contained in the advertisement.


show ip pim mdt history

To display information about the history of data multicast distribution tree (MDT) groups that have been reused, use the show ip pim mdt history command in privileged EXEC mode.

show ip pim vrf vrf-name mdt history interval minutes

Syntax Description

vrf vrf-name

Displays the history of data MDT groups that have been reused for the Multicast VPN (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.

interval minutes

Specifies the interval (in minutes) for which to display information about the history of data MDT groups that have been reused. The range is from 1 to 71512 minutes (7 weeks).


Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(23)S

This command was introduced.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

The output of the show ip pim mdt history command displays the history of reused MDT data groups for the interval specified with the interval keyword and minutes argument. The interval is from the past to the present, that is, from the time specified for the minutes argument to the time at which the command is issued.

Examples

The following is sample output from the show ip pim mdt history command:

Router# show ip pim vrf vrf1 mdt history interval 20

   MDT-data send history for VRF - vrf1 for the past 20 minutes

MDT-data group        Number of reuse
     10.9.9.8           3
     10.9.9.9           2

Table 52 describes the significant fields shown in the display.

Table 52 show ip pim mdt history Field Descriptions 

Field
Description

MDT-data group

The MDT data group for which information is being shown.

Number of reuse

The number of data MDTs that have been reused in this group.


show ip pim mdt receive

To display the data multicast distribution tree (MDT) group mappings received from other provider edge (PE) routers, use the show ip pim mdt receive command in privileged EXEC mode.

show ip pim vrf vrf-name mdt receive [detail]

Syntax Description

vrf vrf-name

Displays the data MDT group mappings for the Multicast VPN (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.

detail

(Optional) Provides a detailed description of the data MDT advertisements received.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(23)S

This command was introduced.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.2(14)S

This command was integrated into Cisco IOS Release 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

When a router wants to switch over from the default MDT to a data MDT, it advertises the VRF source, the group pair, and the global multicast address over which the traffic will be sent. If the remote router wants to receive this data, then it will join this global address multicast group.

Examples

The following is sample output from the show ip pim mdt receive command using the detail keyword for further information:

Router# show ip pim vrf vpn8 mdt receive detail

Joined MDT-data groups for VRF:vpn8
group:172.16.8.0 source:10.0.0.100 ref_count:13
(10.101.8.10, 225.1.8.1), 1d13h/00:03:28/00:02:26, OIF count:1, flags:TY
(10.102.8.10, 225.1.8.1), 1d13h/00:03:28/00:02:27, OIF count:1, flags:TY

Table 53 describes the significant fields shown in the display.

Table 53 show ip pim mdt receive Field Descriptions 

Field
Description

group:172.16.8.0

Group that caused the data MDT to be built.

source:10.0.0.100

VRF source that caused the data MDT to be built.

ref_count:13

Number of (S, G) pairs that are reusing this data MDT.

OIF count:1

Number of interfaces out of which this multicast data is being forwarded.

flags:

Information about the entry.

A—candidate Multicast Source Discovery Protocol (MSDP) advertisement

B—bidirectional group

D—dense

C—connected

F—register flag

I—received source-specific host report

J—join shortest path source tree (SPT)

L—local

M—MSDP created entry

P—pruned

R—RP bit set

S—sparse

s—Source Specific Multicast (SSM) group

T—SPT bit set

X—proxy join timer running

U—URL Rendezvous Directory (URD)

Y—joined MDT data group

y—sending to MDT data group

Z—multicast tunnel


show ip pim mdt send

To display the data multicast distribution tree (MDT) groups in use, use the show ip pim mdt send command in privileged EXEC mode.

show ip pim vrf vrf-name mdt send

Syntax Description

vrf vrf-name

Displays the data MDT groups in use by the Multicast VPN (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(23)S

This command was introduced.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.2(14)S

This command was integrated into Cisco IOS Releaes 12.2(14)S.

12.2(18)SXE

Support for this command was introduced on the Supervisor Engine 720.

12.2(27)SBC

This command was integrated into Cisco IOS Release 12.2(27)SBC.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.


Usage Guidelines

Use this command to show the data MDT groups in use by a specified MVRF.

Examples

The following is sample output from the show ip pim mdt send command:

Router# show ip pim vrf vpn8 mdt send

MDT-data send list for VRF:vpn8
  (source, group)                     MDT-data group      ref_count
  (10.100.8.10, 225.1.8.1)            232.2.8.0           1
  (10.100.8.10, 225.1.8.2)            232.2.8.1           1
  (10.100.8.10, 225.1.8.3)            232.2.8.2           1
  (10.100.8.10, 225.1.8.4)            232.2.8.3           1
  (10.100.8.10, 225.1.8.5)            232.2.8.4           1
  (10.100.8.10, 225.1.8.6)            232.2.8.5           1
  (10.100.8.10, 225.1.8.7)            232.2.8.6           1
  (10.100.8.10, 225.1.8.8)            232.2.8.7           1
  (10.100.8.10, 225.1.8.9)            232.2.8.8           1
  (10.100.8.10, 225.1.8.10)           232.2.8.9           1

Table 54 describes the significant fields shown in the display.

Table 54 show ip pim mdt send Field Descriptions 

Field
Description

source, group

Source and group addresses that this router has switched over to data MDTs.

MDT-data group

Multicast address over which these data MDTs are being sent.

ref_count

Number of (S, G) pairs that are reusing this data MDT.


show ip pim neighbor

To display the Protocol Independent Multicast (PIM) neighbors discovered by PIMv1 router query messages or PIMv2 hello messages, use the show ip pim neighbor command in user EXEC or privileged EXEC mode.

show ip pim [vrf vrf-name] neighbor [interface-type interface-number]

Syntax Description

vrf vrf-name

(Optional) Displays the PIM neighbors associated with the Multicast Virtual Private Network (MVPN) routing and forwarding (MVRF) instance specified for the vrf-name argument.

interface-type

(Optional) Interface type.

interface-number

(Optional) Interface number.


Command Modes

User EXEC (>)
Privileged EXEC (#)

Command History

Release
Modification

10.0

This command was introduced.

12.0(22)S