Skip to content

Commit

Permalink
Interfaces: Diagnostics: Ping - update documentation, closes opnsense…
Browse files Browse the repository at this point in the history
  • Loading branch information
AdSchellevis committed Mar 17, 2023
1 parent 38e6275 commit ab648e2
Showing 1 changed file with 14 additions and 2 deletions.
16 changes: 14 additions & 2 deletions source/manual/diagnostics_interfaces.rst
Original file line number Diff line number Diff line change
Expand Up @@ -161,7 +161,8 @@ The jobs tab contains all running or executed captures, the following options ar
Ping
---------------------

Use ping to establish if a remote host can be reached using ICMP.
Use ping to establish if a remote host can be reached using ICMP echo requests. It's one of the most used tools
to validate basic connectivity.

==============================================================================================================================================

Expand All @@ -171,10 +172,21 @@ Address Family Send using IPv4 or IPv6
Source address Source address to use, can be any address configured on this firewall
Packet size Specify the number of data bytes to be sent.
Keep in mind this is the payload size, an IP and ICMP header are added.
Do not fragment Set DF bit, can be used to validate if a certain packet size fits a path.
Do not fragment Set DF bit.
Description Description to be displayed in "jobs" tab
=========================== ==================================================================================================================

.. Tip::

To locate MTU (Maximum transmission unit) issues, use the "Do not fragment" option to force a packet of certain size to travel the network

.. Tip::

When the default ping is not able to reach the target, but one with a preset source address is, one usally
needs to add a static route to force traffic using the correct source address. This is for example common
for IPsec policy based tunnels which install a kernel trap on the specified source network.


The jobs tab contains all running or executed pings, the following options and properties are available per job:

.. raw:: html
Expand Down

0 comments on commit ab648e2

Please sign in to comment.