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]
inband-tunnel [type {rx | tx}] [prefix prefix] [tunnel-id tunnel-id]
inband-tunnel [prefix prefix] [tunnel-id tunnel-id] leaf
routing [sub-domain sub-domain] [bsl bsl] [neighbor-prefix ip-address] [dest-prefix ip-address]
template [template-name]
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

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 name, up to 32 characters.
Output 

The following displays an example of a BIER database. Table 35 provides BIER database field descriptions.

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#
Table 35:  Bier Database Fields  

Label

Description

Template

The template name

MT

The IGP topology associated with the sub-domain

Sub-domain

The sub-domain ID

BSL

The BitStringLength used in the sub-domain

BFR-ID

The BFR ID which identifies the router in the BitString

Start

The start label allocated for this sub-domain

End

The end label allocated for this sub-domain

Total

The total number of labels allocated for this sub-domain

BFR-Prefix

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 

This command shows the BIER forwarding 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 neighbor-prefix in IP address format.
si—
Specifies an SI.
Values—
0 to 16

 

Output 

The following is an example of a BIER forwarding configuration. Table 36 provides BIER forwarding field descriptions.

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#
Table 36:  BIER Forwarding Fields  

Label

Description

Neighbor

The neighbor IP address

Nexthop

The next-hop IP address

Interface

The egress interface name for the programmed tunnel

[SI]:Label

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

The BitString forwarding mask

BFR-ID: Prefix

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

inband-tunnel

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

This command shows the BIER tunnels.

Parameters 
type—
Specifies the type of tunnel.
Values—
tx, rx

 

prefix—
Specifies the BFR prefix of the tunnel in IP address form.
tunnel-id—
Specifies the tunnel ID.
Values—
0 to 4294967295

 

leaf—
Specifies that the tunnel leafs are displayed.
Output 

The following is an example of a BIER in-band tunnel configuration. Table 37 provides BIER in-band tunnel descriptions.

Sample Output
*A:Dut-B# /show router bier inband-tunnel 
===============================================================================
BIER Tunnels
===============================================================================
Tunnel-id           Type                Oper                No. Of Leaves
BFR Prefx           Bfr-ID              Mpls Label          Sub-domain
-------------------------------------------------------------------------------
73748               rx                  In service          0
10.20.1.4           4                   0                   0
===============================================================================
BIER Tunnel entries : 1
===============================================================================
Table 37:  BIER In-band Tunnel Fields  

Label

Description

Tunnel-id

The tunnel ID

Type

The tunnel type - Tx or Rx

Oper

The operational state of the tunnel

No. Of Leaves

The number of leafs in the tunnel

BFR Prefix

The BFR prefix of the tunnel

Bfr-IFD

The BFR ID of the tunnel

MPLS Label

The MPLS Label of the tunnel

Sub-domain

The sub-domain associated with the tunnel

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 is an example of a BIER router table. Table 38 provides BIER routing field descriptions.

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# 
Table 38:  BIER Routing Fields  

Label

Description

Destination Prefix

The destination prefix

BFR-ID

The BFR ID

Age

The tunnel age

Neighbor

The neighbor IP address

Nexthop

The next-hop IP address

Interface

The egress interface name for the programmed tunnel

statistics

Syntax 
statistics
Context 
show>router>bier
Description 

This command displays BIER statistics.

template

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

This command shows the BIER template information.

Parameters 
template-name—
Displays the template name, up to 64 characters.
Output 

The following displays an example of a BIER template. Table 39 provides BIER template field descriptions.

Sample Output
*A:sim-06# show router bier template "BIER-Template-1"
===============================================================================
Bier Admin State             : Up
Oper State                   : Up
===============================================================================
Templates
===============================================================================
Template Name                                                         Admin/Op*
  SD-Range
    Prefix                                   Bfr* MT                  #PMSI
-------------------------------------------------------------------------------
BIER-Template-1                                                       Up/Up
  0-0
    192.0.2.6                                6    ipv4-unicast        4
  1-1
    192.0.2.6                                6    ipv4-multicast      2
-------------------------------------------------------------------------------
Total number of templates    : 1
Total number of subdomains   : 2
Table 39:  Bier Template Fields  

Label

Description

Bier Admin State

The BIER administrative state

Oper State

The BIER operational state

Template Name

The BIER template name

SD-Range

The BIER SD-Range

Prefix

The prefix

Total number of templates

The total number of templates

Total number of subdomains

The total number of subdomains

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

 

leaf—
Specifies that the tunnel leafs are displayed.
Output 

The following is an example of a BIER tunnel table. Table 40 provides BIER tunnel table descriptions.

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
===============================================================================
Table 40:  BIER Tunnel Fields  

Label

Description

Tunnel-id

The tunnel ID allocated for this tunnel

Type

The tunnel type, indicated if it is a terminating tunnel or an originating one

Oper

The operational status of the tunnel

No. of Leaves

The number of leaves associated with the tunnel if the tunnel type is tx or BFIR. This field represents the number of leafs associated with it.

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

BFR Prefix

The BFR prefix associated with the root of the tunnel

Bfr-ID

The 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

The sub-domain associated with the root of the tunnel