Date: Fri, 14 Jun 2002 14:16:31 +0200 (CEST) From: Martin Faxer <gmh003532@brfmasthugget.se> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/39293: the dumpon man page incorrectly states that sysctl(3) is used Message-ID: <200206141216.g5ECGVlU000401@lockdown.spectrum.fearmuffs.net>
next in thread | raw e-mail | index | archive | help
>Number: 39293 >Category: docs >Synopsis: the dumpon man page incorrectly states that sysctl(3) is used >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Fri Jun 14 05:20:01 PDT 2002 >Closed-Date: >Last-Modified: >Originator: Martin Faxer >Release: FreeBSD 5.0-CURRENT i386 >Organization: none >Environment: System: FreeBSD lockdown.spectrum.fearmuffs.net 5.0-CURRENT FreeBSD 5.0-CURRENT #11: Fri Jun 14 14:02:42 CEST 2002 redpixel@lockdown.spectrum.fearmuffs.net:/usr/obj/usr/src/sys/LOCKDOWN i386 >Description: 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. >How-To-Repeat: read the dumpon(8) man page >Fix: apply the following patch: --- dumpon.diff begins here --- Index: dumpon.8 =================================================================== RCS file: /home/ncvs/src/sbin/dumpon/dumpon.8,v retrieving revision 1.23 diff -u -r1.23 dumpon.8 --- dumpon.8 9 Apr 2002 19:51:50 -0000 1.23 +++ dumpon.8 14 Jun 2002 12:03:58 -0000 @@ -81,18 +81,20 @@ .Pp The .Nm -program operates by setting the -.Xr sysctl 3 -MIB variable -.Dq kern.dumpdev -to the device number of the designated +program operates by opening the designated .Ar special_file -or to -.Dv NODEV -(meaning that no dumps are to be taken) if +and doing an +.Xr ioctl 2 +request, +.Dv DIOCSKERNELDUMP , +telling the kernel to use that device for saving dumps. +If .Ar special_file is the text string: -.Dq Li off . +.Dq Li off , +dumpon opens +.Pa /dev/null , +telling the kernel not to save crash dumps. .Pp Since .Nm --- dumpon.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200206141216.g5ECGVlU000401>