Fortinet white logo
Fortinet white logo

CLI Reference

ping-options

ping-options

Use these commands to configure the behavior of the ping command.

To use this command, your administrator account’s access control profile must have at least r permission to the sysgrp area. For details, see Permissions.

Syntax

execute ping-options data-size <bytes_int>

execute ping-options df-bit {yes | no}

execute ping-options pattern <bufferpattern_hex>

execute ping-options repeat-count <repeat_int>

execute ping-options source {auto | <interface_ipv4>}

execute ping-options timeout <seconds_int>

execute ping-options tos {<service_type>}

execute ping-options ttl <hops_int>

execute ping-options validate-reply {yes | no}

execute ping-options view-settings

Variable Description Default

data-size <bytes_int>

Enter datagram size in bytes.This allows you to send out packets of different sizes for testing the effect of packet size on the connection. If you want to configure the pattern that will be used to buffer small datagrams to reach this size, also configure pattern <bufferpattern_hex>.

56

df-bit {yes | no}

Enter either yes to set the DF bit in the IP header to prevent the ICMP packet from being fragmented, or enter no to allow the ICMP packet to be fragmented.

no

pattern <bufferpattern_hex>

Enter a hexadecimal pattern, such as 00ffaabb, to fill the optional data buffer at the end of the ICMP packet. The size of the buffer is determined by data-size <bytes_int>.

No default.

repeat-count <repeat_int>

Enter the number of times to repeat the ping.

5

source {auto | <interface_ipv4>}

Select the network interface from which the ping is sent. Enter either auto or a FortiWeb network interface IP address.

auto

timeout <seconds_int>

Enter the ping response timeout in seconds.

2

tos {<service_type>}

Enter the IP type-of-service option value, either:

  • default—Do not indicate. That is, set the TOS byte to 0.
  • lowcost—Minimize cost.
  • lowdelay—Minimize delay.
  • reliability—Maximize reliability.
  • throughput—Maximize throughput.
default

ttl <hops_int>

Enter the time-to-live (TTL) value.

64

validate-reply {yes | no}

Select whether or not to validate ping replies.

no

view-settings

Display the current ping option settings.

No default.

Example

This example sets the number of pings to three and the source IP address to 192.0.2.1, then views the ping options to verify their configuration.

execute ping-option repeat-count 3

execute ping-option source 192.0.2.1

execute ping-option view-settings

The CLI would display the following:

Ping Options:

Repeat Count: 3

Data Size: 56

Timeout: 2

TTL: 64

TOS: 0

DF bit: unset

Source Address: 192.0.2.1

Pattern:

Pattern Size in Bytes: 0

Validate Reply: no

Related topics

ping-options

ping-options

Use these commands to configure the behavior of the ping command.

To use this command, your administrator account’s access control profile must have at least r permission to the sysgrp area. For details, see Permissions.

Syntax

execute ping-options data-size <bytes_int>

execute ping-options df-bit {yes | no}

execute ping-options pattern <bufferpattern_hex>

execute ping-options repeat-count <repeat_int>

execute ping-options source {auto | <interface_ipv4>}

execute ping-options timeout <seconds_int>

execute ping-options tos {<service_type>}

execute ping-options ttl <hops_int>

execute ping-options validate-reply {yes | no}

execute ping-options view-settings

Variable Description Default

data-size <bytes_int>

Enter datagram size in bytes.This allows you to send out packets of different sizes for testing the effect of packet size on the connection. If you want to configure the pattern that will be used to buffer small datagrams to reach this size, also configure pattern <bufferpattern_hex>.

56

df-bit {yes | no}

Enter either yes to set the DF bit in the IP header to prevent the ICMP packet from being fragmented, or enter no to allow the ICMP packet to be fragmented.

no

pattern <bufferpattern_hex>

Enter a hexadecimal pattern, such as 00ffaabb, to fill the optional data buffer at the end of the ICMP packet. The size of the buffer is determined by data-size <bytes_int>.

No default.

repeat-count <repeat_int>

Enter the number of times to repeat the ping.

5

source {auto | <interface_ipv4>}

Select the network interface from which the ping is sent. Enter either auto or a FortiWeb network interface IP address.

auto

timeout <seconds_int>

Enter the ping response timeout in seconds.

2

tos {<service_type>}

Enter the IP type-of-service option value, either:

  • default—Do not indicate. That is, set the TOS byte to 0.
  • lowcost—Minimize cost.
  • lowdelay—Minimize delay.
  • reliability—Maximize reliability.
  • throughput—Maximize throughput.
default

ttl <hops_int>

Enter the time-to-live (TTL) value.

64

validate-reply {yes | no}

Select whether or not to validate ping replies.

no

view-settings

Display the current ping option settings.

No default.

Example

This example sets the number of pings to three and the source IP address to 192.0.2.1, then views the ping options to verify their configuration.

execute ping-option repeat-count 3

execute ping-option source 192.0.2.1

execute ping-option view-settings

The CLI would display the following:

Ping Options:

Repeat Count: 3

Data Size: 56

Timeout: 2

TTL: 64

TOS: 0

DF bit: unset

Source Address: 192.0.2.1

Pattern:

Pattern Size in Bytes: 0

Validate Reply: no

Related topics