From 380770fd3a6181d6c7f14b45cc1d622be4fdf168 Mon Sep 17 00:00:00 2001 From: hmp Date: Wed, 7 May 2003 19:37:51 +0000 Subject: 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(-) (limited to 'sbin/dumpon') diff --git a/sbin/dumpon/dumpon.8 b/sbin/dumpon/dumpon.8 index 8fd88c2..0401112 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 , -- cgit v1.1