6.4. Show, Clear, and Debug Command Reference

6.4.1. Command Hierarchies

  1. Show Commands
  2. Clear Commands
  3. Debug Commands

6.4.1.1. Show Commands

show
— router
— msdp
— group [group-name] [detail]
— peer [ip-address] [group group-name] [detail]
— source [ip-address/mask] [type {configured | dynamic | both}] [detail]
— source-active [{group ip-address | local | originator ip-address | peer ip-address | source ip-address | group ip-address source ip-address}] [detail]
— source-active-rejected [peer-group name] [group ip-address] [source ip-address] [originator ip-address] [peer ip-address]
— statistics [peer ip-address]
— status

6.4.1.2. Clear Commands

clear
— router
— msdp
— cache [peer ip-address] [group ip-address] [source ip-address] [originrp ip-address]
— statistics [peer ip-address]

6.4.1.3. Debug Commands

debug
— router
— [no] msdp
— packet [pkt-type] [peer ip-address]
— no packet
— pim [grp-address]
— no pim
— rtm [rp-address]
— no rtm
— sa-db [group grpAddr] [source srcAddr] [rp rpAddr]
— no sa-db

6.4.2. Command Descriptions

6.4.2.1. Show Commands

The command outputs in the following section are examples only; actual displays may differ depending on supported functionality and user configuration.

group

Syntax 
group [group-name] [detail]
Context 
show>router>msdp
Description 

This command displays information about MSDP groups.

Parameters 
group-name—
Displays information about the specified group name, up to 32 characters. If no group-name is specified, information about all group names display.
detail—
Displays detailed MSDP group information.
Output 

The following is an example of MSDP group information. Table 27 provides MSDP group field descriptions.

Sample Output
*A:ALA-48>show>router>msdp# group
===============================================================================
MSDP Groups
===============================================================================
Group Name                        Mode       Act Srcs  Local Address          
-------------------------------------------------------------------------------
main                              Mesh-group None None                   
loop1                             Mesh-group None None                   
loop2                             Mesh-group None None                   
loop3                             Mesh-group None None                   
loop4                             Mesh-group None None                   
loop5                             Mesh-group None None                   
-------------------------------------------------------------------------------
Groups : 6
=======================
*A:ALA-48>show>router>msdp# 
 
 
*A:ALA-48>show>router>msdp# group test
===============================================================================
MSDP Groups
===============================================================================
Group Name                        Mode       Act Srcs  Local Address
-------------------------------------------------------------------------------
test                              Mesh-group 50000     10.10.10.103
-------------------------------------------------------------------------------
Groups : 1
===============================================================================
*A:ALA-48>show>router>msdp#
 
 
*A:ALA-48>show>router>msdp# group test detail
===============================================================================
MSDP Groups
===============================================================================
Group Name         : test
-------------------------------------------------------------------------------
Local Address      : 10.10.10.103
Admin State        : Up                 Receive Msg Rate   : None
Receive Msg Time   : None               Receive Msg Thd    : None
Mode               : Mesh-group         SA Limit           : 50000
Export Policy      : None Specified / Inherited
Import Policy      : None Specified / Inherited
 
-------------------------------------------------------------------------------
Groups : 1
===============================================================================
*A:ALA-48>show>router>msdp#
Table 27:  MSDP Group Fields 

Label

Description

Group Name

The MSDP group name.

Mode

The groups of peers in a full mesh topology to limit excessive flooding of source-active messages to neighboring peers.

Act Srcs

The configured maximum number of active source messages that will be accepted by MSDP.

Local Address

The local end of a MSDP session.

Admin State

The administrative state.

Receive Msg Rate

Displays rate that the messages are read from the TCP session.

Receive Msg Time

The time of MSDP messages that are read from the TCP session within the configured number of seconds.

Receive Msg Thd

The configured threshold number of MSDP messages can be processed before the MSDP message rate limiting function.

SA Limit

The source-active limit.

peer

Syntax 
peer [ip-address] [group group-name] [detail]
Context 
show>router>msdp
Description 

This command displays information about an MSDP peer.

Parameters 
ip-address—
Displays information about the specified IP address. If no IP address specified, information about all MSDP IP addresses display.
group group-name—
Displays information about the specified group name. If no group-name is specified, information about all MSDP peers display.
detail—
Displays detailed MSDP peer information.
Output 

The following is an example of MSDP peer information. Table 28 provides MSDP field descriptions.

Sample Output
A:ALA-48# show router msdp peer
=============================================================================
MSDP Peers
=============================================================================
Peer             Local Address    State       Last State Change     SA Learnt
-----------------------------------------------------------------------------
10.20.1.1        10.20.1.6        Established 08/30/2002 03:22:131008    
-----------------------------------------------------------------------------
Peers : 1
=============================================================================
A:ALA-48# 
 
 
A:ALA-48# show router msdp peer detail
===============================================================================
MSDP Peers
-------------------------------------------------------------------------------
Peer Address       : 10.20.1.1                                                
-------------------------------------------------------------------------------
Group Name         : None                                                     
Local Address      : 10.20.1.6                                                
Last State Change  : 08/30/2002 03:22:13 Last Act Src Limit : N/A
Peer Admin State   : Up                 Default Peer       : No               
Peer Connect Retry : 0                  State              : Established      
SA accepted        : 1008               SA received        : 709              
State timer expires: 18                 Peer time out      : 62               
Active Source Limit: None               Receive Msg Rate   : 0                
Receive Msg Time   : 0                  Receive Msg Thd    : 0                
Auth Status        : Disabled           Auth Key           : None             
Export Policy      : None Specified / Inherited
Import Policy      : None Specified / Inherited
-------------------------------------------------------------------------------
Peers : 1
===============================================================================
A:ALA-48#
Table 28:  MSDP Fields 

Label

Description

Peer

The IP address of the peer.

Local Address

The local IP address.

State

The current state of the peer.

Last State Change

The date and time of the peer’s last state change.

SA Learn

The number of SAs learned through a peer.

source

Syntax 
source [ip-address/mask] [type {configured | dynamic | both}] [detail]
Context 
show>router>msdp
Description 

This command displays the discovery method for this multicast source.

Parameters 
configured—
Displays user-created sources.
dynamic—
Displays dynamically created sources.
both—
Displays both user-configured and dynamically created sources.
detail—
Displays detailed MSDP source information.

source-active

Syntax 
source-active [{group ip-address | local | originator ip-address | peer ip-address | source ip-address | group ip-address source ip-address}] [detail]
Context 
show>router>msdp
Description 

This command displays source active messages accepted by MSDP.

Parameters 
group ip-address—
Displays information about the specified group IP address.
local—
Displays information about local source-active messages.
originator ip-address—
Displays information about the specified originator IP address.
peer ip-address—
Displays information about the specified peer IP address.
source ip-address—
Displays information about the specified source IP address.
group ip-address—
Displays information about the specified group IP address.
detail—
Displays detailed MSDP source-active information.
Output 

The following is an example of MSDP source active information. Table 29 provides MSDP source active field descriptions.

Sample Output
A:ALA-48# show router msdp source-active
===============================================================================
MSDP Source Active Info
===============================================================================
Grp Address      Src Address      Origin RP        Peer Address State Timer
-------------------------------------------------------------------------------
239.100.0.0      10.112.1.2      10.20.1.1        10.20.1.1 69        
239.100.0.1      10.112.1.2      10.20.1.1        10.20.1.1 69        
239.100.0.2      10.112.1.2      10.20.1.1        10.20.1.1 69        
239.100.0.3      10.112.1.2      10.20.1.1        10.20.1.1 69        
239.100.0.4      10.112.1.2      10.20.1.1        10.20.1.1 69        
239.100.0.5      10.112.1.2      10.20.1.1        10.20.1.1 69        
239.100.0.6      10.112.1.2      10.20.1.1        10.20.1.1 69        
239.100.0.7      10.112.1.2      10.20.1.1        10.20.1.1 69        
239.100.0.8      10.112.1.2      10.20.1.1        10.20.1.1 69        
239.100.0.9      10.112.1.2      10.20.1.1        10.20.1.1 69        
-------------------------------------------------------------------------------
MSDP Source Active : 10
===============================================================================
A:ALA-48# 
 
 
A:ALA-48# show router msdp source-active detail
===============================================================================
MSDP Source Active
===============================================================================
Group Address      : 239.100.0.0        Source Address     : 10.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 3d 01:44:25      
Group Address      : 239.100.0.1        Source Address     : 10.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 239.100.0.2        Source Address     : 10.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 239.100.0.3        Source Address     : 10.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 239.100.0.4        Source Address     : 10.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 239.100.0.5        Source Address     : 10.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 239.100.0.7        Source Address     : 10.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 239.100.0.8        Source Address     : 10.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
Group Address      : 239.100.0.9        Source Address     : 10.112.1.2      
Origin RP          : 10.20.1.1          Peer Address       : 10.20.1.1        
State Timer        : 64                 Up Time            : 48d 18:22:29     
-------------------------------------------------------------------------------
MSDP Source Active : 10
===============================================================================
A:ALA-48# 
Table 29:  MSDP Source-Active Fields 

Label

Description

Grp Address

The IP address of the group.

Src Address

The IP address of the source.

Origin RP

The origination rendezvous point (RP) address.

Peer Address

The address of the peer.

State Timer

The time-out value. If the value reaches zero, the SA is removed.

source-active-rejected

Syntax 
source-active-rejected [peer-group name] [group ip-address] [source ip-address] [originator ip-address] [peer ip-address]
Context 
show>router>msdp
Description 

This command displays source-active messages rejected by MSDP.

Parameters 
peer-group name—
Displays information about rejected source-active messages for the specified peer group.
group ip-address—
Displays information about the specified group IP address.
source ip-address—
Displays information about the source address of the source active entry that is rejected.
originator ip-address—
Displays information about the specified originator IP address.
peer ip-address—
Displays information about the peer from which this rejected source active entry was last received.
Output 

The following is an example of MSDP rejected source active information. Table 30 provides MSDP source active field descriptions.

Sample Output
*A:ALA-48# show router msdp source-active-rejected
===============================================================================
MSDP Source Active Rejected Info
===============================================================================
Grp Address     Src Address     Origin RP       Peer Address    Reject Reason
-------------------------------------------------------------------------------
239.100.0.1     10.0.0.1       10.20.0.1       239.0.0.1        Import Policy
239.100.0.2     10.0.0.2       10.20.0.2       239.0.0.2        Export Policy
239.100.0.3     10.0.0.3       10.20.0.3       239.0.0.3        RPF Failure
239.100.0.4     10.0.0.4       10.20.0.4       239.0.0.4        Limit Exceeded
239.100.0.5     10.0.0.5       10.20.0.5       239.0.0.5        Limit Exceeded
239.100.0.6     10.0.0.6       10.20.0.6       239.0.0.6        Limit Exceeded
239.100.0.7     10.0.0.7       10.20.0.7       239.0.0.7        Limit Exceeded
-------------------------------------------------------------------------------
SA Rejected Entries : 7
===============================================================================
*A:ALA-48# 
Table 30:  MSDP Source-Active Fields 

Label

Description

Grp Address

The IP address of the group.

Src Address

The IP address of the source.

Origin RP

The origination rendezvous point (RP) address.

Peer Address

The address of the peer.

Reject Reason

The reason why this source active entry is rejected.

statistics

Syntax 
statistics [peer ip-address]
Context 
show>router>msdp
Description 

This command displays statistics information related to a MSDP peer.

Parameters 
ip-address—
Displays information about the specified peer IP address.
Output 

The following is an example of MSDP statistics information. Table 31 provides MSDP statistics field descriptions.

Sample Output
A:ALA-48# show router msdp statistics
===============================================================================
MSDP Statistics
===============================================================================
Glo ActSrc Lim Excd: 0                                                        
-------------------------------------------------------------------------------
Peer Address       : 10.20.1.1                                                
-------------------------------------------------------------------------------
Last State Change  : 0d 11:33:16        Last message Peer  : 0d 00:00:17      
RPF Failures       : 0                  Remote Closes      : 0                
SA Msgs Sent       : 0                  SA Msgs Recvd      : 709              
SA req. Msgs Sent  : 0                  SA req. Msgs Recvd : 0                
SA res. Msgs Sent  : 0                  SA res. Msgs Recvd : 0                
KeepAlive Msgs Sent: 694                KeepAlive Msgs Recd: 694              
Unknown Msgs Sent  : 0                  Error Msgs Recvd   : 0                
-------------------------------------------------------------------------------
Peers : 1
===============================================================================
A:ALA-48#
Table 31:  MSDP Statistics Fields 

Label

Description

Last State Change

The date and time the peer state changed.

RPF Failures

The number of reverse path forwarding (RPF) failures.

SA Msgs Sent

The number of source-active messages sent.

SA req. Msgs Sent

The number of source-active request messages sent.

SA res. Msgs Sent

The number of source-active response messages sent.

KeepAlive Msgs Sent

The number of keepalive messages sent.

Unknown Msgs Sent

The number of unknown messages received.

Last message Peer

The time the last message was received from the peer.

Remote Closes

The number of times the remote peer close.

SA Msgs Recvd

The number of source-active messages received.

SA req. Msgs Recvd

The number of source-active request messages received.

SA res. Msgs Recvd

The number of source-active response messages received.

KeepAlive Msgs Recd

The number of keepalive messages received.

Error Msgs Recvd

The number of unknown messages received.

status

Syntax 
status
Context 
show>router>msdp
Description 

This command displays MSDP status information.

Output 

The following is an example of MSDP status information. Table 32 provides MSDP status field descriptions.

Table 32:  MSDP Status Fields 

Label

Description

Admin State

The administrative state.

Local Address

The local IP address.

Active Src Limit

The active source limit.

Act Src Lim Excd

The active source limit which has been exceeded.

Num. Peers

The number of peers.

Num. Peers Estab

The number of peers established.

Num. Source Active

The number of active sources.

Policies

The policy to export source active state from the source active list into MSDP.

Data Encapsulation

The rendezvous point (RP) using MSDP to encapsulate multicast data received in MSDP register messages inside forwarded MSDP source-active messages - enabled or disabled.

Rate

The receive message rate.

Time

The receive message time.

Threshold

The number of MSDP messages that can be processed before the MSDP message rate limiting function is activated.

RPF Table

The name of the reverse path forwarding table.

Last msdp Enabled

The time the last MSDP was triggered.

Sample Output
A:ALA-48# show router msdp status 
===============================================================================
MSDP Status
===============================================================================
Admin State                       : Up 
Local Address                     : None 
Global Statistics
Active Src Limit                  : None                                      
Act Src Lim Excd                  : 0                                         
Num. Peers                        : 1                                         
Num. Peers Estab                  : 1                                         
Num. Source Active                : 10 
Policies                          : None
Data Encapsulation                : Enabled 
Receive Msg Rate
Rate                              : 0                                         
Time                              : 0                                         
Threshold                         : 0 
Last Msdp Enabled                 : 08/30/2002 03:21:43
===============================================================================
A:ALA-48#

6.4.2.2. Clear Commands

msdp

Syntax 
msdp
Context 
clear>router
Description 

This command enables the context to clear and reset Multicast Source Discovery protocol (MSDP) entities and statistics.

cache

Syntax 
cache [peer ip-address] [group ip-address] [source ip-address] [originrp ip-address]
Context 
clear>router>msdp
Description 

This command clears the MSDP cache.

Parameters 
peer ip-address—
Clears the cache of the IP address of the peer to which Multicast Source Discovery protocol (MSDP) source-active (SA) requests for groups matching this entry's group range were sent.
group ip-address—
Clears the group IP address of the SA entry.
source ip-address—
Clears the source IP address of the SA entry.
originrp ip-address—
Clears the origin rendezvous point (RP) address type of the SA entry.

statistics

Syntax 
statistics [peer ip-address]
Context 
clear>router>msdp
Description 

This command clears IP address statistics of the peer to which Multicast Source Discovery Protocol (MSDP) source-active (SA) requests for groups matching this entry's group range were sent.

Parameters 
ip-address—
Clears the statistics of the specified IP address.

6.4.2.3. Debug Commands

msdp

Syntax 
[no] msdp
Context 
debug>router
Description 

This command enables debugging for Multicast Source Discovery Protocol (MSDP).

The no form of the command disables MSDP debugging.

packet

Syntax 
packet [pkt-type] [peer ip-address]
Context 
debug>router>msdp
Description 

This command enables debugging for Multicast Source Discovery Protocol (MSDP) packets.

The no form of the command disables MSDP packet debugging.

Parameters 
pkt-type—
Debugs information associated with the specified packet type.
Values—
keep-alive, source-active, sa-request, sa-response

 

ip-address—
Debugs information associated with the specified peer IP address.

pim

Syntax 
pim [grp-address]
no pim
Context 
debug>router>msdp
Description 

This command enables debugging for Multicast Source Discovery Protocol (MSDP) PIM.

The no form of the command disables MSDP PIM debugging.

Parameters 
grp-address—
Debugs the IP multicast group address for which this entry contains information.

rtm

Syntax 
rtm [rp-address]
no rtm
Context 
debug>router>msdp
Description 

This command enables debugging for Multicast Source Discovery Protocol (MSDP) route table manager (RTM).

The no form of the command disables MSDP RTM debugging.

Parameters 
rp-address—
Debugs the IP multicast address for which this entry contains information.

sa-db

Syntax 
sa-db [group grpAddr] [source srcAddr] [rp rpAddr]
no sadb
Context 
debug>router>msdp
Description 

This command enables debugging for Multicast Source Discovery Protocol (MSDP) source-active requests.

The no form of the command disables the MSDP source-active database debugging.

Parameters 
grpAddr—
Debugs the IP address of the group.
srcAddr—
Debugs the source IP address.
rpAddr—
Debugs the specified rendezvous point RP address.