summaryrefslogtreecommitdiffstats
path: root/sbin/dumpon
diff options
context:
space:
mode:
authorjkoshy <jkoshy@FreeBSD.org>1998-05-25 08:54:40 +0000
committerjkoshy <jkoshy@FreeBSD.org>1998-05-25 08:54:40 +0000
commite163105395bbfc361c7a84836c6912877f8d088f (patch)
tree8fb6912439f85d109d86c5af6725e89d1936255a /sbin/dumpon
parent33ee3bc8fe78993299dd272d53460fed02ac7b91 (diff)
downloadFreeBSD-src-e163105395bbfc361c7a84836c6912877f8d088f.zip
FreeBSD-src-e163105395bbfc361c7a84836c6912877f8d088f.tar.gz
Manual page fix: add cross references, refer to ``dumpdev'' variable in
"/etc/rc.conf". PR: 6117 Submitted by: Mark Mayo <mark@vmunix.com>
Diffstat (limited to 'sbin/dumpon')
-rw-r--r--sbin/dumpon/dumpon.842
1 files changed, 33 insertions, 9 deletions
diff --git a/sbin/dumpon/dumpon.8 b/sbin/dumpon/dumpon.8
index 2850b43..296e92e 100644
--- a/sbin/dumpon/dumpon.8
+++ b/sbin/dumpon/dumpon.8
@@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" 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
.Dt DUMPON 8
@@ -41,18 +41,26 @@
.Sh SYNOPSIS
.Nm dumpon
.Op Fl v
-.Ar special_file
+.Ar swap_device
.Sh DESCRIPTION
.Nm Dumpon
is used to specify a device where the kernel can save a crash dump in
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
-clause was specified in the input to
-.Xr config 8 .
+clause is specified in the kernel configuration file
+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
-specified in the configuration file, and it must be at least the size
-of physical memory.
+specified in the filesystem configuration file
+.Pa /etc/fstab ,
+and it must be at least the size of physical memory.
+.Pp
Calls to
.Nm dumpon
normally occur in the system multi-user initialization file
@@ -65,6 +73,13 @@ The
flag can be specified to cause the
.Nm
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
The
.Nm
@@ -82,13 +97,22 @@ is the text string
.Dq Li off .
.Sh SEE ALSO
.Xr sysctl 3 ,
+.Xr fstab 5 ,
+.Xr rc.conf 5 ,
.Xr init 8 ,
+.Xr config 8 ,
.Xr rc 8 ,
-.Xr savecore 8
+.Xr savecore 8 ,
+.Xr swapon 8 ,
+.Xr panic 9
.Sh FILES
.Bl -tag -width /dev/[ws]d?b -compact
.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
.Sh BUGS
Because the filesystem layer is already dead by the time a crash dump
OpenPOWER on IntegriCloud