Show, Clear, and Debug Command Reference

Command Hierarchies

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

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

Clear Commands

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

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

Command Descriptions

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. If no group-name is specified, information about all group names display.
detail—
Displays detailed MSDP group information.
Output 

MSDP Group Output

The following table provides MSDP group field descriptions.

Table 20:  MSDP Group Fields  

Label

Description

Group Name

Displays the MSDP group name.

Mode

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

Act Srcs

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

Local Address

Displays the local end of a MSDP session.

Admin State

Displays the administrative state.

Receive Msg Rate

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

Receive Msg Time

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

Receive Msg Thd

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

SA Limit

Displays the source-active limit.

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#

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 infomration.
Output 

MSDP Peer Output

The following table provides MSDP field descriptions.

Table 21:  MSDP Fields  

Label

Description

Peer

Displays the IP address of the peer.

Local Address

Displays the local IP address.

State

Displays the current state of the peer.

Last State Change

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

SA Learn

The number of SAs learned through a peer.

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#

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

MSDP Source Output

The following table provides MSDP source field descriptions.

Table 22:  MSDP Source Fields  

Label

Description

Source

Displays the IP address of the peer.

Type

Displays the type of peer.

SA limit

Displays the local IP address.

State

Displays the current state of the peer.

Num excd

Indicates the number of times the global active source limit has been exceeded.

Last exceeded

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

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 

MSDP Source-Active Output

The following table provides MSDP source-active field descriptions.

Table 23:  MSDP Source-Active Fields  

Label

Description

Grp Address

Displays the IP address of the group.

Src Address

Displays the IP address of the source.

Origin RP

Displays the origination rendezvous point (RP) address.

Peer Address

Displays the address of the peer.

State Timer

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

Sample Output
A:ALA-48# show router msdp source-active
===============================================================================
MSDP Source Active Info
===============================================================================
Grp Address      Src Address      Origin RP        Peer Address State Timer
-------------------------------------------------------------------------------
228.100.0.0      100.112.1.2      10.20.1.1        10.20.1.1 69        
228.100.0.1      100.112.1.2      10.20.1.1        10.20.1.1 69        
228.100.0.2      100.112.1.2      10.20.1.1        10.20.1.1 69        
228.100.0.3      100.112.1.2      10.20.1.1        10.20.1.1 69        
228.100.0.4      100.112.1.2      10.20.1.1        10.20.1.1 69        
228.100.0.5      100.112.1.2      10.20.1.1        10.20.1.1 69        
228.100.0.6      100.112.1.2      10.20.1.1        10.20.1.1 69        
228.100.0.7      100.112.1.2      10.20.1.1        10.20.1.1 69        
228.100.0.8      100.112.1.2      10.20.1.1        10.20.1.1 69        
228.100.0.9      100.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      : 228.100.0.0        Source Address     : 100.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      : 228.100.0.1        Source Address     : 100.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      : 228.100.0.2        Source Address     : 100.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      : 228.100.0.3        Source Address     : 100.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      : 228.100.0.4        Source Address     : 100.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      : 228.100.0.5        Source Address     : 100.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      : 228.100.0.6        Source Address     : 100.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      : 228.100.0.7        Source Address     : 100.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      : 228.100.0.8        Source Address     : 100.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      : 228.100.0.9        Source Address     : 100.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# 

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 

MSDP Source-Active Output

The following table provides MSDP source-active field descriptions.

Table 24:  MSDP Source-Active Fields  

Label

Description

Grp Address

Displays the IP address of the group.

Src Address

Displays the IP address of the source.

Origin RP

Displays the origination rendezvous point (RP) address.

Peer Address

Displays the address of the peer.

Reject Reason

Displays the reason why this source active entry is rejected.

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
-------------------------------------------------------------------------------
228.100.0.1     110.0.0.1       10.20.0.1       20.0.0.1        Import Policy
228.100.0.2     110.0.0.2       10.20.0.2       20.0.0.2        Export Policy
228.100.0.3     110.0.0.3       10.20.0.3       20.0.0.3        RPF Failure
228.100.0.4     110.0.0.4       10.20.0.4       20.0.0.4        Limit Exceeded
228.100.0.5     110.0.0.5       10.20.0.5       20.0.0.5        Limit Exceeded
228.100.0.6     110.0.0.6       10.20.0.6       20.0.0.6        Limit Exceeded
228.100.0.7     110.0.0.7       10.20.0.7       20.0.0.7        Limit Exceeded
-------------------------------------------------------------------------------
SA Rejected Entries : 7
===============================================================================
*A:ALA-48# 

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 

MSDP Statistics Output

The following table provides MSDP statistics field descriptions.

Table 25:  MSDP Statistics Fields  

Label

Description

Last State Change

Displays the date and time the peer state changed.

RPF Failures

Displays the number of reverse path forwarding (RPF) failures.

SA Msgs Sent

Displays the number of source-active messages sent.

SA req. Msgs Sent

Displays the number of source-active request messages sent.

SA res. Msgs Sent

Displays the number of source-active response messages sent.

KeepAlive Msgs Sent

Displays the number of keepalive messages sent.

Unknown Msgs Sent

Displays the number of unknown messages received.

Last message Peer

Displays the time the last message was received from the peer.

Remote Closes

Displays the number of times the remote peer close.

SA Msgs Recvd

Displays the number of source-active messages received.

SA req. Msgs Recvd

Displays the number of source-active request messages received.

SA res. Msgs Recvd

Displays the number of source-active response messages received.

KeepAlive Msgs Recd

Displays the number of keepalive messages received.

Error Msgs Recvd

Displays the number of unknown messages received.

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#

status

Syntax 
status
Context 
show>router>msdp
Description 

This command displays MSDP status information.

Output 

MSDP Status Output

The following table provides MSDP status field descriptions.

Table 26:  MSDP Status Fields  

Label

Description

Admin State

Displays the administrative state.

Local Address

Displays the local IP address.

Active Src Limit

Displays the active source limit.

Act Src Lim Excd

Displays the active source limit which has been exceeded.

Num. Peers

Displays the number of peers.

Num. Peers Estab

Displays the number of peers established.

Num. Source Active

Displays 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 mdsp Enabled

The time the last MDSP 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#

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.

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.