Cisco IOS XR MPLS Debug Command Reference, Release 3.6
MPLS Label Distribution Protocol Debug Commands on Cisco IOS XR Software
Download this chapter
MPLS Label Distribution Protocol Debug Commands on Cisco IOS XR SoftwareMPLS Label Distribution Protocol Debug Commands on Cisco IOS XR Software
Download the complete book
Cisco IOS XR MPLS Debug Command Reference, Release 3.6Cisco IOS XR MPLS Debug Command Reference, Release 3.6 (PDF - 2 MB)
give_us_feedback

Table Of Contents

MPLS Label Distribution Protocol Debug Commands on Cisco IOS XR Software

debug mpls ldp advertisements

debug mpls ldp backoff

debug mpls ldp bindings

debug mpls ldp chkpt

debug mpls ldp config

debug mpls ldp control

debug mpls ldp errors

debug mpls ldp filter

debug mpls ldp forwarding

debug mpls ldp graceful-restart

debug mpls ldp igp auto-config

debug mpls ldp igp sync

debug mpls ldp interface

debug mpls ldp memory

debug mpls ldp messages

debug mpls ldp peer

debug mpls ldp process

debug mpls ldp pw

debug mpls ldp route

debug mpls ldp session

debug mpls ldp session protection

debug mpls ldp targeted-neighbors

debug mpls ldp timers

debug mpls ldp transport

debug mpls ldp warnings


MPLS Label Distribution Protocol Debug Commands on Cisco IOS XR Software

This chapter describes the commands used to debug MPLS Label Distribution Protocol (LDP) in
Cisco IOS XR software.

debug mpls ldp advertisements

To display information about the advertisement of labels and interface addresses to LDP peers, use the debug mpls ldp advertisements command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp advertisements [peer-acl acl] [prefix-acl acl]

no debug mpls ldp advertisements [peer-acl acl] [prefix-acl acl]

Syntax Description

peer-acl acl

(Optional) Limits the displayed advertisements to those for LDP peers permitted by the access control list (ACL).

prefix-acl acl

(Optional) Limits the displayed binding information to that learned for prefixes permitted by the ACL.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Use the debug mpls ldp advertisements command to monitor the label and address advertisements to LDP peers.

Use the peer-acl or prefix-acl keywords separately or together to limit the information display to specific LDP peers and specific prefixes.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp advertisements command using the peer-acl keyword: 

RP/0/RP0/CPU0:router# debug mpls ldp advertisements peer-acl peer_2


RP/0/RP0/CPU0:Aug 5 07:05:17.836: mpls_ldp[315]: %ROUTING-LDP-5-NBR_CHANGE: Nbr 2.2.2.2:0, 
UP

RP/0/RP0/CPU0:Aug 5 07:05:17.837: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): Sending 
initial addr/label advertisements to peer

RP/0/RP0/CPU0:Aug 5 07:05:17.837: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): Initial 
Address advertisement to peer

RRP/0/RP0/CPU0:Aug 5 07:05:17.837: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): advertise 
address 10.1.0.1

RRP/0/RP0/CPU0:Aug 5 07:05:17.838: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): advertise 
address 10.2.0.1

RRP/0/RP0/CPU0:Aug 5 07:05:17.838: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): advertise 
address 10.8.0.1

RRP/0/RP0/CPU0:Aug 5 07:05:17.838: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): advertise 
address 10.9.0.1

RRP/0/RP0/CPU0:Aug 5 07:05:17.838: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): advertise 
address 20.0.0.1

RRP/0/RP0/CPU0:Aug 5 07:05:17.839: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): advertise 
address 5.42.37.201

RRP/0/RP0/CPU0:Aug 5 07:05:17.839: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): advertise 
address 1.1.1.1

RRP/0/RP0/CPU0:Aug 5 07:05:17.839: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): advertise 
address 10.0.0.1

RRP/0/RP0/CPU0:Aug 5 07:05:21.974: mpls_ldp[315]: %ROUTING-LDP-5-NBR_CHANGE: Nbr 
3.3.3.3:0, UP 

RRP/0/RP0/CPU0:Aug 5 07:05:21.974: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): Omitting 
initial address advertisement to peer; state Estab

RRP/0/RP0/CPU0:Aug 5 07:05:24.668: mpls_ldp[315]: DBG-Advt: Peer(2.2.2.2:0): Initial Label 
advertisement to peer

debug mpls ldp backoff

To display information about the LDP backoff mechanism parameters, use the debug mpls ldp backoff command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp backoff

no debug mpls ldp backoff

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Use the debug mpls ldp backoff command to monitor backoff parameters configured for LDP sessions.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp backoff command: 

RP/0/RP0/CPU0:router# debug mpls ldp backoff


RP/0/RP0/CPU0:router# RP/0/RP0/CPU0:Aug 5 07:07:21.113: mpls_ldp[315]: 
%ROUTING-LDP-5-NBR_CHANGE: Nbr 3.3.3.3:0, DOWN 

RP/0/RP0/CPU0:Aug 5 07:07:22.700: mpls_ldp[315]: DBG-Backoff: Backoff OK for 
peer:3.3.3.3:0

RP/0/RP0/CPU0:Aug 5 07:07:22.701: mpls_ldp[315]: DBG-Backoff: Backoff OK for 
peer:3.3.3.3:0

RP/0/RP0/CPU0:Aug 5 07:07:22.704: mpls_ldp[315]: DBG-Backoff: Backoff OK for 
peer:3.3.3.3:0

RP/0/RP0/CPU0:Aug 5 07:07:24.598: mpls_ldp[315]: DBG-Backoff: Backoff OK for 
peer:3.3.3.3:0

debug mpls ldp bindings

To display information about addresses and label bindings learned from LDP peers by means of LDP downstream unsolicited label distribution, use the debug mpls ldp bindings command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp bindings [peer-acl acl] [prefix-acl acl]

no debug mpls ldp bindings [peer-acl acl] [prefix-acl acl]

Syntax Description

peer-acl acl

(Optional) Limits the displayed binding information to that learned from LDP peers permitted by the access control list (expressed as an alpha or numeric string).

prefix-acl acl

(Optional) Limits the displayed binding information to that learned for prefixes permitted by the ACL (expressed as an alpha or numeric string).


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Use the debug ldp bindings command to monitor label bindings and label switch router (LSR) addresses learned from LDP peers.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp bindings command using the prefix-acl keyword: 

RP/0/RP0/CPU0:router# debug mpls ldp bindings prefix-acl pfx_2


RP/0/RP0/CPU0:Aug 5 07:11:58.364: mpls_ldp[315]: DBG-Bind: Prefix(2.2.2.2/32): created; 
find route tags request

RP/0/RP0/CPU0:Aug 5 07:11:58.364: mpls_ldp[315]: DBG-Bind: Prefix(2.2.2.2/32): label 22 
(rev#11) assigned

RP/0/RP0/CPU0:Aug 5 07:11:59.449: mpls_ldp[315]: DBG-Bind: Prefix(2.2.2.2/32): label 
imp-null from 2.2.2.2:0 added

debug mpls ldp chkpt

To debug the interaction with the checkpoint library in relation to graceful restart and LDP forwarding states, use the debug mpls ldp chkpt command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp chkpt [interface type instance] [prefix-acl name] [peer-acl name]

no debug mpls ldp chkpt [interface type instance] [prefix-acl name] [peer-acl name]

Syntax Description

interface

Enter to select an interface type.

type

Interface type. For more information, use the question mark (?) online help function.

instance

Either a physical interface instance or a virtual interface instance as follows:

•Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

–rack: Chassis number of the rack.

–slot: Physical slot number of the modular services card or line card.

–module: Module number. A physical layer interface module (PLIM) is always 0.

–port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

•Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

peer-acl

(Optional) Limits the displayed binding information to that learned from LDP peers permitted by the access control list (ACL).

prefix-acl

(Optional) Limits the displayed binding information to that learned for prefixes permitted by the ACL.

name

ACL name for peer- or prefix-acl.

acl

ACL expressed as an alpha or numeric string.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp chkpt command: 

RP/0/RP0/CPU0:router# debug mpls ldp chkpt


RP/0/RP0/CPU0:router# RP/0/RP0/CPU0:Aug 5 07:15:22.484: mpls_ldp[315]: DBG-ChkPt: 
ldp_chkpt_lib_init

RP/0/RP0/CPU0:Aug 5 07:15:22.792: mpls_ldp[315]: DBG-ChkPt: Checkpointed table does exist

RP/0/RP0/CPU0:Aug 5 07:15:24.851: mpls_ldp[315]: DBG-ChkPt: ldp_chkpt_init

RP/0/RP0/CPU0:Aug 5 07:15:24.851: mpls_ldp[315]: DBG-ChkPt: ldp_chkpt_rewrite_tbl_reg

RP/0/RP0/CPU0:Aug 5 07:15:24.852: mpls_ldp[315]: DBG-ChkPt: Checkpointed rewrite table 
already exists; No. of records=8

RP/0/RP0/CPU0:Aug 5 07:15:24.852: mpls_ldp[315]: DBG-ChkPt: Iterating through checkpointed 
rewrite data...

RP/0/RP0/CPU0:Aug 5 07:15:24.862: mpls_ldp[315]: DBG-ChkPt: Prefix(2.2.2.2/32); path(nh 
10.2.0.2, oif PO0/2/0/1): chkpt_read; obj_id=0x80002f28, , labels 22/3, path_metric 0, 
fib_table_id 17, flags 0x0, is_from_gr_nbr Y

RP/0/RP0/CPU0:Aug 5 07:15:24.869: mpls_ldp[315]: DBG-ChkPt: Prefix(3.3.3.3/32); path(nh 
20.0.0.3, oif Gi0/3/0/0): chkpt_read; obj_id=0x80002f40, , labels 23/0, path_metric 0, 
fib_table_id 17, flags 0x0, is_from_gr_nbr Y

RP/0/RP0/CPU0:Aug 5 07:15:24.869: mpls_ldp[315]: DBG-ChkPt: Prefix(3.3.3.3/32); path(nh 
10.9.0.3, oif PO0/2/0/3): chkpt_read; obj_id=0x80002f58, , labels 23/0, path_metric 0, 
fib_table_id 17, flags 0x0, is_from_gr_nbr Y

...

debug mpls ldp config

To debug the verification and application of the configurations, use the debug mpls ldp config command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp config

no debug mpls ldp config

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp config command: 

RP/0/RP0/CPU0:router# debug mpls ldp config


RP/0/RP0/CPU0:router# RP/0/RP0/CPU0:Aug 5 07:18:14.397: mpls_ldp[315]: DBG-Config: LDP GR 
cfg read: in_use=No, cfged=No

RP/0/RP0/CPU0:Aug 5 07:18:16.782: mpls_ldp[315]: DBG-Config: BACKEND_SCAN: global-section 
(/cfg/gl/mpls_ldp/ord_gl/)

RP/0/RP0/CPU0:Aug 5 07:18:16.793: mpls_ldp[315]: DBG-Config: ldp_router_id_apply: Unpacked 
tuple: mask 0x3, cmd 1, new_ifname Loopback0 ipaddr 0

RP/0/RP0/CPU0:Aug 5 07:18:16.793: mpls_ldp[315]: DBG-Config: CREATE/SET: 
item='ord_gl/aa/router-id'

RP/0/RP0/CPU0:Aug 5 07:18:16.793: mpls_ldp[315]: DBG-Config: intf=Loopback0, Not yet 
CREATed in our db - processing IFRS

RP/0/RP0/CPU0:Aug 5 07:18:16.794: mpls_ldp[315]: DBG-Config: ldp_add_tuple_for_ifrs: 
intf=Loopback0, tuple='ord_gl/aa/router-id'

RP/0/RP0/CPU0:Aug 5 07:18:16.794: mpls_ldp[315]: DBG-Config: intf=Loopback0, Not in IFRS - 
adding entry

RP/0/RP0/CPU0:Aug 5 07:18:16.796: mpls_ldp[315]: DBG-Config: BACKEND_SCAN: if-section 
(/cfg/gl/mpls_ldp/ord_if/)

RP/0/RP0/CPU0:Aug 5 07:18:16.797: mpls_ldp[315]: DBG-Config: CREATE/SET: 
item='ord_if/if/GigabitEthernet0_3_0_0/ipv4'

RP/0/RP0/CPU0:Aug 5 07:18:16.797: mpls_ldp[315]: DBG-Config: intf=GigabitEthernet0_3_0_0, 
Not yet CREATed in our db - processing IFRS

...

debug mpls ldp control

To debug the general control plane interactions with the collaborators and peers, use the debug mpls ldp control command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp control

no debug mpls ldp control

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp control command: 

RP/0/RP0/CPU0:router# debug mpls ldp control


RP/0/RP0/CPU0:router# RP/0/RP0/CPU0:Aug 5 07:21:11.057: mpls_ldp[315]: DBG-Control: 
handling WORK_EVENT

RP/0/RP0/CPU0:Aug 5 07:21:11.058: mpls_ldp[315]: DBG-Control: Handling ADJ_DESTROYED with 
peer:0.0.0.0

RP/0/RP0/CPU0:Aug 5 07:21:11.058: mpls_ldp[315]: %ROUTING-LDP-5-NBR_CHANGE: Nbr 3.3.3.3:0, 
DOWN 

RP/0/RP0/CPU0:Aug 5 07:21:14.086: mpls_ldp[315]: DBG-Control: handling WORK_EVENT

RP/0/RP0/CPU0:Aug 5 07:21:14.086: mpls_ldp[315]: DBG-Control: Handling ADJ_UNSOL_OPEN with 
peer:10.8.0.3

RP/0/RP0/CPU0:Aug 5 07:21:14.086: mpls_ldp[315]: DBG-Control: Initializing 
lcl_addr_distribution_struct for peer_adj:0x4858e1ac

...

debug mpls ldp errors

To expose erroneous LDP conditions, use the debug mpls ldp errors command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp errors

no debug mpls ldp errors

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp errors command: 

RP/0/RP0/CPU0:router# debug mpls ldp errors


RP/0/RP0/CPU0:router# RP/0/RP0/CPU0:Aug 5 07:23:29.770: mpls_ldp[315]: ERROR: 
[ldp_read_error:1228] recv FAILED for socket (1.1.1.1:646 <-> 3.3.3.3:51980): No such 
process


RP/0/RP0/CPU0:Aug 5 07:23:29.776: mpls_ldp[315]: %ROUTING-LDP-5-NBR_CHANGE: Nbr 3.3.3.3:0, 
DOWN 

RP/0/RP0/CPU0:Aug 5 07:23:33.405: mpls_ldp[315]: %ROUTING-LDP-5-NBR_CHANGE: Nbr 3.3.3.3:0, 
UP

debug mpls ldp filter

To set up an LDP-enabled debug filter, use the debug mpls ldp filter command in EXEC. To disable this feature, use the no form of this command.

debug mpls ldp filter [ldp-id A.B.C.D: label space ID]

no debug mpls ldp filter [ldp-id A.B.C.D: label space ID]

Syntax Description

ldp-id A.B.C.D: label space ID

Defines the LDP ID of neighbor to be filtered.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.5.0

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The debug mpls ldp filter command is used to setup a debug filter, such as peer-acl, prefix-acl, or ldp-identifier, on global level so that LDP-enabled debugs are filtered using the global filter setup.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows how to enable debugging: 

RP/0/RP0/CPU0:router# debug mpls ldp filter

debug mpls ldp forwarding

To debug the operations on the internal LDP interface database, use the debug mpls ldp forwarding command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp forwarding [prefix-acl acl]

no debug mpls ldp forwarding [prefix-acl acl]

Syntax Description

prefix-acl acl

(Optional) Limits the displayed binding information to that learned for prefixes permitted by the access control list (expressed as an alpha or numeric string).


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp forwarding command using the prefix-acl keyword: 

RP/0/RP0/CPU0:router# debug mpls ldp forwarding prefix-acl pfx_2


RP/0/RP0/CPU0:router# RP/0/RP0/CPU0:Aug 5 07:50:40.718: mpls_ldp[315]: DBG-Rewrite: 
ldp_rewrite_db_init

RP/0/RP0/CPU0:Aug 5 07:50:40.741: mpls_ldp[315]: DBG-Rewrite: Prefix(2.2.2.2/32); path(nh 
10.2.0.2, oif PO0/2/0/1): obj_id=0x80002fe8, ldp_chkpt_restore_rewrite_info

RP/0/RP0/CPU0:Aug 5 07:50:40.741: mpls_ldp[315]: DBG-Rewrite: Prefix(2.2.2.2/32); New 
Prefix Node

RP/0/RP0/CPU0:Aug 5 07:50:40.742: mpls_ldp[315]: DBG-Rewrite: Prefix(2.2.2.2/32); path(nh 
10.2.0.2, oif PO0/2/0/1): New path node

RP/0/RP0/CPU0:Aug 5 07:50:40.743: mpls_ldp[315]: DBG-Rewrite: Prefix(2.2.2.2/32); path(nh 
10.2.0.2, oif PO0/2/0/1): UNLABELED=N

RP/0/RP0/CPU0:Aug 5 07:50:40.743: mpls_ldp[315]: DBG-Rewrite: Prefix(2.2.2.2/32); path(nh 
10.2.0.2, oif PO0/2/0/1): STALE=Y

RP/0/RP0/CPU0:Aug 5 07:50:40.743: mpls_ldp[315]: DBG-Rewrite: Prefix(2.2.2.2/32); path(nh 
10.2.0.2, oif PO0/2/0/1): CHKPT=Y

RP/0/RP0/CPU0:Aug 5 07:50:45.659: mpls_ldp[315]: %ROUTING-LDP-5-NBR_CHANGE: Nbr 3.3.3.3:0, 
UP

debug mpls ldp graceful-restart

To debug the graceful restart mode and associated timers, use the debug mpls ldp graceful-restart command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp graceful-restart

no debug mpls ldp graceful-restart

Syntax Description

peer-acl acl

(Optional) Limits the displayed binding information to that learned from LDP peers permitted by the access control list (expressed as an alpha or numeric string).


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp graceful restart command using the peer-acl keyword: 

RP/0/RP0/CPU0:router# debug mpls ldp graceful restart peer-acl peer_2


RP/0/RP0/CPU0:router# deb mpls ldp graceful-restart peer-acl peer_2

RP/0/RP0/CPU0:router# prl

RP/0/RP0/CPU0:router# proc res mpls_ldp

RP/0/RP0/CPU0:router# RP/0/RP0/CPU0:Aug 5 07:31:38.485: mpls_ldp[315]: DBG-GR: 
ldp_graceful_restart_init

RP/0/RP0/CPU0:Aug 5 07:31:38.488: mpls_ldp[315]: DBG-GR: LDP Process seem to be restarted!

RP/0/RP0/CPU0:Aug 5 07:31:38.489: mpls_ldp[315]: DBG-GR: LDP GR Forwarding State Hold 
timer started; timeout=180 sec

RP/0/RP0/CPU0:Aug 5 07:31:38.489: mpls_ldp[315]: DBG-GR: ldp_graceful_restart_init: set 
LDP GR recovery time to 360 sec

RP/0/RP0/CPU0:Aug 5 07:31:39.588: mpls_ldp[315]: DBG-GR: *** GR Neighbor Down List ***

RP/0/RP0/CPU0:Aug 5 07:31:39.590: mpls_ldp[315]: %ROUTING-LDP-5-NBR_CHANGE: Nbr 3.3.3.3:0, 
UP

debug mpls ldp igp auto-config

To debug MPLS LDP IGP auto-configuration events, use the debug mpls ldp igp auto-config command in EXEC. To return to the default behavior, use the no form of this command.

debug mpls ldp igp auto-config [interface type instance]

no debug mpls ldp igp auto-config [interface type instance]

Syntax Description

type

Interface type. For more information, use the question mark (?) online help function.

instance

Either a physical interface instance or a virtual interface instance as follows:

•Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

–rack: Chassis number of the rack.

–slot: Physical slot number of the modular services card or line card.

–module: Module number. A physical layer interface module (PLIM) is always 0.

–port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

•Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.5.0

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows how to debug MPLS LDP IGP auto-configuration: 

RP/0/RP0/CPU0:router# debug mpls ldp igp auto-config

debug mpls ldp igp sync

To debug MPLS LDP IGP synchronization events, use the debug mpls ldp igp sync command in EXEC mode. To return to the default behavior, use the no form of this command.

debug mpls ldp igp sync [1- 65535 | type instance]

no debug mpls ldp igp sync [1- 65535 | type instance]

Syntax Description

1-65535

Filters based on value (used to identify aggregated Ethernet and POS interfaces).

type

Interface type. For more information, use the question mark (?) online help function.

instance

Either a physical interface instance or a virtual interface instance as follows:

•Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

–rack: Chassis number of the rack.

–slot: Physical slot number of the modular services card or line card.

–module: Module number. A physical layer interface module (PLIM) is always 0.

–port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

•Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.3.0

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows how to debug MPLS LDP IGP synchronization: 

RP/0/RP0/CPU0:router# debug mpls ldp igp synch

debug mpls ldp interface

To debug manipulation of the internal LDP interface database and interaction with the interface manager, use the debug mpls ldp interface command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp interface type instance

no debug mpls ldp interface type instance

Syntax Description

type

Interface type. For more information, use the question mark (?) online help function.

instance

Either a physical interface instance or a virtual interface instance as follows:

•Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

–rack: Chassis number of the rack.

–slot: Physical slot number of the modular services card or line card.

–module: Module number. A physical layer interface module (PLIM) is always 0.

–port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0.
Example: interface MgmtEth0/RP1/CPU0/0.

•Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp interface command: 

RP/0/RP0/CPU0:router# debug mpls ldp interface GigabitEthernet 0/3/0/0


RP/0/RP0/CPU0:router# RP/0/RP0/CPU0:Aug 5 07:33:56.510: mpls_ldp[315]: DBG-IF: Connection 
UP with Ifmgr 

RP/0/RP0/CPU0:Aug 5 07:33:56.512: mpls_ldp[315]: DBG-IF: Registered with Ifmgr on CREATE 
event for ALL IPv4 interfaces

RP/0/RP0/CPU0:Aug 5 07:33:56.512: mpls_ldp[315]: DBG-IF: mpls_imc_connect: DONE

RP/0/RP0/CPU0:Aug 5 07:33:56.525: mpls_ldp[315]: DBG-IF: IP ARM Connect event

RP/0/RP0/CPU0:Aug 5 07:33:56.528: mpls_ldp[315]: DBG-IF: IP ARM router id - READY

RP/0/RP0/CPU0:Aug 5 07:33:56.534: mpls_ldp[315]: DBG-IF: IP ARM router id: old=0.0.0.0, 
new=1.1.1.1

RP/0/RP0/CPU0:Aug 5 07:33:58.788: mpls_ldp[315]: DBG-IF: 

RP/0/RP0/CPU0:Aug 5 07:33:58.788: mpls_ldp[315]: DBG-IF: ##### IMC bulk notification 
handler - 11 events - START #####

RP/0/RP0/CPU0:Aug 5 07:33:58.796: mpls_ldp[315]: DBG-IF: IMC state reg bulk start (reg=1)

RP/0/RP0/CPU0:Aug 5 07:33:58.802: mpls_ldp[315]: DBG-IF: IMC CREATE: 
GigabitEthernet0_3_0_0 - 0x4000200 (proto 12 'ipv4', caps 26 'ipv4', intf_type 15, encap 
30, flags 0x5)

RP/0/RP0/CPU0:Aug 5 07:33:58.802: mpls_ldp[315]: DBG-IF: Deleted IFRS entry for 
intf=GigabitEthernet0_3_0_0 (ifh=0x4000200)

RP/0/RP0/CPU0:Aug 5 07:33:58.803: mpls_ldp[315]: DBG-IF: Adding a IDB for 
GigabitEthernet0_3_0_0 (ifh:0x4000200)

RP/0/RP0/CPU0:Aug 5 07:33:58.803: mpls_ldp[315]: DBG-IF: Registering with IP ARM for IP 
address notifications on GigabitEthernet0_3_0_0

RP/0/RP0/CPU0:Aug 5 07:33:58.805: mpls_ldp[315]: DBG-IF: IP ARM data callback - 
ifh:0x4000200, change_type:0, addr:20.0.0.1/24

RP/0/RP0/CPU0:Aug 5 07:33:58.805: mpls_ldp[315]: DBG-IF: tdp_ip_address_change: 
intf=GigabitEthernet0_3_0_0, addr=20.0.0.1 (add)

RP/0/RP0/CPU0:Aug 5 07:33:58.806: mpls_ldp[315]: DBG-IF: IMC state reg bulk add (#4): 
GigabitEthernet0_3_0_0 (ifh:0x4000200)

RP/0/RP0/CPU0:Aug 5 07:33:58.810: mpls_ldp[315]: DBG-IF: tc_lsd_mpls_interface: 
intf=Gi0/3/0/0, enable

RP/0/RP0/CPU0:Aug 5 07:33:58.810: mpls_ldp[315]: DBG-IF: ldp_if_mpls_ipv4_apply: mpls 
netio chains successfully enabled on GigabitEthernet0_3_0_0

RP/0/RP0/CPU0:Aug 5 07:33:58.810: mpls_ldp[315]: DBG-IF: Adding ifrs tuple 
'ord_if/if/GigabitEthernet0_3_0_0/ipv4' for GigabitEthernet0_3_0_0 (ifh:0x4000200)

debug mpls ldp memory

To debug LDP allocation, lock, and freeing of various memory, use the debug mpls ldp memory command in debug mpls ldp configuration mode. To disable this feature, use the no form of this command.

debug mpls ldp memory

no debug mpls ldp memory

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp memory command: 

RP/0/RP0/CPU0:router# debug mpls ldp memory


RP/0/RP0/CPU0:router# RP/0/RP0/CPU0:Aug 5 07:37:42.887: mpls_ldp[315]: DBG-Mem: mem_lock: 
TCB=0x48616e58, refcount=2, calling_fn=tdp_rx_notify

RP/0/RP0/CPU0:Aug 5 07:37:42.887: mpls_ldp[315]: DBG-Mem: mem_lock: LINK_ADJ=0x485890f0, 
refcount=3, calling_fn=tdp_process_packet

RP/0/RP0/CPU0:Aug 5 07:37:42.888: mpls_ldp[315]: DBG-Mem: mem_lock: PTCL_ADJ=0x4860f4a0, 
refcount=2, calling_fn=ldp_handle_rcvd_msg

RP/0/RP0/CPU0:Aug 5 07:37:42.888: mpls_ldp[315]: DBG-Mem: mem_free: PTCL_ADJ=0x4860f4a0, 
refcount=1, calling_fn=ldp_handle_rcvd_msg

RP/0/RP0/CPU0:Aug 5 07:37:42.889: mpls_ldp[315]: DBG-Mem: mem_free: LINK_ADJ=0x485890f0, 
refcount=2, calling_fn=tdp_process_packet

RP/0/RP0/CPU0:Aug 5 07:37:42.889: mpls_ldp[315]: DBG-Mem: mem_free: TCB=0x48616e58, 
refcount=1, calling_fn=tdp_process_packet

debug mpls ldp messages

To debug the transmission and receipt of the LDP control message, use the debug mpls ldp messages command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp messages {received | sent} [all] [peer-acl acl]

no debug mpls ldp messages {received | sent} [all] [peer-acl acl]

Syntax Description

received

Displays LDP messages received by LDP peers permitted by the ACL.

sent

Displays LDP messages sent to LDP peers permitted by the access control list (ACL).

all

(Optional) Displays all LDP messages sent to and received from LDP peers (including periodic keepalive messages) permitted by the ACL.

peer-acl

(Optional) Limits the displayed binding information to that learned from LDP peers permitted by the ACL.

acl

ACL expressed as an alpha or numeric string.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

LDP requires periodic transmission of keepalive messages. If you do not specify the all option, periodic keepalive messages are not displayed.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp messages command using the sent and peer-acl keywords: 

RP/0/RP0/CPU0:router# debug mpls ldp messages sent peer-acl peer_2


RP/0/RP0/CPU0:router# RP/0/RP0/CPU0:Aug 5 07:41:18.949: mpls_ldp[315]: DBG-MsgTx: INIT msg 
(size 38) sent towards 2.2.2.2:0

RP/0/RP0/CPU0:Aug 5 07:41:18.950: mpls_ldp[315]: DBG-MsgTx: KEEPALIVE msg (size 4) sent 
towards 2.2.2.2:0

RP/0/RP0/CPU0:Aug 5 07:41:18.960: mpls_ldp[315]: %ROUTING-LDP-5-NBR_CHANGE: Nbr 3.3.3.3:0, 
UP 

RP/0/RP0/CPU0:Aug 5 07:41:18.961: mpls_ldp[315]: %ROUTING-LDP-5-NBR_CHANGE: Nbr 2.2.2.2:0, 
UP 

RP/0/RP0/CPU0:Aug 5 07:41:18.962: mpls_ldp[315]: DBG-MsgTx: ADDRESS msg (size 42) sent 
towards 2.2.2.2:0

RP/0/RP0/CPU0:Aug 5 07:41:25.785: mpls_ldp[315]: DBG-MsgTx: LABEL_MAPPING msg (size 24) 
sent towards 2.2.2.2:0

RP/0/RP0/CPU0:Aug 5 07:41:25.786: mpls_ldp[315]: DBG-MsgTx: LABEL_MAPPING msg (size 24) 
sent towards 2.2.2.2:0

debug mpls ldp peer

To debug the LDP peer state machine, use the debug mpls ldp peer command in EXEC mode. To disable this feature, use the no form of this command.

debug mpls ldp peer state-machine [peer-acl acl]

no debug mpls ldp peer state-machine [peer-acl acl]

Syntax Description

state-machine

LDP peer session state machine.

peer-acl acl

(Optional) Limits the displayed binding information to that learned from LDP peers permitted by the access control list (expressed as an alpha or numeric string).


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.2

This command was introduced on the Cisco CRS-1 and
Cisco XR 12000 Series Router.

Release 3.3.0

No modification.

Release 3.4.0

No modification.

Release 3.5.0

No modification.

Release 3.6.0

No modification.


Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Debugging output is assigned high priority in the CPU process and, therefore, can affect system performance.For more information about the impact on system performance when using debug commands, refer to Using Debug Commands on Cisco IOS XR Software.

LDP manages peer sessions by means of two coupled peers:

•A low-level peer that deals with session establishment and shutdown

•A high-level peer that deals with setting up and shutting down label advertisement

Use the debug mpls ldp session command to monitor the lower-level peer.

Task ID

Task ID
Operations

mpls-ldp

read


Examples

The following example shows debug output for the debug mpls ldp peer command using the state-machine and peer-acl keywords: 

RP/0/RP0/CPU0:router# debug mpls ldp peer state-machine peer-acl peer_2


RP/0/RP0/CPU0:router