Petr Šabata f5bf49
.TH KDUMPCTL 8 2015-07-13 kexec-tools
Petr Šabata f5bf49
Petr Šabata f5bf49
.SH NAME
Petr Šabata f5bf49
kdumpctl \- control interface for kdump
Petr Šabata f5bf49
Petr Šabata f5bf49
.SH SYNOPSIS
Petr Šabata f5bf49
.B kdumpctl
Petr Šabata f5bf49
.I COMMAND
Petr Šabata f5bf49
Petr Šabata f5bf49
.SH DESCRIPTION
Petr Šabata f5bf49
.B kdumpctl
Petr Šabata f5bf49
is used to check or control the kdump service.
Petr Šabata f5bf49
In most cases, you should use
Petr Šabata f5bf49
.B systemctl
Petr Šabata f5bf49
to start / stop / enable kdump service instead. However,
Petr Šabata f5bf49
.B kdumpctl
Petr Šabata f5bf49
provides more details for debug and a helper to setup ssh key authentication.
Petr Šabata f5bf49
Petr Šabata f5bf49
.SH COMMANDS
Petr Šabata f5bf49
.TP
Petr Šabata f5bf49
.I start
Petr Šabata f5bf49
Start the service.
Petr Šabata f5bf49
.TP
Petr Šabata f5bf49
.I stop
Petr Šabata f5bf49
Stop the service.
Petr Šabata f5bf49
.TP
Petr Šabata f5bf49
.I status
Petr Šabata f5bf49
Prints the current status of kdump service.
Petr Šabata f5bf49
It returns non-zero value if kdump is not operational.
Petr Šabata f5bf49
.TP
Petr Šabata f5bf49
.I restart
Petr Šabata f5bf49
Is equal to
Petr Šabata f5bf49
.I start; stop
Petr Šabata f5bf49
.TP
Petr Šabata f5bf49
.I reload
Petr Šabata f5bf49
reload crash kernel image and initramfs without triggering a rebuild.
Petr Šabata f5bf49
.TP
Petr Šabata f5bf49
.I rebuild
Petr Šabata f5bf49
rebuild the crash kernel initramfs.
Petr Šabata f5bf49
.TP
Petr Šabata f5bf49
.I propagate
Petr Šabata f5bf49
Helps to setup key authentication for ssh storage since it's
Petr Šabata f5bf49
impossible to use password authentication during kdump.
Petr Šabata f5bf49
.TP
Petr Šabata f5bf49
.I showmem
Petr Šabata f5bf49
Prints the size of reserved memory for crash kernel in megabytes.
Kairui Song a9fda5
.TP
Kairui Song a9fda5
.I estimate
Kairui Song a9fda5
Estimate a suitable crashkernel value for current machine. This is a
Kairui Song a9fda5
best-effort estimate. It will print a recommanded crashkernel value
Kairui Song a9fda5
based on current kdump setup, and list some details of memory usage.
Kairui Song a0fe51
.TP
Kairui Song a0fe51
.I reset-crashkernel [KERNEL]
Kairui Song a0fe51
Reset crashkernel value to default value. kdumpctl will try to read
Kairui Song a0fe51
from /usr/lib/modules/<KERNEL>/crashkernel.default and reset specified
Kairui Song a0fe51
kernel's crashkernel cmdline value. If no kernel is
Kairui Song a0fe51
specified, will reset current running kernel's crashkernel value.
Kairui Song a0fe51
If /usr/lib/modules/<KERNEL>/crashkernel.default doesn't exist, will
Kairui Song a0fe51
simply exit return 1.
Kairui Song a0fe51
Petr Šabata f5bf49
Petr Šabata f5bf49
.SH "SEE ALSO"
Petr Šabata f5bf49
.BR kdump.conf (5),
Petr Šabata f5bf49
.BR mkdumprd (8)