Bug 39293

Summary: the dumpon man page incorrectly states that sysctl(3) is used
Product: Documentation Reporter: Martin Faxer <gmh003532>
Component: Books & ArticlesAssignee: Hiten Pandya <hmp>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
dumpon.diff none

Description Martin Faxer 2002-06-14 13:20:01 UTC
the dumpon(8) man page states that dumpon uses sysctl(3) to set the
dump device.  this is however incorrect, as can be proved by reading
the code.  the reality is that ioctl() is used on the opened special
device.

Fix: apply the following patch:
	
How-To-Repeat: read the dumpon(8) man page
Comment 1 Hiten Pandya 2002-06-15 10:50:08 UTC
Hi.

As far as I know, and my research goes, this change should only be 
applied to CURRENT, but NOT to be MFC'ed.  This is because, if you:

  o look into the dumpon source code, you will see that this
    change, coined as "New dumping infrastructure" was implemented
    in revision 1.14, BRANCH: MAIN by the great phk.

  o The RELENG_4, and RELENG_4_5, AND RELENG_4_6 are still using
    the sysctl(3) infrastructure; because as far as my knowledge
    goes, the new DUMPING ioctl's are only available in -current
    thus made use by -current only.

I hope this helps to clear my point.
Thanks.

-- 
Hiten Pandya
http://storm.uk.FreeBSD.org/~hiten
Finger hiten@storm.uk.FreeBSD.org for PGP public key
-- 4FB9 C4A9 4925 CF97 9BF3  ADDA 861D 5DBD E4E3 03C3
Comment 2 Hiten Pandya freebsd_committer freebsd_triage 2003-05-07 17:11:30 UTC
Responsible Changed
From-To: freebsd-doc->hmp

You are right, the dumpon(8) manual page is 
not documenting the new behaviour.  I will 
take care of this.  For the record, this PR is 
regarding rev 1.14 of sbin/dumpon/dumpon.c
Comment 3 Hiten Pandya freebsd_committer freebsd_triage 2003-05-07 20:42:02 UTC
State Changed
From-To: open->closed

I have commited a slighly different fix derived from 
the patch available in this PR.  Thanks Martin!