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 ldp session

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
show ldp session
<brief | detail | extensive>
<auto-targeted>
<destination>
<instance instance-name>
<logical-system (all | logical-system-name)>

Description

Display information about Label Distribution Protocol (LDP) sessions.

Options

none

Display standard information about all LDP sessions for all routing instances.

brief | detail | extensive

(Optional) Display the specified level of output.

auto-targeted

(Optional) Display information about LDP sessions that are automatically targeted using loopback addresses.

destination

(Optional) Restrict LDP session display to the specified address.

instance instance-name

(Optional) Display routing instance information for the specified instance. If instance-name is omitted, information is displayed for the master instance.

logical-system (all | logical-system-name)

(Optional) Perform this operation on all logical systems or on a particular logical system. This option is only supported on Junos OS.

Required Privilege Level

view

Output Fields

Table 1 describes the output fields for the show ldp session command. Output fields are listed in the approximate order in which they appear.

Table 1: show ldp session Output Fields

Field Name

Field Description

Level of Output

Address

Transport address of the session.

any

State

State of the session: Nonexistent, Connecting, Initialized, OpenRec, OpenSent, Operational, or Closing. The states correspond to the state diagram specified in Internet Draft LDP Specification draft-ietf-mpls-rfc3036bis-01.txt.

any

Connection

TCP connection state: Closed, Opening, or Open.

any

Hold time

Time remaining until the session will be closed, in seconds.

any

Session ID

LDP identifiers of the peers of this session.

detail extensive

Next keepalive

Time until next keepalive is sent, in seconds.

detail extensive

Active

Whether the local router is playing the active role in the session and during session establishment.

detail extensive

Passive

Whether the local router is playing the passive role in the session and during session establishment.

detail extensive

Maximum PDU

Maximum protocol data unit (PDU) size (packet size) for the session.

detail extensive

Hold time

Time remaining until the session will be closed, in seconds. This value corresponds to the one configured using the keepalive-timeout statement configured at the [edit protocols ldp] hierarchy level.

detail extensive

Neighbor count

Number of neighbors that are contributing to the session.

detail extensive

Neighbor types

Category of LDP session: discovered or auto-targeted.

any

Keepalive interval

Keepalive interval, in seconds.

detail extensive

Connect retry interval

TCP connection retry interval, in seconds.

detail extensive

Local address

Local transport address.

detail extensive

Remote address

Remote transport address.

detail extensive

Up for

Time that this session has been up.

detail extensive

Last down

Time since the session last went down.

detail extensive

Reason

Reason the session went down:

  • Aborted graceful restart

  • Authentication key was changed

  • Bad type length value (TLV)

  • Bad protocol data unit (PDU) packets

  • Command-line interface (CLI) command

  • Connect time expired

  • Connection error

  • Connection reset

  • Error during initialization

  • Hold time expired

  • No adjacency or all adjacencies down

  • Notification received

  • Received notification from peer

  • Unexpected End of File (EOF)

  • Unknown reason

detail extensive

Number of session flaps

Number of times the session changes from up to down.

detail extensive

Restarting

LDP is in the process of gracefully restarting.

detail extensive

Capabilities advertised

LDP capabilities advertised to a peer.

detail extensive

Capabilities received

LDP capabilities received from a peer.

detail extensive

Protection

Information about the status of MPLS LDP session protection.

detail extensive

restart complete in nnn msec

Amount of time (in milliseconds) remaining until graceful restart is declared complete.

detail extensive

Authentication type

Shows the longest match MD5 authentication

detail extensive

Local

Information about graceful restart for the local end of an LDP session. Graceful restart and helper mode are independent.

  • Restart—Status of the grateful restart feature at the local end of the LDP session: enabled or disabled.

  • Helper mode—Status of the helper mode feature at the local end of the LDP session: enabled or disabled. When this feature is enabled, the local end of the LDP session can help the restarting router with its LDP restart procedures.

  • Reconnect time—Amount of time to wait from when a restart is initiated until the router can exchange LDP messages with its neighbors. The default is 60000 msec and is not configurable. (Reconnect timeout refers to "FT Reconnect timeout" in draft-ietf-mpls-ldp-restart-06, Internet Draft Graceful Restart Mechanism for LDP.)

detail extensive

Remote

Information about graceful restart at the remote end of an LDP session. Graceful restart and helper mode are independent.

  • Restart—Status of the grateful restart feature at the remote end of the LDP session: enabled or disabled.

  • Helper mode—Status of the helper mode feature at the remote end of the LDP session: enabled or disabled. When this feature is enabled, the remote end of the LDP session can help the restarting router with its LDP restart procedures.

  • Reconnect time—Amount of time in milliseconds from when a restart is initiated until the remote router can exchange LDP messages with its neighbors.

detail extensive

Local maximum recovery time

Amount of time during which the restarting node attempts to recover its lost states with help from its neighbors (in milliseconds).

detail extensive

Next-hop addresses received

Next-hop addresses received on the session.

detail extensive

Queue depth

Number of messages that are queued for sending to the peers in the group.

extensive

Message type

Type of message being sent:

    • Initialization—Session initialization negotiation messages sent by an LSR to an LDP peer when the transport connection is established.

    • Keeaplive—Keepalive timer messages sent by an LSR to an LDP peer to keep the session active when there is no information or PDU exchanged between them.

    • Notification—Notification messages (such as state of the LDP session) or error information (such as bad PDU length) sent by an LSR to an LDP peer.

    • Address—Message sent by an LSR to an LDP peer to advertise interface addresses.

    • Address withdraw—Message sent by an LSR to an LDP peer to withdraw a previously advertised interface address.

    • Label mapping—Message sent by an LSR to an LDP peer to advertise label mapping for a forwarding equivalence class (FEC).

    • Label request—Message sent by an LSR to an LDP peer to request a label mapping for an FEC.

    • Label withdraw— Message sent by an LSR to an LDP peer to withdraw a previously advertised FEC-label mapping.

    • Label release—Message sent by an LSR to an LDP peer to notify the peer that a specific FEC-label mapping has been released.

    • Label abort—Message sent by an LSR to an LDP peer to abort a label request message.

  • Total—Messages sent and received during the lifetime of the session.

  • Last 5 seconds—Messages sent and received during the current session.

extensive

Sample Output

show ldp session brief

content_copy zoom_out_map
user@host> show ldp session brief   
  Address           State        Connection     Hold time
10.255.72.160       Operational  Open             21
10.255.72.164       Operational  Open             20
10.255.72.172       Operational  Open             21

show ldp session detail

content_copy zoom_out_map
user@host> show ldp session detail   
Address: 192.168.0.3, State: Operational, Connection: Open, Hold time: 27
  Session ID: 192.168.0.2:0--192.168.0.3:0
  Next keepalive in 7 seconds
  Passive, Maximum PDU: 4096, Hold time: 30, Neighbor count: 1
  Neighbor types: discovered
  Keepalive interval: 10, Connect retry interval: 1
  Local address: 192.168.0.2, Remote address: 192.168.0.3
  Up for 00:00:02
  Capabilities advertised: none
  Capabilities received: none
  Protection: disabled
  Local - Restart: enabled, Helper mode: enabled, Reconnect time: 60000
  Remote - Restart: enabled, Helper mode: enabled, Reconnect time: 60000
  Local maximum neighbor reconnect time: 120000 msec
  Local maximum neighbor recovery time: 240000 msec
  Local Label Advertisement mode: Downstream unsolicited
  Remote Label Advertisement mode: Downstream unsolicited
  Negotiated Label Advertisement mode: Downstream unsolicited
  Nonstop routing state: Not in sync
  Next-hop addresses received:
    10.0.0.5
    10.0.0.33

show ldp session extensive

content_copy zoom_out_map
user@host> show ldp session extensive   
Address: 192.168.0.3, State: Operational, Connection: Open, Hold time: 22
  Session ID: 192.168.0.2:0--192.168.0.3:0
  Next keepalive in 2 seconds
  Passive, Maximum PDU: 4096, Hold time: 30, Neighbor count: 1
  Neighbor types: discovered
  Keepalive interval: 10, Connect retry interval: 1
  Local address: 192.168.0.2, Remote address: 192.168.0.3
  Up for 00:05:37
  Capabilities advertised: none
  Capabilities received: none
  Protection: disabled
  Local - Restart: enabled, Helper mode: enabled, Reconnect time: 60000
  Remote - Restart: enabled, Helper mode: enabled, Reconnect time: 60000
  Local maximum neighbor reconnect time: 120000 msec
  Local maximum neighbor recovery time: 240000 msec
  Local Label Advertisement mode: Downstream unsolicited
  Remote Label Advertisement mode: Downstream unsolicited
  Negotiated Label Advertisement mode: Downstream unsolicited
  Nonstop routing state: Not in sync
  Next-hop addresses received:
    10.0.0.5
    10.0.0.33
  Queue depth: 0
Message type               Total                     Last 5 seconds
                       Sent      Received          Sent      Received
Initialization            1             1             0             0
Keepalive                33            33             1             1
Notification              0             0             0             0
Address                   1             1             0             0
Address withdraw          0             0             0             0
Label mapping             7             5             0             0
Label request             0             0             0             0
Label withdraw            3             1             0             0
Label release             1             3             0             0
Label abort               0             0             0             0

show ldp session auto-targeted detail

content_copy zoom_out_map
user@host> show ldp session auto-generated detail
Address: 192.168.1.5, State: Operational, Connection: Open, Hold time: 25
    Session ID: 192.168.1.1:0--192.168.1.5:0
    Next keepalive in 5 seconds
    Passive, Maximum PDU: 4096, Hold time: 30, Neighbor count: 1
    Neighbor types: discovered, Auto-targeted
                                ^^^^^^^^^^^^^
    Keepalive interval: 10, Connect retry interval: 1
    Local address: 192.168.1.1, Remote address: 192.168.1.5
    Up for 00:00:34
    Capabilities advertised: none
    Capabilities received: none
    Protection: disabled
    Local - Restart: disabled, Helper mode: enabled
    Remote - Restart: disabled, Helper mode: enabled
    Local maximum neighbor reconnect time: 120000 msec
    Local maximum neighbor recovery time: 240000 msec
    Local Label Advertisement mode: Downstream unsolicited
    Remote Label Advertisement mode: Downstream unsolicited
    Negotiated Label Advertisement mode: Downstream unsolicited
    Nonstop routing state: Not in sync
    Next-hop addresses received:
      192.168.1.2
      192.168.1.3

Release Information

Command introduced before Junos OS Release 7.4.

footer-navigation