summaryrefslogtreecommitdiffstats
path: root/sbin/dumpon
diff options
context:
space:
mode:
authorhmp <hmp@FreeBSD.org>2003-05-07 19:37:51 +0000
committerhmp <hmp@FreeBSD.org>2003-05-07 19:37:51 +0000
commit380770fd3a6181d6c7f14b45cc1d622be4fdf168 (patch)
tree0bb5ccacae052ef277bde647d54915186bfd380f /sbin/dumpon
parent2e1c393dfc9eb11b05e093718baa11cd6a695a7d (diff)
downloadFreeBSD-src-380770fd3a6181d6c7f14b45cc1d622be4fdf168.zip
FreeBSD-src-380770fd3a6181d6c7f14b45cc1d622be4fdf168.tar.gz
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 <gmh003532brfmasthugget.se> [1] PR: docs/39293 Approved and Reviewed by: des (mentor), re (scottl, bmah)
Diffstat (limited to 'sbin/dumpon')
-rw-r--r--sbin/dumpon/dumpon.826
1 files changed, 15 insertions, 11 deletions
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 ,
OpenPOWER on IntegriCloud