diff options
author | hmp <hmp@FreeBSD.org> | 2003-05-07 19:37:51 +0000 |
---|---|---|
committer | hmp <hmp@FreeBSD.org> | 2003-05-07 19:37:51 +0000 |
commit | 380770fd3a6181d6c7f14b45cc1d622be4fdf168 (patch) | |
tree | 0bb5ccacae052ef277bde647d54915186bfd380f | |
parent | 2e1c393dfc9eb11b05e093718baa11cd6a695a7d (diff) | |
download | FreeBSD-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)
-rw-r--r-- | sbin/dumpon/dumpon.8 | 26 |
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 , |