Linux Blog

MKINITRD.CONF

Section: File Formats (5)
Updated: 26 November 2007
Index Return to Main Contents
 

NAME

mkinitrd.conf(5)  

SYNOPSIS

mkinitrd.conf - optional configuration file for mkinitrd(8)

 

DESCRIPTION

The mkinitrd.conf file contains options to be passed to mkinitrd(8) on every run if mkinitrd is executed with the -F flag.
It is intended as a fast and easy way for the system administrator to pass options to mkinitrd without having to type them on each execution.

Options passed to mkinitrd(8) on the command line will override any values set in the config file.

 

OPTIONS AND SYNTAX

All options are in the format of OPTION="value"
Unset variables have no effect.

SOURCE_TREE
This is the location for the initrd's source tree.
Defaults to "/boot/initrd-tree"

CLEAR_TREE
This option specifies whether to clear the initrd source tree prior to creating the initrd.
This requires a value of either "0" or "1" where 0=no and 1=yes
Examples:
CLEAR_TREE="0"         # Do not clear initrd tree first

CLEAR_TREE="1"         # Clear initrd tree first

It is recommended to leave this unset and pass "-c" on the command line when clearing the tree is desired. Clearing the tree is not desirable if you wish to build support for more than one kernel into the initrd image.

OUTPUT_IMAGE
This is the location for the initrd image that is created.
Defaults to "/boot/initrd.gz"

KERNEL_VERSION
This is the kernel version for which the initrd should be created.

 Defaults to "$(uname -r)"

MODULE_LIST
This should be a colon-separated list of modules you wish to be included in the initrd image.
Example: MODULE_LIST="ext3:mbcache:jbd"

If you have loadtime options that you need to specify when loading kernel modules, those can be added here as well.
Example: MODULE_LIST"module1:module2 option=1:module3"

LUKSDEV
When using cryptsetup with an encrypted root partition, use this variable to define the *actual* device name of the encrypted root partition and define the *mapped* device name as ROOTDEV.
For example, if your actual root device name in /etc/fstab is:
/dev/mapper/cryptroot on /dev/sda2

Then you'll need to set:
LUKSDEV="/dev/sda2"
ROOTDEV="cryptroot"

ROOTDEV
The device on which your root filesystem is located.
Example: ROOTDEV="/dev/sda2"

If you are using cryptsetup and an encrypted root filesystem, be sure to read the option above for LUKSDEV or Bad Things will happen.

ROOTFS
The filesystem type of your root filesystem
Example: ROOTFS="ext3"

LVM
This option adds support for LVM partitions into the initrd. If you wish to add LVM support to the initrd, then set this to 1; otherwise, leave it unset or set it to 0.
Examples:
LVM="0" # Do not add LVM support to initrd
LVM="1" # Add LVM support to initrd

WAIT
This defines the time to wait, in seconds, until all disks are detected.
This is useful for allowing extra time that might be needed for slow usb disks or systems with large amounts of storage to become ready.
If not defined, the default is 1 second.

 

FILES

/etc/mkinitrd.conf
See /etc/mkinitrd.conf.sample

 

SEE ALSO

mkinitrd(8)

 

BUGS

None known :-)

 

MISCELLANEOUS

Support for mkinitrd.conf was added in mkinitrd-1.3.0


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS AND SYNTAX
FILES
SEE ALSO
BUGS
MISCELLANEOUS




Random Man Pages:
autoexpect
iso_8859_15
nv
ptmx