History log of /freebsd-10.1-release/sbin/ping/ping.8
Revision Date Author Comments
(<<< Hide modified files)
(Show modified files >>>)
# 272461 02-Oct-2014 gjb

Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

# 256281 10-Oct-2013 gjb

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation


# 187067 11-Jan-2009 danger

- improve readability

Reviewed by: trhodes, keramida
MFC after: 3 days


# 186843 06-Jan-2009 danger

- 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


# 157535 05-Apr-2006 glebius

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>


# 152568 18-Nov-2005 ru

-mdoc sweep.


# 149086 15-Aug-2005 glebius

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)


# 128073 09-Apr-2004 markm

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

Approved by: core, imp


# 119893 08-Sep-2003 ru

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


# 116806 25-Jun-2003 ru

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


# 112985 02-Apr-2003 mdodd

Back out support for RFC3514.

RFC3514 poses an unacceptale risk to compliant systems.


# 112929 01-Apr-2003 mdodd

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.


# 112110 11-Mar-2003 ru

Fix and sync SYNOPSIS and usage().

Prodded by: bde


# 111930 05-Mar-2003 mdodd

Spelling, grammar fixes.


# 111927 05-Mar-2003 mdodd

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


# 111765 02-Mar-2003 mdodd

Support ICMP_TSTAMP/ICMP_TSTAMPREPLY.

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


# 111287 22-Feb-2003 ru

Sort options.


# 110009 28-Jan-2003 mdodd

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


# 109734 23-Jan-2003 maxim

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


# 109731 23-Jan-2003 maxim

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

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


# 108317 27-Dec-2002 schweikh

english(4) police.


# 108260 24-Dec-2002 ru

Spelling: s/then/than/ where appropriate.


# 104339 02-Oct-2002 dd

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


# 99501 06-Jul-2002 charnier

The .Nm utility


# 90351 07-Feb-2002 maxim

Document ping(8) reaction to SIGINFO.

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


# 83940 25-Sep-2001 iedowse

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


# 81251 07-Aug-2001 ru

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.


# 79754 15-Jul-2001 dd

Remove whitespace at EOL.


# 79530 10-Jul-2001 ru

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


# 77119 24-May-2001 phk

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

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


# 74029 09-Mar-2001 ru

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


# 70152 18-Dec-2000 ru

Prepare for mdoc(7)NG.


# 68960 20-Nov-2000 ru

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


# 57668 01-Mar-2000 sheldonh

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.


# 56342 20-Jan-2000 billf

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


# 55996 14-Jan-2000 billf

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

Submitted by: adrian


# 55505 06-Jan-2000 shin

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

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


# 50476 27-Aug-1999 peter

$Id$ -> $FreeBSD$


# 44138 19-Feb-1999 imp

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>


# 42337 06-Jan-1999 imp

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


# 41409 29-Nov-1998 bde

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


# 38588 27-Aug-1998 dillon

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


# 38549 25-Aug-1998 dillon

(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.


# 37671 15-Jul-1998 charnier

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


# 34976 31-Mar-1998 imp

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


# 34673 19-Mar-1998 charnier

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


# 27508 18-Jul-1997 wollman

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.


# 23304 02-Mar-1997 jmg

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

plus other minor fixes


# 23295 02-Mar-1997 imp

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


# 23251 02-Mar-1997 imp

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).


# 23247 01-Mar-1997 wollman

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.


# 22990 22-Feb-1997 peter

Revert $FreeBSD$ to $Id$


# 22417 07-Feb-1997 danny

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.


# 21673 14-Jan-1997 jkh

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.


# 20540 15-Dec-1996 fenner

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


# 18718 05-Oct-1996 wosch

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


# 17724 20-Aug-1996 fenner

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).


# 1559 26-May-1994 rgrimes

This commit was generated by cvs2svn to compensate for changes in r1558,
which included commits to RCS files with non-trunk default branches.


# 1558 26-May-1994 rgrimes

BSD 4.4 Lite sbin Sources

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