/
ping6

ping6


The ping6 command checks whether a specified IPv6 address is reachable and outputs the statistics results.


Command Syntax

  •   From the ">" prompt, use the following format,

ping6 <ipv6-address> [<packets>] [vrf <mgmt-vrf | vrf-name>] [source <source-ip-address>] [deadline <deadline-time>] [ttl <ttl-value>] [interval <interval-value>] [pattern <pattern-value>] [size <size-value>] [tos <tos-value>]

  •   From the "#" prompt, add run in front of the command,

run ping6 <ipv6-address> [<packets>] [vrf <mgmt-vrf | vrf-name>] [source <source-ip-address>] [deadline <deadline-time>] [ttl <ttl-value>] [interval <interval-value>] [pattern <pattern-value>] [size <size-value>] [tos <tos-value>]


Parameter

Parameter

Description

<ip-address>

Specifies the domain name or IPv6 address of the destination host.

<packets>

Optional. Specifies the number of ICMP Echo Request packets be sent.

vrf <mgmt-vrf | vrf-name>

Optional. Specifies a VRF name. The value is a string that could be mgmt-vrf or a user-defined VRF name.

  •   mgmt-vrf: management VRF is specified.
  •   vrf-name: a user-defined VRF set by using command set ip vrf <vrf-name> [description <string>].

NOTE:

  •   When a VRF name is specified, find the next hop routing information from the specified VRF domain.
  •   When no VRF is specified, find the next hop routing information from the default VRF.

source <source-ip-address>

Optional. Specifies the source IPv6 address of the ICMPv6 Echo Request message. If the source IPv6 address is not specified, the IPv6 address of the outbound interface is used as the source IP address of the ICMPv6 Echo Request message.

deadline <deadline-time>

Optional. Specify a timeout, in seconds, before ping exits regardless of how many packets have been sent or received. In this case ping does not stop after count packet are sent, it waits either for deadline to expire or until count probes are answered or for some error notification from network.

The value is an integer.

ttl <ttl-value>

Optional. Specifies the TTL value.

If the TTL field is reduced to 0 during message forwarding, the Layer 3 device that the message reaches sends an ICMPv6 timeout message to the source host, indicating that the destination host is unreachable. 

The value is an integer that ranges from 1 to 255.

interval <interval-value>

Optional. Specify the interval for sending ICMPv6 Echo Request message. The value is an integer in byte.

pattern <pattern-value>

Optional. Specifies pad characters for ICMPv6 Echo Request messages.

By configuring pad characters for ICMPv6 Echo Request messages, you can identify a specific message among the large number of received ICMPv6 Echo Reply messages.

The value is a hexadecimal integer.

size <size-value>

Optional. Specifies the maximum payload length of an ICMPv6 Echo Request message. The value is an integer.


Example

  •   Check whether the host at 1::1 is reachable. 
admin@Xorplus> ping 1::1

PING 1::1(1::1) 56 data bytes
64 bytes from 1::1: icmp_seq=1 ttl=64 time=0.064 ms
64 bytes from 1::1: icmp_seq=2 ttl=64 time=0.063 ms
64 bytes from 1::1: icmp_seq=3 ttl=64 time=0.062 ms
64 bytes from 1::1: icmp_seq=4 ttl=64 time=0.061 ms

Copyright © 2025 Pica8 Inc. All Rights Reserved.