crashinfo(8) [freebsd man page]

CRASHINFO(8)						    BSD System Manager's Manual 					      CRASHINFO(8)

NAME

     crashinfo -- analyze a core dump of the operating system

SYNOPSIS

     crashinfo [-d crashdir] [-n dumpnr] [-k kernel] [core]

DESCRIPTION

     The crashinfo utility analyzes a core dump saved by savecore(8).  It generates a text file containing the analysis in the same directory as
     the core dump.  For a given core dump file named vmcore.XX the generated text file will be named core.txt.XX.

     By default, crashinfo analyzes the most recent core dump in the core dump directory.  A specific core dump may be specified via either the
     core or dumpnr arguments.	Once crashinfo has located a core dump, it analyzes the core dump to determine the exact version of the kernel
     that generated the core.  It then looks for a matching kernel file under each of the subdirectories in /boot.  The location of the kernel
     file can also be explicitly provided via the kernel argument.

     Once crashinfo has located a core dump and kernel, it uses several utilities to analyze the core including dmesg(8), fstat(1), iostat(8),
     ipcs(1), kgdb(1), netstat(1), nfsstat(1), ps(1), pstat(8), and vmstat(8).

     The options are as follows:

     -d crashdir
	     Specify an alternate core dump directory.	The default crash dump directory is /var/crash.

     -n dumpnr
	     Use the core dump saved in vmcore.dumpnr instead of the latest core in the core dump directory.

     -k kernel
	     Specify an explicit kernel file.

SEE ALSO

     textdump(4), savecore(8)

HISTORY

     The crashinfo utility appeared in FreeBSD 6.4.

BSD
								   June 28, 2008							       BSD

savecore(8)						      System Manager's Manual						       savecore(8)

Name
       savecore - save a core dump of the operating system

Syntax
       /etc/savecore [ options ] dirname [ system ] [ corename ]

Description
       The  command  is  meant	to  be called near the end of the file.  The command saves the core dump of the system (assuming one was made) and
       writes a reboot message in the shutdown log.

       The command checks the core dump to be certain it corresponds with the current running ULTRIX.  If it does, it saves the core image in  the
       file  dirname/vmcore.n and saves the namelist in the file dirname/vmunix.n.  The trailing .n in the pathnames is replaced by a number which
       increments each time is run in that directory.

       After saving the core and namelist images, will save the error logger buffer into a predetermined file.	The error logger  buffer  contains
       information about why the crash occurred.  After completes, the daemon will extract the error logger file and translate its contents into a
       form familiar to the program.

       Before writes out a core image, it reads a number from the file dirname/minfree.  If there are fewer free blocks  on  the  filesystem  that
       contains  dirname  than the number obtained from the file, a core dump is not done.  If the file does not exist, savecore always writes out
       the core file (assuming that a core dump was taken).

       The command also writes a reboot message in the shut down log.  If the system crashed as a result of a panic, also records the panic string
       in the shut down log.

       For  partial  crash  dumps,  creates  a	sparse	core image file in dirname/vmcore.n.  If this sparse core image file is copied or moved to
       another location, the file expands to its true size which can take too much file system space.  Hence, to copy or move  sparse  core  image
       files, you must use the command. The command has a conversion option to create sparse output files.

Options
       -c   Clears  the core dump.  This option is useful when the core dump is corrupted in a way that will not allow to save it safely.  Use the
	    option with caution, because once it clears the core dump, the core dump cannot be retrieved.

       -d dumpdev dumplo
	    Specifies the dump device and the dump offset when running on a system image other than the currently running system image.  The  pro-
	    gram  assumes  that  the running system image is and it reads the dump device and dump device offset are different in the system image
	    that crashed, the option provides the correct dump device and dump device offset.

       -e   Saves only the error logger buffer into a file.  If used, core or namelist images are not saved.

       -f corename
	    Takes the i corefile name as the file from which to extract the the crash dump data instead of the default dump device.   This  option
	    is used only for diskless workstations.

       If  the	core  dump was from a system other than /vmunix, the name of that system must be supplied as system.  The program assumes that the
       running image is

       After successful completion, the core dump is cleared.  Also, a message is written in the file which tells whether the  dump  succeeded	or
       failed.

Files
       Shut down log

       Current running ULTRIX system

See Also
       dd(1), uerf(8)

																       savecore(8)