crashinfo(8)

crashinfo8

Analyze a core dump of the operating system

Usage

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

Overview

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) (ports/devel/gdb), netstat(1), nfsstat(1), ps(1), pstat(8), and vmstat(8). Note that kgdb must be installed from the devel/gdb port or gdb package.

The options are as follows:

-b

Run in batch mode. Write most messages to the core.txt.XX file instead of the terminal. This flag is used when crashinfo is run during boot.

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

Releases

44 releases since FreeBSD 6.4-RELEASE; the text changed 31 times.

  1. 6.4
  2. 7.1
  3. 7.2
  4. 7.3
  5. 7.4
  6. 8.0
  7. 8.1
  8. 8.2
  9. 8.3
  10. 8.4
  11. 9.0
  12. 9.1
  13. 9.2
  14. 9.3
  15. 10.0
  16. 10.1
  17. 10.2
  18. 10.3
  19. 10.4
  20. 11.0
  21. 11.1
  22. 11.2
  23. 11.3
  24. 11.4
  25. 12.0
  26. 12.1
  27. 12.2
  28. 12.3
  29. 12.4
  30. 13.0–13.2
  31. 13.3–13.5
  32. 14.0–16.0

-b since FreeBSD 12.0-RELEASE.

History

The crashinfo utility appeared in FreeBSD 6.4.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.