Man Linux: Main Page and Category List

NAME

       initramfs.conf - configuration file for mkinitramfs

DESCRIPTION

       The behaviour of mkinitramfs can be modified by its configuration file.

       Each line in the file can be a configuration variable, a blank line, or
       a  comment. The value of an variable is assigned by an statement of the
       form: name=[value]

       Configuration options can be broken out into configuration snippets and
       placed  in  individual  files in the /etc/mkinitramfs/conf.d directory.
       Files in this directory are always read after  the  main  configuration
       file,  so you can override the settings in the main config file without
       editing it directly.

GENERAL VARIABLES

        MODULES
              Specifies the modules for  the  initramfs  image.   The  default
              setting is most.

              most adds most file system, all ide, sata, scsi and usb drivers.

              dep tries to guess which modules are necessary for  the  running
              box.

              netboot  adds the base modules, network modules, but skips block
              devices.

              list includes only modules from the additional modules  list  to
              load them early.

        BUSYBOX
              Include  busybox  utilities for the boot scripts.  If set to 'n'
              mkinitramfs will build an  initramfs  without  busybox.   Beware
              that many boot scripts need busybox utilities.

        COMPRESS
              Specifies  the  compression method used for the initramfs image.
              mkinitramfs will default to gzip if  the  kernel  lacks  support
              (CONFIG_RD)  or  the  corresponding  userspace  utility  is  not
              present.

        UMASK Set the umask value of the generated initramfs file.  Useful  to
              not disclose eventual keys.

        COMPCACHE_SIZE
              Amount  of  RAM to use for RAM-based compressed swap space.  The
              default is not to use compcache.

              An empty value - compcache isn't used, or added to the initramfs
              at all.

              An integer and K (e.g. 65536 K) - use a number of kilobytes.

              An integer and M (e.g. 256 M) - use a number of megabytes.

              An integer and G (e.g. 1 G) - use a number of gigabytes.

              An integer and % (e.g. 50 %) - use a percentage of the amount of
              RAM.

              You can optionally install the compcache  package  to  configure
              this  setting via debconf and have userspace scripts to load and
              unload compcache.

NFS VARIABLES

        BOOT  Allows to use an nfs drive  as  the  root  of  the  drive.   The
              default  is  to  boot  from local media (hard drive, USB stick).
              Set to nfs for an NFS root share.

        DEVICE
              Specifies the network interface, like eth0.

        ROOT  Allows optional root bootarg hardcoding, when  no  root  bootarg
              can be passed.  A root bootarg overrides that special setting.

        NFSROOT
              Defaults  to  auto  in  order to pick up value from DHCP server.
              Otherwise you need to specify HOST:MOUNT.

FILES

       /etc/initramfs-tools/initramfs.conf

AUTHOR

       The initramfs-tools are written by Maximilian Attems <maks@debian.org>,
       Jeff Bailey <jbailey@raspberryginger.com> and numerous others.  Loosely
       based on mkinitrd.conf by Herbert Xu.

SEE ALSO

        initramfs-tools(8), mkinitramfs(8), update-initramfs(8).