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)
This commit is contained in:
parent
924a7003b0
commit
8340d5bcae
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=114811
@ -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 ,
|
||||
|
Loading…
Reference in New Issue
Block a user