kdumpctl - Man Page

control interface for kdump

Synopsis

kdumpctl COMMAND

Description

kdumpctl is used to check or control the kdump service. In most cases, you should use systemctl to start / stop / enable kdump service instead. However, kdumpctl provides more details for debug and a helper to setup ssh key authentication.

Commands

start

Start the service.

stop

Stop the service.

status

Prints the current status of kdump service. It returns non-zero value if kdump is not operational.

restart

Is equal to start; stop

reload

reload crash kernel image and initramfs without triggering a rebuild.

rebuild

rebuild the crash kernel initramfs.

propagate

Helps to setup key authentication for ssh storage since it's impossible to use password authentication during kdump.

showmem

Prints the size of reserved memory for crash kernel in megabytes.

estimate

Estimate a suitable crashkernel value for current machine. This is a best-effort estimate. It will print a recommanded crashkernel value based on current kdump setup, and list some details of memory usage.

reset-crashkernel [--kernel=path_to_kernel] [--reboot]

Reset crashkernel to default value recommended by kexec-tools. If no kernel is specified, will reset KDUMP_KERNELVER if it's defined in /etc/sysconfig/kdump or current running kernel's crashkernel value if KDUMP_KERNELVER is empty. You can also specify --kernel=ALL and --kernel=DEFAULT which have the same meaning as grubby's kernel-path=ALL and kernel-path=DEFAULT. ppc64le supports FADump and supports an additonal [--fadump=[on|off|nocma]] parameter to toggle FADump on/off.

Note: The memory requirements for kdump varies heavily depending on the used hardware and system configuration. Thus the recommended crashkernel might not work for your specific setup. Please test if kdump works after resetting the crashkernel value.

See Also

kdump.conf(5), mkdumprd(8)

Referenced By

kdumpctl_selinux(8).

2015-07-13 kexec-tools