Subject: bin/12113: ping: -w function and doc mismatch
To: None <>
From: None <>
List: netbsd-bugs
Date: 02/02/2001 07:35:20
>Number:         12113
>Category:       bin
>Synopsis:       ping: -w function and doc mismatch
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Feb 02 07:38:00 PST 2001
>Originator:     Jim Bernard
>Release:        Feb. 2, 2001
System: NetBSD zoo 1.5R NetBSD 1.5R (ZOO-$Revision: 1.60 $) #0: Sat Jan 27 21:54:35 MST 2001 jim@zoo:/home/tmp/compile/sys/arch/i386/compile/ZOO i386
Architecture: i386
Machine: i386
	The man page says:

	  -w maxwait
		Specifies the number of seconds to wait for a response to a pack-
		et before transmitting the next one.  The default is 10.0.

	but the behavior is for ping to terminate after maxwait seconds.

	ping -w 3 your_favorite_host
	or examine ping.c

	I don't know which was the originally intended behavior, so it's not
	immediately clear whether the code or the documentation is in error.
	(Though it looks like the code was quite intentionally designed to
	do exactly what it does.)  This feature and its documentation were
	introduced in July, 1995 by ghudson (rev. 1.8 of ping.8, rev. 1.19
	of ping.c), so it might be worthwhile to ask him what was his
	intention.  I did notice on a Red Hat Linux system that uses a
	version of the same code (iputils-ss990107) that the man page had
	been changed to read:

	-w deadline
	      Specify a timeout, in seconds, before ping exits regardless of
	      how many packets have been sent or received.