initramfs.conf Configuration Directives

TEMPLATE $<$path$>$

Use the specified initramfs template

MODULE $<$module$>$

Adds the module (and its dependencies) to the ramfs

NOMODPROBE

Does not automaticaly add any ethernet/disk drivers from modprobe.conf

SCSIMODS

Add disk (scsi_hostadapter) modules from modprobe.conf

PRELOAD $<$module$>$

Adds the module (and its dependencies) to the ramfs before any SCSI modules are loaded

RAMDISK_ROOT

Directs the initrd/ramfs to use the ram disk as the root filesystem

COPY $<$path$>$

[-r] [-n]

Copies the given path to the initramfs

-r	recursive copy
-n	Do not copy library dependencies

OVERLAY $<$directory$>$

Overlays the given directory onto the ramfs

RAM_OVERLAY [max_size[k$\vert$m$\vert$g]]

Overlays a RAM disk that grow up to max_size onto the NFS root filesystem. Deprecates the need for LINKDIR/LINKFILE directives. Defaults to half of available RAM. Note: A patch is currently needed to get ideal behavior out of overlayfs.

NOMOUNT

Do not automount fomr /etc/fstab when using ramdisk-root mode

NODHCP

Directs the initrd/ramfs not to run a DHCP client

DHCP_INTERFACE $<$interface$>$

Run dhcp client over the specified interface. Multiple directives can be supplied to try each interface in turn. (default: all available interfaces)

DHCP_RETRIES $<$number$>$

Attempt to send number discovers before trying the next interface. A value of 0 will continue to retry indefinitely. (default: 5)

NFS_RETRIES $<$number$>$

Attempt to try to mount the NFS root filesystem <number> times before failing. (default: 5)

RETRY_REBOOT

Reboot the system if any of NFS, DHCP, or network check fails

BOND_INTERFACES $<$interface$>$,$<$interface$>$...

Bond the requested interfaces together. To use this option, you must have a modprobe.conf with the desired options set for the bonding driver. eg:

options bonding mode=balance-alb miimon=100

Be aware that some bonding modes require the switch to have the appropriate ports configured for `etherchannel' or `trunking'.

NETWORK_CHECK $<$number$>$

Before attempting to mount an NFS root, this option checks for network connectivity by attempting to ping the gateway address up to number times. This is useful for interfaces such as bonded NICs that may take some time before they are fully ready. A value of 0 disables the network check. (default: 5)

RESUME_FROM $<$device$>$

Attempt to resume from swsusp image on DEVICE

AUTOMOUNT

Directs the initrd/ramfs to mount any labeled filesystems. eg: A disk labeled `/var' will be mounted on /var

SWAPON

Directs the initrd/ramfs to enable any swap partitions.

SETUP_RAID

Directs the initrd/ramfs to attempt to assemble any existing RAID arrays

MOUNT_RW $<$dir$>$

Directs the initrd/ramfs to mount the given directory read-write

MOUNT_ALL_RW

Directs the initrd/ramfs to mount all directories read-write

INITRD

Creates an initrd image instead of initramfs

INITRD_SIZE $<$kbytes$>$

Specifies absolute size to use for the uncompressed initrd image. (Note: not necessary for initramfs images)

INITRD_BUFFER $<$kbytes$>$

Specifies the amount of free space to leave available after all files have been added to an initrd (Note: not necessary for initramfs images)