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

cos-map 2    class  tag-VC 

             3      control 

             2      control 

             1      available

             0      available

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                     

16    Aggregate     IPv6              0             

17    Aggregate     IPv6              0                 

18    Aggregate     IPv6              0                 

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    

22    Aggregate     IPv6              5424    

23    Aggregate     IPv6              3576 

24    Aggregate     IPv6              2600

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{}

      00010000AAAA030000008847

  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{}

      00010000AAAA030000008847

  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         

POS2/0/0               Yes (tdp)  No       No          

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

Interface Ethernet1/1/1:

        IP labeling enabled (tdp)

        LSP Tunnel labeling not enabled

        MPLS operational

        MPLS turbo vector

        MTU = 1500

Interface POS2/0/0:

        IP labeling enabled (ldp)

        LSP Tunnel labeling not enabled

        MPLS not operational

        MPLS turbo vector

        MTU = 4470

Interface ATM3/0.1:

        IP labeling enabled (ldp)

        LSP Tunnel labeling not enabled

        MPLS operational

        MPLS turbo vector

        MTU = 4470

        ATM labels: Label VPI = 1

                Label VCI range = 33 - 65535

                Control VC = 0/32

Related Commands

Command	Description
mpls ip (global configuration)	Enables label switching of IPv4 packets on all interfaces.
mpls ip (interface configuration)	Enables label switching of IPv4 packets on the associated interface.
mpls label protocol (global configuration)	Specifies the label distribution protocol to be used on a given platform.
mpls label protocol (interface configuration)	Specifies the label distribution protocol to be used on a given interface.
mpls traffic-eng tunnels (global configuration)	Enables MPLS traffic engineering tunneling signaling on a device.
mpls traffic-eng tunnels (interface configuration)	Enables MPLS traffic engineering tunneling signaling on an interface.

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 

  34.0.0.0/8 

        in label:     20        

        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) 

  45.0.0.0/8 

        in label:     25        

        in vc label:  1/36      lsr: 203.0.7.7:2      ATM1/0.8

                      Active    egress (vcd 55) 

        out label:    imp-null  lsr: 155.0.0.55:0     inuse

  66.66.0.66/32 

        in label:     26        

        in vc label:  1/39      lsr: 203.0.7.7:2      ATM1/0.8

                      Active    egress (vcd 58) 

        out label:    16        lsr: 155.0.0.55:0     inuse

  133.0.0.33/32 

        in label:     23        

        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) 

  144.0.0.44/32 

        in label:     61        

        out label:    27        lsr: 155.0.0.55:0     inuse

  150.88.0.0/16 

        in label:     28        

        in vc label:  1/40      lsr: 203.0.7.7:2      ATM1/0.8

                      Active    egress (vcd 59) 

        out label:    imp-null  lsr: 155.0.0.55:0     inuse

  166.47.0.0/16 

        in label:     33        

        in vc label:  1/46      lsr: 203.0.7.7:2      ATM1/0.8

                      Active    egress (vcd 65) 

        out label:    imp-null  lsr: 155.0.0.55:0     inuse

  194.44.44.0/24 

        in label:     24        

        in vc label:  1/37      lsr: 203.0.7.7:2      ATM1/0.8

                      Active    egress (vcd 56) 

        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

  194.44.44.0/24 

        in label:     24        

        in vc label:  1/37      lsr: 203.0.7.7:2      ATM1/0.8

                      Active    egress (vcd 56) 

        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

  166.253.0.0/16 

        in 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

Generic label bindings

                      assigned        learned

       prefixes      in labels     out labels

             53             53             51

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

Command	Description
show mpls atm-ldp bindings	Displays specified entries from the ATM label binding database.
show mpls ldp bindings	Displays the contents of the LIB.

show mpls l2transport binding

To display VC label binding information, use the show mpls l2transport binding command in EXEC mode.

show mpls l2transport binding