Table Of Contents

senders

show ip dvmrp route

show ip igmp groups

show ip igmp interface

show ip igmp membership

show ip igmp udlr

show ip mcache

show ip mpacket

show ip mrm interface

show ip mrm manager

show ip mrm status-report

show ip mroute

show ip msdp count

show ip msdp peer

show ip msdp sa-cache

show ip msdp summary

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

show ip pim vc

show ip rpf

show ip rpf events

show ip sap

show ip sdr

tunnel udlr address-resolution

tunnel udlr receive-only

tunnel udlr send-only

udp-port

senders

To configure Test Sender parameters used for a Multicast Routing Monitor (MRM) test, use the senders command in MRM manager configuration mode. To restore the default settings, use the no form of this command.

senders access-list [packet-delay milliseconds] [rtp | udp] [target-only | all-multicasts | all-test-senders] [proxy-src]

no senders access-list

Syntax Description

access-list	IP named or numbered access list that defines which Test Senders are involved in the test and which Test Senders these parameters apply to.
packet-delay milliseconds	(Optional) Specifies the delay between test packets (in milliseconds). The range is from 50 to 10000. The default is 200 milliseconds, which results in 5 packets per second.
rtp | udp	(Optional) Specifies the encapsulation of test packets, either Real-Time Transport Protocol (RTP)-encapsulated or User Datagram Protocol (UDP)-encapsulated. By default, test packets are RTP-encapsulated.
target-only	(Optional) Specifies that test packets are sent out on the targeted interface only (that is, the interface with the IP address that is specified in the Test Sender request target field). By default, test packets are sent out on all interfaces that are enabled with IP multicast.
all-multicasts	(Optional) Specifies that the test packets are sent out on all interfaces that are enabled with IP multicast. This is the default method for sending test packets.
all-test-senders	(Optional) Specifies that test packets are sent out on all interfaces that have test-sender mode enabled. By default, test packets are sent out on all interfaces that are enabled with IP multicast.
proxy-src	(Optional) Source IP address for which the Test Sender will proxy test packets. Enter an address if you want to test, for a specific source, whether the multicast distribution tree is working.

Command Default

No test senders are configured to be involved in MRM tests.

Command Modes

MRM manager configuration

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.

Usage Guidelines

Use this command to specify which Test Senders are involved in the test and are affected by these parameters.

Examples

The following example shows how to configure a Test Sender for an MRM test:

ip mrm manager test1

 manager Ethernet0/0 group 239.1.1.1

 senders 1

 receivers 2 sender-list 1

!

access-list 1 permit 10.1.1.2

access-list 2 permit 10.1.4.2

Related Commands

Command	Description
receivers	Establishes Test Receivers for MRM.

show ip dvmrp route

To display the contents of the Distance Vector Multicast Routing Protocol (DVMRP) routing table, use the show ip dvmrp route command in user EXEC or privileged EXEC mode.

show ip dvmrp route [name | ip-address | interface-type interface-number]

Syntax Description

name | ip-address	(Optional) Name or IP address of an entry in the DVMRP routing table.
interface-type interface-number	(Optional) Interface type and number.

Command Modes

User EXEC
Privileged EXEC

Command History

Release	Modification
10.3	This command was introduced.

Examples

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

Router# show ip dvmrp route

DVMRP Routing Table - 1 entry

172.16.0.0/16 [100/11] uptime 07:55:50, expires 00:02:52

    via 192.168.0.0, Tunnel3

Table 4 describes the significant fields shown in the display.

Table 4 show ip dvmrp route Field Descriptions 

Field	Description
1 entry	Number of entries in the DMVRP routing table.
172.168.0.0/16	Source network.
[100/11]	Administrative distance/metric.
uptime	How long (in hours, minutes, and seconds) that the route has been in the DVMRP routing table.
expires	How long (in hours, minutes, and seconds) until the entry is removed from the DVMRP routing table.
via 192.168.0.0	Next hop router to the source network.
Tunnel3	Interface to the source network.

Related Commands

Command	Description
ip dvmrp accept-filter	Configures an acceptance filter for incoming DVMRP reports.

show ip igmp groups

To display the multicast groups with receivers that are directly connected to the router and that were learned through Internet Group Management Protocol (IGMP), use the show ip igmp groups command in user EXEC or privileged EXEC mode.

show ip igmp [vrf vrf-name] groups [group-name | group-address | interface-type interface-number] [detail]

Syntax Description

vrf	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	(Optional) Name assigned to the VRF.
group-name	(Optional) Name of the multicast group, as defined in the Domain Name System (DNS) hosts table.
group-address	(Optional) Address of the multicast group. This is a multicast IP address in four-part, dotted-decimal notation.
interface-type	(Optional) Interface type.
interface-number	(Optional) Interface number.
detail	(Optional) Provides a detailed description of the sources known through IGMP Version 3 (IGMPv3), IGMP v3lite, or URL Rendezvous Directory (URD).

Command Modes

User EXEC
Privileged EXEC

Command History

Release	Modification
10.0	This command was introduced.
12.1(3)T	Fields were added to the output of this command to support the Source Specific Multicast (SSM) feature.
12.1(5)T	The detail keyword was added.
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.

Usage Guidelines

If you omit all optional arguments and keywords, the show ip igmp groups command displays by group address, interface type, and interface number all directly connected multicast groups.

Examples

The following is sample output from the show ip igmp groups command:

Router# show ip igmp groups

IGMP Connected Group Membership

Group Address     Interface         Uptime      Expires     Last Reporter

239.255.255.254   Ethernet3/1       1w0d        00:02:19    172.21.200.159

224.0.1.40        Ethernet3/1       1w0d        00:02:15    172.21.200.1

224.0.1.40        Ethernet3/3       1w0d        never       172.16.214.251

224.0.1.1         Ethernet3/1       1w0d        00:02:11    172.21.200.11

224.9.9.2         Ethernet3/1       1w0d        00:02:10    172.21.200.155

232.1.1.1         Ethernet3/1       5d21h       stopped     172.21.200.206

The following is sample output from the show ip igmp groups command with the group-address argument and detail keyword:

Router# show ip igmp groups 232.1.1.1 detail

Interface:      Ethernet3/2

Group:          232.1.1.1

Uptime:         01:58:28

Group mode:     INCLUDE

Last reporter:  10.0.119.133

CSR Grp Exp:    00:02:38

Group source list: (C - Cisco Src Report, U - URD, R - Remote)

  Source Address   Uptime    v3 Exp    CSR Exp   Fwd  Flags

  172.16.214.1     01:58:28  stopped   00:02:31  Yes  C

Table 5 describes the significant fields shown in the displays.

Table 5 show ip igmp groups Field Descriptions 

Field	Description
Group Address	Address of the multicast group.
Interface	Interface through which the group is reachable.
Uptime	How long (in weeks, days, hours, minutes, and seconds) this multicast group has been known.
Expires	How long (in hours, minutes, and seconds) until the entry expires. If an entry expires, then the entry will (for a short period) show the word "now" before it is removed. The word "never" indicates that the entry will not time out, because a local receiver is on this router for this entry. The word "stopped" indicates that timing out of this entry is not determined by this expire timer. If the router is in INCLUDE mode for a group, then the whole group entry will time out after the last source entry has timed out (unless the mode is changed to EXCLUDE mode before it times out).
Last Reporter	Last host to report being a member of the multicast group. Both IGMP v3lite and URD require a v2-report.
Group mode:	Can be either INCLUDE or EXCLUDE. The group mode is based on the type of membership reports received on the interface for the group. In the output for the show ip igmp groups detail command, the EXCLUDE mode also shows the "Expires:" field for the group entry (not shown in the output).
CSR Grp Exp	This field is shown for multicast groups in the SSM range. It indicates the time (in hours, minutes, and seconds) since the last received group membership report was received. Cisco IOS software needs to use these reports for the operation of URD and IGMP v3lite, but they do not indicate group membership by themselves.
Group source list:	Provides details of which sources have been requested by the multicast group.
Source Address	IP address of the source.
Uptime	Indicates the time (in hours, minutes, and seconds) since the source state was created.
v3 Exp	Indicates the time (in hours, minutes, and seconds) until the membership for the source will time out according to IGMP operations. The word "stopped" is shown if no member uses IGMPv3 (but only IGMP v3lite or URD).
CSR Exp	Indicates the time (in hours, minutes, and seconds) until the membership for the source will time out according to IGMP v3lite or URD reports. The word "stopped" is shown if members use only IGMPv3.
Fwd	Indicates whether the router is forwarding multicast traffic due to this entry.
Flags	Information about the entry. The Remote flag indicates that an IGMPv3 report has been received by this source. The C flag indicates that an IGMP v3lite or URD report was received by this source. The U flag indicates that a URD report was received for this source.

Related Commands

Command	Description
ip igmp query-interval	Configures the frequency at which the Cisco IOS software sends IGMP host query messages.

show ip igmp interface

To display multicast-related information about an interface, use the show ip igmp interface command in user EXEC or privileged EXEC mode.

show ip igmp [vrf vrf-name] interface [interface-type interface-number]

Syntax Description

vrf	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	(Optional) Name assigned to the VRF.
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(23)S	The vrf keyword and vrf-name argument were added.
12.2(13)T	The vrf keyword and vrf-name argument were added.

Usage Guidelines

If you omit the optional arguments, the show ip igmp interface command displays information about all interfaces.

This command also displays information about dynamically learned Distance Vector Multicast Routing Protocol (DVMRP) routers on the interface.

Examples

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

Router# show ip igmp interface

Ethernet0 is up, line protocol is up

  Internet address is 192.168.37.6, subnet mask is 255.255.255.0

  IGMP is enabled on interface

  IGMP query interval is 60 seconds

  Inbound IGMP access group is not set

  Multicast routing is enabled on interface

  Multicast TTL threshold is 0

  Multicast designated router (DR) is 192.168.37.33

  No multicast groups joined

Ethernet1 is up, line protocol is up

  Internet address is 192.168.36.129, subnet mask is 255.255.255.0

  IGMP is enabled on interface

  IGMP query interval is 60 seconds

  Inbound IGMP access group is not set

  Multicast routing is enabled on interface

  Multicast TTL threshold is 0

  Multicast designated router (DR) is 192.168.36.131

  Multicast groups joined: 225.2.2.2 226.2.2.2

Tunnel0 is up, line protocol is up

  Internet address is 10.1.37.2, subnet mask is 255.255.0.0

  IGMP is enabled on interface

  IGMP query interval is 60 seconds

  Inbound IGMP access group is not set

  Multicast routing is enabled on interface

  Multicast TTL threshold is 0

  No multicast groups joined

Table 6 describes the significant fields shown in the display.

Table 6 show ip igmp interface Field Descriptions 

Field	Description
Ethernet0 is up, line protocol is up	Interface type, number, and status.
Internet address is..., subnet mask is...	Internet address of the interface and subnet mask being applied to the interface, as specified with the ip address command.
IGMP is enabled on interface	Indicates whether IGMP has been enabled on the interface with the ip pim command.
IGMP query interval is 60 seconds	Interval at which the Cisco IOS software sends Protocol Independent Multicast (PIM) router query messages, as specified with the ip igmp query-interval command.
Inbound IGMP access group is not set	Indicates whether an IGMP access group has been configured with the ip igmp access-group command.
Multicast routing is enabled on interface	Indicates whether multicast routing has been enabled on the interface with the ip pim command.
Multicast TTL threshold is 0	Packet time-to-live threshold, as specified with the ip multicast ttl-threshold command.
Multicast designated router (DR) is...	IP address of the designated router for this LAN segment (subnet).
No multicast groups joined	Indicates whether this interface is a member of any multicast groups and, if so, lists the IP addresses of the groups.

Related Commands

Command	Description
ip address	Sets a primary or secondary IP address for an interface.
ip igmp access-group	Controls the multicast groups that hosts on the subnet serviced by an interface can join.
ip igmp query-interval	Configures the frequency at which the Cisco IOS software sends IGMP host query messages.
ip multicast ttl-threshold	Configures the TTL threshold of packets being forwarded out an interface.
ip pim	Enables PIM on an interface.

show ip igmp membership

To display Internet Group Management Protocol (IGMP) membership information for multicast groups and (S, G) channels, use the show ip igmp membership command in user EXEC or privileged EXEC mode.

show ip igmp membership [group-address | group-name] [tracked] [all]

Syntax Description

group-address	(Optional) The IP address of the multicast group for which to display IGMP membership information.
group-name	(Optional) The name of the multicast group, as defined in the Domain Name System (DNS) hosts table, for which to display IGMP membership information.
tracked	(Optional) Displays the multicast groups with the explicit tracking feature enabled.
all	(Optional) Displays the detailed information about the multicast groups with and without the explicit tracking feature enabled.

Command Modes

User EXEC
Privileged EXEC

Command History

Release	Modification
12.0(19)S	This command was introduced.
12.2(8)T	This command was integrated into Cisco IOS Release 12.2(8)T.

Usage Guidelines

Unlike the show ip igmp groups command, this command allows you to display detailed information about multicast channels and explicit tracking.

Examples

The following is sample output from the show ip igmp membership user EXEC command. Each entry in the output shows the aggregate membership information (indicated by the A flag) for a particular multicast group or channel from the IGMP cache. If the entry is prepended with a forward slash ("/") flag, the entry is a filtering entry that is blocking the data forwarding of the multicast group or channel.

Router> show ip igmp membership

Flags:A  - aggregate, T - tracked

       L  - Local, S - static, V - virtual, R - Reported through v3

       I - v3lite, D - Urd, M - SSM (S,G) channel

       1,2,3 - The version of IGMP, the group is in

Channel/Group-Flags:

       / - Filtering entry (Exclude mode (S,G), Include mode (*,G))

Reporter:

       <ip-address> - last reporter if group is not explicitly tracked

       <n>/<m>      - <n> reporter in include mode,<m> reporter in exclude

 Channel/Group                  Reporter        Uptime   Exp.  Flags  Interface

 *,224.0.1.40                   10.10.0.1       00:01:34 02:41 2LA   Et2/0

 *,239.1.1.1                    2/0             00:00:10 stop  3AT    Et2/0

The following is sample output from the show ip igmp membership user EXEC command with the multicast group address 239.1.1.1 and the tracked keyword specified:

Router> show ip igmp membership 239.1.1.1 tracked

Flags:A  - aggregate, T - tracked

       L  - Local, S - static, V - virtual, R - Reported through v3

       I - v3lite, D - Urd, M - SSM (S,G) channel

       1,2,3 - The version of IGMP, the group is in

Channel/Group-Flags:

       / - Filtering entry (Exclude mode (S,G), Include mode (*,G))

Reporter:

       <ip-address> - last reporter if group is not explicitly tracked

       <n>/<m>      - <n> reporter in include mode,<m> reporter in exclude

 Channel/Group                  Reporter        Uptime   Exp.  Flags  Interface

 *,239.1.1.1                    2/0             00:00:11 stop  3AT    Et2/0

 10.30.0.100,239.1.1.1          10.10.0.10      00:00:11 02:48 RT     Et2/0

 10.30.0.101,239.1.1.1          10.10.0.20      00:00:03 02:56 RT     Et2/0

 10.30.0.101,239.1.1.1          10.10.0.10      00:00:11 02:48 RT     Et2/0

 10.30.0.102,239.1.1.1          10.10.0.20      00:00:03 02:56 RT     Et2/0

Table 7 describes the significant fields shown in the displays.

Table 7 show ip igmp membership Field Descriptions 

Field	Description
Channel/Group	(S, G) channel or multicast group filtering entry.
Reporter	Displays information about the hosts reporting membership with the (S, G) channel or multicast group entry.
Uptime	The Uptime timer is how long (in hours, minutes, and seconds) the entry has been known.
Exp.	The Exp. timer is how long (in minutes and seconds) until the entry expires.
Flags	Provides information about the entry: •A—aggregate. Indicates that the aggregate information for the (S, G) channel or multicast group is being displayed. •T—tracked—Indicates that the multicast group is configured with the explicit tracking feature. •L—local. Indicates that the router itself is interested in receiving the traffic for this multicast group or channel. In order for the application to receive this traffic, the packets are sent to the process level of the router. When the ip igmp join-group command is configured for a multicast group, the L flag is set. •S—static. Indicates that the multicast group or channel is forwarded on the interface. When the ip igmp static-group command is configured on the interface, the S flag is set. •V—virtual. Indicates that service such as Hoot and Holler is running on the router requesting the traffic for the multicast group or channel. These services can process IP multicast traffic in the fast switching path. The L flag will not be set by these applications.
	•R—reported through v3. Indicates that an IGMP Version 3 (IGMPv3) report was received for this entry. •I—v3lite. Indicates that an IGMP Version 3 lite (IGMP v3lite) report was received for this entry. •D—URD. Indicates that a URL Rendezvous Directory (URD) report was received for this entry. •M—SSM (S, G) channel. Indicates that the multicast group address is in the Source Specific Multicast (SSM) range. •1, 2, 3—The version of IGMP. The version of IGMP that the multicast group is running.
Interface	Interface type and number.

Related Commands

Command	Description
ip igmp explicit-tracking	Enables explicit tracking of hosts, groups, and channels for IGMP Version 3.
ip igmp version	Configures the version of IGMP that the router uses.
show ip igmp groups	Displays the multicast groups with receivers that are directly connected to the router and that were learned through IGMP.

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.

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 8 describes the significant fields shown in the first display.

Table 8 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 mcache

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	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	(Optional) Name assigned to the VRF.
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.

Examples

The following is sample output from the show ip mcache user EXEC command. This entry shows a specific source (group1-source 239.1.1.1) sending to the group1 group (239.2.2.2).

Router> show ip mcache group1 group1-source

IP Multicast Fast-Switching Cache 

(239.1.1.1/32, 239.2.2.2), Fddi0, Last used: 00:00:00

  Ethernet0       MAC Header: 01005E028F1800000C1883D30800

  Ethernet1       MAC Header: 01005E028F1800000C1883D60800

  Ethernet2       MAC Header: 01005E028F1800000C1883D40800

  Ethernet3       MAC Header: 01005E028F1800000C1883D70800

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 9 describes the significant fields shown in the display.

Table 9 show ip mcache Field Descriptions 

Field	Description
239.1.1.1/32 and *	Source address.
239.2.2.2 and 239.2.3.4	Destination address.
Fddi0	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.
Ethernet0 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 mpacket

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	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	(Optional) Name assigned to the VRF.
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.

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 10 describes the significant fields shown in the display.

Table 10 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 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.

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 11 describes the fields shown in the display.

Table 11 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.

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 12 describes the fields shown in the display.

Table 12 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.

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 13 describes the fields shown in the display.

Table 13 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 mroute

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

show ip mroute [vrf vrf-name] [group-address | group-name] [source-address | source-name] [interface-type interface-number] [summary] [count] [active kbps]

Syntax Description

vrf	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	(Optional) Name assigned to the VRF.
group-address | group-name	(Optional) IP address or name multicast group as defined in the Domain Name System (DNS) hosts table.
source-address | source-name	(Optional) IP address or name of a multicast source.
interface-type interface-number	(Optional) Interface type and number.
summary	(Optional) Displays a one-line, abbreviated summary of each entry in the IP multicast routing table.
count	(Optional) Displays statistics about the group and source, including number of packets, packets per second, average packet size, and bytes per second.
active kbps	(Optional) Displays the rate that active sources are sending to multicast groups. Active sources are those sending at the kbps value or higher. The kbps argument defaults to 4 kbps.

Defaults

The show ip mroute command displays all groups and sources.
The show ip mroute active command displays all sources sending at a rate greater than or equal to 4 kbps.

Command Modes

User EXEC
Privileged EXEC

Command History

Release	Modification
10.0	This command was introduced.
12.0(5)T	The H flag for multicast Multilayer Switching (MMLS) was added in the output display.
12.1(3)T	The U, s, and I flags for Source Specific Multicast (SSM) were 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.3	The Z, Y, and y flags were introduced.

Usage Guidelines

If you omit all optional arguments and keywords, the show ip mroute command displays all entries in the IP multicast routing 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]).

The output for the show ip mroute command with the active keyword will display either positive or negative numbers for the rate PPS. The router displays negative numbers when RPF packets fail or when the router observes RPF packets with an interfaces out (OIF) list. This type of activity may indicate a multicast routing problem.

Examples

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/32, 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 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 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/32, 224.2.127.254), 00:02:46/00:00:12, flags: CLJT

  (172.16.244.217/32, 224.2.127.254), 00:02:15/00:00:40, flags: CLJT

  (172.16.8.33/32, 224.2.127.254), 00:00:25/00:02:32, flags: CLJT

  (172.16.2.62/32, 224.2.127.254), 00:00:51/00:02:03, flags: CLJT

  (172.16.8.3/32, 224.2.127.254), 00:00:26/00:02:33, flags: CLJT

  (172.16.60.189/32, 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)

The following is sample output from the show ip mroute command for a router supporting SSM 
services:

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, A - Assert winner

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

Table 14 describes the significant fields shown in the display.

Table 14 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.
Flags: (continued)	•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 is typically 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. 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.
Flags: (continued)	•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. •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. •A—Assert winner. Indicates the best path (lowest value) to the source router. •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/32, 224.0.255.1)	Entry in the IP multicast routing table. The entry consists of the IP address of the source router 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.

---

Table 15 describes the significant fields shown in the display.

Table 15 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 Group: displays 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 Source: 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 count: 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
ip multicast-routing	Enables IP multicast routing or multicast distributed switching.
ip pim	Enables PIM on an interface.
ip pim ssm	Defines the SSM range of IP multicast addresses.

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.

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 16 describes the significant fields shown in the display.

Table 16 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 the Multicast Source Discovery Protocol (MSDP) peer, 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	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	(Optional) Name assigned to the VRF.
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) SAs accepted from this peer.
advertised-sas	(Optional) SAs advertised to this 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.

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 17 describes the significant fields shown in the display.

Table 17 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 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.

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 18 describes the significant fields shown in the display.

Table 18 show ip msdp sa-cache Field Descriptions 

Field	Description
(172.16.41.33, 238.105.148.0)	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	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 19 describes the significant fields shown in the display.

Table 19 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-exceeded—Indicates 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.

Related Commands

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.

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 20 describes the significant fields shown in the display.

Table 20 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 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.1(1)T	This command was introduced.

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 21 describes the fields Source Session Default Values, Receiver Session Default Values, Common Default Values, and Address used to source packets shown in the sample output. See Table 21 for a definition of each individual default value in the sample output.

Table 21 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.

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 22 describes the significant fields shown in the displays.

Table 22 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.

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 23 describes the significant fields shown in the display.

Table 23 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.

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 24 describes the significant fields shown in the display.

Table 24 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 the bootstrap router (BSR) information, 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 BSR information for 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(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 25 describes the significant fields shown in the display.

Table 25 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 in 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 in 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 IP addresses of RPs.
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 in 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	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance. A space is not required between the values.
vrf-name	(Optional) Name assigned to the VRF.
interface-type interface-number	(Optional) Interface type and number. A space is not required between the values.
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.

Defaults

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.

Usage Guidelines

This command works only on interfaces that are configured for PIM.

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

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 26 describes the significant fields shown in the display.

Table 26 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 27 describes the significant fields shown in the displays.

Table 27 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 28 describes the significant fields shown in the display.

Table 28 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 pim neighbor	Displays information about PIM neighbors.

show ip pim mdt bgp

To show detailed 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	(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(23)S	This command was introduced.
12.2(13)T	This command was integrated into Cisco IOS Release 12.2(13)T.

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 29 describes the significant fields shown in the display.

Table 29 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 provide information on data multicast distribution trees (MDTs) 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	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	(Optional) Name assigned to the VRF.
interval	Specifies the interval during which data MDTs have been reused.
minutes	Length of time, in minutes, for which the interval can be configured.

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.

Usage Guidelines

The show ip pim mdt history command displays the data MDTs that have been reused during the past configured interval.

Examples

The following is sample output from the show ip pim mdt history command with the interval configured to be 20 minutes:

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 30 describes the significant fields shown in the display.

Table 30 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) advertisements received by a specified router, use the show ip pim mdt receive command in privileged EXEC mode.

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

Syntax Description

vrf	Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	Name assigned to the VRF.
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.

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 31 describes the significant fields shown in the display.

Table 31 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 show the data multicast distribution tree (MDT) advertisements that a specified router has made, use the show ip pim mdt send command in privileged EXEC mode.

show ip pim vrf vrf-name mdt send

Syntax Description

vrf	Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	Name assigned to the VRF.

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.

Usage Guidelines

Use this command to show the data MDT advertisements that a specified router has made.

Examples

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

Router# show ip pim mdt vpn8 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 32 describes the significant fields shown in the display.

Table 32 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 list the Protocol Independent Multicast (PIM) neighbors discovered by the Cisco IOS software, 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	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	(Optional) Name assigned to the VRF.
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	The command output was updated to display the PIM protocol version.
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.

Usage Guidelines

Use this command to determine which routers on the LAN are configured for PIM.

Examples

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

Router# show ip pim neighbor

PIM Neighbor Table

Neighbor          	Interface                Uptime/Expires 					Ver 				 DR

Address 																	Prio/Mode

126.1.33.11 	GigabitEthernet2/1		 1d11h/00:00:02				 v2	N / DR

126.1.34.12 	GigabitEthernet2/1		 1d11h/00:00:02				 v2	N / DR

126.104.20.56 	Serial4/1/0/1:0.104		 1d11h/00:00:02				 v2	1 / S

126.105.20.58 	Serial4/1/0/2:0.105		 1d00h/00:01:31				 v2	1 / S

Table 33 describes the significant fields shown in the display.

Table 33 show ip pim neighbor Field Descriptions 

Field	Description
Neighbor Address	IP address of the PIM neighbor.
Interface	Interface type and number on which the neighbor is reachable.
Uptime/Expires	Uptime shows how long (in hours:minutes:seconds) the entry has been in the PIM neighbor table. Expires shows how long (in hours:minutes:seconds or in milliseconds) until the entry will be removed from the IP multicast routing table.
Ver	PIM protocol version.
DR Prio/Mode	Priority and mode of the designated router (DR). Possible modes are S (state refresh capable), B (bidirectional PIM capable), and N (neighbor doesn't include the DR-Priority Option in its Hello messages).

Related Commands

Command	Description
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 the PIM dense mode state refresh control messages on a PIM router.
show ip pim interface	Displays information about interfaces configured for PIM.

show ip pim rp

To display active rendezvous points (RPs) that are cached with associated multicast routing entries, use the show ip pim rp command in user EXEC or privileged EXEC mode.

show ip pim [vrf vrf-name] rp [mapping [elected | in-use] | metric] [rp-address]

Syntax Description

vrf	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	(Optional) Name assigned to the VRF.
mapping	(Optional) Displays all group-to-RP mappings of which the router is aware (either configured or learned from Auto-RP).
elected	(Optional) Displays only the elected Auto RPs.
in-use	(Optional) Displays the learned RPs in use.
metric	(Optional) Displays the unicast routing metric to the RPs configured statically or learned via Auto-RP or the bootstrap router (BSR).
rp-address	(Optional) RP IP address.

Defaults

If no RP is specified, all active RPs are displayed.

Command Modes

User EXEC
Privileged EXEC

Command History

Release	Modification
10.2	This command was introduced.
12.1(2)T	The metric keyword and rp-address argument were added.
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.

Usage Guidelines

The Protocol Independent Multicast (PIM) version known for an RP influences the type of PIM register messages (Version 1 or Version 2) that the router sends when acting as the designated router (DR) for an active source. If an RP is statically configured, the PIM version of the RP is not set and the router, if required to send register packets, tries to send PIM Version 2 register packets. If sending PIM Version 2 packets fails, the router sends PIM Version 1 register packets.

The version of the RP displayed in the show ip pim rp command output can change according to the operations of the router. When the group is created, the version shown is for the RP in the RP mapping cache. Later, the version displayed by this command may change. If this router is acting as a DR for an active source, the router sends PIM register messages. The PIM register messages are answered by the RP with PIM register stop messages. The router learns from these PIM register stop messages the actual PIM version of the RP. Once the actual PIM version of the RP is learned, this command displays only this version. If the router is not acting as a DR for active sources on this group, then the version shown for the RP of the group does not change. In this case, the PIM version of the RP is irrelevant to the router because the version of the RP influences only the PIM register messages that this router must send.

When you enter the show ip pim rp mapping command, the version of the RP displayed in the output is determined only by the method through which an RP is learned. If the RP is learned from Auto-RP then the RP displayed is either "v1" or "v2, v1." If the RP is learned from a static RP definition, the RP version is undetermined and no RP version is displayed in the output. If the RP is learned from the BSR, the RP version displayed is "v2."

Use the elected keyword on an Auto-RP Mapping Agent to limit the output to only the elected RPs that the mapping agent will advertise to all other routers in the network via Auto-RP. This is useful when comparing the output of the show ip pim rp mapping command on non mapping agent routers with the ouptut of the show ip pim rp mapping elected command on a mapping agent to verify that the Group-to-RP mapping information is consistent.

Examples

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

Router# show ip pim rp

Group:227.7.7.7, RP:10.10.0.2, v2, v1, next RP-reachable in 00:00:48

The following is sample output from the show ip pim rp command when the mapping keyword is specified:

Router# show ip pim rp mapping

PIM Group-to-RP Mappings

This system is an RP (Auto-RP)

This system is an RP-mapping agent

Group(s) 227.0.0.0/8

  RP 10.10.0.2 (?), v2v1, bidir

    Info source:10.10.0.2 (?), via Auto-RP

         Uptime:00:01:42, expires:00:00:32

Group(s) 228.0.0.0/8

  RP 10.10.0.3 (?), v2v1, bidir

    Info source:10.10.0.3 (?), via Auto-RP

         Uptime:00:01:26, expires:00:00:34

Group(s) 229.0.0.0/8

  RP 10.10.0.5 (mcast1.cisco.com), v2v1, bidir

    Info source:10.10.0.5 (mcast1.cisco.com), via Auto-RP

         Uptime:00:00:52, expires:00:00:37

Group(s) (-)230.0.0.0/8

  RP 10.10.0.5 (mcast1.cisco.com), v2v1, bidir

    Info source:10.10.0.5 (mcast1.cisco.com), via Auto-RP

         Uptime:00:00:52, expires:00:00:37

The following is sample output from the show ip pim rp command when the metric keyword is specified:

Router# show ip pim rp metric

RP Address      Metric Pref    Metric       Flags   RPF Type   Interface

10.10.0.2       0              0              L     unicast    Loopback0

10.10.0.3       90             409600         L     unicast    Ethernet3/3

10.10.0.5       90             435200         L     unicast    Ethernet3/3

Table 34 describes the significant fields shown in the displays.

Table 34 show ip pim rp Field Descriptions 

Field	Description
Group	Address of the multicast group about which to display RP information.
RP	Address of the RP for that group.
v2	Indicates that the RP is running PIM version 2.
v1	Indicates that the RP is running PIM version 1.
bidir	Indicates that the RP is operating in bidirectional mode.
Info source	RP mapping agent that advertised the mapping.
(?)	Indicates that no Domain Name System (DNS) name has been specified.
via Auto-RP	Indicates that RP was learned via Auto-RP.
Uptime	Length of time the RP has been up (in days and hours). If less than 1 day, time is shown in hours, minutes, and seconds.
expires	Time in (hours, minutes, and seconds) in which the entry will expire.
Metric Pref	The preference value used for selecting the unicast routing metric to the RP announced by the designated forwarder (DF).
Metric	Unicast routing metric to the RP announced by the DF.
Flags	Indicates the flags set for the specified RP. The following are descriptions of possible flags: •C—RP is configured. •L—RP learned via Auto-RP or the BSR.
RPF Type	Routing table from which this route was obtained, either unicast, Distance Vector Multicast Routing Protocol (DVMRP), or static mroute.
Interface	Interface type and number that is configured to run PIM.

show ip pim rp-hash

To display which rendezvous point (RP) is being selected for a specified group, use the show ip pim rp-hash command in user EXEC or privileged EXEC mode.

show ip pim [vrf vrf-name] rp-hash {group-address | group-name}

Syntax Description

vrf	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	(Optional) Name assigned to the VRF.
group-address | group-name	RP information for the specified group address or name as defined in the Domain Name System (DNS) hosts table.

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.

Usage Guidelines

This command displays which RP was selected for the group specified. It also shows whether this RP was selected by Auto-RP or the PIM Version 2 bootstrap mechanism.

Examples

The following is sample output from the show ip pim rp-hash command with the group address 239.1.1.1 specified:

Router# show ip pim rp-hash 239.1.1.1

RP 172.16.24.12 (mt1-47a.cisco.com), v2

    Info source: 172.16.24.12 (mt1-47a.cisco.com), via bootstrap

         Uptime: 05:15:33, expires: 00:02:01

Table 35 describes the significant fields shown in the display.

Table 35 show ip pim rp-hash Field Descriptions 

Field	Description
RP 172.16.24.12 (mt1-47a.cisco.com), v2	Address of the RP for the group specified (239.1.1.1). Within parentheses is the DNS name of the RP. If the address of the RP is not registered in the DNS, a question mark (?) is displayed. PIM Version 2 configured.
Info source: 172.16.24.12 (mt1-47a.cisco.com), via bootstrap	Indicates from which system the router learned this RP information, along with the DNS name of the source. RP was selected by the bootstrap mechanism. In this case, the BSR is also the RP.
Uptime	Length of time (in hours, minutes, and seconds) that the router has known about this RP.
expires	Time (in hours, minutes, and seconds) after which the information about this RP expires. If the router does not receive any refresh messages in this time, it will discard information about this RP.

show ip pim vc

To display ATM virtual circuit (VC) status information for multipoint VCs opened by Protocol Independent Multicast (PIM), use the show ip pim vc command in user EXEC or privileged EXEC mode.

show ip pim vc [group-address | group-name] [interface-type interface-number]

Syntax Description

group-address | group-name	(Optional) IP multicast group or name. Displays only the single group.
interface-type interface-number	(Optional) Interface type and number. Displays only the single ATM interface.

Defaults

VC status information is displayed for all ATM interfaces.

Command Modes

User EXEC
Privileged EXEC

Command History

Release	Modification
11.3	This command was introduced.

Examples

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

Router# show ip pim vc

IP Multicast ATM VC Status

ATM0/0 VC count is 5, max is 200

Group            VCD   Interface    Leaf Count  Rate

224.2.2.2        26    ATM0/0       1           0 pps

224.1.1.1        28    ATM0/0       1           0 pps

224.4.4.4        32    ATM0/0       2           0 pps

224.5.5.5        35    ATM0/0       1           0 pps

Table 36 describes the significant fields shown in the display.

Table 36 show ip pim vc Field Descriptions 

Field	Description
ATM0/0	ATM slot and port number on the interface.
VC count	Number of VCs opened by PIM.
max	Maximum number of VCs that PIM is allowed to open, as configured by the ip pim vc-count command.
Group	IP address of the multicast group to which the router is multicasting.
VCD	Virtual circuit descriptor.
Interface	Outgoing interface.
Leaf Count	Number of routers that have joined the group and are members of that multipoint VC.
Rate	Rate (in packets per second) as configured by the ip pim minimum-vc-rate command.

Related Commands

Command	Description
ip pim multipoint-signalling	Enables PIM to open ATM multipoint switched VCs for each multicast group that a receiver joins.

show ip rpf

To display how IP multicast routing does Reverse Path Forwarding (RPF), use the show ip rpf command in privileged EXEC mode.

show ip rpf [vrf vrf-name] {source-address | source-name} [metric]

Syntax Description

vrf	(Optional) Supports the multicast VPN routing and forwarding (VRF) instance.
vrf-name	(Optional) Name assigned to the VRF.
source-address | source-name	RPF information for the specified source address or name.
metric	(Optional) Displays the unicast routing metric.

Defaults

If no source is specified, all sources are displayed.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.0	This command was introduced.
12.1(2)T	The metric keyword was added.
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.

Usage Guidelines

The router can reverse path forward from multiple routing tables (that is, the unicast routing table, Distance Vector Multicast Routing Protocol [DVMRP] routing table, or static multicast routes). This command tells you the source of the retrieved information.

Examples

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

Router# show ip rpf 172.16.10.13

RPF information for host1 (172.16.10.13)

  RPF interface: BRI0

  RPF neighbor: sj1.cisco.com (172.16.121.10)

  RPF route/mask: 172.16.0.0/255.255.0.0

  RPF type: unicast

  RPF recursion count: 0

  Doing distance-preferred lookups across tables

The following is sample output from the show ip rpf command when the metric keyword is specified:

Router# show ip rpf 172.16.10.13 metric

RPF information for host1.cisco.com (172.16.10.13)

  RPF interface: BRI0

  RPF neighbor: neighbor.cisco.com (172.16.121.10)

  RPF route/mask: 172.16.0.0/255.255.0.0

  RPF type: unicast

  RPF recursion count: 0

  Doing distance-preferred lookups across tables

  Metric preference: 110

  Metric: 11

Table 37 describes the significant fields shown in the display.

Table 37 show ip rpf Field Descriptions

Field	Description
RPF information for host1.cisco.com (172.16.10.13)	Host name and source address that this information concerns.
RPF interface	For the given source, the interface from which the router expects to get packets.
RPF neighbor	For the given source, the neighbor from which the router expects to get packets.
RPF route/mask	Route number and mask that matched against this source.
RPF type	Routing table from which this route was obtained, either unicast, DVMRP, or static mroutes.
RPF recursion count	Indicates the number of times the route is recursively resolved.
Doing distance-preferred	Indicates whether RPF was determined based on distance or length of mask.
Metric preference	The preference value used for selecting the unicast routing metric to the RP announced by the designated forwarder (DF).
Metric	Unicast routing metric to the RP announced by the DF.

show ip rpf events

To display the last 15 triggered multicast Reverse Path Forwarding (RPF) check events, use the show ip rpf events command in user EXEC or privileged EXEC mode.

show ip rpf events

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC
Privileged EXEC

Command History

Release	Modification
12.0(22)S	This command was introduced.
12.2(14)S	This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(15)T	This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines

Use this command to determine the most recent triggered multicast RPF check events.

Examples

The following is sample output from the show ip rpf events command:

Router# show ip rpf events

Last 15 triggered multicast RPF check events

RPF backoff delay:500 msec

RPF maximum delay:5 sec

DATE/TIME             BACKOFF    PROTOCOL   EVENT         RPF CHANGES

Mar 7 03:24:10.505    500 msec   Static     Route UP        0

Mar 7 03:23:11.804    1000 sec   BGP        Route UP        3

Mar 7 03:23:10.796    500 msec   ISIS       Route UP        0

Mar 7 03:20:10.420    500 msec   ISIS       Route Down      3

Mar 7 03:19:51.072    500 msec   Static     Route Down      0

Mar 7 02:46:32.464    500 msec   Connected  Route UP        3

Mar 7 02:46:24.052    500 msec   Static     Route Down      0

Mar 7 02:46:10.200    1000 sec   Connected  Route UP        3

Mar 7 02:46:09.060    500 msec   OSPF       Route UP        3

Mar 7 02:46:07.416    500 msec   OSPF       Route Down      0

Mar 7 02:45:50.423    500 msec   EIGRP      Route UP        3

Mar 7 02:45:09.679    500 msec   EIGRP      Route Down      0

Mar 7 02:45:06.322    500 msec   EIGRP      Route Down      2

Mar 7 02:33:09.424    500 msec   Connected  Route UP        0

Mar 7 02:32:28.307    500 msec   BGP        Route UP        3

The following is sample output from the show ip rpf events command when the ip multicast rpf backoff command is used with the disable keyword, disabling the triggered RPF check function:

Router# show ip rpf events

Last 15 triggered multicast RPF check events

Note:Triggered RPF disabled!

RPF backoff delay:50 msec

RPF maximum delay:2 sec

DATE/TIME             BACKOFF    PROTOCOL   EVENT         RPF CHANGES

Sep 4 06:25:31.707    500 msec   Connected  Route UP        0

Sep 4 06:25:30.099    500 msec   Connected  Route UP        0

Table 38 describes the significant fields shown in the display.

Table 38 show ip rpf events Field Descriptions 

Field	Description
RPF backoff delay	The configured amount of time (in milliseconds) allowed for the initial backoff delay.
RPF maximum delay	The maximum configured amount of time (in seconds) allowed for a backoff delay.
DATE/TIME	The date and time (in hours:minutes:seconds) an RPF event occurred.
BACKOFF	The actual backoff delay (in milliseconds) after which the RPF check was done.
PROTOCOL	The protocol that triggered the RPF check.
EVENT	This RPF check was caused by a route that went up or down, or was modified.
RPF CHANGES	The number of multicast routes that were affected by the RPF change.

show ip sap

To display the Session Announcement Protocol (SAP) cache, use the show ip sap command in user EXEC or privileged EXEC mode.

show ip sap [group-address | "session-name" | detail]

Syntax Description

group-address	(Optional) The sessions defining the specified multicast group address.
"session-name"	(Optional) Displays the single session in detail format. The session name is enclosed in quotation marks (" ") that the user must enter.
detail	(Optional) Displays all sessions in detail format.

Command Modes

User EXEC
Privileged EXEC

Command History

Release	Modification
11.1	The show ip sdr command was introduced.
12.2	The show ip sdr command was replaced by the show ip sap command.

Usage Guidelines

If the router is configured to be a member of multicast group 224.2.127.254 (the default session directory group), it will cache SAP announcements.

If no arguments or keywords are used with this command, the system displays a sorted list of session names.

Examples

The following is sample output from the show ip sap command for a session using multicast group 224.2.197.250:

Router# show ip sap 224.2.197.250

SAP Cache - 198 entries

Session Name: Session1

   Description: This broadcast is brought to you courtesy of Name1.

   Group: 0.0.0.0, ttl: 0, Contiguous allocation: 1

   Lifetime: from 10:00:00 PDT Jul 4 1999 until 10:00:00 PDT Aug 1 1999

   Uptime: 4d05h, Last Heard: 00:01:40

   Announcement source: 128.102.84.134

   Created by: sample 3136541828 3139561476 IN IP4 128.102.84.134

   Phone number: Sample Digital Video Lab (555) 555-5555

   Email: email1 <name@email.com>

   URL: http://url.com/

   Media: audio 20890 RTP/AVP 0

     Media group: 224.2.197.250, ttl: 127

     Attribute: ptime:40

   Media: video 62806 RTP/AVP 31

     Media group: 224.2.190.243, ttl: 127

Table 39 describes the significant fields shown in the display.

Table 39 show ip sap Field Descriptions 

Field	Description
SAP Cache - 198 entries	Number of entries (sessions) in the cache.
Session Name:	Name of session.
Description:	Description of the session. Individual media may have their own Description field.
Group:	IP multicast group addresses used for this session. The 0.0.0.0 IP address is displayed if individual media define separate multicast groups.
ttl:	The time-to-live (TTL) value associated with the multicast groups.
Contiguous Allocation:	Number of continuously ascending IP multicast group addresses allocated to this session.
Lifetime:	Period of time during which this session is presumed to carry traffic in the network.
Uptime:	How long (in hours, minutes, and seconds) this announcement has been stored.
Last Heard:	How long ago (in hours, minutes, and seconds) this announcement was last heard. This time is always less than the timeout value configured using the sap cache-timeout command.
Announcement source:	IP address of the host from which this session announcement was received.
Created by:	Information for identifying and tracking the session announcement.
Phone number:	Telephone number of the person or entity responsible for the session.
Email:	E-mail address of the person or entity responsible for the session.
URL:	URL for the location where further information about this session can be found.
Media:	Indicates the media type (audio, video, or data), transport port that the medium stream is sent to, transport protocol used for these media (common values are User Datagram Protocol [UDP] and Real-Time Transport Protocol [RTP]/attribute-value pair [AVP]), and list of media formats that each media instance can use. The first media format is the default format. Format identifiers are specific to the transport protocol used.
Media group:	Indicates the IP multicast group address over which the media instance is sent.
Attribute:	Indicates attributes specific to each media instance.

Related Commands

Command	Description
clear ip sap	Deletes a SAP cache entry or the entire SAP cache.
ip sap cache-timeout	Limits how long a SAP cache entry stays active in the cache.
ip sap listen	Enables the Cisco IOS software to listen to session directory announcements.

show ip sdr

The show ip sdr command is replaced by the show ip sap command. See the description of the show ip sap command for more information.

tunnel udlr address-resolution

To enable the forwarding of the Address Resolution Protocol (ARP) and Next Hop Resolution Protocol (NHRP) over a unidirectional link (UDL), use the tunnel udlr address-resolution command in interface configuration mode. To disable forwarding, use the no form of this command.

tunnel udlr address-resolution

no tunnel udlr address-resolution

Syntax Description

This command has no arguments or keywords.

Defaults

The command is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
12.1(5)T	This command was introduced.

Usage Guidelines

This command is configured on the send-only tunnel interface of a downstream router.

Examples

The following example shows how to configure the tunnel udlr address-resolution command on an interface to enable ARP and NHRP over a send-only tunnel. An ARP address resolution request received from the upstream router on the UDL (Ethernet interface 0) will be replied to over the send-only tunnel of the receiver. Likewise, an ARP request may be sent by the downstream router over the send-only tunnel, and the response will be received over the UDL.

interface tunnel 0

tunnel udlr send-only ethernet 0

tunnel udlr address-resolution

Related Commands

Command	Description
tunnel udlr send-only	Configures a unidirectional, GRE tunnel to act as a back channel that can send messages, when another interface is configured for UDLR to receive messages.

tunnel udlr receive-only

To configure a unidirectional, generic routing encapsulation (GRE) tunnel to act as a back channel that can receive messages, when another interface is configured for unidirectional link routing (UDLR) to send messages, use the tunnel udlr receive-only command in interface configuration mode. To remove the tunnel, use the no form of this command.

tunnel udlr receive-only interface-type interface-number

no tunnel udlr receive-only interface-type interface-number

Syntax Description

interface-type interface-number

Interface type and number. The interface-type and interface-number arguments must match the unidirectional send-only interface type and number specified by the interface command. Thus, when packets are received over the tunnel, the upper layer protocols will treat the packets as if they are received over the unidirectional send-only interface.

Defaults

No UDLR tunnel is configured.

Command Modes

Interface configuration

Command History

Release	Modification
12.0(3)T	This command was introduced.

Usage Guidelines

Use this command to configure a router that has a unidirectional interface with send-only capabilities. One example of when you might configure this command is if you have traffic traveling via a satellite.

The interface-type and interface-number arguments must match the send-only interface type and number specified by the interface command.

You must configure the tunnel udlr send-only command at the opposite end of the tunnel.

If you have a large number of receivers, you should configure UDLR by an alternative means: Internet Group Management Protocol (IGMP) UDLR. See the description of the ip igmp unidirectional-link command.

Examples

In the following example, Router A (the upstream router) is configured with Open Shortest Path First (OSPF) and Protocol Independent Multicast (PIM). Serial interface 0 has send-only capability. Therefore, the UDLR tunnel is configured as receive-only, and points to serial interface 0.

Router A Configuration

ip multicast-routing

!

! Serial0 has send-only capability

!

interface serial 0

 encapsulation hdlc

 ip address 10.1.0.1 255.255.0.0

 ip pim sparse-dense-mode

! 

! Configure tunnel as receive-only UDLR tunnel.

!

interface tunnel 0

 tunnel source ethernet 0

 tunnel destination <downstream-router>

 tunnel udlr receive-only serial 0

!

! Configure OSPF.

!

router ospf <pid>

 network 10.0.0.0 0.255.255.255 area 0

Router B (the downstream router) is configured with OSPF and PIM. Serial interface 1 has receive-only capability. Therefore, the UDLR tunnel is configured as send-only, and points to serial interface 1.

Router B Configuration

ip multicast-routing

!

! Serial1 has receive-only capability

!

interface serial 1

 encapsulation hdlc

 ip address 10.1.0.2 255.255.0.0

 ip pim sparse-dense-mode

! 

! Configure tunnel as send-only UDLR tunnel.

!

interface tunnel 0

 tunnel source ethernet 0

 tunnel destination <upstream-router>

 tunnel udlr send-only serial 1

!

! Configure OSPF.

!

router ospf <pid>

 network 10.0.0.0 0.255.255.255 area 0

Related Commands

Command	Description
interface	Defines the IP addresses of the server, configures an interface type, and enters interface configuration mode.
interface tunnel	Configures a tunnel interface.
ip igmp unidirectional-link	Configures an interface to be unidirectional and enables it for IGMP UDLR.
tunnel udlr send-only	Configures a unidirectional, GRE tunnel to act as a back channel that can send messages, when another interface is configured for UDLR to receive messages.

tunnel udlr send-only

To configure a unidirectional, generic routing encapsulation (GRE) tunnel to act as a back channel that can send messages, when another interface is configured for unidirectional link routing (UDLR) to receive messages, use the tunnel udlr send-only command in interface configuration mode. To remove the tunnel, use the no form of this command.

tunnel udlr send-only interface-type interface-number

no tunnel udlr send-only interface-type interface-number

Syntax Description

interface-type interface-number

Interface type and number. The interface-type and interface-number arguments must match the unidirectional receive-only interface type and number specified by the interface command. Thus, when packets are sent by upper layer protocols over the interface, they will be redirected and sent over this GRE tunnel.

Defaults

No UDLR tunnel is configured.

Command Modes

Interface configuration

Command History

Release	Modification
12.0(3)T	This command was introduced.

Usage Guidelines

Use this command to configure a router that has a unidirectional interface with receive-only capabilities. The UDLR tunnel will act as a back channel. One example of when you might configure this command is if you have traffic traveling via a satellite.

The interface-type and interface-number arguments must match the receive-only interface type and number specified by the interface command.

You must configure the tunnel udlr receive-only command at the opposite end of the tunnel.

Examples

In the following example, Router A (the upstream router) is configured with Open Shortest Path First (OSPF) and Protocol Independent Multicast (PIM). Serial interface 0 has send-only capability. Therefore, the UDLR tunnel is configured as receive-only, and points to serial interface 0.

Router A Configuration

ip multicast-routing

!

! Serial0 has send-only capability

!

interface serial 0

 encapsulation hdlc

 ip address 10.1.0.1 255.255.0.0

 ip pim sparse-dense-mode

! 

! Configure tunnel as receive-only UDLR tunnel.

!

interface tunnel 0

 tunnel source ethernet 0

 tunnel destination <downstream-router>

 tunnel udlr receive-only serial 0

Router B (the downstream router) is configured with OSPF and PIM. Serial interface 1 has receive-only capability. Therefore, the UDLR tunnel is configured as send-only, and points to serial interface 1.

Router B Configuration

ip multicast-routing

!

! Serial1 has receive-only capability

!

interface serial 1

 encapsulation hdlc

 ip address 10.1.0.2 255.255.0.0

 ip pim sparse-dense-mode

! 

! Configure tunnel as send-only UDLR tunnel.

!

interface tunnel 0

 tunnel source ethernet 0

 tunnel destination <upstream-router>

 tunnel udlr send-only serial 1

Related Commands

Command	Description
interface	Defines the IP addresses of the server, configures an interface type, and enters interface configuration mode.
interface tunnel	Configures a tunnel interface.
ip igmp unidirectional-link	Configures an interface to be unidirectional and enables it for IGMP UDLR.
tunnel udlr address-resolution	Enables the forwarding of ARP and NHRP over a UDL.
tunnel udlr receive-only	Configures a unidirectional, GRE tunnel to act as a back channel that can receive messages, when another interface is configured for UDLR to send messages.

udp-port

To change the User Datagram Protocol (UDP) port numbers to which a Test Sender sends test packets or a Test Receiver sends status reports during Multicast Routing Monitor (MRM) tests, use the udp-port command in MRM manager configuration mode. To restore the default settings, use the no form of this command.

udp-port [test-packet port-number] [status-report port-number]

no udp-port

Syntax Description

test-packet port-number	(Optional) Specifies the UDP port number to which test packets are sent by a Test Sender. The port number must be even if the packets are Real-Time Transport Protocol (RTP)-encapsulated. The range is from 16384 to 65535. By default, the Test Sender uses UDP port number 16834 to send test packets.
status-report port-number	(Optional) Specifies the UDP port number to which status reports are sent by a Test Receiver. The port number must be odd if the packets are RTP Control Protocol (RTCP)-encapsulated. The range is from 16834 to 65535. By default, the Test Receiver uses UDP port number 65535 to send status reports.

Command Default

Test Senders use UDP port number 16834 to send test packets, and Test Receivers use UDP port number 65535 to send status reports.

Command Modes

MRM manager configuration

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.

Examples

The following example shows how to change the UDP port to which test packets are sent by a Test Sender to UDP port number 20302:

ip mrm manager test

 udp-port test-packet 20302

Related Commands

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