kdumpctl(1)

KDUMPCTL(1)

User Commands

KDUMPCTL(1)

NAME

kdumpctl - List or debug kdumps

SYNOPSIS

kdumpctl [OPTIONS...] COMMAND [MATCHES...]

DESCRIPTION

kdumpctl is a tool to list or debug kernel dump (kdump) files. It provides commands to list available kdumps, display dmesg logs for specific kdumps, and start a debugger for analyzing kdumps. The tool is inspired by coredumpctl(1).

COMMANDS

The following commands are understood:

list [MATCHES...]: List available kdumps. This is the default command if no other command is specified.
dmesg [MATCHES...]: Show dmesg(1) logs for matching kdumps.
debug [MATCHES...]: Start crash(8) debugger for matching kdumps.

OPTIONS

-h, --help: Show the help message and exit.
-r, --reverse: Show the newest entries first.

USAGE

List kdumps:

kdumpctl list

This command lists all available kdumps.

List kdumps with a specific match:

kdumpctl list 202306

This command lists kdumps that match the specified pattern (e.g., `202306').

Show dmesg for a specific kdump:

kdumpctl dmesg 20230615

This command shows the dmesg log for the kdump that matches the specified pattern (e.g., `20230615').

Debug a specific kdump:

kdumpctl debug 20230615

This command starts a debugger for the kdump that matches the specified pattern (e.g., `20230615').

EXIT STATUS

The kdumpctl utility exits with the following values: 0: on success, >0: if an error occurred.

FILES

/var/crash: Directory where kdump files are stored.

COPYRIGHT

This tool is distributed under the GPL-2.0-or-later license.