Petr Šabata f5bf49
.TH MKDUMRD 8 "Fri Feb 9 2007"
Petr Šabata f5bf49
.SH NAME
Petr Šabata f5bf49
mkdumprd \- creates initial ramdisk images for kdump crash recovery 
Petr Šabata f5bf49
.SH SYNOPSIS
Petr Šabata f5bf49
\fBmkdumprd\fR [OPTION]
Petr Šabata f5bf49
Petr Šabata f5bf49
.SH DESCRIPTION
Petr Šabata f5bf49
\fBmkdumprd\fR creates an initial ram file system for use in conjunction with
Petr Šabata f5bf49
the booting of a kernel within the kdump framework for crash recovery.
Petr Šabata f5bf49
\fBmkdumprds\fR purpose is to create an initial ram filesystem capable of copying
Petr Šabata f5bf49
the crashed systems vmcore image to a location specified in \fI/etc/kdump.conf 
Petr Šabata f5bf49
Petr Šabata f5bf49
\fBmkdumprd\fR interrogates the running system to understand what modules need to
Petr Šabata f5bf49
be loaded in the initramfs (based on configuration retrieved from
Petr Šabata f5bf49
\fI/etc/kdump.conf)\fR
Petr Šabata f5bf49
Petr Šabata f5bf49
\fBmkdumprd\fR add a new \fBdracut\fR module 99kdumpbase and use \fBdracut\fR
DistroBaker 7d0122
utility to generate the initramfs. When generating a kdump initramfs, \fBmkdumprd\fR
DistroBaker 7d0122
will determine how much disk space is available, if the dump target's available
DistroBaker 7d0122
space is not greater than the total system memory, \fBmkdumprd\fR will print a
DistroBaker 7d0122
warning to remind that there might not be enough space to save a vmcore. The
DistroBaker 7d0122
warning covers extreme scenarios such as the slab explodes with non-zero data or
DistroBaker 7d0122
a full vmcore, etc. Therefore, need to prevent users from having minimum disk
DistroBaker 7d0122
space for crash dump.
Petr Šabata f5bf49
Petr Šabata f5bf49
\fBmkdumprd\fR was not intended for casual use outside of the service
Petr Šabata f5bf49
initialization script for the kdump utility, and should not be run manually.  If
Petr Šabata f5bf49
you require a custom kdump initramfs image, it is suggested that you use the
Petr Šabata f5bf49
kdump service infrastructure to create one, and then manually unpack, modify and
Petr Šabata f5bf49
repack the image.
Petr Šabata f5bf49
Petr Šabata f5bf49
Petr Šabata f5bf49
.SH OPTIONS
Petr Šabata f5bf49
.TP
Petr Šabata f5bf49
All options here are passed to dracut directly, please refer \fBdracut\fR docs
Petr Šabata f5bf49
for the info.
Petr Šabata f5bf49
Petr Šabata f5bf49
.SH "SEE ALSO"
Petr Šabata f5bf49
.BR dracut (8)