LDP Operational Commands

LDP Show Commands

The LDP show commands provide detailed information about the LDP protocol operations.

LDP Summary

Syntax:

show ldp summary <options>

Option Description

-

Without any option, the command displays the LDP summary information for all instances.

instance <instance-name>

Displays LDP summary information about the specified instance.

Example: LDP summary for the default instance

supervisor@rtbrick: op> show ldp summary
Instance: default
  General information:
    LDP identifier: 198.51.100.11:0, Version: 1
    FEC resolution: Best match
    Protocol preference: 9
    LSR ID: 198.51.100.11
    IPv4 Status: True
    IPv6 Status: True
    L2VPN VPLS-VPWS Status: False
  Modes:
    Advertisement mode: Downstream Unsolicited
    Advertisement control mode: Ordered
    Label retention mode: Liberal
  Capabilities:
    IPv6 address family: -  , Graceful restart: False
    Loop detection: False
      Hop count: -, Vector length: -
  Timers:
    Adjacency:
      Hello: 5s, Holdtime: 15s
    Targeted adjacency:
      Hello: 15s, Holdtime: 45s
    Session:
      Keepalive: 10s, Holdtime: 30s
  Statistics:
    Adjacency:
      Link adjacency: 4, Targeted adjacency: 0
    Session:
      Session in non-existent: 0, Session in initialized: 0
      Session in opensent: 0, Session in openconfirm: 0
      Session in operational: 1

api  To access the Operational State API that corresponds to this CLI, click here.

LDP Neighbor

Syntax:

show ldp neighbor <options>

Option Description

-

Without any option, this command displays information about LDP neighbors.

detail

Detailed information about the LDP neighbors.

instance <instance-name>

Displays LDP neighbor information about the specified instance.

instance <instance-name> detail

Displays detailed LDP neighbor information about the specified instance.

instance <instance-name> ldp-id <ldp-id>

Displays LDP neighbor information about the specified LDP identifier and instance.

interface <name>

Displays LDP neighbor information about the specified interface.

interface <name> detail

Displays detailed LDP neighbor information about the specified interface.

ldp-id <ldp-id>

Displays LDP neighbor information about the specified LDP identifier.

Example 1: Summary view of all the LDP neighbors

supervisor@rtbrick: op> show ldp neighbor
Instance: default
  Interface/Peer      LDP ID              Transport IP              Up Since                  Expires
  ifl-0/0/2/0         198.51.100.21:0     198.51.100.21             Fri Jun 05 14:49:56       in 13s
  ifl-0/0/2/100       198.51.100.21:0     198.51.100.21             Fri Jun 05 14:49:56       in 13s
  ifl-0/0/2/0         198.51.100.21:0     2001:db8:0:1::21          Fri Jun 05 14:49:56       in 13s
  ifl-0/0/2/100       198.51.100.21:0     2001:db8:0:1::21          Fri Jun 05 14:49:56       in 13s

Example 2: Detailed view of all the LDP neighbors

supervisor@rtbrick: op> show ldp neighbor detail
Instance: default
  LDP-Identifier: 198.51.100.21:0, Interface: ifl-0/0/2/0, Type: Link
  Negotiated holdtime: 15000, Expiry time: 12s 975097us
  Local link address: 192.0.2.1, Peer link address: 192.0.2.2
  Local transport address: 198.51.100.11, Peer transport address: 198.51.100.21
  Local holdtime: 15, Peer holdtime: 15, Up since: Fri Jun 05 14:49:56
  Local transport preference : ipv4, Peer transport preference : ipv4
  Last transition time: Fri Jun 05 14:50:06 GMT +0000 2026
Instance: default
  LDP-Identifier: 198.51.100.21:0, Interface: ifl-0/0/2/100, Type: Link
  Negotiated holdtime: 15000, Expiry time: 12s 975170us
  Local link address: 192.0.2.5, Peer link address: 192.0.2.6
  Local transport address: 198.51.100.11, Peer transport address: 198.51.100.21
  Local holdtime: 15, Peer holdtime: 15, Up since: Fri Jun 05 14:49:56
  Local transport preference : ipv4, Peer transport preference : ipv4
  Last transition time: Fri Jun 05 14:50:06 GMT +0000 2026
Instance: default
  LDP-Identifier: 198.51.100.21:0, Interface: ifl-0/0/2/0, Type: Link
  Negotiated holdtime: 15000, Expiry time: 12s 975086us
  Local link address: fe80::9819:2cff:fe06:b503, Peer link address: fe80::9819:2cff:fe99:472d
  Local transport address: 2001:db8:0:1::11, Peer transport address: 2001:db8:0:1::21
  Local holdtime: 15, Peer holdtime: 15, Up since: Fri Jun 05 14:49:56
  Local transport preference : ipv4, Peer transport preference : ipv4
  Last transition time: Fri Jun 05 14:50:06 GMT +0000 2026
Instance: default
  LDP-Identifier: 198.51.100.21:0, Interface: ifl-0/0/2/100, Type: Link
  Negotiated holdtime: 15000, Expiry time: 12s 975137us
  Local link address: fe80::9819:2c00:6406:b503, Peer link address: fe80::9819:2c00:6499:472d
  Local transport address: 2001:db8:0:1::11, Peer transport address: 2001:db8:0:1::21
  Local holdtime: 15, Peer holdtime: 15, Up since: Fri Jun 05 14:49:56
  Local transport preference : ipv4, Peer transport preference : ipv4
  Last transition time: Fri Jun 05 14:50:06 GMT +0000 2026

Example 3: Detailed view of a targeted LDP neighbor

supervisor@rtbrick: op> show ldp neighbor ldp-id 198.51.100.21:0
Instance: default
  LDP-Identifier: 198.51.100.21:0, Interface: ifl-0/0/2/0, Type: Link
  Negotiated holdtime: 15000, Expiry time: 11s 964088us
  Local link address: 192.0.2.1, Peer link address: 192.0.2.2
  Local transport address: 198.51.100.11, Peer transport address: 198.51.100.21
  Local holdtime: 15, Peer holdtime: 15, Up since: Fri Jun 05 14:49:56
  Local transport preference : ipv4, Peer transport preference : ipv4
  Last transition time: Fri Jun 05 14:50:06 GMT +0000 2026
Instance: default
  LDP-Identifier: 198.51.100.21:0, Interface: ifl-0/0/2/100, Type: Link
  Negotiated holdtime: 15000, Expiry time: 11s 964187us
  Local link address: 192.0.2.5, Peer link address: 192.0.2.6
  Local transport address: 198.51.100.11, Peer transport address: 198.51.100.21
  Local holdtime: 15, Peer holdtime: 15, Up since: Fri Jun 05 14:49:56
  Local transport preference : ipv4, Peer transport preference : ipv4
  Last transition time: Fri Jun 05 14:50:06 GMT +0000 2026
Instance: default
  LDP-Identifier: 198.51.100.21:0, Interface: ifl-0/0/2/0, Type: Link
  Negotiated holdtime: 15000, Expiry time: 11s 964117us
  Local link address: fe80::9819:2cff:fe06:b503, Peer link address: fe80::9819:2cff:fe99:472d
  Local transport address: 2001:db8:0:1::11, Peer transport address: 2001:db8:0:1::21
  Local holdtime: 15, Peer holdtime: 15, Up since: Fri Jun 05 14:49:56
  Local transport preference : ipv4, Peer transport preference : ipv4
  Last transition time: Fri Jun 05 14:50:06 GMT +0000 2026
Instance: default
  LDP-Identifier: 198.51.100.21:0, Interface: ifl-0/0/2/100, Type: Link
  Negotiated holdtime: 15000, Expiry time: 11s 964190us
  Local link address: fe80::9819:2c00:6406:b503, Peer link address: fe80::9819:2c00:6499:472d
  Local transport address: 2001:db8:0:1::11, Peer transport address: 2001:db8:0:1::21
  Local holdtime: 15, Peer holdtime: 15, Up since: Fri Jun 05 14:49:56
  Local transport preference : ipv4, Peer transport preference : ipv4
  Last transition time: Fri Jun 05 14:50:06 GMT +0000 2026

LDP Interface

Syntax:

show ldp interface <option>

Option Description

-

Without any option, this command displays information on all configured LDP interfaces.

<interface-name>

Specify the name of the interface.

detail

Detailed interface information.

Example 1: Summary view of the specified LDP interface

supervisor@rtbrick: op> show ldp interface ifl-0/0/2/0
Instance: default
  Interface: ifl-0/0/2/0
    Primary IPv4 Address: 192.0.2.1, Primary IPv6 Address: fe80::9819:2cff:fe06:b503
    Session Hold: 30, Session Keepalive: 10
    Discovery Hello: 5, Discovery Hold: 15
    Neighbor count: 2, Transport preference: ipv4
    IPv4 enable: True, IPv6 enable: True, Cisco interop: False

Example 2: Summary view of all the LDP interfaces

supervisor@rtbrick: op> show ldp interface
Instance: default
  Interface                 Primary IPv4 Address      Primary IPv6 Address
  ifl-0/0/2/0               192.0.2.1                 fe80::9819:2cff:fe06:b503
  ifl-0/0/2/100             192.0.2.5                 fe80::9819:2c00:6406:b503
  lo-0/0/0/0                198.51.100.11             -
  lo-0/0/0/1                198.51.100.12             -

LDP Session

Syntax:

show ldp session <options>

Option Description

-

Without any option, this command displays a summary of LDP session information.

detail

Displays detailed information about the LDP sessions.

instance <instance-name>

Displays LDP session information about the specified instance.

instance <instance-name> detail

Displays detailed LDP session information about the specified instance.

instance <instance-name> ldp-id <ldp-id>

Displays LDP session information about the specified LDP identifier and instance.

ldp-id <ldp-id>

Displays LDP session information about the specified LDP identifier.

Example 1: Summary view of the LDP session

supervisor@rtbrick: op> show ldp session
Instance: default
  LDP ID            Peer IP                   State             Up/Down           FECRcvd   FECSent
  198.51.100.21:0   198.51.100.21             Operational       0d:00h:00m:13s          8         8

Example 2: Detailed view of the LDP session

supervisor@rtbrick: op> show ldp session detail
Instance: default
  LDP Identifier: 198.51.100.21:0, Peer IP: 198.51.100.21, Local IP: 198.51.100.11
    Type: Link, State: Operational, Uptime: 0d:00h:00m:14s
    Last transition: Fri Jun 05 14:50:00 GMT +0000 2026, Flap count: 0
    Adjacency count: 2, Role: Passive
  Advertisement Mode:
    Peer: Downstream unsolicited, Local: Downstream unsolicited
    Negotiated: Downstream unsolicited
  Timers:
    Connect retry: 10s
    Peer keepalive interval: 10s, Local keepalive interval: 10s
    Peer keepalive timeout: 30s, Local keepalive timeout: 30s
    Negotiated keepalive interval: 10s
    Negotiated keepalive timeout: 30s
  Received messages:
    Initialization: 1, KeepAlive: 2, Notification: 0
    Address: 2, Address Withdraw: 0, Label Mapping: 8
    Label Withdraw: 0, Label Release: 0
  Sent messages:
    Initialization: 1, KeepAlive: 2, Notification: 0
    Address: 2, Address Withdraw: 0, Label Mapping: 8
    Label Withdraw: 0, Label Release: 0
  Capability:
    Typed WildCard FEC:
      Local Support: True, Peer Support: True, Negotiated: True
  Total received messages:
    Initialization: 1, KeepAlive: 2, Notification: 0
    Address: 2, Address Withdraw: 0, Label Mapping: 8
  Total sent messages:
    Initialization: 1, KeepAlive: 2, Notification: 0
    Address: 2, Address Withdraw: 0, Label Mapping: 8
    Label Withdraw: 0, Label Release: 0
In the case of a T-LDP session, the "Type" will be "Targeted".

api  To access the Operational State API that corresponds to this CLI, click here.

LDP Address

Syntax:

show ldp address <options>

Option Description

-

Without any option, this command displays a summary of all the interface addresses received from the LDP sessions.

instance <instance-name>

Displays LDP address information about the specified instance.

instance <instance-name> <afi>

Displays LDP address of the specified address family (AFI). Supported values: ipv4, ipv6.

instance <instance-name> ldp-id <ldp-id>

Displays LDP address information about the specified LDP identifier and instance.

ldp-id <ldp-id>

Displays LDP address information about the specified LDP identifier.

Example: Summary view of all the LDP addresses

supervisor@rtbrick: op> show ldp address
Instance: default, LDP Identifier: 198.51.100.21:0, AFI: ipv4
  192.0.2.2
  192.0.2.6
  198.51.100.21
  198.51.100.22
Instance: default, LDP Identifier: 198.51.100.21:0, AFI: ipv6
  2001:db8:0:1::21
  2001:db8:0:1::22
  2001:db8:1:1::2
  2001:db8:2:1::2
  fe80::9819:2c00:6499:472d
  fe80::9819:2cff:fe99:472d

LDP Binding

Syntax:

show ldp binding <options>

Option Description

-

Without any option, this command displays a summary of all the LDP label bindings.

detail

Displays detailed LDP label binding information.

instance <instance-name>

Displays LDP label binding information of the specified instance.

instance <instance-name> <afi>

Displays LDP label binding information of the specified address family. Supported AFI value: IPv4, IPv6.

instance <instance-name> <afi> detail

Displays detailed LDP label binding information of the specified address family.

instance <instance-name> <afi> prefix <ip>

Displays LDP label binding information of the specified prefix and instance for the specified address family.

instance <instance-name> <afi> prefix <ip> detail

Displays detailed LDP label binding information of the specified prefix and instance for the specified address family.

received

Displays the LDP received label binding information of the LDP sessions.

received instance <instance-name> <afi>

Displays LDP received label binding information of the specified address family and instance.

received instance <instance-name> <afi> detail

Displays detailed LDP received label binding information of the specified address family and instance.

received instance <instance-name> <afi> ldp-id <ldp-id>

Displays LDP received label binding information of the specified instance.

received instance <instance-name> <afi> ldp-id <ldp-id> detail

Displays detailed LDP received label binding information of the specified LDP identifier and instance.

received <afi>

Displays LDP received label binding information of the specified address family. Supported AFI values: IPv4, IPv6.

received <afi> detail

Displays detailed LDP received label binding information of the specified address family.

received <afi> instance <instance-name>

Displays LDP received label binding information of the specified address family and instance.

received <afi> instance <instance-name> detail

Displays detailed LDP received label binding information of the specified address family and instance.

received <afi> instance <instance-name> ldp-id <ldp-id>

Displays LDP received label binding information of the specified address family, instance, and LDP identifier.

received <afi> ldp-id <ldp-id>

Displays LDP received label binding information of the specified address family and LDP identifier.

received <afi> ldp-id <ldp-id> detail

Displays detailed LDP received label binding information of the specified address family and LDP identifier.

sent

Displays the LDP sent label binding information of the LDP sessions.

sent instance <instance-name> <afi>

Displays LDP sent label binding information of the specified address family and instance. Supported AFI values: IPv4, IPv6.

sent instance <instance-name> <afi> detail

Displays detailed LDP sent label binding information of the specified address family and instance.

sent instance <instance-name> <afi> prefix <ip>

Displays LDP sent label binding information of the specified address family, instance, and prefix.

sent instance <instance-name> <afi> prefix <ip> detail

Displays detailed LDP sent label binding information of the specified address family, instance, and prefix.

sent <afi>

Displays LDP sent label binding information of the specified address family. Supported AFI values: IPv4, IPv6.

sent <afi> detail

Displays detailed LDP sent label binding information of the specified address family.

sent <afi> instance <instance-name>

Displays LDP sent label binding information of the specified address family and instance.

sent <afi> instance <instance-name> detail

Displays detailed LDP sent label binding information of the specified address family and instance.

sent <afi> instance <instance-name> prefix <ip>

Displays LDP sent label binding information of the specified address family, instance, and prefix.

sent <afi> instance <instance-name> prefix <ip> detail

Displays detailed LDP sent label binding information of the specified address family, instance, and prefix.

sent <afi> prefix <ip>

Displays LDP sent label binding information of the specified address family and prefix.

sent <afi> prefix <ip> detail

Displays detailed LDP sent label binding information of the specified address family and prefix.

Example 1: Summary view of the LDP binding

supervisor@rtbrick: op> show ldp binding
Instance: default, AFI: ipv4, SAFI: labeled-unicast
  Prefix                                                  In Label          Out Label        LDP ID             Status
  198.51.100.11/32                                               -                  3        -                  Best
                                                            524032                  -        198.51.100.21:0    Non-best
  198.51.100.12/32                                               -                  3        -                  Best
                                                            524032                  -        198.51.100.21:0    Non-best
  198.51.100.21/32                                               3             524032        198.51.100.21:0    Best
  198.51.100.22/32                                               3             524032        198.51.100.21:0    Best
Instance: default, AFI: ipv6, SAFI: labeled-unicast
  Prefix                                                  In Label          Out Label        LDP ID             Status
  2001:db8:0:1::11/128                                           -                  3        -                  Best
                                                            524033                  -        198.51.100.21:0    Non-best
  2001:db8:0:1::12/128                                           -                  3        -                  Best
                                                            524033                  -        198.51.100.21:0    Non-best
  2001:db8:0:1::21/128                                           3             524033        198.51.100.21:0    Best
  2001:db8:0:1::22/128                                           3             524033        198.51.100.21:0    Best

Example 2: Summary view of the LDP binding for the specified prefix

supervisor@rtbrick: op> show ldp binding prefix 198.51.100.21/32
Instance: default, AFI: ipv4, SAFI: labeled-unicast
  Prefix                                                  In Label          Out Label        LDP ID             Status
  198.51.100.21/32                                               3             524032        198.51.100.21:0    Best

LDP Route

Syntax:

show ldp route <options>

Option Description

-

Without any option, this command displays a summary of LDP route information.

instance <instance-name>

Displays LDP route information for the specified instance.

instance <instance-name> <afi>

Displays LDP route information for the specified address family and instance. Supported AFI values: ipv4, ipv6, and mpls.

instance <instance-name> ipv4 prefix <ip>

Displays LDP route information for the specified address family of IPv4 prefix and instance.

instance <instance-name> ipv6 prefix <ip>

Displays LDP route information for the specified address family of IPv6 prefix and instance.

instance <instance-name> prefix <ip>

Displays LDP route information for the specified prefix and instance.

instance <instance-name> label <label>

Displays LDP route information for the specified MPLS label and instance.

instance <instance-name> mpls

Displays LDP route information about MPLS labels.

instance <instance-name> mpls label <label>

Displays LDP route information for the specified MPLS label and instance.

label <label>

Displays LDP route information for the specified MPLS label.

ipv4

Displays LDP route information about the IPv4 address family.

ipv4 prefix <ip>

Displays LDP route IPv4 address family information for the specified prefix.

ipv6

Displays LDP route information about the IPv6 address family.

ipv6 prefix <ip>

Displays LDP route IPv6 address family information for the specified prefix.

mpls

Displays LDP route information about MPLS labels.

mpls label <label>

Displays LDP route information for the specified MPLS label.

prefix <ip>

Displays LDP route information for the specified prefix address.

Example: Summary view of the LDP route

supervisor@rtbrick: op> show ldp route
Instance: default, AFI: ipv4, SAFI: labeled-unicast
  Prefix               Out Label               Next Hop                                   Interface           Metric
  198.51.100.11/32     -                       -                                          -                   0
  198.51.100.12/32     -                       -                                          -                   0
  198.51.100.21/32     -                       192.0.2.2                                  -                   2000000
  198.51.100.22/32     -                       192.0.2.2                                  -                   2000000
Instance: default, AFI: ipv6, SAFI: labeled-unicast
  Prefix                                       Out Label               Next Hop                                   Interface           Metric
  2001:db8:0:1::11/128                         -                       -                                          -                   0
  2001:db8:0:1::12/128                         -                       -                                          -                   0
  2001:db8:0:1::21/128                         -                       fe80::9819:2cff:fe99:472d                  ifl-0/0/2/0         2000000
  2001:db8:0:1::22/128                         -                       fe80::9819:2cff:fe99:472d                  ifl-0/0/2/0         2000000
Instance: default, AFI: mpls, SAFI: unicast
  Label                Out Label               Next Hop                                   Interface           Metric
  524032               -                       192.0.2.2                                  -                   -
  524032,bos:1         -                       192.0.2.2                                  -                   -
  524033               -                       fe80::9819:2cff:fe99:472d                  ifl-0/0/2/0         -
  524033,bos:1         -                       fe80::9819:2cff:fe99:472d                  ifl-0/0/2/0         -

LDP Statistics

Syntax:

show ldp statistics <options>

Option Description

-

Without any option, the command displays the LDP statistics for all instances.

instance <instance-name>

Displays LDP statistics information about the specified instance.

instance <instance-name> ldp-id <ldp-id>

Displays LDP statistics information about the specified LDP identifier and instance.

Example: Summary view of the LDP statistics

supervisor@rtbrick: op> show ldp statistics
Instance: default, LDP ID: 198.51.100.21:0
  Received messages:
    Initialization: 1, KeepAlive: 2, Notification: 0
    Address: 2, Address Withdraw: 0, Label Mapping: 8
    Label Withdraw: 0, Label Release: 0
  Sent messages:
    Initialization: 1, KeepAlive: 2, Notification: 0
    Address: 2, Address Withdraw: 0, Label Mapping: 8
    Label Withdraw: 0, Label Release: 0

LDP TCP connection

Syntax:

show ldp tcp connection <options>

Option Description

-

Without any option, the command displays the TCP connections used by LDP for all instances.

detail

Detailed list view of the TCP connections.

detail instance <instance-name>

Detailed list view of the TCP connections of the specified instance.

instance <instance-name>

TCP connections summary of the specified instance.

Example: Summary view of the LDP TCP connections

supervisor@rtbrick: op> show ldp tcp connection
Instance       Local IP             Remote IP            Local port     Remote port   State
default        198.51.100.11        198.51.100.21               646           58311   Established

LDP Clear Commands

Clear commands allow resetting operational states.

Clear LDP Session

Syntax:

clear ldp session <options>

Option Description

all

Clears all the LDP sessions.

all soft-in

Sends route refresh to all neighbors to receive FEC bindings.

all soft-out

Re-advertises all the routes previously sent to the peers.

instance <instance-name> all

Clears all the LDP sessions for the specified instance.

instance <instance> all soft-in

Sends route refresh to all neighbors to receive FEC bindings for the specified instance.

instance <instance> all soft-out

Re-advertises all the routes previously sent to the peers for the specified instance.

instance <instance-name> peer ldp-id <ldp-id>

Clears the LDP session for the specified instance and peer LDP identifier.

instance <instance> peer ldp-id <ldp-id> soft-in

Sends route refresh to the specific peer to receive FEC bindings for the specified instance and peer ldp-id.

instance <instance> peer ldp-id <ldp-id> soft-out

Re-advertises all the routes previously sent to the specific peer for the specified instance and peer ldp-id.

Example: The example below shows how to clear all the LDP sessions.

supervisor@rtbrick>SPINE01: op> clear ldp session all
LDP session cleared with instance default
supervisor@rtbrick>SPINE01: op>

api  To access the Operational State API that corresponds to this CLI, click here.

Clear LDP Statistics

Syntax:

clear ldp statistics <options>

Option Description

all

Clears all the LDP statistics.

instance <instance-name> all

Clears all the LDP statistics for the specified instance.

instance <instance-name> peer ldp-id <ldp-id>

Clears the LDP statistics for the specified instance and peer LDP identifier.

Example: The example below shows how to clear all the LDP statistics.

supervisor@rtbrick>SPINE01: op> clear ldp statistics all
LDP statistics cleared for instance default
supervisor@rtbrick>SPINE01: op>

Clear LDP Neighbor

Syntax:

clear ldp neighbor <options>

Option Description

all

Clears all the LDP neighbors.

instance <instance-name>

Clears the LDP neighbor for the specified instance.

Example: The example below shows how to clear all the LDP neighbor.

supervisor@rtbrick>SPINE01: op> clear ldp neighbor all
LDP neighbor cleared with instance default
supervisor@rtbrick>SPINE01: op>