Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show ldp session

Syntax

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

show ldp session detail

show ldp session extensive

show ldp session auto-targeted detail

Release Information

Command introduced before Junos OS Release 7.4.