ping

Ping a device to test the connection between the switch and another network device. After you ping a device, the switch sends an Internet Control Message Protocol (ICMP) packet to the target device. If the device receives the packet, it sends a ping reply. After the switch receives the reply, a message appears that indicates traffic can reach the specified IP address. If the switch does not receive a reply, the message indicates the address is not responding.

Syntax

Note

Command parameters for ping varies depending on the parameter input order. All syntax possibilites are not listed. You can use the CLI help to verify the syntax for available parameters during command contextual input.

ping WORD<0-256>
ping WORD<0-256> count <1-9999>
ping WORD<0-256> count <1-9999> mgmt [clip | oob | vlan]
ping WORD<0-256> -d
ping WORD<0-256> datasize <28-51200>
ping WORD<0-256> datasize <28-51200> mgmt [clip | oob | vlan]
ping WORD<0-256> grt
ping WORD<0-256 grt interface gigabitEthernet {slot/port[sub-port]}
ping WORD<0-256> grt interface tunnel <1-2000>
ping WORD<0-256> grt interface vlan <1-4059>
ping WORD<0-256> grt source WORD<1-256>
ping WORD<0-256> -I <1-60>
ping WORD<0-256> interface gigabitEthernet {slot/port[sub-port]}
ping WORD<0-256> interface mgmtEthernet mgmt
ping WORD<0-256> interface tunnel <1-2000>
ping WORD<0-256> interface vlan <1-4059>
ping WORD<0-256> mgmt [clip | oob | vlan]
ping WORD<0-256> -s
ping WORD<0-256> -s mgmt [clip | oob | vlan]
ping WORD<0-256> scopeid <1-9999>
ping WORD<0-256> source WORD<1-256>
ping WORD<0-256> -t <1-120>
ping WORD<0-256> -t <1-120> mgmt [clip | oob | vlan]
ping WORD<0-256> vrf WORD<1-16>
ping WORD<0-256> vrf WORD<1-16> interface gigabitEthernet {slot/port[sub-port]}
ping WORD<0-256> vrf WORD<1-16> interface tunnel <1-2000>
ping WORD<0-256> vrf WORD<1-16> interface vlan <1-4059>
ping WORD<0-256> vrf WORD<1-16> source WORD<0-256>

Command Parameters

interface gigabitEthernet {slot/port[sub-port]}: Specifies a specific outgoing interface to use by IP address. {slot/port[sub-port]} identifies a single slot and port. If your platform supports channelization and the port is channelized, you must also specify the subport in the format slot/port/sub-port.
interface gigabitEthernet {slot/port[sub-port]} | tunnel <1-2000> | vlan <1-4059>: Specifies a specific outgoing interface to use by IP address. Additional ping interface filters: gigabitEthernet: {slot/port[sub-port]} gigabit vlan: Specifies the VLAN ID in the range of 1 to 4059. By default, VLAN IDs 1 to 4059 are configurable and the system reserves VLAN IDs 4060 to 4094 for internal use. If you enable VRF scaling and SPBM mode, the system also reserves VLAN IDs 3500 to 3998. VLAN ID 1 is the default VLAN and you cannot create or delete VLAN ID 1.
mgmt: Ping a network connection using a zero source IP address and route lookup in the main table.
mgmt clip: Ping a network connection using a Segmented Management Instance. If you do not use the mgmt parameter, the ping command uses the IP routing stack to initiate the ping request.
mgmt oob: Ping a network connection using a Segmented Management Instance. If you do not use the mgmt parameter, the ping command uses the IP routing stack to initiate the ping request.
Note

Exception: not supported on VSP 8600 Series or XA1400 Series.
mgmt vlan: Ping a network connection using a Segmented Management Instance. If you do not use the mgmt parameter, the ping command uses the IP routing stack to initiate the ping request.
Note

Exception: not supported on VSP 8600 Series.
WORD <0-256>: Specifies the host name or IPv4 (a.b.c.d) or IPv6 (x:x:x:x:x:x:x:x) address (string length 0-256). Specifies the address to ping.
WORD<0-256> count <1-9999>: Specifies the number of times to ping(for IPV4/IPV6).
WORD<0-256> -d: Configures the ping debug mode. This variable detects local software failures (ping related threads creation or write to sending socket) and receiving issues (ICMP packet too short or wrong ICMP packet type) (for IPV4/IPV6).
WORD<0-256> datasize <28-51200>: Specifies the size of ping data sent in bytes. The datasize for IPv4 addresses is <28-9216>. The datasize for IPv6 addresses is <28-51200>. The default is 0.
WORD<0-256> grt: Specifies the ping is executed in Global Router (GRT) context.
WORD<0-256> -I <1-60>: Specifies the interval between transmissions (for IPV4/IPV6).
WORD<0-256> interface mgmtEthernet mgmt: Specifies an IP address that will be used as the source IP address in the packet header.
Note

Exception: only supported on VSP 8600 Series.
WORD<0-256> interface tunnel <1-2000>: Specifies the tunnel interface.
WORD<0-256> interface vlan <1-4059>: Specifies the virtual routing and forwarding (VRF) name from 1-16 characters.
WORD<0-256> -s: Configures the continuous ping at the interval rate defined by the [-I] parameter (for IPV4/IPV6).
WORD<0-256> scopeid <1-9999>: Specifies the scope ID. <1-9999> specifies the circuit ID for IPv6.
WORD<0-256> source WORD<1-256>: Specifies an IP address that will be used as the source IP address in the packet header.
WORD<0-256> -t <1-120>: Specifies the no-answer timeout value in seconds (1-120) (for IPV4/IPV6).
WORD<0-256> vrf WORD<1-16>: Specifies the virtual routing and forwarding (VRF) name from 1-16 characters.

Default

None

Command Mode

User EXEC

Usage Guidelines

The options [-d], [-I], [interface], [scopeid], [source], and [vrf] are not available if the mgmt keyword is specified.

All command parameters do not apply to all hardware platforms. For more information about feature support, see VOSS Feature Support Matrix.