4.4. Show, Clear, and Debug Command Reference

4.4.1. Command Hierarchies

  1. Show Commands
  2. Clear Commands

4.4.1.1. Show Commands

show
— router
— mld
— group [grp-ipv6-address] [hosts | interfaces | saps]
— group summary [hosts | interfaces | saps]
— group-interface [fwd-service service-id] [ip-int-name] [detail] [group] [grp-ipv6-address]
— hosts [detail] [fwd-service service-id] [grp-interface ip-int-name]
— hosts [host ipv6-address] [group grp-ipv6-address] [detail]
— hosts summary
— interface [ip-int-name | ip-address] [group] [grp-ipv6-address] [detail]
— ipsec-interface
— ipsec-interface ip-int-name [group grp-ipv6-address]
— ipsec-interface gateway-name gw-name [remote-address ip-address | ipv6-address] [port port-id] [sa-id sa-id]
— ipsec-interface static-tunnel-name tunnel-name [sa-id sa-id]
— ssm-translate interface-name
— static [ip-int-name | ipv6-address]
— statistics [ip-int-name | ipv6-address]
— statistics [ipsec-interface ip-int-name]
— group-interface [fwd-service service-id] [ip-int-name]
— host [ipv6-address]
— status

4.4.1.2. Clear Commands

clear
— router
— mld
— database [group grp-ipv6-address [source src-ip-address]]
— database interface {ip-int-name | ipv6-address} [group grp-ipv6-address [source src-ipv6-address]]
— database ipsec-interface ip-int-name [group grp-ipv6-address [source src-ipv6-address]]
— database host ipv6-address [group grp-ipv6-address [source src-ipv6-address]]
— database host all [group grp-ipv6-address [source src-ipv6-address]]
— database group-interface interface-name [fwd-service service-id] [group grp-ipv6-address [source src-ipv6-address]]
— database group-interface all
— statistics group-interface [fwd-service service-id] ip-int-name
— statistics group-interface all
— statistics host ipv6-address
— statistics host all
— statistics [interface ip-int-name | ipv6-address]
— statistics ipsec-interface ip-int-name
— version group-interface [fwd-service service-id] ip-int-name
— version group-interface all
— version host ipv6-address
— version host all
— version [interface ip-int-name | ip-address]

4.4.2. Command Descriptions

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

mld

Syntax 
mld
Context 
show>router
Description 

This command enables the context to show MLD entities.

group

Syntax 
group [grp-ipv6-address] [hosts | interfaces | saps]
group summary [hosts | interfaces | saps]
Context 
show>router>mld
Description 

This command displays the multicast group and (S,G) addresses. If no grp-ipv6-address parameters are specified, then all MLD group, (*,G) and (S,G) addresses are displayed.

Parameters 
grp-ipv6-address—
Displays specific multicast group addresses.
hosts—
Displays hosts for the multicast group address.
interfaces—
Displays interfaces for the multicast group address.
saps—
Displays SAPs for the multicast group address.
Output 

MLD Group Output

Sample Output
*A:Dut-A# show router mld group
===============================================================================
MLD Interface Groups
===============================================================================
(*,ff04:db8:224:100:0:0)                                     UpTime: 0d
00:10:09
     Fwd List  : intf_to_ixia
(*,ff04:db8:224:100:0:1)                                     UpTime: 0d
00:10:09
     Fwd List  : intf_to_ixia
(*,ff04:db8:224:100:0:2)                                     UpTime: 0d
00:10:09
     Fwd List  : intf_to_ixia
(*,ff04:db8:224:100:0:3)                                     UpTime: 0d
00:10:09
     Fwd List  : intf_to_ixia
(*,ff04:db8:224:100:0:4)                                     UpTime: 0d
00:10:09
     Fwd List  : intf_to_ixia
-------------------------------------------------------------------------------
Entries : 5
===============================================================================
MLD Host Groups
===============================================================================
No Matching Entries
===============================================================================
MLD SAP Groups
===============================================================================
No Matching Entries
===============================================================================
*A:Dut-A#
 
*A:Dut-A# show router mld group summary
===============================================================================
MLD Interface Groups Summary                              Nbr Fwd    Nbr Blk
===============================================================================
(*,ff04:db8:224:100:0:0) 1          0
(*,ff04:db8:224:100:0:1) 1          0
(*,ff04:db8:224:100:0:2) 1          0
(*,ff04:db8:224:100:0:3) 1          0
(*,ff04:db8:224:100:0:4) 1          0
-------------------------------------------------------------------------------
Entries : 5
===============================================================================
MLD Host Groups Summary                                   Nbr Fwd    Nbr Blk
===============================================================================
No Matching Entries
===============================================================================
MLD SAP Groups Summary                                    Nbr Fwd    Nbr Blk
===============================================================================
No Matching Entries
===============================================================================
*A:Dut-A#
 
*A:Dut-A# show router mld group ff04:db8:224:100:0:0 
===============================================================================
MLD Interface Groups
===============================================================================
(*,ff04:db8:224:100:0:0)                                     UpTime: 0d
00:10:24
     Fwd List  : intf_to_ixia
-------------------------------------------------------------------------------
Entries : 1
===============================================================================
MLD Host Groups
===============================================================================
No Matching Entries
===============================================================================
MLD SAP Groups
===============================================================================
No Matching Entries
===============================================================================
*A:Dut-A#

Table 9 describes the output fields for MLD group information.

Table 9:  MLD Group Information Output Fields  

Label

Description

MLD Groups

Displays the IP multicast sources corresponding to the IPv6 multicast groups.

Fwd List

Displays the list of interfaces in the forward list.

Blk List

Displays the list of interfaces in the blocked list.

group-interface

Syntax 
group-interface [fwd-service service-id] [ip-int-name] [detail] [group] [grp-ipv6-address]
Context 
show>router>mld
Description 

This command displays MLD group-interface information.

Parameters 
fwd-service service-id—
[1 to 2148007980] | <svc-name:64 char max>
ip-int-name—
IP interface name. A string up to 32 characters.
detail—
Displays detailed information.
group—
Displays information from the group IPv6 address.
grp-ipv6-address—
Group IPv6 address.

hosts

Syntax 
hosts [detail] [fwd-service service-id] [grp-interface ip-int-name]
hosts [host ipv6-address] [group grp-ipv6-address] [detail]
hosts summary
Context 
show>router>mld
Description 

This command shows MLD hosts information.

Parameters 
grp-ipv6-address—
Specifies the group IPv6 address.
service-id —
[1 to 2148007980]| <svc-name: 64 characters maximum>
ip-int-name—
IP interface name. A string up to 32 characters.
ipv6-address—
IPv6 address.
Output 

The following output is an example of MLD host information.

Sample Output
A:Dut-C# show router mld hosts
==============================================================================
MLD Hosts
==============================================================================
Host                                          Subscriber
   Oper-State Oper-Ver Fwd-Svc Num-Groups Group-Interface
------------------------------------------------------------------------------
192:168:9::1                                  oli_1
   Up         2        1       0               grp-1-2-1
192:168:9::2                                  oli_1
   Up         2        1       0               grp-1-2-1
------------------------------------------------------------------------------
Hosts : 2
==============================================================================
A:Dut-C#
 
A:Dut-C# show router mld hosts detail
===============================================================================
MLD Host 192:168:9::1
===============================================================================
Oper Status      : Up         MacAddress     : 00:00:11:00:00:01
Oper Version     : 2          Subscriber     : oli_1
NumGrps          : 0          GrpItf         : grp-1-2-1
MaxGrps Till Now : 0          MLD Policy     : oli1
PPPoE SessionId  : N/A        Next Query Time: 0d 00:00:06
FwdSvcId         : 1          MaxSrcs Allowed: No Limit
MaxGrps Allowed  : No Limit   MaxGrpSrcs All*: No Limit
Qry Interval     : 125        Qry Last Lstnr*: 1
Qry Resp Interval: 10         Router Alert C*: Enabled
Bonding Conn Idx : 0          Bonding Id     : None
===============================================================================
MLD Host 192:168:9::2
===============================================================================
Oper Status      : Up         MacAddress     : 00:00:11:00:00:02
Oper Version     : 2          Subscriber     : oli_1
NumGrps          : 0          GrpItf         : grp-1-2-1
MaxGrps Till Now : 0          MLD Policy     : oli1
PPPoE SessionId  : N/A        Next Query Time: 0d 00:00:06
FwdSvcId         : 1          MaxSrcs Allowed: No Limit
MaxGrps Allowed  : No Limit   MaxGrpSrcs All*: No Limit
Qry Interval     : 125        Qry Last Lstnr*: 1
Qry Resp Interval: 10         Router Alert C*: Enabled
Bonding Conn Idx : 0          Bonding Id     : None
-------------------------------------------------------------------------------
Hosts : 2
===============================================================================
* indicates that the corresponding row element may have been truncated.
A:Dut-C#

interface

Syntax 
interface [ip-int-name | ipv6-address] [group] [grp-ipv6-address] [detail]
Context 
show>router>mld
Description 

This command displays MLD interface information.

Parameters 
ip-int-name—
Displays the information associated with the specified IPv6 interface name.
ipv6-address—
Displays the information associated with the specified IPv6 address.
group grp-ipv6-address—
Displays IPv6 multicast group address for which this entry contains information.
detail—
Displays detailed IPv6 interface information along with the source group information learned on that interface.
Output 

MLD Interface Output

Table 10 displays MLD field descriptions.

Table 10:  MLD Fields  

Label

Description

Interface

Displays the interfaces that participate in the MLD protocol.

Adm

Admin Status

Displays the administrative state for the MLD protocol on this interface.

Oper

Oper Status

Displays the current operational state of MLD protocol on the interface.

Querier

Displays the address of the MLD querier on the IP subnet to which the interface is attached.

Querier Up Time

Displays the time since the querier was last elected as querier.

Querier Expiry Timer

Displays the time remaining before the querier ages out. If the querier is the local interface address, the value will be zero.

Cfg/Opr Version

Admin/Oper version

Cfg — The configured version of MLD running on this interface. For MLD to function correctly, all routers on a LAN must be configured to run the same version of MLD on that LAN.

Opr — The operational version of MLD running on this interface.

Num Groups

The number of multicast groups which have been learned by the router on the interface.

Policy

Displays the policy that is to be applied on the interface.

Group Address

Displays the IP multicast group address for which this entry contains information.

Sample Output
*A:Dut-A# show router mld interface
===============================================================================
MLD Interfaces
===============================================================================
Interface               Adm  Oper Cfg/Opr         Num Policy
    Querier                        Version         Groups
-------------------------------------------------------------------------------
intf_to_ixia            Up   Up   2/2             5 none
    fe0:db8:4403:1ff:fe01:3
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:Dut-A#

ipsec-interface

Syntax 
ipsec-interface
ipsec-interface ip-int-name [group grp-ipv6-address]
ipsec-interface gateway-name gw-name [remote-address ip-address | ipv6-address] [port port-id] [sa-id sa-id]
ipsec-interface static-tunnel-name tunnel-name [sa-id sa-id]
Context 
show>router>mld
Description 

This command displays information about the MLD states over IPsec tunnels.

Parameters 
ip-int-name—
Specifies the dynamic name for the MLD-enabled child_SA.
grp-ipv6-address—
Displays IPv6 multicast group address for which this entry contains information.
Values—
ipv6-address - x:x:x:x:x:x:x:x (eight 16-bit pieces)
x:x:x:x:x:x:d.d.d.d
x - [0..FFFF]H
d - [0..255]D
- multicast group IPv6 address

 

gw-name—
Specifies the IPsec gateway name up to 32 characters.
ip-address—
Displays the information associated with the specified IP address.
ipv6-address—
Displays the information associated with the specified IPv6 address.
port-id—
Specifies the peer’s UDP port.
Values—
0 to 4294967295

 

sa-id—
Specifies the child_SA ID.
Values—
0 to 4294967295

 

tunnel-name—
Specifies the IPsec static tunnel name up to 32 characters.
Output 

The following output displays an example of MLD IPsec interface information. The interface name in the output is the dynamic name for an MLD-enabled child_sa. There is a corresponding MLD interface name in the show>ipsec>gateway name tunnel tunnel output

Sample Output
*A:DUT-A# show router 40 mld ipsec-interface "ipsec-if-1583392" 
=============================================================================== 
mld ipsec dynamic tunnel interfaces detail 
=============================================================================== 
name          : ipsec_gw_1040_1 
remote-address: 3ffe::900:1 
port          : 500                     sa-id         : 1 
index         : 1583392                 state         : in-service 
version       : 2                       group count   : 0 
querier up    : 11384                   querier expiry: 0 
next query    : 56                      interface name: ipsec-if-1583392 
querier       : fe80::6e:9c56:9651:5829 
=============================================================================== 

ssm-translate

Syntax 
ssm-translate
ssm-translate interface interface-name
Context 
show>router>mld
Description 

This command displays MLD SSM translate configuration information.

Parameters 
interface-name—
Specifies the IP interface name up to 32 characters in length.
Output 

MLD Interface Output

The following table provides MLD field descriptions.

Table 11:  MLD Fields  

Label

Description

Start Address

End Address

Displays the address ranges of the multicast groups for which this router can be an RP.

Source Address

Displays the unicast address that sends data on an interface.

Interface

Displays the interface name.

SSM Translate Entries

Displays the total number of SSM translate entries.

Sample Output
*A:ALA-BA# show router mld static 
===============================================================================
MLD SSM Translate Entries
===============================================================================
Start Address      : ff0e::db8:9
End Address        : ff0e::db8:c
   Source Address  : 2001:db8::1
 
Start Address      : ff04:db8:2
End Address        : ff04:db8:10
   Source Address  : 2001:db8:3:4:5:6:7:8
       Interface   : lax-vls
 
Start Address      : ff0e:db8:db8:9
End Address        : ff0e:db8:db8:c
   Source Address  : 2001:db8::1
       Interface   : lax-vls
-------------------------------------------------------------------------------
SSM Translate Entries : 3
===============================================================================
*A:ALA-BA#

static

Syntax 
static [ip-int-name | ipv6-address]
Context 
show>router>mld
Description 

This command displays static MLD, (*,G) and (S,G) information.

Parameters 
ip-int-name—
Only displays the information associated with the specified IP interface name.
ipv6-address—
Only displays the information associated with the specified IPv6 address.
Output 

Static MLD Output

The following table provides static MLD field descriptions.

Table 12:  MLD Static Fields  

Label

Description

Source

Displays entries which represents a source address from which receivers are interested/not interested in receiving multicast traffic.

Group

Displays the IPv6 multicast group address for which this entry contains information.

Interface

Displays the interface name.

Sample Output
*A:ALA-BA# show router mld static 
===============================================================================
Rtr Base MLD Static Group Sources
===============================================================================
Source                                    Interface
  Group Start                             [Group Step]
  [Group End]                             [Group Count]
-------------------------------------------------------------------------------
2001:db8:2016:10ff::4                     lax-vls
  ff05:db8:1
*                                         lax-vls
  ff06:db8:1
*                                         lax-vls
  ff01:db8:1                                 ::4:0
  ff01:db8:100:0                             64
3::1                                      lax-vls
  ff05:db8:1                                 ::1
  ff05:db8:20                                32
*                                         lax-vls
  ff05:db8:2:1                               ::1
  ff05:db8:2:3ff                             1023
3::1                                      lax-vls
  ff05:db8:3:0                               ::64
  ff05:db8:4:0                               656
3::2                                      lax-vls
  ff05:db8:3:0                               ::64
  ff05:db8:4:0                               656
4::1                                      flax-vlsoo
  ff05:db8:3:0                               ::64
  ff05:db8:4:0                               656
5::1                                      lax-vls
  ff05:db8:3:0                               ::64
  ff05:db8:4:0                               656
-------------------------------------------------------------------------------
Static (*,G)/(S,G) Entries : 9
===============================================================================
*A:ALA-BA#

statistics

Syntax 
statistics [ip-int-name | ipv6-address]
statistics ipsec-interface ip-int-name
Context 
show>router>mld
Description 

This command displays MLD statistics information.

Parameters 
ip-int-name—
Displays information associated with the specified IP interface name up to 32 characters.
ipv6-address—
Displays information associated with the specified IPv6 address.
ipsec-interface ip-int-name—
Displays information associated with the specified dynamic name for the MLD-enabled child_SA.
Output 

MLD Statistics Output

Sample Output
*A:ALA-BA# show router mld statistics     
==================================================
MLD Interface Statistics
==================================================
Message Type        Received       Transmitted
--------------------------------------------------
Queries             0              9
Report V1           0              0
Report V2           0              0
Dones               0              0
-------------------------------------------------------------------------------
General Interface Statistics
-------------------------------------------------------------------------------
Bad Length        : 0
Bad Checksum      : 0
Unknown Type      : 0
Bad Receive If    : 0
Rx Non Local      : 0
Rx Wrong Version  : 0
Policy Drops      : 0
No Router Alert   : 0
Rx Bad Encodings  : 0
Rx Pkt Drops      : 0
Local Scope Pkts  : 0
Resvd Scope Pkts  : 0
MCAC Policy Drops : 0
-------------------------------------------------------------------------------
Source Group Statistics
-------------------------------------------------------------------------------
(S,G)             : 0
(*,G)             : 5
==================================================
*A:Dut-A#

The following table provides statistical MLD field descriptions.

Table 13:  MLD Statistics Fields  

Label

Description

MLD Interface Statistics

Lists the MLD statistics for a particular interface.

Message Type

Queries — The number of MLD general queries transmitted or received on this interface.

Report — The total number of MLD V1 or V2 reports transmitted or received on this interface.

Dones — The total number of MLD dones transmitted on this interface.

Received

Displays the total number of MLD packets received on this interface.

Transmitted

Displays the total number of MLD packets transmitted from this interface.

General Interface Statistics

Lists the general MLD statistics.

Bad Length

Displays the total number of MLD packets with bad length received on this interface.

Bad Checksum

Displays the total number of MLD packets with bad checksum received on this interface.

Unknown Type

Displays the total number of MLD packets with unknown type received on this interface.

Bad Receive If

Displays the total number of MLD packets incorrectly received on this interface.

Rx Non Local

Displays the total number of MLD packets received from a non-local sender.

Rx Wrong Version

Displays the total number of MLD packets with wrong versions received on this interface.

Policy Drops

Displays the total number of MLD packets dropped by import policies on this interface.

No Router Alert

Displays the total number of MLD packets received on this interface which did not have the router alert flag set.

Rx Bad Encodings

Displays the total number of MLD packets with bad encodings received on this interface.

Rx Pkt Drops

Displays the total number of MLD receive packet drops on this interface.

Local Scope Pkts

Displays the total number of MLD packets with local scope received on this interface.

Resvd Scope Pkts

Displays the total number of MLD packets with reserved scope received on this interface.

MCAC Policy Drops

Displays the total number of MLD packets dropped by MCAC policies on this interface.

group-interface

Syntax 
group-interface [fwd-service service-id] [ip-int-name]
Context 
show>router>mld>statistics
Description 

This command displays MLD group interface statistics information.

Parameters 
service-name—
Displays information associated with the specified service name.
ip-int-name—
Displays information associated with the specified IP interface name.

host

Syntax 
host [ipv6-address]
Context 
show>router>mld>statistics
Description 

This command displays MLD host statistics information.

Parameters 
ipv6-address—
Only displays the information associated with the specified IPv6 address.

status

Syntax 
status
Context 
show>router>mld
Description 

This command displays MLD status information.

If MLD is not enabled, the following message appears:

A:NYC# show router mld status
MINOR: CLI MLD is not configured.
A:NYC#
Output 

MLD Status Output

The following table provides MLD status field descriptions.

Table 14:  MLD Status Fields  

Label

Description

Admin State

Displays the administrative status of MLD.

Oper State

Displays the current operating state of this MLD protocol instance on this router.

Query Interval

The frequency at which MLD query packets are transmitted.

Last Listener Query Interval

The maximum response time inserted into group-specific queries sent in response to leave group messages, and is also the amount of time between group-specific query messages.

Query Response Interval

The maximum query response time advertised in MLDv2 queries.

Robust Count

Displays the number of times the router will retry a query.

Sample Output
*A:ALA-BA# show router mld status     
===============================================================================
MLD Status
===============================================================================
Admin State                       : Up
Oper State                        : Up
Query Interval                    : 125
Last Listener Query Interval      : 1
Query Response Interval           : 10
Robust Count                      : 2
===============================================================================
*A:ALA-BA# 

4.4.2.2. Clear Commands

mld

Syntax 
mld
Context 
clear>router
Description 

This command enables the context to clear and reset MLD entities.

database

Syntax 
database [group ipv6-address [source ipv6-address]]
database interface {ip-int-name | ipv6-address]} [group ipv6-address [source ipv6-address]]
database ipsec-interface ip-int-name [group ipv6-address [source ipv6-address]]
database host ipv6-address [group ipv6-address [source ipv6-address]]
database host all [group ipv6-address [source ipv6-address]]
database group-interface interface-name [fwd-service service-id] [group grp-ipv6-address [source ipv6-address]]
database group-interface all
Context 
clear>router>mld
Description 

This command clears MLD database parameters.

Parameters 
host ipv6-address—
Clears the MLD database on the specified host.
host all—
Clears the MLD database on all hosts.
interface ip-int-name —
Clears database information for the specified MLD interface name.
interface ipv6-address —
Clears database information for the specified MLD interface IPv6 address.
ipsec-interface ip-int-name —
Clears database information for the specified dynamic name for the MLD-enabled child_SA.
group ipv6-address —
Clears database information for the specified MLD group IPv6 address.
source ipv6-address—
Clears database information for the specified MLD source IPv6 address.

statistics

Syntax 
statistics group-interface [fwd-service service-id] ip-int-name
statistics group-interface all
statistics host ipv6-address
statistics host all
statistics [ip-int-name | ipv6-address]
statistics ipsec-interface ip-int-name
Context 
clear>router>mld
Description 

This command clears MLD statistics parameters.

Parameters 
fwd-service service-id—
[1to 2148007980] | <svc-name:64 char max>
group-interface interface-name—
Clears the MLD statistics on the specified group interface.
group-interface all—
Clears the MLD statistics on all group interfaces.
host all—
Clears the MLD statistics on all hosts.
host ipv6-address—
Clears the MLD statistics on the specified host.
ip-int-name —
Clears statistics for the specified MLD interface name.
ipv6-address —
Clears statistics for the specified MLD IPv6 address.
ipsec-interface ip-int-name—
Clears statistics information for the specified dynamic name for the MLD-enabled child_SA.

version

Syntax 
version group-interface [fwd-service service-id] ip-int-name
version group-interface all
version host ipv6-address
version host all
version [ip-int-name | ipv6-address]
Context 
clear>router>mld
Description 

This command clears MLD version parameters.

Parameters 
group-interface interface-name—
Clears the MLD version on the specified group interface.
group-interface all—
Clears the MLD version on all group interfaces.
fwd-service service-id—
[1to 2148007980] | <svc-name:64 char max>
host ipv6-address—
Clears the MLD version on the specified host.
host all—
Clears the MLD version on all hosts.
ip-int-name —
Clears version information for the specified MLD interface name.
ipv6-address —
Clears version information for the specified MLD IPv6 address.