1dbec4866SSam Ravnborg# 2dbec4866SSam Ravnborg# Configuration for initramfs 3dbec4866SSam Ravnborg# 4dbec4866SSam Ravnborg 5dbec4866SSam Ravnborgconfig INITRAMFS_SOURCE 6dbec4866SSam Ravnborg string "Initramfs source file(s)" 7dbec4866SSam Ravnborg default "" 8dbec4866SSam Ravnborg help 9dbec4866SSam Ravnborg This can be either a single cpio archive with a .cpio suffix or a 10dbec4866SSam Ravnborg space-separated list of directories and files for building the 11dbec4866SSam Ravnborg initramfs image. A cpio archive should contain a filesystem archive 12dbec4866SSam Ravnborg to be used as an initramfs image. Directories should contain a 13dbec4866SSam Ravnborg filesystem layout to be included in the initramfs image. Files 14dbec4866SSam Ravnborg should contain entries according to the format described by the 15dbec4866SSam Ravnborg "usr/gen_init_cpio" program in the kernel tree. 16dbec4866SSam Ravnborg 17dbec4866SSam Ravnborg When multiple directories and files are specified then the 18dbec4866SSam Ravnborg initramfs image will be the aggregate of all of them. 19dbec4866SSam Ravnborg 200979f378SAlexander E. Patrakov See <file:Documentation/early-userspace/README> for more details. 21dbec4866SSam Ravnborg 22dbec4866SSam Ravnborg If you are not sure, leave it blank. 23dbec4866SSam Ravnborg 24dbec4866SSam Ravnborgconfig INITRAMFS_ROOT_UID 25dbec4866SSam Ravnborg int "User ID to map to 0 (user root)" 26dbec4866SSam Ravnborg depends on INITRAMFS_SOURCE!="" 27dbec4866SSam Ravnborg default "0" 28dbec4866SSam Ravnborg help 29dbec4866SSam Ravnborg This setting is only meaningful if the INITRAMFS_SOURCE is 30dbec4866SSam Ravnborg contains a directory. Setting this user ID (UID) to something 31dbec4866SSam Ravnborg other than "0" will cause all files owned by that UID to be 32dbec4866SSam Ravnborg owned by user root in the initial ramdisk image. 33dbec4866SSam Ravnborg 34dbec4866SSam Ravnborg If you are not sure, leave it set to "0". 35dbec4866SSam Ravnborg 36dbec4866SSam Ravnborgconfig INITRAMFS_ROOT_GID 37dbec4866SSam Ravnborg int "Group ID to map to 0 (group root)" 38dbec4866SSam Ravnborg depends on INITRAMFS_SOURCE!="" 39dbec4866SSam Ravnborg default "0" 40dbec4866SSam Ravnborg help 41dbec4866SSam Ravnborg This setting is only meaningful if the INITRAMFS_SOURCE is 42dbec4866SSam Ravnborg contains a directory. Setting this group ID (GID) to something 43dbec4866SSam Ravnborg other than "0" will cause all files owned by that GID to be 44dbec4866SSam Ravnborg owned by group root in the initial ramdisk image. 45dbec4866SSam Ravnborg 46dbec4866SSam Ravnborg If you are not sure, leave it set to "0". 47fb9a4ca9SH. Peter Anvin 48fb9a4ca9SH. Peter Anvinconfig RD_GZIP 49337bed41SH. Peter Anvin bool "Support initial ramdisks compressed using gzip" if EMBEDDED 50fb9a4ca9SH. Peter Anvin default y 5173d8a12fSH. Peter Anvin depends on BLK_DEV_INITRD 52fb9a4ca9SH. Peter Anvin select DECOMPRESS_GZIP 53fb9a4ca9SH. Peter Anvin help 54fb9a4ca9SH. Peter Anvin Support loading of a gzip encoded initial ramdisk or cpio buffer. 55fb9a4ca9SH. Peter Anvin If unsure, say Y. 56fb9a4ca9SH. Peter Anvin 57fb9a4ca9SH. Peter Anvinconfig RD_BZIP2 58337bed41SH. Peter Anvin bool "Support initial ramdisks compressed using bzip2" if EMBEDDED 5973d8a12fSH. Peter Anvin default !EMBEDDED 6073d8a12fSH. Peter Anvin depends on BLK_DEV_INITRD 61fb9a4ca9SH. Peter Anvin select DECOMPRESS_BZIP2 62fb9a4ca9SH. Peter Anvin help 63fb9a4ca9SH. Peter Anvin Support loading of a bzip2 encoded initial ramdisk or cpio buffer 64fb9a4ca9SH. Peter Anvin If unsure, say N. 65fb9a4ca9SH. Peter Anvin 66fb9a4ca9SH. Peter Anvinconfig RD_LZMA 6755d1d26fSH. Peter Anvin bool "Support initial ramdisks compressed using LZMA" if EMBEDDED 6873d8a12fSH. Peter Anvin default !EMBEDDED 6973d8a12fSH. Peter Anvin depends on BLK_DEV_INITRD 70fb9a4ca9SH. Peter Anvin select DECOMPRESS_LZMA 71fb9a4ca9SH. Peter Anvin help 7255d1d26fSH. Peter Anvin Support loading of a LZMA encoded initial ramdisk or cpio buffer 73fb9a4ca9SH. Peter Anvin If unsure, say N. 74ab76f3d7SAlain Knaff 75*cacb246fSAlbin Tonnerreconfig RD_LZO 76*cacb246fSAlbin Tonnerre bool "Support initial ramdisks compressed using LZO" if EMBEDDED 77*cacb246fSAlbin Tonnerre default !EMBEDDED 78*cacb246fSAlbin Tonnerre depends on BLK_DEV_INITRD 79*cacb246fSAlbin Tonnerre select DECOMPRESS_LZO 80*cacb246fSAlbin Tonnerre help 81*cacb246fSAlbin Tonnerre Support loading of a LZO encoded initial ramdisk or cpio buffer 82*cacb246fSAlbin Tonnerre If unsure, say N. 83*cacb246fSAlbin Tonnerre 84ab76f3d7SAlain Knaffchoice 851359096eSH. Peter Anvin prompt "Built-in initramfs compression mode" if INITRAMFS_SOURCE!="" 86ab76f3d7SAlain Knaff help 8740297927SH. Peter Anvin This option decides by which algorithm the builtin initramfs 8840297927SH. Peter Anvin will be compressed. Several compression algorithms are 8940297927SH. Peter Anvin available, which differ in efficiency, compression and 9040297927SH. Peter Anvin decompression speed. Compression speed is only relevant 9140297927SH. Peter Anvin when building a kernel. Decompression speed is relevant at 9240297927SH. Peter Anvin each boot. 93ab76f3d7SAlain Knaff 9455d1d26fSH. Peter Anvin If you have any problems with bzip2 or LZMA compressed 95ab76f3d7SAlain Knaff initramfs, mail me (Alain Knaff) <alain@knaff.lu>. 96ab76f3d7SAlain Knaff 9740297927SH. Peter Anvin High compression options are mostly useful for users who are 9840297927SH. Peter Anvin low on RAM, since it reduces the memory consumption during 9940297927SH. Peter Anvin boot. 100ab76f3d7SAlain Knaff 101ab76f3d7SAlain Knaff If in doubt, select 'gzip' 102ab76f3d7SAlain Knaff 103ab76f3d7SAlain Knaffconfig INITRAMFS_COMPRESSION_NONE 104ab76f3d7SAlain Knaff bool "None" 105ab76f3d7SAlain Knaff help 106ab76f3d7SAlain Knaff Do not compress the built-in initramfs at all. This may 107ab76f3d7SAlain Knaff sound wasteful in space, but, you should be aware that the 108ab76f3d7SAlain Knaff built-in initramfs will be compressed at a later stage 109ab76f3d7SAlain Knaff anyways along with the rest of the kernel, on those 110ab76f3d7SAlain Knaff architectures that support this. 111ab76f3d7SAlain Knaff However, not compressing the initramfs may lead to slightly 112ab76f3d7SAlain Knaff higher memory consumption during a short time at boot, while 113ab76f3d7SAlain Knaff both the cpio image and the unpacked filesystem image will 114ab76f3d7SAlain Knaff be present in memory simultaneously 115ab76f3d7SAlain Knaff 116ab76f3d7SAlain Knaffconfig INITRAMFS_COMPRESSION_GZIP 117ab76f3d7SAlain Knaff bool "Gzip" 118ab76f3d7SAlain Knaff depends on RD_GZIP 119ab76f3d7SAlain Knaff help 120*cacb246fSAlbin Tonnerre The old and tried gzip compression. It provides a good balance 121*cacb246fSAlbin Tonnerre between compression ratio and decompression speed. 122ab76f3d7SAlain Knaff 123ab76f3d7SAlain Knaffconfig INITRAMFS_COMPRESSION_BZIP2 124ab76f3d7SAlain Knaff bool "Bzip2" 125ab76f3d7SAlain Knaff depends on RD_BZIP2 126ab76f3d7SAlain Knaff help 127ab76f3d7SAlain Knaff Its compression ratio and speed is intermediate. 128*cacb246fSAlbin Tonnerre Decompression speed is slowest among the four. The initramfs 129ab76f3d7SAlain Knaff size is about 10% smaller with bzip2, in comparison to gzip. 130ab76f3d7SAlain Knaff Bzip2 uses a large amount of memory. For modern kernels you 131ab76f3d7SAlain Knaff will need at least 8MB RAM or more for booting. 132ab76f3d7SAlain Knaff 133ab76f3d7SAlain Knaffconfig INITRAMFS_COMPRESSION_LZMA 134ab76f3d7SAlain Knaff bool "LZMA" 135ab76f3d7SAlain Knaff depends on RD_LZMA 136ab76f3d7SAlain Knaff help 137ab76f3d7SAlain Knaff The most recent compression algorithm. 138ab76f3d7SAlain Knaff Its ratio is best, decompression speed is between the other 139*cacb246fSAlbin Tonnerre three. Compression is slowest. The initramfs size is about 33% 140ab76f3d7SAlain Knaff smaller with LZMA in comparison to gzip. 141ab76f3d7SAlain Knaff 142*cacb246fSAlbin Tonnerreconfig INITRAMFS_COMPRESSION_LZO 143*cacb246fSAlbin Tonnerre bool "LZO" 144*cacb246fSAlbin Tonnerre depends on RD_LZO 145*cacb246fSAlbin Tonnerre help 146*cacb246fSAlbin Tonnerre Its compression ratio is the poorest among the four. The kernel 147*cacb246fSAlbin Tonnerre size is about about 10% bigger than gzip; however its speed 148*cacb246fSAlbin Tonnerre (both compression and decompression) is the fastest. 149*cacb246fSAlbin Tonnerre 150ab76f3d7SAlain Knaffendchoice 151