mirror of
https://github.com/opnsense/src.git
synced 2026-05-28 04:12:45 -04:00
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
1 changed files with 15 additions and 11 deletions
|
|
@ -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 a new issue