Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


ping mpls l2circuit



Check the operability of the MPLS Layer 2 circuit connections. Type Ctrl+c to interrupt a ping mpls l2circuit command.


This command is not supported on EX4500 and EX4550 switches.


count count

(Optional) Number of ping requests to send. If count is not specified, five ping requests are sent. The range of values is 1 through 1,000,000. The default value is 5.

destination address

(Optional) Specify an address other than the default ( for the ping echo requests. The address can be anything within the 127/8 subnet.


(Optional) Display detailed information about the echo requests sent and received.

exp forwarding-class

(Optional) Value of the forwarding class for the MPLS ping packets.

interface interface-name

Ping an interface configured for the Layer 2 circuit on the egress provider edge (PE) router.

logical-system (all | logical-system-name)

(Optional) Perform this operation on all logical systems or on the specified logical system.


(Optional) Reply mode for the ping request. This option has the following suboptions:


Reply using an application level control channel.


Reply using an IPv4 or IPv6 UDP packet.


Do not reply to the ping request.


The reply-mode option and its suboptions application-level-control-channel, ip-udp, and no-reply are also available in Junos OS Release 10.2R4 and 10.3R2.

size bytes

(Optional) Size of the label-switched path (LSP) ping request packet (96 through 65468 bytes). Packets are 4-byte aligned. For example, If you enter a size of 97, 98, 99, or 100, the router or switch uses a size value of 100 bytes. If you enter a packet size that is smaller than the minimum size, an error message is displayed reminding you of the 96-byte minimum.

source source-address

(Optional) IP address of the outgoing interface. This address is sent in the IP source address field of the ping request. If this option is not specified, the default address is usually the loopback interface (lo.0).


(Optional) Automatically determine the size of the maximum transmission unit (MTU).


(Optional) Use the type 9 Layer 2 circuit type, length, and value (TLV).

virtual-circuit virtual-circuit-id neighbor address

Ping the virtual circuit identifier on the egress PE router or switch and the specified neighbor, testing the integrity of the Layer 2 circuit between the ingress and egress PE routers or switches.

Additional Information

You must configure MPLS at the [edit protocols mpls] hierarchy level on the egress PE router or switch (the router or switch receiving the MPLS echo packets) to ping a Layer 2 circuit.

In asymmetric MTU scenarios, the echo response might be dropped. For example, if the MTU from System A to System B is 1000 bytes, the MTU from System B to  System A is 500 bytes, and the ping request packet size is 1000 bytes, the echo response is dropped because the PAD TLV is included in the echo response, making it too large.

Required Privilege Level


Output Fields

When you enter this command, you are provided feedback on the status of your request. An exclamation point (!) indicates that an echo reply was received. A period ( .) indicates that an echo reply was not received within the timeout period. An x indicates that an echo reply was received with an error code. Packets with an error code are not counted in the received packets count. They are accounted for separately.

Sample Output

ping mpls l2circuit interface

ping mpls l2circuit virtual-circuit detail

ping mpls l2circuit interface <interface-name> reply-mode

Release Information

Command introduced before Junos OS Release 7.4.

The size and sweep options were introduced in Junos OS Release 9.6.

The reply-mode option and its suboptions are introduced in Junos OS Release 10.4R1.