Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

show dynamic-tunnels pfe-tunnel-localization

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
show dynamic-tunnels pfe-tunnel-localization 

Description

Display dynamic tunnel Packet Forwarding Engine (PFE) localization information such as tunnel count of an anchor PFE, the GENCFG blobs that are sent to the kernel for each IPv6 source, the aggregate routes connected to the anchor PFE, the IPv6 routes that are mapped to this anchor PFE. When the PFE goes down BGP withdraws all the aggregate routes and the IPv6 sources.

Note:

PFE localization needs to be configured to display output for this command. This command throws back an error if there are no PFE localization entries to display.

Options

none

Display dynamic tunnel localization information for the Packet Forwarding Engine tunnel.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show dynamic-tunnels pfe-tunnel-localization command. Output fields are listed in the approximate order in which they appear.

Table 1: show dynamic-tunnels pfe-tunnel-localization Output Fields

Field Name

Field Description

Anchor PFE Name

Name of the PFE in pfe-x/y/z format.

Reference count

Number of the dynamic tunnels that are currently anchored to a particular PFE. Each tunnel prefix and each Gencfg takes one reference count.

Gencfg keyid

The key ID of a Gencfg blob that is returned by the kernel.

A Gencfg blob stores the configuration values.

Gencfg tunnel type: UDP

Tunnel count anchored to a particular anchor Packet Forwarding Engine (reference count).

Gencfg last index

The last know index value of the Gencfg blob.

Gencfg current index

The current index value of the Gencfg blob.

Gencfg last state

Last state of the tunnel: Up, or Dn (down).

Gencfg current state

Current state of the tunnel: Up, or Dn (down).

Gencfg V6 source address

Source IP address of the Gencfg blob IPv6 tunnel.

Gencfg backup lock

Backup count of the Gencfg blob. This value is displayed in the backup routing protocol process. Each gencfg takes a backup reference count, which is decremented when tunnel is deleted or after NSR switchover and backup becomes new primary.

Gencfg kqp

Reference count of Gencfg entries in the Kernel Routing table (KRT) queue.

KRT is the module within the Routing Process Daemon (RPD) that synchronizes the routing tables with the forwarding tables in the kernel. This table is then synchronized to the PFE through the KRT queue.

Gencfg Reference count

Each prefix using a particular IPv6 source takes reference count on the Gencfg corresponding to that V6 source. If the Gencfg is added to the kernel and it has key ID, then it has additional reference count of 1. When Gencfg operation is queued in KRTQ then krt q entry takes one ref count on Gencfg.

Aggregate

All aggregate routes that are connected with this anchor PFE. When the PFE goes down, BGP withdraws all these aggregates.

Aggregate refcnt

Reference count of aggregate routes.

V6 source address

All IPv6 source routes that are connected to this anchor PFE. When the PFE goes down, BGP withdraws all these IPv6 sources.

V6 source refcnt

Reference count of IPv6 source routes.

Sample Output

show dynamic-tunnels pfe-tunnel-localization (Primary)

content_copy zoom_out_map
user@host> show dynamic-tunnels pfe-tunnel-localization   
Anchor PFE Name: pfe-0/0/0
    Reference count: 8

    Gencfg keyid: 1
      Gencfg last index: 145
      Gencfg current index: 145
      Gencfg last state: UP
      Gencfg current state: UP
      Gencfg V6 source address: 66:66:00:00:00:00:00:00:00:00:00:00:00:00:66:66
      Gencfg backup lock: 0
      Gencfg kqp: 0x0
      Gencfg Reference count: 0x2

    Gencfg keyid: 2
      Gencfg last index: 145
      Gencfg current index: 145
      Gencfg last state: UP
      Gencfg current state: UP
      Gencfg V6 source address: 77:77:00:00:00:00:00:00:00:00:00:00:00:00:77:77
      Gencfg backup lock: 0
      Gencfg kqp: 0x0
      Gencfg Reference count: 0x2

    Gencfg keyid: 3
      Gencfg last index: 145
      Gencfg current index: 145
      Gencfg last state: UP
      Gencfg current state: UP
      Gencfg V6 source address: 88:88:00:00:00:00:00:00:00:00:00:00:00:00:88:88
      Gencfg backup lock: 0
      Gencfg kqp: 0x0
      Gencfg Reference count: 0x2

    Gencfg keyid: 4
      Gencfg last index: 145
      Gencfg current index: 145
      Gencfg last state: UP
      Gencfg current state: UP
      Gencfg V6 source address: 99:99:00:00:00:00:00:00:00:00:00:00:00:00:99:99
      Gencfg backup lock: 0
      Gencfg kqp: 0x0
      Gencfg Reference count: 0x2

    Aggregate: 4.4.4.0/24
    Aggregate refcnt: 1

    Aggregate: 1.1.1.0/24
    Aggregate refcnt: 1

    Aggregate: 2.2.2.0/24
    Aggregate refcnt: 1

    Aggregate: 3.3.3.0/24
    Aggregate refcnt: 1

    V6 source address: 9999::9999/128
    V6 source refcnt: 1

    V6 source address: 8888::8888/128
    V6 source refcnt: 1

    V6 source address: 7777::7777/128
    V6 source refcnt: 1

    V6 source address: 6666::6666/128
    V6 source refcnt: 1

{master}
regress@10.102.171.225> 

show dynamic-tunnels pfe-tunnel-localization (Backup)

content_copy zoom_out_map
user@host> show dynamic-tunnels pfe-tunnel-localization  
Anchor PFE Name: pfe-0/0/0
    Reference count: 16

    Gencfg keyid: 1
      Gencfg last index: 145
      Gencfg current index: 145
      Gencfg last state: UP
      Gencfg current state: UP
      Gencfg V6 source address: 66:66:00:00:00:00:00:00:00:00:00:00:00:00:66:66
      Gencfg backup lock: 1
      Gencfg kqp: 0x0
      Gencfg Reference count: 0x3

    Gencfg keyid: 2
      Gencfg last index: 145
      Gencfg current index: 145
      Gencfg last state: UP
      Gencfg current state: UP
      Gencfg V6 source address: 77:77:00:00:00:00:00:00:00:00:00:00:00:00:77:77
      Gencfg backup lock: 1
      Gencfg kqp: 0x0
      Gencfg Reference count: 0x3

    Gencfg keyid: 3
      Gencfg last index: 145
      Gencfg current index: 145
      Gencfg last state: UP
      Gencfg current state: UP
      Gencfg V6 source address: 88:88:00:00:00:00:00:00:00:00:00:00:00:00:88:88
      Gencfg backup lock: 1
      Gencfg kqp: 0x0
      Gencfg Reference count: 0x3

    Gencfg keyid: 4
      Gencfg last index: 145
      Gencfg current index: 145
      Gencfg last state: UP
      Gencfg current state: UP
      Gencfg V6 source address: 99:99:00:00:00:00:00:00:00:00:00:00:00:00:99:99
      Gencfg backup lock: 1
      Gencfg kqp: 0x0
      Gencfg Reference count: 0x3

    Aggregate: 1.1.1.0/24
    Aggregate refcnt: 1

    Aggregate: 2.2.2.0/24
    Aggregate refcnt: 1

    Aggregate: 3.3.3.0/24
    Aggregate refcnt: 1

    Aggregate: 4.4.4.0/24
    Aggregate refcnt: 1

    V6 source address: 8888::8888/128
    V6 source refcnt: 1

    V6 source address: 7777::7777/128
    V6 source refcnt: 1

    V6 source address: 6666::6666/128
    V6 source refcnt: 1

    V6 source address: 9999::9999/128
    V6 source refcnt: 1

show dynamic-tunnels pfe-tunnel-localization (Localization)

content_copy zoom_out_map
user@host> show dynamic-tunnels pfe-tunnel-localization 
Anchor PFE Name: pfe-0/0/0
	Reference count: 12
	Gencfg keyid: 1
  	Gencfg tunnel type: UDP
  	Gencfg last index: 142
  	Gencfg current index: 142
  	Gencfg last state: UP
  	Gencfg current state: UP
  	Gencfg backup lock: 0
  	Gencfg kqp: 0x0
  	Gencfg Reference count: 14

Release Information

Command introduced in Junos OS Release 17.3R1.

footer-navigation