From owner-freebsd-doc Fri Jun 14 5:20:18 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id D09B137B414 for ; Fri, 14 Jun 2002 05:20:01 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g5ECK1J57548; Fri, 14 Jun 2002 05:20:01 -0700 (PDT) (envelope-from gnats) Received: from lockdown.spectrum.fearmuffs.net (c164-147.pro.thalamus.se [212.31.164.147]) by hub.freebsd.org (Postfix) with ESMTP id 7F5D537B411 for ; Fri, 14 Jun 2002 05:17:10 -0700 (PDT) Received: from lockdown.spectrum.fearmuffs.net (localhost.spectrum.fearmuffs.net [127.0.0.1]) by lockdown.spectrum.fearmuffs.net (8.12.3/8.12.3) with ESMTP id g5ECGWdu000402 for ; Fri, 14 Jun 2002 14:16:32 +0200 (CEST) (envelope-from redpixel@lockdown.spectrum.fearmuffs.net) Received: (from redpixel@localhost) by lockdown.spectrum.fearmuffs.net (8.12.3/8.12.3/Submit) id g5ECGVlU000401; Fri, 14 Jun 2002 14:16:31 +0200 (CEST) (envelope-from redpixel) Message-Id: <200206141216.g5ECGVlU000401@lockdown.spectrum.fearmuffs.net> Date: Fri, 14 Jun 2002 14:16:31 +0200 (CEST) From: Martin Faxer Reply-To: Martin Faxer To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/39293: the dumpon man page incorrectly states that sysctl(3) is used Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >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