Table Of Contents
show mpls atm-ldp bindings
show mpls atm-ldp bindwait
show mpls atm-ldp capability
show mpls atm-ldp summary
show mpls cos-map
show mpls forwarding-table
show mpls interfaces
show mpls ip binding
show mpls l2transport binding
show mpls l2transport hw-capability
show mpls l2transport summary
show mpls l2transport vc
show mpls label range
show mpls ldp backoff
show mpls ldp bindings
show mpls ldp discovery
show mpls ldp neighbor
show mpls ldp parameters
show mpls prefix-map
show mpls traffic-eng autoroute
show mpls traffic-eng link-management admission-control
show mpls traffic-eng link-management advertisements
show mpls traffic-eng link-management bandwidth-allocation
show mpls traffic-eng link-management igp-neighbors
show mpls traffic-eng link-management interfaces
show mpls traffic-eng link-management summary
show mpls atm-ldp bindings
To display the requested entries from the ATM label distribution protocol (LDP) label bindings database, use the show mpls atm-ldp bindings command in EXEC mode.
show mpls atm-ldp bindings [A.B.C.D {mask | length}]
[local-label vpi vci] [remote-label vpi vci] [neighbor atm slot/subslot/port] [vc-merged]
[path]
Syntax Description
A.B.C.D
|
(Optional) Destination of prefix.
|
mask
|
(Optional) Destination netmask prefix.
|
length
|
(Optional) Netmask length, in the range from 1 to 32.
|
local-label vpi vci
|
(Optional) Matches locally assigned label values. (VPI range is 0 to 4095. VCI range is 0 to 65535.)
|
remote-label vpi vci
|
(Optional) Matches remotely assigned label values. (VPI range is 0 to 4095. VCI range is 0 to 65535.)
|
neighbor atm slot/subslot/port
|
(Optional) Matches labels assigned by a neighbor on the specified ATM interface.
|
vc-merged
|
(Optional) Lists the merged VCs.
|
path
|
(Optional) Displays the path of an LVC, from source to destination.
|
Defaults
Displays all database entries.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
12.2(4)T
|
This command was updated to reflect the MPLS IETF terminology. The VPI range of values was extended to 4095.
|
12.2(8)T
|
This command was modified to include the vc-merged keyword.
|
12.3(2)T6
|
This command was modified to include the path keyword.
|
12.3(9)
|
This command was integrated into 12.3(9).
|
Usage Guidelines
The display output can show the entire database or a subset of entries based on the prefix, the VC label value, or an assigning interface.
Examples
The following is sample output from the show mpls atm-ldp bindings command:
Router# show mpls atm-ldp bindings
Destination: 10.13.13.6/32
Headend Router ATM1/0.1 (2 hops) 1/33 Active, VCD=8, CoS=available
Headend Router ATM1/0.1 (2 hops) 1/34 Active, VCD=9, CoS=standard
Headend Router ATM1/0.1 (2 hops) 1/35 Active, VCD=10, CoS=premium
Headend Router ATM1/0.1 (2 hops) 1/36 Active, VCD=11, CoS=control
Destination: 192.168.0.0/8
Headend Router ATM1/0.1 (1 hop) 1/37 Active, VCD=4, CoS=available
Headend Router ATM1/0.1 (1 hop) 1/34 Active, VCD=5, CoS=standard
Headend Router ATM1/0.1 (1 hop) 1/35 Active, VCD=6, CoS=premium
Headend Router ATM1/0.1 (1 hop) 1/36 Active, VCD=7, CoS=control
Destination: 10.0.0.18/32
Tailend Router ATM1/0.1 1/33 Active, VCD=8
The following is sample output from the show mpls atm-ldp bindings command with the path keyword:
Router# show mpls atm-ldp bindings 10.0.2.115 32 path
Destination: 10.0.2.115/32
Headend Router Switch1.1 (2 hops) 0/39 Active, VCD=9, CoS=available
Path: 10.0.2.102* 10.0.3.42 10.0.2.115
Headend Router Switch1.1 (2 hops) 0/41 Active, VCD=8, CoS=premium
Path: 10.0.2.102* 10.0.3.42 10.0.2.115
Headend Router Switch1.1 (2 hops) 0/43 Active, VCD=7, CoS=control
Path: 10.0.2.102* 10.0.3.42 10.0.2.115
Table 77 describes the significant fields shown in the display.
Table 77 show mpls atm-ldp bindings Field Descriptions
Field
|
Description
|
Destination:
|
Destination IP address/length of netmask.
|
Headend Router
|
VC type:
• Headend—VC that originates at this router
• Tailend—VC that terminates at this router
• Transit—VC that passes through this router
|
ATM1/0.1
|
ATM interface.
|
1/33
|
VPI/VCI
|
Active
|
LVC state:
• Active—Set up and working
• Bindwait—Waiting for response
|
VCD=
|
Virtual circuit descriptor number.
|
CoS=
|
Label virtual circuit type for class of service categories:
• Available—CoS = 0
• Standard—CoS = 1
• Premium—CoS = 2
• Control—CoS = 3
|
Path
|
The path of the LVC. The asterisk (*) next to the first prefix indicates that the command was issued from that router. This output displays when you issue the path keyword.
|
Related Commands
Command
|
Description
|
show mpls atm-ldp bindwait
|
Displays the number of bindings waiting for label assignments for a remote MPLS ATM switch.
|
show mpls atm-ldp bindwait
To display the number of bindings waiting for label assignments from a remote Multiprotocol Label Switching (MPLS) ATM switch, use the show mpls atm-ldp bindwait command in user EXEC or privileged EXEC mode.
show mpls atm-ldp bindwait
Syntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
12.2(4)T
|
This command was updated to reflect the Multiprotocol Label Switching (MPLS) Internet Engineering Task Force (IETF) terminology.
|
Examples
The following is a sample display using this command:
Router# show mpls atm-ldp bindwait
If everything is working properly, this command does not display any output.
Related Commands
Command
|
Description
|
show mpls atm-ldp bindings
|
Displays requested entries from the ATM LDP label binding database.
|
show mpls atm-ldp capability
To display the Multiprotocol Label Switching (MPLS) ATM capabilities negotiated with Label Distribution Protocol (LDP) neighbors for label-controlled ATM (LC-ATM) interfaces, use the show mpls atm-ldp capability command in privileged EXEC mode.
show mpls atm-ldp capability
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.1CT
|
This command was introduced.
|
12.0(10)ST
|
This command was modified to reflect Multiprotocol Label Switching (MPLS) Internet Engineering Task Force (IETF) command syntax and terminology.
|
12.1(8a)E
|
This command was integrated into Cisco IOS Release 12.1(8a)E.
|
12.2(2)T
|
This command was integrated into Cisco IOS Release 12.2(2)T.
|
Usage Guidelines
When two label switch routers (LSRs) establish an LDP session, they negotiate parameters for the session, such as the range of virtual path identifiers (VPIs) and virtual channel identifiers (VCIs) that will be used as labels.
This command displays the MPLS ATM capabilities negotiated by LDP or the Tag Distribution Protocol (TDP).
Examples
The following is sample output from the show mpls atm-ldp capability command:
Router# show mpls atm-ldp capability
VPI VCI Alloc Odd/Even VC Merge
ATM0/1/0 Range Range Scheme Scheme IN OUT
Negotiated [100 - 101] [33 - 1023] UNIDIR - -
Local [100 - 101] [33 - 16383] UNIDIR EN EN
Peer [100 - 101] [33 - 1023] UNIDIR - -
VPI VCI Alloc Odd/Even VC Merge
ATM0/1/1 Range Range Scheme Scheme IN OUT
Negotiated [201 - 202] [33 - 1023] BIDIR - -
Local [201 - 202] [33 - 16383] UNIDIR ODD NO NO
Peer [201 - 202] [33 - 1023] BIDIR EVEN - -
Table 78 describes the fields shown in the display.
Table 78 show mpls atm-ldp capability Field Descriptions
Field
|
Description
|
VPI Range
|
Minimum and maximum numbers of VPIs supported on this interface.
|
VCI Range
|
Minimum and maximum numbers of VCIs supported on this interface.
|
Alloc Scheme
|
Indicates the applicable allocation scheme, as follows:
• UNIDIR—Unidirectional capability indicates that the peer can, within a single VPI, support binding of the same VCI to different prefixes on different directions of the link.
• BIDIR—Bidirectional capability indicates that within a single VPI, a single VCI can appear in one binding only. In this case, one peer allocates bindings in the even VCI space, and the other in the odd VCI space. The system with the lower LDP identifier assigns even-numbered VCIs.
The negotiated allocation scheme is UNIDIR, only if, both peers have UNIDIR capability. Otherwise, the allocation scheme is BIDIR.
Note These definitions for unidirectional and bidirectional are consistent with normal ATM usage of the terms; however, they are exactly opposite from the definitions for them in the IETF LDP specification.
|
Odd/Even Scheme
|
Indicates whether the local device or the peer is assigning an odd- or even-numbered VCI when the negotiated scheme is BIDIR. It does not display any information when the negotiated scheme is UNIDIR.
|
VC Merge
|
Indicates the type of virtual circuit merge support available on this interface. There are two possibilities, as follows:
IN—Indicates the input interface merge capability. IN displays the following values:
• EN—The hardware interface supports virtual circuit merge, and virtual circuit merge is enabled on the device.
• DIS—The hardware interface supports virtual circuit merge and virtual circuit merge is disabled on the device.
• NO—The hardware interface does not support virtual circuit merge.
OUT—Indicates the output interface merge capability. OUT displays the same values as the input merge side.
The virtual circuit merge capability is meaningful only on ATM switches. This capability is not negotiated.
|
Negotiated
|
Indicates the set of options that both LDP peers have agreed to share on this interface. For example, the VPI or VCI allocation on either peer remains within the negotiated range.
|
Local
|
Indicates the options supported locally on this interface.
|
Peer
|
Indicates the options supported by the remote LDP peer on this interface.
|
Related Commands
Command
|
Description
|
mpls ldp atm vc-merge
|
Controls whether ATM-virtual circuit merge (multipoint-to-point) is supported for unicast label virtual circuits.
|
show mpls atm-ldp summary
To display summary information about all the entries in the ATM label binding database, use the show mpls atm-ldp summary command in privileged EXEC mode.
show mpls atm-ldp summary
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.1CT
|
This command was introduced.
|
12.0(10)ST
|
This command was modified to reflect MPLS IETF command syntax and terminology.
|
12.2(2)T
|
This command was integrated into Cisco IOS Release 12.2(2)T.
|
12.0(22)S
|
This command was integrated into Cisco IOS Release 12.0(22)S.
|
Usage Guidelines
Use this command to display dynamic ATM accounting information.
Examples
The following shows sample output from the show mpls atm-ldp summary command:
Router# show mpls atm-ldp summary
Total number of destinations: 406
ATM label bindings summary
interface total active local remote Bwait Rwait IFwait
ATM0/0/0 406 406 404 2 0 0 0
ATM0/0/1 406 406 3 403 0 0 0
Table 79 describes the significant fields shown in the display.
Table 79 show mpls atm-ldp summary Field Descriptions
Field
|
Description
|
Total number of destinations
|
Number of destination address prefixes in the LC-ATM database.
|
interface
|
Name of an interface with associated ATM label bindings.
|
total
|
Total number of ATM labels on this interface.
|
active
|
Number of ATM labels in an "active" state that are ready to use for data transfer.
|
local
|
Number of ATM labels on this interface assigned by this label-switch router (LSR).
|
remote
|
Number of ATM labels on this interface assigned by the neighbor LSR.
|
Bwait
|
Number of bindings that are waiting for a label assignment from the downstream neighbor LSR.
|
Rwait
|
Number of bindings that are waiting for resources (VPI/VCI space) to be available on the downstream device.
|
IFwait
|
Number of bindings that are waiting for learned labels to be installed for switching use. For an ATM label switch router, this value is 0.
|
Related Commands
Command
|
Description
|
show mpls atm-ldp bindings
|
Displays the requested entries from the ATM LDP label binding database.
|
show mpls cos-map
To display the quality of service (QoS) map used to assign a quantity of label virtual circuits and the associated class of service (CoS) for those virtual circuits, use the show mpls cos-map command in privileged EXEC mode.
show mpls cos-map [cos-map]
Syntax Description
cos-map
|
(Optional) Number specifying the QoS map to be displayed.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
12.0(10)ST
|
This command was modified to reflect Multiprotocol Label Switching (MPLS) Internet Engineering Task Force (IETF) syntax and terminology.
|
12.2(2)T
|
This command was integrated into Cisco IOS Release 12.2(2)T.
|
Usage Guidelines
Not entering a specific QoS number causes all QoS maps to be displayed.
Examples
The following is sample output from the show mpls cos-map command:
Router# show mpls cos-map 2
Table 80 describes the fields shown in the display.
Table 80 show mpls cos-map Field Descriptions
Field
|
Description
|
cos-map
|
Configures a class map, which specifies how classes map to MPLS virtual circuits when they are combined with a prefix map.
|
class
|
The IP precedence.
|
tag-VC
|
An ATM virtual circuit that is set up through ATM label switch router (LSR) label distribution procedures.
|
Related Commands
Command
|
Description
|
mpls cos-map
|
Creates a class map specifying how classes map to label virtual circuits when they are combined with a prefix map.
|
show mpls forwarding-table
To display the contents of the Multiprotocol Label Switching (MPLS) label forwarding information base (LFIB), use the show mpls forwarding-table command in privileged EXEC mode.
show mpls forwarding-table [network {mask | length} | labels label [- label] | interface interface
| next-hop address | lsp-tunnel [tunnel-id]] [vrf vrf-name] [detail]
Syntax Description
network
|
(Optional) Destination network number.
|
mask
|
(Optional) IP address of the destination mask whose entry is to be shown.
|
length
|
(Optional) Number of bits in mask of destination.
|
labels label - label
|
(Optional) Displays only entries with the specified local labels.
|
interface interface
|
(Optional) Displays only entries with the specified outgoing interface.
|
next-hop address
|
(Optional) Displays only entries with the specified neighbor as the next hop.
|
lsp-tunnel tunnel-id
|
(Optional) Displays only entries with the specified label switched path (LSP) tunnel, or with all LSP tunnel entries.
|
vrf vrf-name
|
(Optional) Displays only entries with the specified VPN routing/forwarding instance (VRF).
|
detail
|
(Optional) Displays information in long form (includes length of encapsulation, length of MAC string, maximum transmission unit (MTU), and all labels).
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
12.1(3)T
|
This command was modified to reflect new MPLS Internet Engineering Task Force (IETF) terminology and command-line interface (CLI) command syntax.
|
12.2(8)T
|
The command was modified to accommodate use of the MPLS experimental (EXP) level as a selection criteria for packet forwarding. The output display was modified to include a bundle adjacency field and exp (vcd) values when the optional detail keyword is specified.
|
12.0(22)S
|
IPv6 MPLS aggregate label and prefix information was added to the display.
|
12.2(14)S
|
This command was integrated into Cisco IOS Release 12.2(14)S.
|
Usage Guidelines
The options described allow specification of a subset of the entire LFIB.
Examples
The following is sample output from the show mpls forwarding-table command:
Router# show mpls forwarding-table
Local Outgoing Prefix Bytes tag Outgoing Next Hop
tag tag or VC or Tunnel Id switched interface
26 Untagged 10.253.0.0/16 0 Et4/0/0 172.27.32.4
28 1/33 10.15.0.0/16 0 AT0/0.1 point2point
29 Pop tag 10.91.0.0/16 0 Hs5/0 point2point
1/36 10.91.0.0/16 0 AT0/0.1 point2point
30 32 10.250.0.97/32 0 Et4/0/2 10.92.0.7
32 10.250.0.97/32 0 Hs5/0 point2point
34 26 10.77.0.0/24 0 Et4/0/2 10.92.0.7
26 10.77.0.0/24 0 Hs5/0 point2point
35 Untagged [T] 10.100.100.101/32 0 Tu301 point2point
36 Pop tag 168.1.0.0/16 0 Hs5/0 point2point
1/37 168.1.0.0/16 0 AT0/0.1 point2point
[T] Forwarding through a TSP tunnel.
View additional tagging info with the 'detail' option
The following is sample output from the show mpls forwarding-table command when the IPv6 Provider Edge Router over MPLS feature is configured to allow IPv6 traffic to be transported across an IPv4 MPLS backbone. The labels are aggregate because there are several prefixes for one local label, and the prefix column contains "IPv6" instead of a target prefix.
Router# show mpls forwarding-table
Local Outgoing Prefix Bytes tag Outgoing Next Hop
tag tag or VC or Tunnel Id switched interface
19 Pop tag 192.168.99.64/30 0 Se0/0 point2point
20 Pop tag 192.168.99.70/32 0 Se0/0 point2point
21 Pop tag 192.168.99.200/32 0 Se0/0 point2point
The following is sample output from the show mpls forwarding-table command when you specify the detail keyword. If the MPLS EXP level is used as a selection criterion for packet forwarding, a Bundle adjacency exp (vcd) field is included in the display. This field includes the EXP value and the corresponding virtual circuit descriptor (VCD) in parentheses:
Router# show mpls forwarding-table detail
Local Outgoing Prefix Bytes tag Outgoing Next Hop
tag tag or VC or Tunnel Id switched interface
16 Pop tag 1.0.0.6/32 0 AT1/0.1 point2point
Bundle adjacency exp(vcd)
0(1) 1(1) 2(1) 3(1) 4(1) 5(1) 6(1) 7(1)
MAC/Encaps=12/12, MTU=4474, Tag Stack{}
No output feature configured
17 18 1.0.0.9/32 0 AT1/0.1 point2point
Bundle adjacency exp(vcd)
0(1) 1(1) 2(1) 3(1) 4(1) 5(1) 6(1) 7(1)
MAC/Encaps=12/16, MTU=4470, Tag Stack{18}
00010000AAAA030000008847 00012000
No output feature configured
18 19 1.0.0.10/32 0 AT1/0.1 point2point
Bundle adjacency exp(vcd)
0(1) 1(1) 2(1) 3(1) 4(1) 5(1) 6(1) 7(1)
MAC/Encaps=12/16, MTU=4470, Tag Stack{19}
00010000AAAA030000008847 00013000
No output feature configured
19 17 20.0.0.0/8 0 AT1/0.1 point2point
Bundle adjacency exp(vcd)
0(1) 1(1) 2(1) 3(1) 4(1) 5(1) 6(1) 7(1)
MAC/Encaps=12/16, MTU=4470, Tag Stack{17}
00010000AAAA030000008847 00011000
No output feature configured
20 20 60.0.0.0/8 0 AT1/0.1 point2point
Bundle adjacency exp(vcd)
0(1) 1(1) 2(1) 3(1) 4(1) 5(1) 6(1) 7(1)
MAC/Encaps=12/16, MTU=4470, Tag Stack{20}
00010000AAAA030000008847 00014000
No output feature configured
21 Pop tag 60.0.0.0/24 0 AT1/0.1 point2point
Bundle adjacency exp(vcd)
0(1) 1(1) 2(1) 3(1) 4(1) 5(1) 6(1) 7(1)
MAC/Encaps=12/12, MTU=4474, Tag Stack{}
No output feature configured
22 Pop tag 1.0.0.4/32 0 Et2/3 40.0.0.4
MAC/Encaps=14/14, MTU=1504, Tag Stack{}
000427AD10430005DDFE043B8847
No output feature configured
Table 81 describes the significant fields shown in the displays.
Table 81 show mpls forwarding-table Field Descriptions
Field
|
Description
|
Local tag
|
Label assigned by this router.
|
Outgoing tag or VC
|
Label assigned by the next hop or virtual path identifier (VPI)/virtual channel identifier (VCI) used to get to next hop. The entries that you can specify in this column include the following:
• [T]—Means forwarding through an LSP tunnel.
• "Untagged"—Means that there is no label for the destination from the next hop or that label switching is not enabled on the outgoing interface.
• "Pop tag"—Means that the next hop advertised an implicit NULL label for the destination and that this router popped the top label.
• "Aggregate"—Means there are several prefixes for one local label. Used when IPv6 is configured on edge routers to transport IPv6 traffic over an IPv4 MPLS network.
|
Prefix or Tunnel Id
|
Address or tunnel to which packets with this label are going.
Note If IPv6 is configured on edge routers to transport IPv6 traffic over an IPv4 MPLS network, "IPv6" is displayed here.
|
Bytes tag switched
|
Number of bytes switched with this incoming label.
|
Outgoing interface
|
Interface through which packets with this label are sent.
|
Next Hop
|
IP address of the neighbor that assigned the outgoing label.
|
Bundle adjacency exp (vcd)
|
Bundle adjacency information. Includes the MPLS EXP value and the corresponding VCD.
|
MAC/Encaps
|
Length in bytes of the Layer 2 header and length in bytes of the packet encapsulation, including the Layer 2 header and label header.
|
MTU
|
Maximum transmission unit (MTU) of the labeled packet.
|
Tag Stack
|
All the outgoing labels. If the outgoing interface is transmission convergence (TC)-ATM, the VCD is also shown.
|
00010000AAAA030000008847 00013000
|
The actual encapsulation in hexadecimal form. A space is shown between Layer 2 and the label header.
|
show mpls interfaces
To display information about one or more or all interfaces that have been configured for label switching, use the show mpls interfaces command in privileged EXEC mode.
show mpls interfaces [interface] [detail]
Syntax Description
interface
|
(Optional) Defines the interface about which to display label switching information.
|
detail
|
(Optional) Displays detailed label switching information for the specified interface.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.1CT
|
This command was introduced.
|
12.0(10)ST
|
This command was modified to reflect Multiprotocol Label Switching (MPLS) Internet Engineering Task Force (IETF) command syntax and terminology.
|
12.1(3)T
|
This command was modified to reflect new MPLS IETF terminology and CLI command syntax.
|
12.1(8a)E
|
This command was integrated into Cisco IOS Release 12.1(8a)E.
|
12.2(2)T
|
This command was integrated into Cisco IOS Release 12.2(2)T.
|
Usage Guidelines
This command shows MPLS information about the specified interface or about all the interfaces for which MPLS has been configured.
If no optional keyword or argument is specified in this command, summary information is displayed for each interface configured for label switching.
Examples
The following is sample output from the show mpls interfaces command:
Router# show mpls interfaces
Interface IP Tunnel Operational
Ethernet1/1/1 Yes (tdp) No No
Ethernet1/1/2 Yes (tdp) Yes No
Ethernet1/1/3 Yes (tdp) Yes Yes
ATM0/0.1 Yes (tdp) No No (ATM labels)
ATM3/0.1 Yes (ldp) No Yes (ATM labels)
ATM0/0.2 Yes (tdp) No Yes
Note
If an interface uses label-controlled ATM (LC-ATM) procedures, the associated line in the display is flagged with the notation "(ATM labels)."
Table 82 describes the significant fields shown in the display.
Table 82 show mpls interfaces Field Descriptions
Field
|
Description
|
Interface
|
Interface name.
|
IP
|
"Yes" if IP label switching (sometimes called hop-by-hop label switching) has been enabled on this interface.
|
Tunnel
|
"Yes" if label switched path (LSP) tunnel labeling has been enabled on this interface.
|
Operational
|
Operational state. "Yes" if packets are being labeled.
|
The following is sample output from the show mpls interfaces command when you specify the detail keyword:
Router# show mpls interfaces detail
IP labeling enabled (tdp)
LSP Tunnel labeling not enabled
IP labeling enabled (ldp)
LSP Tunnel labeling not enabled
IP labeling enabled (ldp)
LSP Tunnel labeling not enabled
ATM labels: Label VPI = 1
Label VCI range = 33 - 65535
Related Commands
show mpls ip binding
To display specified information about label bindings learned by the Label Distribution Protocol (LDP), use the show mpls ip binding command in privileged EXEC mode. To summarize information about label bindings learned by LDP, use the show mpls ip binding summary command in privileged EXEC mode.
show mpls ip binding [network {mask | length} [longer-prefixes]] [local-label {atm vpi vci |
label [- label]}] [remote-label {atm vpi vci | label [- label]}] [neighbor address] [local]
[interface interface] [generic | atm]
show mpls ip binding [summary]
Syntax Description
network
|
(Optional) Defines the destination network number.
|
mask
|
(Optional) Defines the network mask, written as A.B.C.D.
|
length
|
(Optional) Defines the mask length (1 to 32 characters).
|
longer-prefixes
|
(Optional) Selects any prefix that matches the mask with a length from 1 to 32 characters.
|
local-label atm vpi vci
|
(Optional) Displays entry with locally assigned ATM label that matches the specified ATM label value.
|
local-label label - label
|
(Optional) Displays entries with locally assigned label(s) that match the specified label value(s). Use the label - label argument to indicate the label range.
|
remote-label atm vpi vci
|
(Optional) Displays entries with remotely assigned ATM label values learned from neighbor routers that match the specified ATM label value.
|
remote-label label - label
|
(Optional) Displays entries with remotely assigned label(s) learned from neighbor routers that match the specified label value(s). Use the label - label argument to indicate the label range.
|
neighbor address
|
(Optional) Displays label bindings assigned by the selected neighbor.
|
local
|
(Optional) Displays the local label bindings.
|
interface interface
|
(Optional) Displays label bindings associated with the specified interface (for label-controlled ATM (LC-ATM) only).
|
generic
|
(Optional) Displays only generic (non-LC-ATM) label bindings.
|
atm
|
(Optional) Displays only LC-ATM label bindings.
|
summary
|
(Optional) Displays summary information about label bindings learned by LDP.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0(10)ST
|
This command was introduced.
|
12.1(8a)E
|
This command was integrated into Cisco IOS Release 12.1(8a)E.
|
12.2(2)T
|
This command was integrated into Cisco IOS Release 12.2(2)T.
|
Usage Guidelines
The show mpls ip binding command displays label bindings learned by LDP or Tag Distribution Protocol (TDP).
A request can specify that the entire database be displayed, that a summary of entries from the database be displayed, or that the display be limited to a subset of entries. The subset can be limited according to any of the following:
•
Prefix
•
Input or output label values or ranges
•
Neighbor advertising the label
•
Interface for label bindings of interest (LC-ATM only)
•
Generic (non-LC-ATM) label bindings
•
LC-ATM label bindings
All label bindings are displayed when no arguments or keywords are specified.
Examples
The following is sample output from the show mpls ip binding command. The output shows all the label bindings in the database.
Router# show mpls ip binding
out label: 26 lsr: 155.0.0.55:0
out vc label: 1/80 lsr: 203.0.7.7:2 ATM1/0.8
Active ingress 3 hops (vcd 49)
in vc label: 1/36 lsr: 203.0.7.7:2 ATM1/0.8
out label: imp-null lsr: 155.0.0.55:0 inuse
in vc label: 1/39 lsr: 203.0.7.7:2 ATM1/0.8
out label: 16 lsr: 155.0.0.55:0 inuse
out label: 22 lsr: 155.0.0.55:0
out vc label: 1/83 lsr: 203.0.7.7:2 ATM1/0.8
Active ingress 3 hops (vcd 52)
out label: 27 lsr: 155.0.0.55:0 inuse
in vc label: 1/40 lsr: 203.0.7.7:2 ATM1/0.8
out label: imp-null lsr: 155.0.0.55:0 inuse
in vc label: 1/46 lsr: 203.0.7.7:2 ATM1/0.8
out label: imp-null lsr: 155.0.0.55:0 inuse
in vc label: 1/37 lsr: 203.0.7.7:2 ATM1/0.8
out label: imp-null lsr: 155.0.0.55:0 inuse
In the following example, a request is made for the display of the label binding information for prefix 194.44.44.0/24:
Router# show mpls ip binding 194.44.44.0 24
in vc label: 1/37 lsr: 203.0.7.7:2 ATM1/0.8
out label: imp-null lsr: 155.0.0.55:0 inuse
In the following example, the local-label keyword is used to request that label binding information be displayed for the prefix with local label 58:
Router# show mpls ip binding local-label 58
out label: imp-null lsr: 155.0.0.55:0 inuse
Table 83 describes the fields shown in the display.
Table 83 show mpls ip binding Field Descriptions
Field
|
Description
|
A.B.C.D/n
|
Destination prefix. Indicates that the following lines are for a particular destination (network/mask).
|
in label
|
Incoming label. This is the local label assigned by the label switch router (LSR) and advertised to other LSRs. The label value imp-null indicates the well-known Implicit NULL label.
|
out label
|
Outgoing label. This is a remote label learned from an LDP neighbor. The neighbor is identified by its LDP ID in the lsr field.
|
inuse
|
Indicates that the outgoing label is in use for Multiprotocol Label Switching (MPLS) forwarding; that is, it is installed in the MPLS forwarding table (LFIB).
|
in vc label
|
Incoming MPLS ATM label. This is the local virtual path identifier (VPI)/virtual channel identifier (VCI) assigned by the LSR as the incoming label for the destination and advertised to the upstream LSR(s).
|
out vc label
|
Outgoing MPLS ATM label. This is the VPI/VCI learned from the destination next hop as its label for the destination and advertised to this LSR.
|
ATM1/0.8
|
The ATM interface with which the MPLS ATM label is associated.
|
Active
|
The state of the label virtual circuit (LVC) associated with the destination prefix. Possible states include the following:
• Active. The label virtual circuit is established and operational.
• Bindwait. Waiting for a response from the destination next hop.
• Remote Resource Wait. Waiting for resources (VPI/VCI) to become available on the destination next hop.
• Parent Wait. Transit LVC upstream side waiting for downstream side to become active.
• AbortAckWait. Waiting for response to a Label Abort message sent to the destination next hop.
• ReleaseWait. Waiting for response to a Label Withdraw message sent to an upstream neighbor.
|
vcd n
|
Virtual circuit descriptor number for the LVC.
|
ingress n hops
|
Indicates whether the LSR is an ingress, transit, or egress node for the destination. Options include the following:
• Ingress n hops. The LSR is an ingress edge router for the MPLS ATM cloud for the destination.
• Egress. The LSR is an egress edge router for the MPLS ATM cloud for the destination.
• Transit. The LSR is a transit LSR within the MPLS ATM cloud for the destination.
|
In the following example, summary information about the label bindings learned by LDP is shown:
Router# show mpls ip binding summary
Total number of prefixes: 53
prefixes in labels out labels
ATM label bindings summary
interface total active local remote Bwait Rwait IFwait
ATM1/0.8 47 47 40 7 0 0 0
Table 84 describes the fields shown in the display.
Table 84 show mpls ip binding summary Field Descriptions
Field
|
Description
|
Total number of prefixes
|
Number of destinations for which the LSR has label bindings.
|
Generic label bindings
|
Indicates the start of summary information for "generic" label bindings. Generic labels are used for MPLS forwarding on all interface types except MPLS ATM interfaces.
|
prefixes
|
Number of destinations for which the LSR has a generic label binding.
|
assigned in labels
|
Number of prefixes for which the LSR has assigned an incoming (local) label.
|
learned out labels
|
Number of prefixes for which the LSR has learned an outgoing (remote) label from an LDP neighbor.
|
ATM label bindings summary
|
Indicates the start of summary information for MPLS ATM label bindings. An ATM label is a VPI/VCI.
|
interface
|
Indicates a row in the ATM label bindings summary table. The summary information in the row is for ATM labels associated with this interface.
|
total
|
Total number of ATM labels associated with the interface.
|
active
|
Number of ATM labels (LVCs) in the Active (operational) state.
|
local
|
Number of ATM labels assigned by this LSR for the interfaces. These are incoming labels.
|
remote
|
Number of ATM labels learned from the neighbor LSR for this interface. These are outgoing labels.
|
Bwait
|
Number of bindings (LVCs) waiting for a label assignment from the neighbor LSR for the interface.
|
Rwait
|
Number of bindings (LVCs) waiting for resources (VPI/VCIs) to become available on the neighbor LSR for the interface.
|
IFwait
|
Number of bindings (LVCs) waiting for labels to be installed for switching use.
|
Related Commands
show mpls l2transport binding
To display VC label binding information, use the show mpls l2transport binding command in EXEC mode.
show mpls l2transport binding