d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Manual page fix: add cross references, refer to ``dumpdev'' variable in

Browse Source 
"/etc/rc.conf".

PR: 6117
Submitted by: Mark Mayo <mark@vmunix.com>
This commit is contained in:
Joseph Koshy 1998-05-25 08:54:40 +00:00
parent 436c7212e6
commit bb556bcf30
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=36365
1 changed files with 33 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
sbin/dumpon/dumpon.8
View File

@ -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