From 8340d5bcaef558c8068eea41fd0270b06b6e2e2f Mon Sep 17 00:00:00 2001 From: Hiten Pandya Date: Wed, 7 May 2003 19:37:51 +0000 Subject: [PATCH] Bring the dumpon(8) man page closer to reality: - dumpon utility has not used kern.dumpdev sysctl since rev. 1.14 (sbin/dumpon/dumpon.c) when phk@ updated it to use the DIOCSKERNELDUMP ioctl [1] - remove obsolete reference to sysctl(3) While I am there, fix two style nits: - use .Nm instead of `dumpon' - change NOTES to IMPLEMENTATION NOTES, to bring it in line with recommended section headings in mdoc(7) Original patch by: Martin Faxer [1] PR: docs/39293 Approved and Reviewed by: des (mentor), re (scottl, bmah) --- sbin/dumpon/dumpon.8 | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/sbin/dumpon/dumpon.8 b/sbin/dumpon/dumpon.8 index 8fd88c201006..0401112e7930 100644 --- a/sbin/dumpon/dumpon.8 +++ b/sbin/dumpon/dumpon.8 @@ -72,7 +72,7 @@ The flag causes .Nm to be verbose about its activity. -.Sh NOTES +.Sh IMPLEMENTATION NOTES Since a .Xr panic 9 condition may occur in a situation @@ -86,18 +86,23 @@ should be used as the dump device. .Pp The .Nm -utility operates by setting the -.Xr sysctl 3 -MIB variable -.Dq kern.dumpdev -to the device number of the designated +utility operates by opening .Ar special_file -or to -.Dv NODEV -(meaning that no dumps are to be taken) if +and making a +.Dv DIOCSKERNELDUMP +.Xr ioctl 2 +request on it to save kernel crash dumps. +If .Ar special_file is the text string: -.Dq Li off . +.Dq Li off , +.Nm +performs a +.Dv DIOCSKERNELDUMP +.Xr ioctl 2 +on +.Pa /dev/null +and thus instructs the kernel not to save crash dumps. .Pp Since .Nm @@ -108,7 +113,6 @@ variable of must be used to enable dumps for system panics which occur during kernel initialization. .Sh SEE ALSO -.Xr sysctl 3 , .Xr fstab 5 , .Xr rc.conf 5 , .Xr config 8 ,