Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Include clues on what to do with the crash dump once you've got it

This commit is contained in:
sommerfeld 1999-11-20 19:57:01 +00:00
parent 1760a4ef69
commit 3a73fcfff7
1 changed files with 48 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
sbin/savecore/savecore.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: savecore.8,v 1.14 1999/09/17 10:20:01 is Exp $
.\" $NetBSD: savecore.8,v 1.15 1999/11/20 19:57:01 sommerfeld Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -47,12 +47,48 @@
.Op Fl N Ar system
.Ar directory
.Sh DESCRIPTION
When the
.Nx
kernel encounters a fatal error, the
.Xr panic 9
routine arranges for a snapshot of the contents of physical memory to
be written into a dump area, typically in the swap partition.
.Pp
Upon a subsequent reboot,
.Nm
copies the currently running kernel and its associated core dump into
is typically run out of
.Xr rc 8 ,
before swapping is enabled, to copy the kernel and the saved memory image
into
.Fa directory ,
and enters a reboot message and information about the core dump into
the system log.
.Pp
The kernel and core file can then be analyzed using various tools,
including
.Xr dmesg 8 ,
.Xr fstat 1 ,
.Xr gdb 1 ,
.Xr iostat 8 ,
.Xr netstat 1 ,
.Xr ps 1 ,
and
.Xr pstat 8 ,
to attempt to deduce the cause of the crash.
.Pp
Crashes are usually the result of kernel bugs; if this is suspected, a
full bug report should be filed using
.Xr send-pr 8 ,
containing as much information as possible about the circumstances of
the crash. Since crash dumps are typically very large and may contain
whatever (potentially confidential) information was in memory at the
time of the crash, do
.Em NOT
include a copy of the crash dump file in the bug report; instead, save it
somewhere in the event that a
.Nx
developer wants to examine it.
.Pp
The options are as follows:
.Bl -tag -width directory
.It Fl c
@ -124,6 +160,16 @@ current kernel
The minfree code does not consider the effect of compression.
.Sh SEE ALSO
.Xr compress 1 ,
.Xr dmesg 8 ,
.Xr fstat 1 ,
.Xr gdb 1 ,
.Xr iostat 8 ,
.Xr netstat 1 ,
.Xr ps 1 ,
.Xr pstat 8 ,
.Xr panic 9 ,
.Xr rc 8 ,
.Xr send-pr 1 ,
.Xr syslogd 8
.Sh HISTORY
The