|
 |
5cf148 |
.TH KDUMPCTL 8 2015-07-13 kexec-tools
|
|
|
5cf148 |
|
|
|
5cf148 |
.SH NAME
|
|
|
5cf148 |
kdumpctl \- control interface for kdump
|
|
|
5cf148 |
|
|
|
5cf148 |
.SH SYNOPSIS
|
|
|
5cf148 |
.B kdumpctl
|
|
|
5cf148 |
.I COMMAND
|
|
|
5cf148 |
|
|
|
5cf148 |
.SH DESCRIPTION
|
|
|
5cf148 |
.B kdumpctl
|
|
|
5cf148 |
is used to check or control the kdump service.
|
|
|
5cf148 |
In most cases, you should use
|
|
|
5cf148 |
.B systemctl
|
|
|
5cf148 |
to start / stop / enable kdump service instead. However,
|
|
|
5cf148 |
.B kdumpctl
|
|
|
5a6191 |
provides more details for debugging and a helper to set up ssh key authentication.
|
|
|
5cf148 |
|
|
|
5cf148 |
.SH COMMANDS
|
|
|
5cf148 |
.TP
|
|
|
5cf148 |
.I start
|
|
|
5cf148 |
Start the service.
|
|
|
5cf148 |
.TP
|
|
|
5cf148 |
.I stop
|
|
|
5cf148 |
Stop the service.
|
|
|
5cf148 |
.TP
|
|
|
5cf148 |
.I status
|
|
|
5cf148 |
Prints the current status of kdump service.
|
|
|
5a6191 |
It returns a non-zero value if kdump is not operational.
|
|
|
5cf148 |
.TP
|
|
|
5cf148 |
.I restart
|
|
|
5cf148 |
Is equal to
|
|
|
5cf148 |
.I start; stop
|
|
|
5cf148 |
.TP
|
|
|
5cf148 |
.I reload
|
|
|
5a6191 |
reload the crash kernel image and initramfs without triggering a rebuild.
|
|
|
5cf148 |
.TP
|
|
|
5cf148 |
.I rebuild
|
|
|
5cf148 |
rebuild the crash kernel initramfs.
|
|
|
5cf148 |
.TP
|
|
|
5cf148 |
.I propagate
|
|
|
5cf148 |
Helps to setup key authentication for ssh storage since it's
|
|
|
5cf148 |
impossible to use password authentication during kdump.
|
|
|
5cf148 |
.TP
|
|
|
5cf148 |
.I showmem
|
|
|
5a6191 |
Prints the size of reserved memory for the crash kernel in megabytes.
|
|
|
5cf148 |
.TP
|
|
|
5cf148 |
.I estimate
|
|
|
5a6191 |
Estimate a suitable crashkernel value for the current machine. This is a
|
|
|
5a6191 |
best-effort estimate. It will print a recommended crashkernel value
|
|
|
5a6191 |
based on the current kdump setup, and list some details of memory usage.
|
|
|
5a6191 |
.TP
|
|
|
5a6191 |
.I get-default-crashkernel
|
|
|
5a6191 |
Return the default crashkernel value provided by kexec-tools.
|
|
|
5cf148 |
.TP
|
|
|
5cf148 |
.I reset-crashkernel [--kernel=path_to_kernel] [--reboot]
|
|
|
5cf148 |
Reset crashkernel to default value recommended by kexec-tools. If no kernel
|
|
|
5cf148 |
is specified, will reset KDUMP_KERNELVER if it's defined in /etc/sysconfig/kdump
|
|
|
5a6191 |
or the current running kernel's crashkernel value if KDUMP_KERNELVER is empty. You can
|
|
|
5cf148 |
also specify --kernel=ALL and --kernel=DEFAULT which have the same meaning as
|
|
|
5cf148 |
grubby's kernel-path=ALL and kernel-path=DEFAULT. ppc64le supports FADump and
|
|
|
5a6191 |
supports an additional [--fadump=[on|off|nocma]] parameter to toggle FADump
|
|
|
5cf148 |
on/off.
|
|
|
5cf148 |
|
|
|
5cf148 |
Note: The memory requirements for kdump varies heavily depending on the
|
|
|
5cf148 |
used hardware and system configuration. Thus the recommended
|
|
|
5cf148 |
crashkernel might not work for your specific setup. Please test if
|
|
|
5cf148 |
kdump works after resetting the crashkernel value.
|
|
|
5cf148 |
|
|
|
5cf148 |
.SH "SEE ALSO"
|
|
|
5cf148 |
.BR kdump.conf (5),
|
|
|
5cf148 |
.BR mkdumprd (8)
|