Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


show dynamic-tunnels pfe-tunnel-localization



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.


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.



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

Required Privilege Level


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.


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)

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

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

Release Information

Command introduced in Junos OS Release 17.3R1.