1MKDUMRD(8)                  System Manager's Manual                 MKDUMRD(8)
2
3
4

NAME

6       mkdumprd - creates initial ramdisk images for kdump crash recovery
7

SYNOPSIS

9       mkdumprd [--version] [-v] [-f] [-d]
10                [--preload=module] [--omit-scsi-modules]
11                [--omit-raid-modules] [--omit-lvm-modules]
12                [--image-version] [--allow-missing]
13                [--fstab=fstab] [--nocompress]
14                [--builtin=module]
15                image kernel-version
16
17

DESCRIPTION

19       mkdumprd creates an initial ram file system for use in conjunction with
20       the booting of a kernel within the kdump framework for crash  recovery.
21       mkdumprds  purpose  is  to  create an initial ram filesystem capable of
22       copying the crashed systems vmcore image to  a  location  specified  in
23       /etc/kdump.conf
24
25       Any  module  options  specified in /etc/modprobe.conf are passed to the
26       modules as they are loaded by the initial ramdisk.
27
28       mkdumprd interrogates the running system  to  understand  what  modules
29       need  to  be  loaded in the initramfs (based on configuration retrieved
30       from /etc/kdump.conf)
31
32       mkdumprd was origionally derived from the mkinitrd utility  (hence  the
33       simmilarity  in  option sets), however mkdumprds purpose and mission is
34       significantly different than that of mkinitrd.  As such, while most  of
35       the  options  still  exist, and may work, they are largely vestigual at
36       this point.  mkdumprd was not intended for casual use  outside  of  the
37       service  initialization script for the kdump utility, and should not be
38       run manually.  If you require a custom kdump  initramfs  image,  it  is
39       suggested  that you use the kdump service infrastrucutre to create one,
40       and then manually unpack, modify and repack the image.
41
42
43

OPTIONS

45       --builtin=module
46              Act as if module is built into the kernel being  used.  mkdumprd
47              will  not look for this module, and will not emit an error if it
48              does not exist. This option may be used multiple times.
49
50
51       -f     Allows mkdumprd to overwrite an existing image file.
52
53
54       --fstab=fstab
55              Use fstab to automatically determine what type of filesystem the
56              root device is on. Normally, /etc/fstab is used.
57
58
59       --image-version
60              The  kernel  version number is appended to the initrd image path
61              before the image is created.
62
63
64       --allow-missing
65              Continue even if kernel module is not  found  in  normal  kernel
66              module path.
67              Note:  Capturing  vmcore  will  fail if the kernel module or any
68              modules which depends on it is mandatory. Make  sure  it's  safe
69              when you use this option.
70
71
72       --nocompress
73              Normally  the  created  initrd image is compressed with gzip. If
74              this option is specified, the compression is skipped.
75
76
77       --omit-lvm-modules
78              Do not load any lvm modules, even if /etc/fstab expects them.
79
80
81       --omit-raid-modules
82              Do  not  load  any  raid  modules,  even   if   /etc/fstab   and
83              /etc/raidtab expect them.
84
85
86       --omit-scsi-modules
87              Do  not load any scsi modules, including 'scsi_mod' and 'sd_mod'
88              modules, even if they are present.
89
90
91       --preload=module
92              Load the module module in the initial ramdisk image. The  module
93              gets  loaded  before  any  SCSI  modules  which are specified in
94              /etc/modprobe.conf.  This option may be used as  many  times  as
95              necessary.
96
97
98       -v     Prints  out  verbose  information while creating the image (nor‐
99              mally the mkdumprd runs silently).
100
101
102       -d     Query /etc/kdump for initrd construction configuration
103
104
105       --version
106              Prints the version of mkdumprd that's being used and then exits.
107
108

FILES

110       /etc/modprobe.conf  Specifies modules to be loaded and  module  options
111                           to be used.
112
113

SEE ALSO

115       fstab(5), insmod(1) mkinitrd(8)
116
117
118
119                                Fri Feb 9 2007                      MKDUMRD(8)
Impressum