Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mkinitramfs(8) [linux man page]

MKINITRAMFS(8)							mkinitramfs manual						    MKINITRAMFS(8)

NAME
mkinitramfs - low-level tool for generating an initramfs image SYNOPSIS
mkinitramfs [-c compress] [-d confdir] [-k] -o outfile [-r root] [-v] [version] mkinitramfs [--supported-host-version= hversion] mkinitramfs [--supported-target-version= tversion] DESCRIPTION
The mkinitramfs script generates an initramfs image. The initramfs is a compressed cpio archive. The archive can be used on a different box of the same arch with the corresponding Linux kernel. mkinitramfs is meant for advanced usage. On your local box update-initramfs calls mkinitramfs with the relevant parameters. update-initramfs keeps sha1sum of generated initramfs. It takes care to generate backups and eventually runs the bootloader. At boot time, the kernel unpacks that archive into RAM disk, mounts and uses it as initial root file system. All finding of the root device happens in this early userspace. OPTIONS
-c compress Override the COMPRESS setting in initramfs.conf. -d confdir Set an alternate configuration directory. -k Keep the temporary directory used to make the image. -o outfile Write the image to outfile. -r root Override the ROOT setting in initramfs.conf. -v Set the verbose mode output. version Set the kernel version of the initramfs image (defaults to the running kernel). --supported-host-version=hversion This option queries if mkinitramfs can create ramdisks on a running kernel of version hversion. --supported-target-version=tversion This option queries if mkinitramfs can create ramdisks for kernel version tversion. ENVIRONMENT
mkinitramfs honours the TMPDIR environment variable. If set, it uses subdirectories in the given directory to create its temporary working directories. Else it uses /tmp as default value for that purpose. The given directory should be on a filesystem which allows the execution of files stored there, i.e. should not be mounted with the noexec mount option. FILES
/etc/initramfs-tools/initramfs.conf The default configuration file for the script. See initramfs.conf(5) for a description of the available configuration parameter. /etc/initramfs-tools/modules Specified modules will be put in the generated image and loaded when the system boots. The format - one per line - is identical to that of /etc/modules, which is described in modules(5). /etc/initramfs-tools/conf.d The conf.d directory allows one to hardcode bootargs at initramfs build time via config snippets. This allows one to set ROOT or RESUME. This is especially useful for bootloaders, which do not pass an root bootarg. /etc/initramfs-tools/DSDT.aml If this file exists, it will be appended to the initramfs in a way that causes it to be loaded by ACPI. EXAMPLES
Create an initramfs for current running kernel: mkinitramfs -o ~/tmp/initramfs-$(uname -r) Create an initramfs for specific kernel and keep builddirs: mkinitramfs -k -o ~/tmp/initramfs-2.6.21-686 2.6.21-686 Debug initramfs creation (check out written logfile) sh -x mkinitramfs -o ~/tmp/initramfs-$(uname -r) 2> ~/tmp/log AUTHOR
The initramfs-tools are written by Maximilian Attems <maks@debian.org>, Jeff Bailey <jbailey@raspberryginger.com> and numerous others. SEE ALSO
initramfs.conf(5), initramfs-tools(8), update-initramfs(8). Linux 2010/04/07 MKINITRAMFS(8)

Check Out this Related Man Page

DRACUT.CONF(5)							      dracut							    DRACUT.CONF(5)

NAME
dracut.conf - configuration file(s) for dracut SYNOPSIS
/etc/dracut.conf /etc/dracut.conf.d/*.conf DESCRIPTION
dracut.conf is loaded during the initialisation phase of dracut. Command line parameter will overwrite any values set here. dracut.conf.d/*.conf files are read in alphanumerical order and will overwrite parameters set in /etc/dracut.conf. Each line specifies an attribute and a value. A # indicates the beginning of a comment; following characters, up to the end of the line are not interpreted. dracutmodules+=" <dracut modules> " Specify a space-separated list of dracut modules to call when building the initramfs. Modules are located in /usr/lib/dracut/modules.d. omit_dracutmodules+=" <dracut modules> " Omit a space-separated list of dracut modules. add_dracutmodules+=" <dracut modules> " Add a space-separated list of dracut modules. drivers+=" <kernel modules> " Specify a space-separated list of kernel modules to exclusively include in the initramfs. The kernel modules have to be specified without the ".ko" suffix. add_drivers+=" <kernel modules> " Specify a space-separated list of kernel modules to add to the initramfs. The kernel modules have to be specified without the ".ko" suffix. omit_drivers+=" <kernel modules> " Specify a space-separated list of kernel modules not to add to the initramfs. The kernel modules have to be specified without the ".ko" suffix. install_items+=" <kernel modules> " Specify a space-separated list of files, which are added to the initramfs image. filesystems+=" <filesystem names> " Specify a space-separated list of kernel filesystem modules to exclusively include in the generic initramfs. drivers_dir="<kernel modules directory>" Specify the directory, where to look for kernel modules fw_dir+=" :<dir>[:<dir> ...] " Specify additional directories, where to look for firmwares, separated by : install_items+=" <file>[ <file> ...] " Specify additional files to include in the initramfs, separated by spaces. do_strip="{yes|no}" Strip binaries in the initramfs (default=yes) hostonly="{yes|no}" Host-Only mode: Install only what is needed for booting the local host instead of a generic host and generate host-specific configuration. tmpdir="<temporary directory>" Specify temporary directory to use. Warning If chrooted to another root other than the real root device, use --fstab and provide a valid /etc/fstab. use_fstab="{yes|no}" Use /etc/fstab instead of /proc/self/mountinfo. add_fstab+=" <filename> " Add entries of <filename> to the initramfs /etc/fstab. mdadmconf="{yes|no}" Include local /etc/mdadm.conf (default=yes) lvmconf="{yes|no}" Include local /etc/lvm/lvm.conf (default=yes) fscks=" <fsck tools> " Add a space-separated list of fsck tools. If nothing is specified, the default is: "umount mount /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck jfs_fsck reiserfsck btrfsck". The installation is opportunistic (non-existing tools are ignored). nofscks="{yes|no}" If specified, inhibit installation of any fsck tools. kernel_only="{yes|no}" Only install kernel drivers and firmware files. (default=no) no_kernel="{yes|no}" Do not install kernel drivers and firmware files (default=no) stdloglvl="{0-6}" Set logging to standard error level. sysloglvl="{0-6}" Set logging to syslog level. fileloglvl="{0-6}" Set logging to file level. logfile="<file>" Path to log file. show_modules="{yes|no}" Print included module's name to standard output during build. FILES
/etc/dracut.conf Old configuration file. You better use your own file in /etc/dracut/conf.d/. /etc/dracut/conf.d/ Any /etc/dracut/conf.d/*.conf file can overwrite the values in /etc/dracut.conf. The configuration files are read in alphanumerical order. AUTHOR
Harald Hoyer SEE ALSO
dracut(8) dracut.cmdline(7) dracut 11/08/2012 DRACUT.CONF(5)
Man Page