2020-10-15 12:45:57 +00:00
|
|
|
.TH KDUMPCTL 8 2015-07-13 kexec-tools
|
|
|
|
|
|
|
|
|
|
.SH NAME
|
|
|
|
|
kdumpctl \- control interface for kdump
|
|
|
|
|
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B kdumpctl
|
|
|
|
|
.I COMMAND
|
|
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.B kdumpctl
|
|
|
|
|
is used to check or control the kdump service.
|
|
|
|
|
In most cases, you should use
|
|
|
|
|
.B systemctl
|
|
|
|
|
to start / stop / enable kdump service instead. However,
|
|
|
|
|
.B kdumpctl
|
2022-05-11 02:27:42 +00:00
|
|
|
provides more details for debugging and a helper to set up ssh key authentication.
|
2020-10-15 12:45:57 +00:00
|
|
|
|
|
|
|
|
.SH COMMANDS
|
|
|
|
|
.TP
|
|
|
|
|
.I start
|
|
|
|
|
Start the service.
|
|
|
|
|
.TP
|
|
|
|
|
.I stop
|
|
|
|
|
Stop the service.
|
|
|
|
|
.TP
|
|
|
|
|
.I status
|
|
|
|
|
Prints the current status of kdump service.
|
2022-05-11 02:27:42 +00:00
|
|
|
It returns a non-zero value if kdump is not operational.
|
2020-10-15 12:45:57 +00:00
|
|
|
.TP
|
|
|
|
|
.I restart
|
|
|
|
|
Is equal to
|
|
|
|
|
.I start; stop
|
|
|
|
|
.TP
|
|
|
|
|
.I reload
|
2022-05-11 02:27:42 +00:00
|
|
|
reload the crash kernel image and initramfs without triggering a rebuild.
|
2020-10-15 12:45:57 +00:00
|
|
|
.TP
|
|
|
|
|
.I rebuild
|
|
|
|
|
rebuild the crash kernel initramfs.
|
|
|
|
|
.TP
|
|
|
|
|
.I propagate
|
|
|
|
|
Helps to setup key authentication for ssh storage since it's
|
|
|
|
|
impossible to use password authentication during kdump.
|
|
|
|
|
.TP
|
|
|
|
|
.I showmem
|
2022-05-11 02:27:42 +00:00
|
|
|
Prints the size of reserved memory for the crash kernel in megabytes.
|
2021-04-21 19:27:10 +00:00
|
|
|
.TP
|
|
|
|
|
.I estimate
|
2022-05-11 02:27:42 +00:00
|
|
|
Estimate a suitable crashkernel value for the current machine. This is a
|
|
|
|
|
best-effort estimate. It will print a recommended crashkernel value
|
|
|
|
|
based on the current kdump setup, and list some details of memory usage.
|
|
|
|
|
.TP
|
|
|
|
|
.I get-default-crashkernel
|
|
|
|
|
Return the default crashkernel value provided by kexec-tools.
|
2021-06-10 05:06:22 +00:00
|
|
|
.TP
|
2022-01-05 03:53:09 +00:00
|
|
|
.I 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
|
2022-05-11 02:27:42 +00:00
|
|
|
or the current running kernel's crashkernel value if KDUMP_KERNELVER is empty. You can
|
2022-01-05 03:53:09 +00:00
|
|
|
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
|
2022-05-11 02:27:42 +00:00
|
|
|
supports an additional [--fadump=[on|off|nocma]] parameter to toggle FADump
|
2022-01-05 03:53:09 +00:00
|
|
|
on/off.
|
2021-06-10 05:06:22 +00:00
|
|
|
|
2022-01-05 03:53:09 +00:00
|
|
|
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.
|
2020-10-15 12:45:57 +00:00
|
|
|
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.BR kdump.conf (5),
|
|
|
|
|
.BR mkdumprd (8)
|
