The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This module describes the commands used to configure and use Multiprotocol Label Switching (MPLS) forwarding.
For detailed information about MPLS concepts, configuration tasks, and examples, see Cisco IOS XR MPLS Configuration Guide for the Cisco XR 12000 Series Router.
To configure the behavior controlling the propagation of the IP Time-To-Live (TTL) field to and from the MPLS header, use the mpls ip-ttl-propagate command in global configuration mode. To return to the default behavior, use the no form of this command.
mpls ip-ttl-propagate disable [ forwarded | local ]
no mpls ip-ttl-propagate
disable |
Disables the propagation of IP TTL to and from the MPLS header for both forwarded and local packets. |
forwarded |
(Optional) Disables the propagation of IP TTL to and from the MPLS headed for only the forwarded packets. This prevents the traceroute command from displaying the MPLS-enabled nodes beyond the device under the configuration. |
local |
(Optional) Disables the propagation of IP TTL to the MPLS header for only locally generated packets. This prevents the traceroute command from displaying the MPLS-enabled nodes beyond the device under the configuration. |
Enabled
Global configuration
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
Release 3.9.0 |
Both forwarded and local keywords were added as optional. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
By default, the IP TTL is propagated to the MPLS header when IP packets enter the MPLS domain. Within the MPLS domain, the MPLS TTL is decremented at each MPLS hop. When an MPLS encapsulated IP packet exits the MPLS domain, the MPLS TTL is propagated to the IP header. When propagation is disabled, the MPLS TTL is set to 255 during the label imposition phase and the IP TTL is not altered.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
mpls-ldp |
read, write |
The following example shows how to disable IP TTL propagation:
RP/0/0/CPU0:router(config)# mpls ip-ttl-propagate disable
The following example shows how to disable IP TTL propagation for forwarded MPLS packets:
RP/0/0/CPU0:router(config)# mpls ip-ttl-propagate disable forwarded
The following example shows how to disable IP TTL propagation for locally generated MPLS packets:
RP/0/0/CPU0:router(config)# mpls ip-ttl-propagate disable local
To configure the dynamic range of local labels available for use on packet interfaces, use the mpls label range command in global configuration mode. To return to the default behavior, use the no form of this command.
mpls label range table table-id minimum maximum
no mpls label range table table-id minimum maximum
table table-id |
Identifies a specific label table; the global label table has table-id = 0. If no table is specified, the global table is assumed. Currently, you can specify table 0 only. |
minimum |
Smallest allowed label in the label space. Default is 16000. |
maximum |
Largest allowed label in the label space. Default is 1048575. |
table-id: 0
minimum: 16000
maximum: 1048575
Global configuration
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
After configuring the mpls label range command, restart the router for the configuration to take effect.
The label range defined by the mpls label range command is used by all MPLS applications that allocate local labels (for dynamic label switching Label Distribution Protocol [LDP], MPLS traffic engineering, and so on).
Labels 0 through 15 are reserved by the Internet Engineering Task Force (IETF) (see the draft-ietf-mpls-label-encaps-07.txt for details) and cannot be included in the range using the mpls label range command.
Labels 16 through 15999 are reserved for Layer 2 VPN static pseudowires. You should not configure Layer 2 VPN static pseudowires which fall within the dynamic range. If more Layer 2 VPN static pseudowires are required, restrict the dynamic label range using this configuration.
Note | Restart the router after changing the mpls label range. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
mpls-ldp |
read, write |
The following example shows how to configure the size of the local label space using a minimum of 16200 and a maximum of 120000:
RP/0/0/CPU0:router# configure RP/0/0/CPU0:router(config)# mpls label range 16200 120000
Command |
Description |
---|---|
Displays the range of the MPLS local label space. |
To configure the MPLS label security for the interface, use the mpls label-security command in interface configuration mode.
mpls label-security multi-label-packet [drop] rpf
multi-label-packet |
Handles incoming packets with multiple labels on the stack. |
drop |
Drops packets with multiple labels on the stack. |
rpf |
Checks for RPF label on incoming packets. |
Interface configuration.
Release |
Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The optional keywords and arguments described allow display of an MPLS label security information.
Task ID |
Operations |
---|---|
mpls-te |
read |
mpls-ldp |
read |
mpls-static |
read |
This example shows how to configure MPLS label RPF check:
RP/0/0/CPU0:router# configure RP/0/0/CPU0:router(config)#interface tunnel-te 1 RP/0/0/CPU0:router(config-if)#mpls label-security rpf
Command | Description |
Display MPLS label RPF information. | |
Displays the contents of the MPLS label security information. | |
Display MPLS label interface security information. | |
Displays MPLS label security information summary. | |
Displays the interface label security information. | |
Displays the LSD label RPF information. | |
Display the LSD label RPF summary information. |
To configure the maximum packet size or maximum transmission unit (MTU) size on an MPLS interface, use the mpls mtu command in global configuration mode. To disable this feature, use the no form of this command.
mpls mtu bytes
no mpls mtu bytes
bytes |
MTU size, in bytes. The range is from 68 to 65535. |
The default MTU value is 1500.
Global configuration
Release |
Modification |
---|---|
Release 3.6.0 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Each interface has a default maximum packet size or MTU size. This number generally defaults to the largest size possible for that interface type. On serial interfaces, the MTU size varies, but cannot be set smaller than 68 bytes.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
mpls-ldp |
read, write |
mpls-static |
read, write |
The following example specifies an MTU of 70 bytes on an MPLS interface:
RP/0/0/CPU0:router# interface Loopback0 RP/0/0/CPU0:router(config-if)# mpls mtu 70
To display the interface label security information, use the show mpls ea interfacescommand in EXEC mode.
show mpls ea interface [ location node-id ]
locationnode-id |
Displays hardware resource counters on the designated node. |
EXEC
Release |
Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The optional keywords and arguments described allow display of the interface label security information.
Task ID |
Operations |
---|---|
mpls-te |
read |
mpls-ldp |
read |
mpls-static |
read |
The following sample output is from the show mpls forwarding label-security interface command and specific interface and location:
RP/0/0/CPU0:router# show mpls ea interfaces location 0/1/CPU0
Interface IFH MTU Flags Type
-------------- ---------- ----- ---------- ----------
FI0/1/CPU0 0x02000080 8000 0x01000000 0x0000001b
tt1 0x08000320 1500 0x01000000 0x00000024
Command | Description |
Display MPLS label RPF information. | |
Displays the contents of the MPLS label security information. |
To display the contents of the MPLS Label Forwarding Information Base (LFIB), use the show mpls forwardingcommand in EXEC mode.
show mpls forwarding [detail] [ hardware { ingress | egress } ] [ interface type interface-path-id ] [ location node-id ] [ labels low-value [high-value] ] [ prefix { network/mask | ipv4 unicast network/mask } ] [private] [summary] [ tunnels tunnel-id ] [ vrf vrf-name ]
detail |
(Optional) Displays information in long form (includes length of encapsulation, length of Media Access Control [MAC] string, maximum transmission unit [MTU], Packet switched, and label stack). |
||
hardware |
(Optional) Displays the hardware location entry. |
||
ingress |
(Optional) Reads information from the ingress PSE. |
||
egress |
(Optional) Reads information from the egress PSE. |
||
interface |
(Optional) Displays information for the specified interface. |
||
type |
Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
labels low-value [high-value] |
(Optional) Entries with a local labels range. Ranges for both low-value and high-value are 0 to 1048575. |
||
location node-id |
(Optional) Displays hardware resource counters on the designated node. |
||
prefix network/mask /length |
(Optional) Displays the destination address and mask/prefix length.
|
||
ipv4 unicast |
(Optional) Displays the IPv4 unicast address. |
||
private |
(Optional) Displays private information. |
||
summary |
(Optional) Displays summarized information. |
||
tunnels tunnel-id |
(Optional) Displays entries either for a specified label switch path (LSP) tunnel or all LSP tunnel entries. |
||
vrf vrf-name |
(Optional) Displays entries for VPN routing and forwarding (VRF). |
EXEC
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
Release 3.9.0 |
The hardware, egress, and ingress keywords were added. The ipv4 and unicast keywords were added. |
The optional keywords and arguments described allow specification of a subset of the entire MPLS forwarding table.
The node-id argument is entered in the rack/slot/module notation.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
mpls-ldp |
read, write |
mpls-static |
read, write |
The following sample output is from the show mpls forwarding command using the location keyword and a specific node ID:
RP/0/0/CPU0:router# show mpls forwarding location 0/2/CPU0
Local Outgoing Outgoing Next Hop Bytes
Label Label Interface Switched
------ ----------- ------------ --------------- ---------------------------
16000 Unlabelled ce01::ce01/128[V] Gi0/1/0/0 ce01:10::2 0
16001 Aggregate router: Per-VRF Aggr[V] \
router 0
16021 16020 P2MP TE:10 Gi0/2/0/3 172.99.1.2 13912344
16040 P2MP TE:10 Gi0/2/0/3 172.99.2.2 13912344
16045 P2MP TE:10 PO0/1/0/4 172.16.1.2 13912344
The following sample output shows detailed information for the LSP tunnels:
RP/0/0/CPU0:router# show mpls forwarding prefix 10.241.4.0/24 detail
Local Outgoing Prefix Outgoing Next Hop Bytes
Label Label or ID Interface Switched
------ ----------- ------------------ ------------ --------------- ------------
16057 16058 10.241.4.0/24 Gi0/1/0/23 10.114.4.11 0
Updated May 10 20:00:15.983
MAC/Encaps: 14/18, MTU: 9202
Label Stack (Top -> Bottom): { 16058 }
Packets Switched: 0
16058 10.241.4.0/24 Te0/4/0/0 10.114.8.11 0
Updated May 10 20:00:15.983
MAC/Encaps: 14/18, MTU: 9086
Label Stack (Top -> Bottom): { 16058 }
Packets Switched: 0
The following sample output shows the number of P2MP TE heads and midpoints and the number of P2MP route updates that are received from the MRIB from the summary keyword:
RP/0/0/CPU0:router# show mpls forwarding summary
Forwarding entries:
Label switching: 91647
MPLS TE tunnel head: 1351, protected: 1
MPLS TE midpoint: 0, protected: 0
MPLS TE internal: 1351, protected: 1
MPLS P2MP TE tunnel head: 499
MPLS P2MP TE tunnel midpoint/tail: 999 Forwarding updates:
messages: 3925
p2p updates: 229115
p2mp updates: 13519
add/modify:12020, deletes:1499,
dropped:0 (iir trigger drops:0)) Labels in use:
Reserved: 3
Lowest: 0
Highest: 112979
Deleted stale label entries: 0
Field |
Description |
---|---|
Local Label |
Label assigned by this router. |
Outgoing Label |
|
Prefix or Tunnel ID |
Address or tunnel to which packets with this label are going. |
Outgoing Interface |
Interface through which packets with this label are sent. |
Next Hop |
IP address of neighbor that assigned the outgoing label. |
Bytes Switched |
Number of bytes switched with this incoming label. |
TO |
Timeout: Indicated by an “*” if entry is being timed out in forwarding. |
Mac/Encaps |
Length in bytes of Layer 2 header, and length in bytes of packet encapsulation, including Layer 2 header and label header. |
MTU |
MTU1 of labeled packet. |
Label Stack |
All the outgoing labels on the forwarded packet. |
Packets Switched |
Number of packets switched with this incoming label. |
Label switching |
Number of Label switching LFIB2 forwarding entries. |
IPv4 label imposition |
Number of IPv4 label imposition forwarding entries (installed at ingress LSR). |
MPLS TE tunnel head |
Number of forwarding entries (installed at ingress LSR) on MPLS TE tunnel head. |
MPLS TE fast-reroute |
Number of forwarding entries (installed at PLR) for MPLS-TE fast reroute. |
Forwarding updates |
Number of forwarding updates sent from LSD (RP/DRP) to LFIB/MPLS (RP/DRP/LC) using BCDL mechanism, indicating the total number of updates and total number of BCDL messages. |
Labels in use |
Local labels in use (installed in LFIB). These usually indicate the lowest and highest label in use (allocated by applications). Furthermore, some reserved labels, such as explicit-nullv4, explicit-nullv6, are installed in the forwarding plane. The label range is 0 to 15. |
Command |
Description |
---|---|
Displays the exact path for the source and destination address pair. |
To display the contents of the MPLS forwarding tunnel, use the show mpls forwarding tunnel command in EXEC mode.
show mpls forwarding tunnels [detail] [ tunnels tunnel-id ] [ vrf vrf-name ]
detail |
(Optional) Displays information in long form (includes length of encapsulation, length of Media Access Control [MAC] string, maximum transmission unit [MTU], Packet switched, and label stack). |
tunnels tunnel-id |
(Optional) Displays entries either for a specified label switch path (LSP) tunnel or all LSP tunnel entries. |
vrf vrf-name |
(Optional) Displays entries for VPN routing and forwarding (VRF). |
EXEC
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
Release 3.9.0 |
The hardware, egress, and ingress keywords were added. The ipv4 and unicast keywords were added. |
Release 5.3.2 |
This command was introduced. |
The optional keywords and arguments described allow specification of a subset of the entire MPLS forwarding table.
The node-id argument is entered in the rack/slot/module notation.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
mpls-ldp |
read, write |
mpls-static |
read, write |
The following sample output is from the show mpls forwarding tunnels command using the location keyword and a specific node ID:
show mpls forwarding tunnels RP/0/RSP0/CPU0:PE1#sh mpls forwarding tunnels 1999 detail Thu Jul 23 22:56:09.726 PDT Tunnel Outgoing Outgoing Next Hop Bytes Name Label Interface Switched ------------- ----------- ------------ --------------- ------------ tt1999 50045 BE10 point2point 0 Updated: Jul 23 20:04:57.416 Version: 82681, Priority: 2 Label Stack (Top -> Bottom): { 50045 } Local Label: 27972 NHID: 0x0, Path idx: 0, Backup path idx: 0, Weight: 0 MAC/Encaps: 14/18, MTU: 1500 Packets Switched: 0 Interface Handle: 0x0801f4a0, Local Label: 27972 Forwarding Class: 0, Weight: 0 Packets/Bytes Switched: 7045837/7116295370 RP/0/RSP0/CPU0:PE1#sh mpls forwarding tunnels 1999 detail location 0/0/CPU0 Thu Jul 23 22:56:14.526 PDT Tunnel Outgoing Outgoing Next Hop Bytes Name Label Interface Switched ------------- ----------- ------------ --------------- ------------ tt1999 50045 BE10 point2point 0 Updated: Jul 23 20:04:57.640 Version: 82681, Priority: 2 Label Stack (Top -> Bottom): { 50045 } Local Label: 27972 NHID: 0x0, Path idx: 0, Backup path idx: 0, Weight: 0 MAC/Encaps: 14/18, MTU: 1500 Packets Switched: 0 Interface Handle: 0x0801f4a0, Local Label: 27972 Forwarding Class: 0, Weight: 0 Packets/Bytes Switched: 7045837/7116295370 RP/0/RSP0/CPU0:PE1#sh mpls forwarding tunnels 1999 Thu Jul 23 22:56:19.717 PDT Tunnel Outgoing Outgoing Next Hop Bytes Name Label Interface Switched ------------- ----------- ------------ --------------- ------------ tt1999 50045 BE10 point2point 0
Command |
Description |
---|---|
Displays the exact path for the source and destination address pair. |
To display the exact path for the source and destination address pair, use the show mpls forwarding exact-route command in EXEC mode.
show mpls forwarding exact-route label label-number { bottom-label value | ipv4 source-address destination-address | ipv6source-addressdestination-address } [detail] [ protocol protocol source-port source-port destination-port destination-port ingress-interface type interface-path-id ] [ location node-id ] [ policy-class value ] [ hardware { ingress | egress } ]
label label-number |
Displays the exact path for a source and destination address pair. |
||
bottom-label value |
Displays the bottom label value. Range is 0 to 1048575. |
||
ipv4 source-address destination-address |
Displays the exact path for IPv4 payload. The IPv4 source address in x.x.x.x format. The IPv4 destination address in x.x.x.x format. |
||
ipv6 source-address destination-address |
Displays the exact path for IPv6 payload. The IPv6 source address in x:x::x format. The IPv6 destination address in x:x::x format. |
||
detail |
(Optional) Displays detailed information. |
||
protocol protocol |
(Optional) Displays the specified protocol for the route. |
||
source-port source-port |
Sets the UDP source port. The range is from 0 to 65535. |
||
destination-port destination-port |
Sets the UDP destination port. The range is from 0 to 65535. |
||
ingress-interface |
Sets the ingress interface. |
||
type |
Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
location node-id |
(Optional) Displays hardware resource counters on the designated node. |
||
policy-class value |
(Optional) Displays the policy-based tunnel selection (PBTS) to direct traffic into specific TE tunnels. The policy-class attribute maps the correct traffic class to this policy. The range for the policy-class value is from 1 to 7. |
||
hardware |
(Optional) Displays the hardware location entry. |
||
ingress |
(Optional) Reads information from the ingress PSE. |
||
egress |
(Optional) Reads information from the egress PSE. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.6.0 |
Added command parameters for 7-tuple. |
Release 3.9.0 |
The following keywords and arguments were added: |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The show mpls forwarding exact-route command displays information in long form and includes the following information:
Task ID |
Operations |
---|---|
mpls-te |
read, write |
mpls-ldp |
read, write |
mpls-static |
read, write |
The following shows a sample output from the show mpls forwarding exact-route command:
RP/0/0/CPU0:router# show mpls forwarding exact-route label 16000 ipv4 10.74.1.6 127.0.0.15 protocol tcp source-port 3503 destination-port 3503 ingress-interface pos 0/3/4/3
Local Outgoing Prefix Outgoing Next Hop Bytes
Label Label or ID Interface Switched
------ ----------- ------------------ ------------ --------------- ------------
16000 16001 5.5.5.5/32 PO0/1/5/1 1.24.1.192 N/A
Via: PO0/1/5/1, Next Hop: point2point
MAC/Encaps: 4/8, MTU: 1500
Label Stack (Top -> Bottom): { 16001 }
Field |
Description |
---|---|
Local Label |
Label assigned by this router. |
Outgoing Label |
|
Prefix or Tunnel ID |
Address or tunnel to which packets with this label are going. |
Outgoing Interface |
Interface through which packets with this label are sent. |
Next Hop |
IP address of neighbor that assigned the outgoing label. |
Bytes Switched |
Number of bytes switched with this incoming label. |
TO |
Timeout: Indicated by an “*” if entry is being timed out in forwarding. |
MAC/Encaps |
Length in bytes of Layer 2 header, and length in bytes of packet encapsulation, including Layer 2 header and label header. |
MTU |
MTU3 of labeled packet. |
Label Stack |
All the outgoing labels on the forwarded packet. |
Packets Switched |
Number of packets switched with this incoming label. |
Label switching |
Number of Label switching LFIB4 forwarding entries. |
IPv4 label imposition |
Number of IPv4 label imposition forwarding entries (installed at ingress LSR). |
MPLS TE tunnel head |
Number of forwarding entries (installed at ingress LSR) on MPLS TE tunnel head. |
MPLS TE fast-reroute |
Number of forwarding entries (installed at PLR) for MPLS-TE fast reroute. |
Forwarding updates |
Number of forwarding updates sent from LSD (RP/DRP) to LFIB/MPLS (RP/DRP/LC) using BCDL mechanism, indicating the total number of updates and total number of BCDL messages. |
Labels in use |
Local labels in use (installed in LFIB). These usually indicate the lowest and highest label in use (allocated by applications). Furthermore, some reserved labels, such as explicit-nullv4, explicit-nullv6, are installed in the forwarding plane. The label range is 0 to 15. |
Command |
Description |
---|---|
Displays the contents of the MPLS LFIB. |
To display the contents of the MPLS label interface security information, use the show mpls forwarding label-security interfacecommand in EXEC mode.
show mpls forwarding label-security [ interface type interface-path-id ] [ location node-id ]
interface |
(Optional) Displays information for the specified interface. |
||
type |
Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
locationnode-id |
(Optional) Displays hardware resource counters on the designated node. |
EXEC
Release |
Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The optional keywords and arguments described allow display of an MPLS label security information.
Task ID |
Operations |
---|---|
mpls-te |
read |
mpls-ldp |
read |
mpls-static |
read |
The following sample output is from the show mpls forwarding label-security interface command and specific interface and location:
RP/0/0/CPU0:router# show mpls forwarding label-security interface GigabitEthernet location 0/1/CPU0
Command | Description |
Displays the contents of the MPLS label security information. | |
Display MPLS label RPF information. | |
Displays MPLS label security information summary. |
To display the contents of the MPLS label security information summary, use the show mpls forwarding label-security summary locationcommand in EXEC mode.
show mpls forwarding label-security summary location node-id
locationnode-id |
Displays label security information on the designated node. |
EXEC
Release |
Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The optional keywords and arguments described allow display of an MPLS label security information.
Task ID |
Operations |
---|---|
mpls-te |
read |
mpls-ldp |
read |
mpls-static |
read |
The following sample output is from the show mpls forwarding label-security summary location command and a specific location:
RP/0/0/CPU0:router# show mpls forwarding label-security summary location 0/1/CPU0
Command | Description |
Displays the contents of the MPLS label security information. | |
Display MPLS label RPF information. | |
Display MPLS label interface security information. |
To display the contents of the MPLS label RPF information, use the show mpls forwarding labelscommand in EXEC mode.
show mpls forwarding [ labels low-value high-value ] [detail] [rpf]
labelslow-value high-value |
(Optional) Entries with a local labels range. Ranges for both low-value and high-value are 0 to 1048575. |
detail |
|
rpf |
(Optional) Displays label RPF information. |
EXEC
Release |
Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The optional keywords and arguments described allow display of MPLS label security and RPF information.
Task ID |
Operations |
---|---|
mpls-te |
read |
mpls-ldp |
read |
mpls-static |
read |
The following sample output is from the show mpls forwarding labels command using the rpf:
RP/0/0/CPU0:router# show mpls forwarding labels rpf
Forwarding entries:
Label switching: 0, protected: 0
MPLS TE tunnel head: 0, protected: 0
MPLS TE midpoint: 0, protected: 0
MPLS TE internal: 0, protected: 0
MPLS P2MP TE tunnel head: 0
MPLS P2MP TE tunnel midpoint/tail: 0
MPLS P2MP MLDP tunnel head: 0
MPLS P2MP MLDP tunnel midpoint/tail: 0
Forwarding updates:
messages: 2
p2p updates: 4
Labels in use:
Reserved: 4
Lowest: 0
Highest: 13
Deleted stale label entries: 0
Pkts dropped: 0
Pkts fragmented: 0
Failed lookups: 0
Command | Description |
Displays the contents of the MPLS label security information. | |
Display MPLS label interface security information. | |
Displays MPLS label security information summary. |
To display the contents of the MPLS label security information, use the show mpls forwarding summarycommand in EXEC mode.
show mpls forwarding summary [debug] [ location node-id ] no-counters private rpf
debug |
(Optional) Displays the information for internal debugging in the command output. |
locationnode-id |
(Optional) Displays hardware resource counters on the designated node. |
no-counters |
(Optional) Skips displaying counters. |
private |
(Optional) Displays private information. |
rpf |
(Optional) Displays label RPF information. |
EXEC
Release |
Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The optional keywords and arguments described allow display of an MPLS label security information.
Task ID |
Operations |
---|---|
mpls-te |
read |
mpls-ldp |
read |
mpls-static |
read |
The following sample output is from the show mpls forwarding summary command using the debug keyword:
RP/0/0/CPU0:router# show mpls forwarding summary debug
Forwarding entries:
Label switching: 0, protected: 0
MPLS TE tunnel head: 0, protected: 0
MPLS TE midpoint: 0, protected: 0
MPLS TE internal: 0, protected: 0
MPLS P2MP TE tunnel head: 0
MPLS P2MP TE tunnel midpoint/tail: 0
MPLS P2MP MLDP tunnel head: 0
MPLS P2MP MLDP tunnel midpoint/tail: 0
Forwarding updates:
messages: 2
p2p updates: 4
Labels in use:
Reserved: 4
Lowest: 0
Highest: 13
Deleted stale label entries: 0
Pkts dropped: 0
Pkts fragmented: 0
Failed lookups: 0
The following sample output is from the show mpls forwarding summary command using the location keyword and a specific location:
RP/0/0/CPU0:router# show mpls forwarding summary location 0/1/CPU0
Forwarding entries:
Label switching: 0, protected: 0
MPLS TE tunnel head: 0, protected: 0
MPLS TE midpoint: 0, protected: 0
MPLS TE internal: 0, protected: 0
MPLS P2MP TE tunnel head: 0
MPLS P2MP TE tunnel midpoint/tail: 0
MPLS P2MP MLDP tunnel head: 0
MPLS P2MP MLDP tunnel midpoint/tail: 0
Forwarding updates:
messages: 2
p2p updates: 4
Labels in use:
Reserved: 4
Lowest: 0
Highest: 13
Deleted stale label entries: 0
Pkts dropped: 0
Pkts fragmented: 0
Failed lookups: 0
The following sample output is from the show mpls forwarding summary command using the no-counters:
RP/0/0/CPU0:router# show mpls forwarding summary no-counters
Forwarding entries:
Label switching: 0, protected: 0
MPLS TE tunnel head: 0, protected: 0
MPLS TE midpoint: 0, protected: 0
MPLS TE internal: 0, protected: 0
MPLS P2MP TE tunnel head: 0
MPLS P2MP TE tunnel midpoint/tail: 0
MPLS P2MP MLDP tunnel head: 0
MPLS P2MP MLDP tunnel midpoint/tail: 0
Forwarding updates:
messages: 2
p2p updates: 4
Labels in use:
Reserved: 4
Lowest: 0
Highest: 13
Deleted stale label entries: 0
The following sample output is from the show mpls forwarding summary command using the private:
RP/0/0/CPU0:router# show mpls forwarding summary private
Forwarding entries:
Label switching: 0, protected: 0
MPLS TE tunnel head: 0, protected: 0
MPLS TE midpoint: 0, protected: 0
MPLS TE internal: 0, protected: 0
MPLS P2MP TE tunnel head: 0
MPLS P2MP TE tunnel midpoint/tail: 0
MPLS P2MP MLDP tunnel head: 0
MPLS P2MP MLDP tunnel midpoint/tail: 0
Forwarding updates:
messages: 2
p2p updates: 4
Labels in use:
Reserved: 4
Lowest: 0
Highest: 13
Deleted stale label entries: 0
Path count:
Unicast: 0
Pkts dropped: 0
Pkts fragmented: 0
Failed lookups: 0
fwd-flags: 0x5, ttl-expire-pop-cnt: 0
The following sample output is from the show mpls forwarding summary command using the rpf:
RP/0/0/CPU0:router# show mpls forwarding summary rpf
Forwarding entries:
Label switching: 0, protected: 0
MPLS TE tunnel head: 0, protected: 0
MPLS TE midpoint: 0, protected: 0
MPLS TE internal: 0, protected: 0
MPLS P2MP TE tunnel head: 0
MPLS P2MP TE tunnel midpoint/tail: 0
MPLS P2MP MLDP tunnel head: 0
MPLS P2MP MLDP tunnel midpoint/tail: 0
Forwarding updates:
messages: 2
p2p updates: 4
Labels in use:
Reserved: 4
Lowest: 0
Highest: 13
Deleted stale label entries: 0
Pkts dropped: 0
Pkts fragmented: 0
Failed lookups: 0
Field |
Description |
---|---|
Label switching |
Number of Label switching Label Forwarding Information Base (LFIB) forwarding entries. |
MPLS TE tunnel head |
Number of forwarding entries (installed at ingress LSR) on MPLS TE tunnel head. |
Forwarding updates |
Number of forwarding updates sent from LSD (RP/DRP) to LFIB/MPLS (RP/DRP/LC) using BCDL mechanism, indicating the total number of updates and total number of BCDL messages. |
Labels in use |
Local labels in use (installed in LFIB). These usually indicate the lowest and highest label in use (allocated by applications). Furthermore, some reserved labels, such as explicit-nullv4, explicit-nullv6, are installed in the forwarding plane. The label range is 0 to 15. |
Command | Description |
Display MPLS label RPF information. | |
Display MPLS label interface security information. | |
Displays MPLS label security information summary. | |
Displays the interface label security information. | |
Displays the LSD label RPF information. | |
Display the LSD label RPF summary information. |
To display information about one or more interfaces that have been configured for MPLS, use the show mpls interfaces command in EXEC mode.
show mpls interfaces [ type interface-path-id ] [ location node-id ] [detail]
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
location node-id |
(Optional) Displays hardware resource counters on the designated node. |
||
detail |
(Optional) Displays detailed information for the designated node. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
This command displays MPLS information about a specific interface or about all interfaces where MPLS is configured.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
mpls-ldp |
read, write |
mpls-static |
read, write |
The following shows a sample output from the show mpls interfaces command:
RP/0/0/CPU0:router# show mpls interfaces
Interface LDP Tunnel Enabled
-------------------------- -------- -------- --------
POS0/4/0/0 Yes Yes Yes
POS0/4/0/1 Yes Yes Yes
POS0/4/0/2 Yes Yes Yes
The following shows a sample output from the show mpls interfaces command using the detail keyword:
RP/0/0/CPU0:router# show mpls interfaces detail
Interface POS0/4/0/0:
LDP labelling enabled
LSP labelling enabled (TE-Control)
MPLS enabled
MTU = 4474
Interface POS0/4/0/1:
LDP labelling enabled
LSP labelling enabled (TE-Control)
MPLS enabled
MTU = 4474
Interface POS0/4/0/2:
LDP labelling enabled
LSP labelling enabled (TE-Control)
MPLS enabled
MTU = 4474
The following shows a sample output from the show mpls interfaces command using the location keyword:
RP/0/0/CPU0:router# show mpls interfaces location pos 0/4/0/0 Interface LDP Tunnel Enabled -------------------------- -------- -------- -------- POS0/4/0/0 Yes Yes Yes RP/0/0/CPU0:router# show mpls interfaces pos 0/4/0/0 detail Interface POS0/4/0/0: LDP labelling enabled LSP labelling enabled (TE-Control) MPLS enabled MTU = 4474
Field |
Description |
---|---|
LDP |
State of LDP labelling. |
Tunnel |
State of LSP Tunnel labelling. |
MTU |
MTU5 of labeled packet. |
Caps |
Capsulation switching chains installed on an interface. |
M |
MPLS switching capsulation/switching chains are installed on the interface and are ready to switch MPLS traffic. |
To display the range of local labels available for use on packet interfaces, use theshow mpls label range command in EXEC mode.
show mpls label range
This command has no arguments or keywords.
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
You can use the show mpls label range command to configure a range for local labels that is different from the default range.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
mpls-ldp |
read, write |
mpls-static |
read, write |
The following shows a sample output from the show mpls label range command:
RP/0/0/CPU0:router# show mpls label range
Range for dynamic labels: Min/Max: 16000/144000
Field |
Description |
---|---|
Range for dynamic labels |
Minimum and maximum allowable range for local labels (which differs from the default range). |
Command |
Description |
---|---|
Configures a range of values for use as local labels. |
To display the local labels contained in the MPLS label table, use the show mpls label table command in EXEC mode.
show mpls label table table-index [ application application ] [ label label-value ] [summary] [detail]
table-index |
Index of the label table to display. The global label table is 0. Currently, you can specify table 0 only. |
application application |
(Optional) Displays all labels owned by the selected application. Options are: bgp-ipv4, bgp-spkr, bgp-vpn-ipv4, internal, ldp, none, l2vpn, static, te-control, te-link, and test. |
label label-value |
(Optional) Displays a selected label based on the label value. Range is 0 to 1048575. |
summary |
(Optional) Displays a summary of local labels. |
detail |
(Optional) Displays detailed information for the MPLS label table. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
Release 3.9.0 |
The detail keyword was added. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Note | Labels 16 to 15999 are reserved for static Layer 2 VPN pseudowires. |
Task ID |
Operations |
---|---|
mpls-te |
read, write |
mpls-ldp |
read, write |
mpls-static |
read, write |
The following shows a sample output from the show mpls label table command:
RP/0/0/CPU0:router# show mpls label table 0
Table Label Owner State Rewrite
----- ------- ---------- ------ -------
0 0 LSD InUse Yes
0 1 LSD InUse Yes
0 2 LSD InUse Yes
0 3 LSD InUse Yes
0 16 TE-Link InUse Yes
Field |
Description |
---|---|
Table |
Table ID. |
Label |
Label index. |
Owner |
Application that allocated the label. All labels displaying “InUse” state have an owner. |
State |
|
Rewrite |
Number of initiated rewrites. |
Command |
Description |
---|---|
Displays entries in the MPLS forwarding table. Label switching entries are indexed by their local label. |
|
Displays MPLS applications that are registered with the MPLS LSD server. |
To display the MPLS applications registered with the MPLS Label Switching Database (LSD) server, use the show mpls lsd applications command in EXEC mode.
show mpls lsd applications [ application application ]
application application |
(Optional) Displays all labels owned by the selected application. Options are: bgp-ipv4, bgp-spkr, bgp-vpn-ipv4, internal, ldp, none, l2vpn, static, te-control, te-link, and test. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
Release 3.9.0 |
The application keyword was added. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
MPLS applications include Traffic Engineering (TE) control, TE Link Management, and label distribution protocol (LDP). The application must be registered with MPLS LSD for its features to operate correctly. All applications are clients (see the show mpls lsd clients command), but not all clients are applications.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
mpls-ldp |
read, write |
mpls-static |
read, write |
The following shows a sample output from the show mpls lsd applications command:
RP/0/0/CPU0:router# show mpls lsd applications
Type State RecoveryTime Node
------------ -------- ------------ ------------
LDP Active 300 0/0/CPU0
TE-Control Active 100 0/0/CPU0
TE-Link Active 600 0/0/CPU0
Field |
Description |
---|---|
Type |
LSD application type. |
State |
|
RecoveryTime |
Seconds remaining before MPLS LSD gives up or resumes the application. |
Node |
Node expressed in standard rack/slot/module notation. |
Command |
Description |
---|---|
Displays MPLS clients connected to the MPLS LSD server. |
To display the MPLS clients connected to the MPLS Label Switching Database (LSD) server, use the show mpls lsd clients command in EXEC mode.
show mpls lsd clients
This command has no arguments or keywords.
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
MPLS clients include Traffic Engineering (TE) Control, TE Link Management, Label Distribution Protocol (LDP), and Bulk Content Downloader (BCDL) Agent. Not all clients are applications (see the show mpls lsd applications command), but all applications are clients.
Task ID |
Operations |
---|---|
mpls-te |
read, write |
mpls-ldp |
read, write |
mpls-static |
read, write |
The following shows a sample output from the show mpls lsd clients command:
RP/0/0/CPU0:router# show mpls lsd clients
Id Services Node
-- -------------------- ------------
0 BA(p=none) 0/0/CPU0
1 A(TE-Link) 0/0/CPU0
2 A(LDP) 0/0/CPU0
3 A(TE-Control) 0/0/CPU0
The following table describes the significant fields shown in the display.
Field |
Description |
---|---|
Id |
Client identification number. |
Services |
A(xxx) means that this client is an application and xxx is the application name, BA(yyy) means that this client is a BCDL Agent and yyy is expert data. Depending on system conditions, there can be multiple BCDL Agent clients (this is normal). |
Node |
Node expressed in standard rack/slot/module notation. |
Command |
Description |
---|---|
show mpls lsd applications |
Displays MPLS applications registered with the MPLS LSD server. |
To display the LSD label RPF information, use the show mpls lsd forwarding labelscommand in EXEC mode.
show mpls lsd forwarding [ labels low-value high-value ] [ location node-id ]
labelslow-value high-value |
(Optional) Entries with a local labels range. Ranges for both low-value and high-value are 0 to 1048575. |
locationnode-id |
Displays hardware resource counters on the designated node. |
EXEC
Release |
Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The optional keywords and arguments described allow display of an MPLS label security information.
Task ID |
Operations |
---|---|
mpls-te |
read |
mpls-ldp |
read |
mpls-static |
read |
The following sample output is from the show mpls lsd forwarding labels command using a specific location:
RP/0/0/CPU0:router# show mpls lsd forwarding labels 1 13 detail location 0/1/CPU0
Command | Description |
Display MPLS label RPF information. | |
Display the LSD label RPF summary information. |
To display the LSD label RPF information, use the show mpls lsd forwarding summarycommand in EXEC mode.
show mpls lsd forwarding summary [ location node-id ]
locationnode-id |
Displays hardware resource counters on the designated node. |
EXEC
Release |
Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The optional keywords and arguments described allow display of the interface label security information.
Task ID |
Operations |
---|---|
mpls-te |
read |
mpls-ldp |
read |
mpls-static |
read |
The following sample output is from the show mpls lsd forwarding summary command and a specific location:
RP/0/0/CPU0:router# show mpls lsd forwarding summary location 0/1/CPU0
Interface IFH MTU Flags Type
-------------- ---------- ----- ---------- ----------
FI0/1/CPU0 0x02000080 8000 0x01000000 0x0000001b
tt1 0x08000320 1500 0x01000000 0x00000024
Command | Description |
Display MPLS label RPF information. | |
Displays the contents of the MPLS label security information. | |
Displays the LSD label RPF information. |
To display the contents of the fast reroute (FRR) database, use the show mpls traffic-eng fast-reroute database command in EXEC mode.
show mpls traffic-eng fast-reroute database [ip-address] [ ip-address /length ] [ afi-all { safi-all | unicast } { ip-address | ip-address/length } ] [backup-interface] [ tunnel tunnel -id ] [unresolved] [ interface type interface-path-id ] [ ipv4 { safi-all | unicast } { ip-address | ip-address/length } ] [ labels low-number high-number ] [ state { active | complete | partial | ready } ] [ role { head | midpoint } ] [summary] [ location node-id ]
ip-address |
(Optional) IP address of the destination network. |
||
ip-address/length |
(Optional) Bit combination indicating the portion of the IP address that is being used for the subnet address. |
||
afi-all |
(Optional) Returns data for all specified address family identifiers. |
||
safi-all |
(Optional) Returns data for all sub-address family identifiers. |
||
unicast |
(Optional) Returns unicast data only. |
||
backup-interface |
(Optional) Displays entries with the specified backup interface. |
||
tunnel tunnel-id |
(Optional) Tunnel and tunnel ID to which packets with this label are going. The summary suboption is available. |
||
unresolved |
(Optional) Displays entries whose backup interface has not yet been fully resolved. |
||
interface |
(Optional) Displays entries with this primary outgoing interface. The summary keyword is available. |
||
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or a virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
ipv4 |
(Optional) Displays only IPv4 data. |
||
labels |
(Optional) Displays database entries that possess in-labels assigned by this router (local labels). Specify either a starting value or a range of values. The state suboption is available. |
||
state |
|
||
role |
(Optional) Displays entries associated either with the tunnel head or tunnel midpoint. The summary suboption is available. |
||
summary |
(Optional) Displays summarized information about the FRR database. |
||
location node-id |
(Optional) Displays hardware resource counters on the designated node. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
For fast reroute (FRR) information in regards to multicast label forwarding, see Cisco IOS XR Software Multicast Command Reference for the Cisco XR 12000 Series Router.
If the location is specified, Fast-Reroute (FRR) entries for both Point-to-Point (P2P) and P2MP tunnels are available. If the location is not specified, only P2P tunnel entries are available.
Task ID |
Operations |
---|---|
mpls-te |
read |
The following shows a sample output from the show mpls traffic-eng fast-reroute database command:
RP/0/0/CPU0:router# show mpls traffic-eng fast-reroute database
Tunnel head FRR information:
Tunnel Out intf/label FRR intf/label Status
---------- ---------------- ---------------- -------
tt4000 PO0/3/0/0:34 tt1000:34 Ready
tt4001 PO0/3/0/0:35 tt1001:35 Ready
tt4002 PO0/3/0/0:36 tt1001:36 Ready
Note | The Prefix field indicates the IP address where packets with this label are headed. |
The following sample output displays filtering of the FRR database using the backup-interface keyword:
RP/0/0/CPU0:router# show mpls traffic-eng fast database backup-interface
LSP midpoint FRR information:
LSP Identifier Out Intf/ FRR Intf/ Status
Label Label
----------------------------- ---------------- ---------------- -------
10.10.10.10 1006 [54] Gi0/6/5/2:Pop tt1060:Pop Ready
The following sample output displays the FRR database filtered by the primary outgoing interface:
RP/0/0/CPU0:router# show mpls traffic-eng fast-reroute database interface pos0/3/0/0
Tunnel head FRR information:
Tunnel Out intf/label FRR intf/label Status
---------- ---------------- ---------------- -------
tt4000 PO0/3/0/0:34 tt1000:34 Ready
tt4001 PO0/3/0/0:35 tt1001:35 Ready
tt4002 PO0/3/0/0:36 tt1001:36 Ready
The following sample output displays a summary of the FRR database with the role as head:
RP/0/0/CPU0:router# show mpls traffic-eng fast-reroute database role head summary
Status Count
---------- ----------
Active 0
Ready 3
Partial 0
The following sample output displays summarized information for the FRR database with the role as midpoint:
RP/0/0/CPU0:routerr# show mpls traffic-eng fast-reroute database role midpoint summary
Status Count
------- -----
Active 0
Ready 2
Partial 0
Field |
Description |
---|---|
Tunnel |
Short form of tunnel interface name. |
Out intf/label |
|
FRR intf/label |
|
Status |
State of the rewrite: partial, ready, or active. |
Command |
Description |
---|---|
Displays the contents of the FRR event log. |
To display a history of fast reroute (FRR) events, use the show mpls traffic-eng fast-reroute log command in EXEC mode.
show mpls traffic-eng fast-reroute log [ interfacetypeinterface-path-id | location node-id ]
interface |
(Optional) Displays all FRR events for the selected protected interface. |
||
type |
(Optional) Interface type. For more information, use the question mark (?) online help function. |
||
interface-path-id |
Physical interface or virtual interface.
For more information about the syntax for the router, use the question mark (?) online help function. |
||
location node-id |
(Optional) Displays all FRR events that occurred on the selected node. |
No default behavior or values
EXEC
Release |
Modification |
---|---|
Release 3.2 |
This command was introduced. |
Release 3.9.0 |
Sample output was modified. |
To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID |
Operations |
---|---|
mpls-te |
read |
The following shows a sample output from the show mpls traffic-eng fast-reroute log command:
RP/0/0/CPU0:router# show mpls traffic-eng fast-reroute log
Node Protected LSPs Rewrites When Switching Time
Interface (usec)
-------- --------- ----- -------- ---------------------- --------------
0/0/CPU0 PO0/1/0/1 1 1 Feb 27 19:12:29.064000 147
Field |
Description |
---|---|
Node |
Node address. |
Protected Interface |
Type and interface-path-id that is being protected. |
LSPs |
LSP6 associated with each interface being protected. |
Rewrites |
Number of rewrites initiated on the LSP. |
When |
Date the interface was protected. |
Switching Time |
Time required to switch the protected interface in microseconds. |
Command |
Description |
---|---|
Displays the contents of the FRR database. |