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]
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       --nocompress
65              Normally the created initrd image is compressed  with  gzip.  If
66              this option is specified, the compression is skipped.
67
68
69       --omit-lvm-modules
70              Do not load any lvm modules, even if /etc/fstab expects them.
71
72
73       --omit-raid-modules
74              Do   not   load   any  raid  modules,  even  if  /etc/fstab  and
75              /etc/raidtab expect them.
76
77
78       --omit-scsi-modules
79              Do not load any scsi modules, including 'scsi_mod' and  'sd_mod'
80              modules, even if they are present.
81
82
83       --preload=module
84              Load  the module module in the initial ramdisk image. The module
85              gets loaded before any  SCSI  modules  which  are  specified  in
86              /etc/modprobe.conf.   This  option  may be used as many times as
87              necessary.
88
89
90       -v     Prints out verbose information while creating  the  image  (nor‐
91              mally the mkdumprd runs silently).
92
93
94       -d     Query /etc/kdump for initrd construction configuration
95
96
97       --version
98              Prints the version of mkdumprd that's being used and then exits.
99
100

FILES

102       /etc/modprobe.conf  Specifies  modules  to be loaded and module options
103                           to be used.
104
105

SEE ALSO

107       fstab(5), insmod(1) mkinitrd(8)
108
109
110
111                                Fri Feb 9 2007                      MKDUMRD(8)
Impressum