Manual page fix: add cross references, refer to ``dumpdev'' variable in
"/etc/rc.conf". PR: 6117 Submitted by: Mark Mayo <mark@vmunix.com>
This commit is contained in:
parent
436c7212e6
commit
bb556bcf30
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=36365
@ -30,7 +30,7 @@
|
|||||||
.\" SUCH DAMAGE.
|
.\" SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.\" From: @(#)swapon.8 8.1 (Berkeley) 6/5/93
|
.\" From: @(#)swapon.8 8.1 (Berkeley) 6/5/93
|
||||||
.\" $Id$
|
.\" $Id: dumpon.8,v 1.5 1997/02/22 14:32:21 peter Exp $
|
||||||
.\"
|
.\"
|
||||||
.Dd May 12, 1995
|
.Dd May 12, 1995
|
||||||
.Dt DUMPON 8
|
.Dt DUMPON 8
|
||||||
@ -41,18 +41,26 @@
|
|||||||
.Sh SYNOPSIS
|
.Sh SYNOPSIS
|
||||||
.Nm dumpon
|
.Nm dumpon
|
||||||
.Op Fl v
|
.Op Fl v
|
||||||
.Ar special_file
|
.Ar swap_device
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
.Nm Dumpon
|
.Nm Dumpon
|
||||||
is used to specify a device where the kernel can save a crash dump in
|
is used to specify a device where the kernel can save a crash dump in
|
||||||
the case of a panic.
|
the case of a panic.
|
||||||
The system begins with no dump area configured for safety, unless a
|
.Pp
|
||||||
|
The system begins with no dump area configured for safety. If a
|
||||||
.Dq dumps on
|
.Dq dumps on
|
||||||
clause was specified in the input to
|
clause is specified in the kernel configuration file
|
||||||
.Xr config 8 .
|
or if the variable
|
||||||
|
.Dq Li dumpdev
|
||||||
|
in the boot time configuration file
|
||||||
|
.Pa /etc/rc.conf
|
||||||
|
names a dump device, future panics will cause the kernel
|
||||||
|
to save a crash dump on the specified dump device.
|
||||||
The dump device must be one of the swap areas
|
The dump device must be one of the swap areas
|
||||||
specified in the configuration file, and it must be at least the size
|
specified in the filesystem configuration file
|
||||||
of physical memory.
|
.Pa /etc/fstab ,
|
||||||
|
and it must be at least the size of physical memory.
|
||||||
|
.Pp
|
||||||
Calls to
|
Calls to
|
||||||
.Nm dumpon
|
.Nm dumpon
|
||||||
normally occur in the system multi-user initialization file
|
normally occur in the system multi-user initialization file
|
||||||
@ -65,6 +73,13 @@ The
|
|||||||
flag can be specified to cause the
|
flag can be specified to cause the
|
||||||
.Nm
|
.Nm
|
||||||
program to be verbose about its activity.
|
program to be verbose about its activity.
|
||||||
|
.Sh NOTES
|
||||||
|
.Pp
|
||||||
|
Hardcoding the dump device using the kernel configuration file
|
||||||
|
is only useful if a kernel crashes before reaching multi-user mode.
|
||||||
|
Otherwise, the use of
|
||||||
|
.Nm
|
||||||
|
to specify the dump device is recommended.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
@ -82,13 +97,22 @@ is the text string
|
|||||||
.Dq Li off .
|
.Dq Li off .
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr sysctl 3 ,
|
.Xr sysctl 3 ,
|
||||||
|
.Xr fstab 5 ,
|
||||||
|
.Xr rc.conf 5 ,
|
||||||
.Xr init 8 ,
|
.Xr init 8 ,
|
||||||
|
.Xr config 8 ,
|
||||||
.Xr rc 8 ,
|
.Xr rc 8 ,
|
||||||
.Xr savecore 8
|
.Xr savecore 8 ,
|
||||||
|
.Xr swapon 8 ,
|
||||||
|
.Xr panic 9
|
||||||
.Sh FILES
|
.Sh FILES
|
||||||
.Bl -tag -width /dev/[ws]d?b -compact
|
.Bl -tag -width /dev/[ws]d?b -compact
|
||||||
.It Pa /dev/[ws]d?b
|
.It Pa /dev/[ws]d?b
|
||||||
standard paging devices
|
standard swap areas
|
||||||
|
.It Pa /etc/fstab
|
||||||
|
static filesystem and swap information
|
||||||
|
.It Pa /etc/rc.conf
|
||||||
|
boot-time system configuration
|
||||||
.El
|
.El
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
Because the filesystem layer is already dead by the time a crash dump
|
Because the filesystem layer is already dead by the time a crash dump
|
||||||
|
Loading…
Reference in New Issue
Block a user