History log of /freebsd-current/sbin/ping/ping.8
Revision Date Author Comments
# 51e16cb8 23-Nov-2023 Warner Losh <imp@FreeBSD.org>

sbin: Remove ancient SCCS tags.

Remove ancient SCCS tags from the tree, automated scripting, with two
minor fixup to keep things compiling. All the common forms in the tree
were removed with a perl script.

Sponsored by: Netflix


# a2d13601 19-Sep-2023 Dag-Erling Smørgrav <des@FreeBSD.org>

ping: The -C option is also supported for IPv6.

MFC after: 3 days
Sponsored by: Klara, Inc.
Sponsored by: NetApp, Inc.
Reviewed by: rscheff, allanjude
Differential Revision: https://reviews.freebsd.org/D41881


# b2c76c41 16-Aug-2023 Warner Losh <imp@FreeBSD.org>

Remove $FreeBSD$: one-line nroff pattern

Remove /^\.\\"\s*\$FreeBSD\$$\n/


# 8eb4df94 19-Nov-2022 Jose Luis Duran <jlduran@gmail.com>

ping(8): man page cleanup

* Appease mandoc -T lint and igor

* Use example.com for documentation

* Update the IPv4 TTL section.
Update the IPv4 TTL section specifically for FreeBSD.
FreeBSD changed the default TTL to 64 in
5639e86bdd7ea151958776264bf5a67e60a54d68. NetBSD and OpenBSD still
use 255. Remove some references of extinct operating systems.

Reviewed by: gbe (manpages), asomers
MFC after: 2 weeks
Pull Request: https://github.com/freebsd/freebsd-src/pull/630


# d399eb3e 11-Apr-2022 Piotr Pawel Stefaniak <pstef@FreeBSD.org>

ping: split the visual part of -f into a new option -.

After this, we'll be able to ping a host and not spam the terminal, and
no flooding will have to be involved. I've been doing this under Linux
as ping -fi1 host.

Reviewed by: rpokala, Pau Amma
Differential Revision: https://reviews.freebsd.org/D34882


# 83e66677 05-Feb-2022 Wolfram Schneider <wosch@FreeBSD.org>

update external URL


# ea0dd3ca 19-Dec-2020 Gordon Bergling <gbe@FreeBSD.org>

ping(8): Fix a mandoc related issue

- unusual Xr punctuation: none before traceroute6(8)


# 4ddfc27e 04-Dec-2020 Gordon Bergling <gbe@FreeBSD.org>

ping(8): Fix a few mandoc related issues

- new sentence, new line


# d2624517 26-Nov-2020 Alan Somers <asomers@FreeBSD.org>

ping: add a ping6 hard link for backwards compatibility

When invoked as "ping6", ping will now attempt to use ICMPv6 for hostnames
that resolve both IPv4 and IPv6 addresses.

Reviewed by: bz, manu
MFC-With: r368045
Differential Revision: https://reviews.freebsd.org/D27384


# 3cde9171 25-Nov-2020 Alan Somers <asomers@FreeBSD.org>

Merge ping6 to ping

There is now a single ping binary, which chooses to use ICMP or ICMPv4
based on the -4 and -6 options, and the format of the address.

Submitted by: Ján Sučan <sucanjan@gmail.com>
Sponsored by: Google LLC (Google Summer of Code 2019)
MFC after: Never
Differential Revision: https://reviews.freebsd.org/D21377


# 81a6f4c7 24-Oct-2020 Richard Scheffenegger <rscheff@FreeBSD.org>

Make use of IP_VLAN_PCP setsockopt in ping and ping6.

In order to validate the proper marking and use of a different
ethernet priority class, add the new session-specific PCP
feature to the ping/ping6 utilities.

Reviewed by: mav, bcr
Sponsored by: NetApp, Inc.
Differential Revision: https://reviews.freebsd.org/D26627


# 299e2c58 22-Aug-2019 Alan Somers <asomers@FreeBSD.org>

ping: By default, don't reverse lookup IP addresses

ping's default is now not to attempt reverse DNS lookups. The -H flag will
enable them. This change is not quite a reversion of r351330. That change
made the happy path and error path do reverse lookups consistently; this
change changes the default for both paths.

Submitted by: Ján Sučan <sucanjan@gmail.com>
Discussed with: cem
MFC after: 2 weeks
MFC-With: 351330
Sponsored by: Google LLC (Google Summer of Code 2019)
Differential Revision: https://reviews.freebsd.org/D21364


# 99f13ae1 21-Aug-2019 Alan Somers <asomers@FreeBSD.org>

ping: add -H option for enabling reverse DNS lookup

This is the reverse of the -n flag.

Submitted by: Ján Sučan <sucanjan@gmail.com>
Sponsored by: Google LLC (Google Summer of Code 2019)
Differential Revision: https://reviews.freebsd.org/D21356


# fbbd9655 28-Feb-2017 Warner Losh <imp@FreeBSD.org>

Renumber copyright clause 4

Renumber cluase 4 to 3, per what everybody else did when BSD granted
them permission to remove clause 3. My insistance on keeping the same
numbering for legal reasons is too pedantic, so give up on that point.

Submitted by: Jan Schaumann <jschauma@stevens.edu>
Pull Request: https://github.com/freebsd/freebsd/pull/96


# 3c32812b 11-Mar-2016 Maxim Konovalov <maxim@FreeBSD.org>

o Xr icmp(4).


# 4323cae0 11-Mar-2016 Maxim Konovalov <maxim@FreeBSD.org>

o Document net.inet.icmp.maskfake and net.inet.icmp.tstamprepl sysctls.


# a7d5f7eb 19-Oct-2010 Jamie Gritton <jamie@FreeBSD.org>

A new jail(8) with a configuration file, to replace the work currently done
by /etc/rc.d/jail.


# fe0506d7 09-Mar-2010 Marcel Moolenaar <marcel@FreeBSD.org>

Create the altix project branch. The altix project will add support
for the SGI Altix 350 to FreeBSD/ia64. The hardware used for porting
is a two-module system, consisting of a base compute module and a
CPU expansion module. SGI's NUMAFlex architecture can be an excellent
platform to test CPU affinity and NUMA-aware features in FreeBSD.


# 7f220ecf 11-Jan-2009 Daniel Gerzo <danger@FreeBSD.org>

- improve readability

Reviewed by: trhodes, keramida
MFC after: 3 days


# 0c868e90 06-Jan-2009 Daniel Gerzo <danger@FreeBSD.org>

- rename the RETURN VALUES section to EXIT STATUS
- not bumping a date as this is not a real content change

Approved by: ru
MFC after: 3 days


# d7f03759 19-Oct-2008 Ulf Lilleengen <lulf@FreeBSD.org>

- Import the HEAD csup code which is the basis for the cvsmode work.


# d6cd1497 04-Apr-2006 Gleb Smirnoff <glebius@FreeBSD.org>

Add a new feature to ping(8) - possibility to specify maximum
wait time for a packet. This allows to:

- Count number of packets received before and after specified
time.
- Shorten time of execution of 'ping -c 1' scripts.

Submitted by: Lytochkin Boris <lytboris gmail.com>


# 4e9e907d 18-Nov-2005 Ruslan Ermilov <ru@FreeBSD.org>

-mdoc sweep.


# 9ff95228 15-Aug-2005 Gleb Smirnoff <glebius@FreeBSD.org>

Implement a new feature for ping(8) - sweeping pings. In a sweeping
ping ICMP payload of packets being sent is increased with given step.
Sweeping pings are useful for testing problematic channels, MTU
issues or traffic policing functions in networks.

PR: bin/82625
Submitted by: Chris Hellberg <chellberg juniper.net> (with some cleanups)


# 4c723140 09-Apr-2004 Mark Murray <markm@FreeBSD.org>

Remove advertising clause from University of California Regent's license,
per letter dated July 22, 1999.

Approved by: core, imp


# fe08efe6 08-Sep-2003 Ruslan Ermilov <ru@FreeBSD.org>

mdoc(7): Use the new feature of the .In macro.


# a70dc556 25-Jun-2003 Ruslan Ermilov <ru@FreeBSD.org>

The current recommended default time to live (TTL) for the Internet
Protocol (IP) is 64 [RFC791, RFC1122].

Prodded by: Igor Kucherenko <kivvy@sunbay.com>
Obtained from: http://www.iana.org/assignments/ip-parameters


# 2c56e246 02-Apr-2003 Matthew N. Dodd <mdodd@FreeBSD.org>

Back out support for RFC3514.

RFC3514 poses an unacceptale risk to compliant systems.


# 09139a45 01-Apr-2003 Matthew N. Dodd <mdodd@FreeBSD.org>

Implement support for RFC 3514 (The Security Flag in the IPv4 Header).
(See: ftp://ftp.rfc-editor.org/in-notes/rfc3514.txt)

This fulfills the host requirements for userland support by
way of the setsockopt() IP_EVIL_INTENT message.

There are three sysctl tunables provided to govern system behavior.

net.inet.ip.rfc3514:

Enables support for rfc3514. As this is an
Informational RFC and support is not yet widespread
this option is disabled by default.

net.inet.ip.hear_no_evil

If set the host will discard all received evil packets.

net.inet.ip.speak_no_evil

If set the host will discard all transmitted evil packets.

The IP statistics counter 'ips_evil' (available via 'netstat') provides
information on the number of 'evil' packets recieved.

For reference, the '-E' option to 'ping' has been provided to demonstrate
and test the implementation.


# 1bd10ba2 11-Mar-2003 Ruslan Ermilov <ru@FreeBSD.org>

Fix and sync SYNOPSIS and usage().

Prodded by: bde


# 1fb474d8 05-Mar-2003 Matthew N. Dodd <mdodd@FreeBSD.org>

Spelling, grammar fixes.


# 9b085129 05-Mar-2003 Matthew N. Dodd <mdodd@FreeBSD.org>

Remove documentation of old '-M' flag.
Re-order.


# eb1543c6 02-Mar-2003 Matthew N. Dodd <mdodd@FreeBSD.org>

Support ICMP_TSTAMP/ICMP_TSTAMPREPLY.

This alters the meaning of the '-M' flag.


# 1f6a4631 22-Feb-2003 Ruslan Ermilov <ru@FreeBSD.org>

Sort options.


# 143008a1 28-Jan-2003 Matthew N. Dodd <mdodd@FreeBSD.org>

Send ICMP_MASKREQ packets when the '-M' option is specified.


# fb7d32c7 23-Jan-2003 Maxim Konovalov <maxim@FreeBSD.org>

Better error handling for -s.

Submitted by: bde

Do not constantify maximum payload size. It is 65467 with -R
(record route), and 65507 without it.

Reviewed by: silence on -net
Proposed by: bde

I am going to MFC rev.1.77 - 1.81 ping.c and rev.1.39 and 1.40 ping.8:

MFC after: 6 months


# 0b2f8b3f 22-Jan-2003 Maxim Konovalov <maxim@FreeBSD.org>

Implement -D (do not fragment) and -z (TOS) options.

PR: bin/29164
Reviewed by: silence of -net
Obtained from: OpenBSD


# 57bd0fc6 26-Dec-2002 Jens Schweikhardt <schweikh@FreeBSD.org>

english(4) police.


# 074ad115 24-Dec-2002 Ruslan Ermilov <ru@FreeBSD.org>

Spelling: s/then/than/ where appropriate.


# 8025c44b 01-Oct-2002 Dima Dorfman <dd@FreeBSD.org>

Add an -o option to exit after receiving one reply. This can be used
to test whether a link is live.

PR: 38573
Submitted by: David Taylor <davidt@yadt.co.uk>
Obtained from: NetBSD


# e1205e80 06-Jul-2002 Philippe Charnier <charnier@FreeBSD.org>

The .Nm utility


# 605af08d 07-Feb-2002 Maxim Konovalov <maxim@FreeBSD.org>

Document ping(8) reaction to SIGINFO.

PR: doc/33639
Reviewed by: ru
Approved by: ru
MFC after: 1 week


# 25107197 25-Sep-2001 Ian Dowse <iedowse@FreeBSD.org>

The -A option (beep when packets are dropped) didn't work quite
right; after a single packet was dropped it beeped after every
transmission.

Change its implementation to only output a bell when there is an
increase in the maximum value of the number of packets that were
sent but not yet received. This has the benefit that even for very
long round-trip times, ping -A will do roughly the right thing
after a few inital false-positives.

Reviewed by: ru


# c4d9468e 07-Aug-2001 Ruslan Ermilov <ru@FreeBSD.org>

mdoc(7) police:

Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.


# 7ebcc426 15-Jul-2001 Dima Dorfman <dd@FreeBSD.org>

Remove whitespace at EOL.


# 9fe48c6e 10-Jul-2001 Ruslan Ermilov <ru@FreeBSD.org>

mdoc(7) police: removed HISTORY info from the .Os call.


# ca517ad8 24-May-2001 Poul-Henning Kamp <phk@FreeBSD.org>

Add a -A option to ping which beeps when packets are lost.

PR: 11818
Submitted by: Marc Evans marc@destek.net


# 211bfbd2 09-Mar-2001 Ruslan Ermilov <ru@FreeBSD.org>

Add new option -m which allows the user to set IP TTL.


# 1252c1bb 18-Dec-2000 Ruslan Ermilov <ru@FreeBSD.org>

Prepare for mdoc(7)NG.


# 7c7fb079 20-Nov-2000 Ruslan Ermilov <ru@FreeBSD.org>

mdoc(7) police: use the new features of the Nm macro.


# ef8f7ac9 01-Mar-2000 Sheldon Hearn <sheldonh@FreeBSD.org>

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.


# bf113f1b 20-Jan-2000 Bill Fumerola <billf@FreeBSD.org>

Brucify:
add an upper limit to -t
match the types of return values and the variables they are stuffed in
make the man page and usage() a little more consistantly ugly
less obfuscation.

Submitted by: adrian, billf


# 7237fd94 14-Jan-2000 Bill Fumerola <billf@FreeBSD.org>

Add '-t X' which times out after pinging for X seconds.

Submitted by: adrian


# 9a4365d0 05-Jan-2000 Yoshinobu Inoue <shin@FreeBSD.org>

libipsec and IPsec related apps. (and some KAME related man pages)

Reviewed by: freebsd-arch, cvs-committers
Obtained from: KAME project


# 7f3dea24 27-Aug-1999 Peter Wemm <peter@FreeBSD.org>

$Id$ -> $FreeBSD$


# 2faab3cd 19-Feb-1999 Warner Losh <imp@FreeBSD.org>

Finish documenting -S src-addr change.

Forgotten by: me
Forgotten for: Far Too Long
Gently Reminded by: Ruslan Ermilov <ru@ucb.crimea.ua>
Submitted by: Ruslan Ermilov <ru@ucb.crimea.ua>


# 99490ede 06-Jan-1999 Warner Losh <imp@FreeBSD.org>

Allow PINGing from any address on multihomed hosts

In the words of the submitter:
"The patch below allows to ping from any address on the multihomed host.
The man page is also updated, the text was cutted from traceroute(8)."

Submitted by: Ruslan Ermilov
PR: 6832


# 0ed77db8 29-Nov-1998 Bruce Evans <bde@FreeBSD.org>

Fixed non-use of .Nm and hard line breaks in rev.1.16-1.17:


# 0b0c1554 27-Aug-1998 Matthew Dillon <dillon@FreeBSD.org>

Updated manual page. Removed description of (now defunct) -c restrictions.


# 526f06b2 25-Aug-1998 Matthew Dillon <dillon@FreeBSD.org>

(well tested at BEST): -i option can now take FP values (e.g. -i 0.1),
extremely useful for networking testing. Other options secured from
user-level D.O.S. attacks. -f, -s now root-only. -i wait times < 1.0
root-only. -c count limited to 100 and defaults to 16 when ping run
by non-root user.


# e345a80d 15-Jul-1998 Philippe Charnier <charnier@FreeBSD.org>

Correct use of .Nm. Remove unused #includes. Use warn(). cosmetic in usage()
string.
Translate 0 sec 1000000 usec to 1 sec 0 usec.


# c03e877a 31-Mar-1998 Warner Losh <imp@FreeBSD.org>

A fairly rare possible buffer overflow:
Theo fixed this and tqbf reported it
Obtained from: OpenBSD


# 68085a0e 19-Mar-1998 Philippe Charnier <charnier@FreeBSD.org>

.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq.


# 3109a910 18-Jul-1997 Garrett Wollman <wollman@FreeBSD.org>

Calculate and print out the standard deviation of the round trip times.
This isn't necessarily the best statistic, but it is by far the easiest to
calculate. Update the man page to be more explicit about precisely which
statistics are printed out. Revert some of jmg's bogus man page changes from
rev 1.11.


# 25e43cba 01-Jul-1997 Bruce Evans <bde@FreeBSD.org>

Import Lite2's src/sbin, except for XNSrouted and routed. All relevant
files in src/sbin are off the vendor branch, so this doesn't change the
active versions.


# 50ceac88 02-Mar-1997 John-Mark Gurney <jmg@FreeBSD.org>

fix man page to use marcos instead of parens, quotes and braces

plus other minor fixes


# ee2bf734 02-Mar-1997 Warner Losh <imp@FreeBSD.org>

1) Minor nits in the usage message from bde. I took out the hard tabs and
used spaces to align the second line under the program name.
2) Cache uid after call to setuid(getuid()) so we don't waste a system call
for each packet with a call to getuid for the -v case.
3) Update manual to reflect new restriction on -l from last delta.

Suggested by: bde, Bill Fenner


# f78ac61b 01-Mar-1997 Warner Losh <imp@FreeBSD.org>

1) Fix usage to match convention and manual. Fix manual to match usage.
2) Must be root to run preload (OpenBSD ping.c 1.8)
3) Don't print all replies unless verbose and root (from idea in
OpenBSD ping.c 1.10 and 1.11) to avoid leaking information available
only to root.
4) Remove unused h: from option string to getopt.
5) Make the compiler happy with exit(0) (Lite-2?)

Reviewed by: Dan Cross <tenser@spitfire.ecsel.psu.edu>

Good candidate for 2.2 and 2.1 (as are many of the 1.17 changes).


# 43470e3b 01-Mar-1997 Garrett Wollman <wollman@FreeBSD.org>

Make ping -Wall clean (except for one warning).
Do a better job of argument parsing.
Don't permit ping -f to a multicast address (very antisocial).
Don't permit -L, -I, -T options with unicast addresses.
Ensure that we ask for only AF_INET addresses (should close PR#2584).
Return <sysexits.h> error codes for failures. Document this.
Fix man page to identify the author and put sections in correct order.


# c0ec1f37 22-Feb-1997 Peter Wemm <peter@FreeBSD.org>

Revert $FreeBSD$ to $Id$


# 772dfa72 07-Feb-1997 Daniel O'Callaghan <danny@FreeBSD.org>

Reviewed by: Gary Jennejohn <gj@freebsd.org>
Submitted by: Bruce Murphy <packrat@iinet.net.au>

Add '-a' audible flag, so terminal will beep upon receipt of a reply
packet. Useful for debugging ethernet runs, among other things.


# 1130b656 14-Jan-1997 Jordan K. Hubbard <jkh@FreeBSD.org>

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.


# 85456935 15-Dec-1996 Bill Fenner <fenner@FreeBSD.org>

Add multicast options -I (source interface), -T (set ttl), -L (no loopback).
They were all lowercase in the original, but our ping already uses -i and
-l so I made them all uppercase.

Obtained from: Multicast release 3.5


# e83201b4 05-Oct-1996 Wolfram Schneider <wosch@FreeBSD.org>

delete doubled words, e.g.: "the the" -> "the"


# ef9e6dc7 20-Aug-1996 Bill Fenner <fenner@FreeBSD.org>

Print out ICMP errors that are responses to our own packets by default.
Turn this behavior off using '-Q'. This makes '-v' useless other than as
an ICMP-sniffer, which tcpdump is better at anyway.

Print out another couple of ICMP messages, and fix the printing of the
original packet (mostly byte order problems).


# 8fae3551 26-May-1994 Rodney W. Grimes <rgrimes@FreeBSD.org>

BSD 4.4 Lite sbin Sources

Note: XNSrouted and routed NOT imported here, they shall be imported with
usr.sbin.