11.3. Show, Clear, and Debug Command Reference

11.3.1. Command Hierarchies

11.3.1.1. Show Commands

show
— router
— bier
database [sub-domain sub-domain] [template template-name]
forwarding [sub-domain sub-domain] [bsl bsl] [neighbor-prefix ip-address] [si si]
routing [sub-domain sub-domain] [bsl bsl] [neighbor-prefix ip-address] [dest-prefix ip-address]
tunnel [type {rx | tx}] [prefix ip-address] [tunnel-id tunnel-id]
tunnel [prefix ip-address] [tunnel-id tunnel-id] leaf

11.3.2. Command Descriptions

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

database

Syntax 
database [sub-domain sub-domain] [template template-name]
Context 
show>router>bier
Description 

This command shows the BIER database and assigned labels for <SD, BSL, SI>.

Parameters 
sub-domain—
Displays detailed information about the sub-domain.
Values—
0 to 255

 

template-name—
Displays template information.
Output 

The following output displays an example of a BIER database.

Sample Output
*A:Dut-A# show router bier database 
===============================================================================
BIER Database
===============================================================================
Template                         MT             Sub-domain     BSL
BFR-ID                           Start          End            Total
BFR-Prefix                                                     
-------------------------------------------------------------------------------
temp1                            ipv4-unicast   0              256
1                                1048464        1048479        16
10.20.1.1                                                      
 
temp1                            ipv4-unicast   1              256
255                              1048447        1048462        16
10.20.1.1                                                      
 
temp1                            ipv4-unicast   2              256
2966                             1048430        1048445        16
10.20.1.1                                                      
 
temp1                            ipv4-unicast   3              256
1                                1048413        1048428        16
10.20.1.1                                                      
 
temp1                            ipv4-unicast   4              256
255                              1048396        1048411        16
10.20.1.1                                                      
 
===============================================================================
BIER Database entries : 5
===============================================================================
*A:Dut-A#

The following table provides BIER database field descriptions

Table 36:  Bier Database Fields  

Label

Description

Template

Displays the template name.

MT

Displays the IGP topology associated with the sub-domain.

Sub-domain

Displays the sub-domain ID.

BSL

Displays the BitStringLength used in the sub-domain.

BFR-ID

Displays the BFR ID which identifies the router in the BitString.

Start

Displays the start label allocated for this sub-domain.

End

Displays the end label allocated for this sub-domain.

Total

Displays the total number of labels allocated for this sub-domain.

BFR-Prefix

Displays the routable IP address of a BFR, used by BIER to identify a BFR.

forwarding

Syntax 
forwarding [sub-domain sub-domain] [bsl bsl] [neighbor-prefix ip-address] [si si]
Context 
show>router>bier
Description 

Display PIM candidate RP (CRP) information received at the elected Bootstrap router (BSR).

Parameters 
sub-domain—
Specifies a sub-domain.
Values—
0 to 255

 

bsl—
Specifies a bit string length.
Values—
256 to 1024

 

ip-address—
Specifies a neighbor-prefix in IP address format.
si—
Specifies an SI.
Output 

The following output is an example of a BIER forwarding configuration.

Sample Output
*A:Dut-A# show router bier forwarding sub-domain 0 
===============================================================================
Neighbor
  Nexthop
  Interface
  [SI]: Label
     Forwarding Bit Mask
       BFR-ID : Prefix
-------------------------------------------------------------------------------
===============================================================================
BIER Forwarding Database Sub-Domain 0 BSL 256
===============================================================================
10.20.1.2
  10.180.1.2
  ip-10.180.1.1
  [0]: 1048556
     0x0000000000000000000000000000000000000000000000000000000000000036
       2 : 10.20.1.2
       3 : 10.20.1.3
       5 : 10.20.1.5
       6 : 10.20.1.6
===============================================================================
Total (Sub-Domain 0): 1
===============================================================================
Total BIER Forwarding entries : 1
===============================================================================
*A:Dut-A#

The following table provides BIER forwarding field descriptions.

Table 37:  BIER Forwarding Fields  

Label

Description

Neighbor

Displays the neighbor IP address.

Nexthop

Displays the next-hop IP address.

Interface

Displays the egress interface name for the programmed tunnel.

[SI]:Label

Displays the SI and label. The BitString and the SI together determine the set of BFERs to which a given packet will be delivered. The label is the egress transport label used for the given SI/SD.

Forwarding Bit Mask

Displays the BitString forwarding mask.

BFR-ID: Prefix

Displays the BFR ID and the prefix reachable through this SD/SI/BFR-ID.

routing

Syntax 
routing [sub-domain sub-domain] [bsl bsl] [neighbor-prefix ip-address] [dest-prefix ip-address]
Context 
show>router>bier
Description 

This command shows the BIER routing table.

Parameters 
sub-domain—
Specifies a sub-domain.
Values—
0 to 255

 

bsl—
Specifies a bit string length.
Values—
256 to 1024

 

ip-address—
Specifies a prefix in IP address format.
Output 

The following output is an example of a BIER router table.

Sample Output
*A:Dut-A# show router bier routing sub-domain 0    
===============================================================================
Destination Prefix                          Bfr-ID          Age
  Neighbor                                                  
    Nexthop                                                 
    Interface                                               
-------------------------------------------------------------------------------
===============================================================================
BIER Routing Database Sub-Domain 0 BSL 256
===============================================================================
10.20.1.2                                   2               0d 23:05:23
  10.20.1.2                                                   
    10.180.1.2                                                  
    ip-10.180.1.1                                               
 
10.20.1.3                                   3               0d 23:05:20
  10.20.1.2                                                   
    10.180.1.2                                                  
    ip-10.180.1.1                                               
 
10.20.1.4                                   0               0d 23:05:20
  10.20.1.2                                                   
    10.180.1.2                                                  
    ip-10.180.1.1                                               
 
10.20.1.5                                   5               0d 23:05:16
  10.20.1.2                                                   
    10.180.1.2                                                  
    ip-10.180.1.1                                               
 
10.20.1.6                                   6               0d 23:05:16
  10.20.1.2                                                   
    10.180.1.2                                                  
    ip-10.180.1.1                                               
 
===============================================================================
Total (Sub-Domain 0): 5
===============================================================================
Total BIER Routing entries : 5        
===============================================================================
*A:Dut-A# 

The following table provides BIER routing field descriptions.

Table 38:  BIER Routing Fields  

Label

Description

Destination Prefix

Displays the destination prefix.

BFR-ID

Displays the BFR ID.

Age

Displays how long the tunnel has been up.

Neighbor

Displays the neighbor IP address.

Nexthop

Displays the next-hop IP address.

Interface

Displays the egress interface name for the programmed tunnel.

statistics

Syntax 
statistics
Context 
show>router>bier
Description 

This command displays BIER statistics.

tunnel

Syntax 
tunnel [type {rx | tx}] [prefix ip-address] [tunnel-id tunnel-id]
tunnel [prefix ip-address] [tunnel-id tunnel-id] leaf
Context 
show>router>bier
Description 

This command shows the BIER tunnel table used for MVPN.

Parameters 
ip-address—
Specifies a prefix in IP address format.
tunnel-id—
Specifies a tunnel identifier.
Values—
0 to 4294967295

 

Output 

The following output is an example of a BIER tunnel table.

Sample Output
*A:Dut-A# show router bier tunnel prefix 10.20.1.3
===============================================================================
BIER Tunnels
===============================================================================
Tunnel-id           Type                Oper                No. Of Leaves
BFR Prefx           Bfr-ID              Mpls Label          Sub-domain
-------------------------------------------------------------------------------
73941               rx                  In service          0
10.20.1.3           767                 1048475             4
73942               rx                  In service          0
10.20.1.3           767                 1048473             1
73943               rx                  In service          0
10.20.1.3           767                 1048573             1
73944               rx                  In service          0
10.20.1.3           3                   1048474             0
73945               rx                  In service          0
10.20.1.3           3                   1048471             3
73946               rx                  In service          0
10.20.1.3           767                 1048470             4
73947               rx                  In service          0
10.20.1.3           3                   1048574             0
73948               rx                  In service          0
10.20.1.3           1593                1048472             2
73949               rx                  In service          0
10.20.1.3           3                   1048477             3
73950               rx                  In service          0
10.20.1.3           1593                1048480             2
73951               rx                  In service          0
10.20.1.3           767                 1048476             4
                                      
73952               rx                  In service          0
10.20.1.3           3                   1048478             3
73955               rx                  In service          0
10.20.1.3           1593                1048481             2
73956               rx                  In service          0
10.20.1.3           767                 1048485             1
73957               rx                  In service          0
10.20.1.3           3                   1048490             0
===============================================================================
BIER Tunnel entries : 15
===============================================================================

The following table provides BIER tunnel table descriptions.

Table 39:  BIER Tunnel Fields  

Label

Description

Tunnel-id

Displays the tunnel ID allocated for this tunnel.

Type

Displays the tunnel type, indicated if it is a terminating tunnel or an originating one.

Oper

Displays the operational status of the tunnel.

No. of Leaves

Displays the number of leaves associated with the tunnel if the tunnel type is tx or BFIR, this field represent the number of leafs associated with it.

If the tunnel type is rx or BFER, this field is zero.

BFR Prefix

Displays the BFR prefix associated with the root of the tunnel.

Bfr-ID

BFR ID associated with the root of the tunnel.

Mpls Label

If the tunnel type is tx or BFIR, this field represents the egress VPRN label allocated.

If the tunnel type is rx or BFER, this field represents the ingress VPRN label allocated by the root.

Sub-domain

Displays the sub-domain associated with the root of the tunnel.