Multicast Source Discovery Protocol Commands

This chapter explains the function and syntax of the Multicast Source Discovery Protocol (MSDP) commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS IP and IP Routing Command Reference, Release 12.1.

clear ip msdp peer

To clear the TCP connection to the specified Multicast Source Discovery Protocol (MSDP) peer, use the clear ip msdp peer EXEC command.

clear ip msdp peer {ip-address | name}

Syntax Description

ip-address | name

IP address or name of the MSDP peer to which the TCP connection is cleared.

ip-address \| name	IP address or name of the MSDP peer to which the TCP connection is cleared.

clear ip msdp sa-cache

To clear Multicast Source Discovery Protocol (MSDP) Source-Active cache entries, use the clear ip msdp sa-cache EXEC command.

clear ip msdp sa-cache [group-address | name]

Syntax Description

group-address | name

(Optional) Multicast group address or name for which Source-Active entries are cleared from the Source-Active cache.

group-address \| name	(Optional) Multicast group address or name for which Source-Active entries are cleared from the Source-Active cache.

clear ip msdp statistics

To clear statistics counters for one or all of the Multicast Source Discovery Protocol (MSDP) peers without resetting the sessions, use the clear ip msdp statistics EXEC command.

clear ip msdp statistics [peer-address | name]

Syntax Description

peer-address | name

(Optional) Address or name of the MSDP peers whose statistics counters, reset count, and input/output count are cleared.

peer-address \| name	(Optional) Address or name of the MSDP peers whose statistics counters, reset count, and input/output count are cleared.

ip msdp border

To configure a router that borders a Protocol Independent Multicast (PIM) sparse mode region and dense-mode region to use Multicast Source Discovery Protocol (MSDP), use the ip msdp border global configuration command. To prevent this action, use the no form of this command.

ip msdp border sa-address type number

no ip msdp border sa-address type number

Syntax Description

sa-address

Active source IP address.

type number

Interface type and number from which the IP address is derived and used as the RP address in Source-Active messages. Thus, MSDP peers can forward Source-Active messages away from this border. The IP address of the interface is used as the Originator-ID, which is the RP field in the MSDP Source-Active message.

sa-address	Active source IP address.
type number	Interface type and number from which the IP address is derived and used as the RP address in Source-Active messages. Thus, MSDP peers can forward Source-Active messages away from this border. The IP address of the interface is used as the Originator-ID, which is the RP field in the MSDP Source-Active message.

ip msdp cache-sa-state

To have the router create Source-Active (SA) state, use the ip msdp cache-sa-state global configuration command. To prevent this action, use the no form of this command.

ip msdp cache-sa-state [list access-list-number]

no ip msdp cache-sa-state

Syntax Description

list access-list-number

(Optional) Extended IP access list number in the range from 100 to 199 that defines which source/group pairs to cache.

list access-list-number	(Optional) Extended IP access list number in the range from 100 to 199 that defines which source/group pairs to cache.

ip msdp default-peer

To define a default peer from which to accept all Multicast Source Discovery Protocol (MSDP) Source-Active messages, use the ip msdp default-peer global configuration command. To remove the default peer, use the no form of this command.

ip msdp default-peer ip-address | name [prefix-list list]

no ip msdp default-peer

Syntax Description

ip-address | name

IP address or Domain Name System (DNS) name of the MSDP default peer.

prefix-list list

(Optional) Border Gateway Protocol (BGP) prefix-list that specifies the peer will be a default peer only for the prefixes listed in the list specified by the list argument. Of course, there must be a BGP prefix-list configured for this prefix-list list keyword and argument to have any effect.

ip-address \| name	IP address or Domain Name System (DNS) name of the MSDP default peer.
prefix-list list	(Optional) Border Gateway Protocol (BGP) prefix-list that specifies the peer will be a default peer only for the prefixes listed in the list specified by the list argument. Of course, there must be a BGP prefix-list configured for this prefix-list list keyword and argument to have any effect.

ip msdp description

To add descriptive text to the configuration for a Multicast Source Discovery Protocol (MSDP) peer, use the ip msdp description global configuration command. To remove the description, use the no form of this command.

ip msdp description {peer-name | peer-address} text

no ip msdp description {peer-name | peer-address}

Syntax Description

peer-name | peer-address

Peer name or address to which this description applies.

text

Description of the MSDP peer.

peer-name \| peer-address	Peer name or address to which this description applies.
text	Description of the MSDP peer.

ip msdp filter-sa-request

To configure the router to send Source-Active Request (SA Request) messages to the Multicast Source Discovery Protocol (MSDP) peer when a new joiner from a group becomes active, use the ip msdp filter-sa-request global configuration command. To prevent this action, use the no form of this command.

ip msdp filter-sa-request {ip-address | name} [list access-list-number]

no ip msdp filter-sa-request {ip-address | name}

Syntax Description

ip-address | name

IP address or name of the MSDP peer from which the local router requests Source-Active messages when a new joiner for the group becomes active.

list access-list-number

(Optional) Standard IP access list number that describes a multicast group address. The access list number is in the range 1 to 99. If no access list is specified, all Source-Active Request messages are ignored.

ip-address \| name	IP address or name of the MSDP peer from which the local router requests Source-Active messages when a new joiner for the group becomes active.
list access-list-number	(Optional) Standard IP access list number that describes a multicast group address. The access list number is in the range 1 to 99. If no access list is specified, all Source-Active Request messages are ignored.

ip msdp mesh-group

To configure a Multicast Source Discovery Protocol (MSDP) peer to be a member of a mesh group, use the ip msdp mesh-group global configuration command. To remove an MSDP peer from a mesh group, use the no form of this command.

ip msdp mesh-group name {ip-address | name}

no ip msdp mesh-group name {ip-address | name}

Syntax Description

name

Name of the mesh group.

ip-address | name

IP address or name of the MSDP peer to be a member of the mesh group.

name	Name of the mesh group.
ip-address \| name	IP address or name of the MSDP peer to be a member of the mesh group.

ip msdp originator-id

To allow a Multicast Source Discovery Protocol (MSDP) speaker that originates a Source-Active (SA) message to use the IP address of the interface as the rendezvous point (RP) address in the SA message, use the ip msdp originator-id global configuration command. To prevent the RP address from being derived in this way, use the no form of this command.

ip msdp originator-id type number

no ip msdp originator-id type number

Syntax Description

type number

Interface type and number on the local router, whose IP address is used as the RP address in Source-Active messages.

type number	Interface type and number on the local router, whose IP address is used as the RP address in Source-Active messages.

ip msdp peer

To configure a Multicast Source Discovery Protocol (MSDP) peer, use the ip msdp peer global configuration command. To remove the peer relationship, use the no form of this command.

ip msdp peer {peer-name | peer-address} [connect-source type number] [remote-as
as-number]

no ip msdp peer {peer-name | peer-address}

Syntax Description

peer-name | peer-address

DNS name or IP address of the router that is to be the MSDP peer.

connect-source type number

(Optional) Interface type and number whose primary address becomes the source IP address for the TCP connection. This interface is on the router being configured.

remote-as as-number

(Optional) Autonomous system number of the MSDP peer. This is used for display purposes only.

There are cases where a peer might appear to be in another autonomous system (other than the one it really resides in) when you MSDP-peer but do not BGP-peer with that peer. In this case, if the prefix of the peer is injected by another autonomous system (AS), it is displayed as the AS number of the peer (and is misleading).

peer-name \| peer-address	DNS name or IP address of the router that is to be the MSDP peer.
connect-source type number	(Optional) Interface type and number whose primary address becomes the source IP address for the TCP connection. This interface is on the router being configured.
remote-as as-number	(Optional) Autonomous system number of the MSDP peer. This is used for display purposes only. There are cases where a peer might appear to be in another autonomous system (other than the one it really resides in) when you MSDP-peer but do not BGP-peer with that peer. In this case, if the prefix of the peer is injected by another autonomous system (AS), it is displayed as the AS number of the peer (and is misleading).

ip msdp redistribute

To configure which (S,G) entries from the multicast routing table are advertised in Source-Active (SA) messages originated to Multicast Source Discovery Protocol (MSDP) peers, use the ip msdp redistribute global configuration command. To remove the filter, use the no form of this command.

ip msdp redistribute [list access-list-name] [asn aspath-access-list-number] [route-map map]

no ip msdp redistribute

Syntax Description

list access-list-name

(Optional) Name or number of a standard or extended IP access list that controls which local sources are advertised and to which groups they send.

asn aspath-access-list-number

(Optional) Standard or extended IP access list number in the range 1 to 199. This access list number must also be configured in the ip as-path command.

route-map map

(Optional) Standard or extended IP access list number in the range 1 to 199. This access list number must also be configured in the ip as-path command.

list access-list-name	(Optional) Name or number of a standard or extended IP access list that controls which local sources are advertised and to which groups they send.
asn aspath-access-list-number	(Optional) Standard or extended IP access list number in the range 1 to 199. This access list number must also be configured in the ip as-path command.
route-map map	(Optional) Standard or extended IP access list number in the range 1 to 199. This access list number must also be configured in the ip as-path command.

ip msdp sa-filter in

To configure an incoming filter list for Source-Active (SA) messages received from the specified Multicast Source Discovery Protocol (MSDP) peer, use the ip msdp sa-filter in global configuration command. To remove the filter, use the no form of this command.

ip msdp sa-filter in {ip-address | name} [list access-list-name] [route-map map-tag]

no ip msdp sa-filter in {ip-address | name} [list access-list-name] [route-map map-tag]

Syntax Description

ip-address | name

IP address or name of the MSDP peer from which the Source-Active messages are filtered.

list access-list-name

(Optional) IP access list name. If no access list is specified, all source/group pairs from the peer are filtered.

route-map map-tag

(Optional) Route map name. From the specified MSDP peer, passes only those SA messages that meet the match criteria in the route map map-tag.

If all match criteria are true, a permit keyword from the route-map will pass routes through the filter. A deny keyword will filter routes.

If both the list and the route-map keywords are used, all conditions must be true to pass any (S,G) pair in incoming SA messages.

ip-address \| name	IP address or name of the MSDP peer from which the Source-Active messages are filtered.
list access-list-name	(Optional) IP access list name. If no access list is specified, all source/group pairs from the peer are filtered.
route-map map-tag	(Optional) Route map name. From the specified MSDP peer, passes only those SA messages that meet the match criteria in the route map map-tag. If all match criteria are true, a permit keyword from the route-map will pass routes through the filter. A deny keyword will filter routes. If both the list and the route-map keywords are used, all conditions must be true to pass any (S,G) pair in incoming SA messages.

ip msdp sa-filter out

To configure an outgoing filter list for Source-Active messages sent to the specified Multicast Source Discovery Protocol (MSDP) peer, use the ip msdp sa-filter out global configuration command. To remove the filter, use the no form of this command.

ip msdp sa-filter out {ip-address | name} [list access-list-name] [route-map map-tag]

no ip msdp sa-filter out {ip-address | name} [list access-list-name] [route-map map-tag]

Syntax Description

ip-address | name

IP address or DNS name of the MSDP peer to which the Source-Active messages are filtered.

list access-list-name

(Optional) Extended IP access list number or name. If no access list is specified, all source/group pairs are filtered. To the specified MSDP peer, passes only those Source-Active messages that pass the extended access list.

If both the list and the route-map keywords are used, all conditions must be true to pass any (S,G) pair in outgoing SA messages.

route-map map-tag

(Optional) Route map name. To the specified MSDP peer, passes only those Source-Active messages that meet the match criteria in the route map map-tag.

If all match criteria are true, a permit from the route-map will pass routes through the filter. A deny will filter routes.

If both the list and the route-map keywords are used, all conditions must be true to pass any (S,G) pair in outgoing SA messages.

ip-address \| name	IP address or DNS name of the MSDP peer to which the Source-Active messages are filtered.
list access-list-name	(Optional) Extended IP access list number or name. If no access list is specified, all source/group pairs are filtered. To the specified MSDP peer, passes only those Source-Active messages that pass the extended access list. If both the list and the route-map keywords are used, all conditions must be true to pass any (S,G) pair in outgoing SA messages.
route-map map-tag	(Optional) Route map name. To the specified MSDP peer, passes only those Source-Active messages that meet the match criteria in the route map map-tag. If all match criteria are true, a permit from the route-map will pass routes through the filter. A deny will filter routes. If both the list and the route-map keywords are used, all conditions must be true to pass any (S,G) pair in outgoing SA messages.

ip msdp sa-request

To configure the router to send Source-Active Request messages to the Multicast Source Discovery Protocol (MSDP) peer when a new joiner from the group becomes active, use the ip msdp sa-request global configuration command. To prevent this action, use the no form of this command.

ip msdp sa-request {ip-address | name}

no ip msdp sa-request {ip-address | name}

Syntax Description

ip-address | name

IP address or name of the MSDP peer from which the local router requests Source-Active messages when a new joiner for the group becomes active.

ip-address \| name	IP address or name of the MSDP peer from which the local router requests Source-Active messages when a new joiner for the group becomes active.

ip msdp shutdown

To administratively shut down a configured Multicast Source Discovery Protocol (MSDP) peer, use the ip msdp shutdown global configuration command. To bring the peer back up, use the no form of this command.

ip msdp shutdown {peer-address | peer-name}

no ip msdp shutdown {peer-address | peer-name}

Syntax Description

peer-address | peer-name

IP address or name of the MSDP peer to shut down.

peer-address \| peer-name	IP address or name of the MSDP peer to shut down.

ip msdp ttl-threshold

To limit which multicast data packets are sent in Source-Active (SA) messages to a Multicast Source Discovery Protocol (MSDP) peer, use the ip msdp ttl-threshold global configuration command. To restore the default value, use the no form of this command.

ip msdp ttl-threshold {ip-address | name} ttl

no ip msdp ttl-threshold {ip-address | name}

Syntax Description

ip-address | name

IP address or name of the MSDP peer to which the ttl limitation applies. The default value of the ttl argument is 0, meaning all multicast data packets are forwarded to the peer until the TTL is exhausted.

ttl

Time-to-live (TTL) value.

ip-address \| name	IP address or name of the MSDP peer to which the ttl limitation applies. The default value of the ttl argument is 0, meaning all multicast data packets are forwarded to the peer until the TTL is exhausted.
ttl	Time-to-live (TTL) value.

show ip msdp count

To display the number of sources and groups originated in Multicast Source Discovery Protocol (MSDP) Source-Active (SA) messages, use the show ip msdp count EXEC command.

show ip msdp count [autonomous-system-number]

Syntax Description

autonomous-system-number

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

autonomous-system-number	(Optional) Displays the number of sources and group originated in SA messages from the specified autonomous system.

show ip msdp peer

To display detailed information about the Multicast Source Discovery Protocol (MSDP) peer, use the show ip msdp peer EXEC command.

show ip msdp peer peer-address | name

Syntax Description

peer-address | name

Address or name of the MSDP peer for which information is displayed.

peer-address \| name	Address or name of the MSDP peer for which information is displayed.

show ip msdp sa-cache

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

Syntax Description

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 (source, group) information is displayed. If two address 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 SA cache is displayed.

autonomous-system-number

(Optional) Only state originated by the autonomous system specified is displayed.

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 (source, group) information is displayed. If two address 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 SA cache is displayed.
autonomous-system-number	(Optional) Only state originated by the autonomous system specified is displayed.

show ip msdp summary

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

show ip msdp summary

Syntax Description

This command has no arguments or keywords.

Table of Contents

Multicast Source Discovery Protocol Commands