| Sam Ravnborg | dbec486 | 2005-08-10 20:44:50 +0200 | [diff] [blame] | 1 | # | 
|  | 2 | # Configuration for initramfs | 
|  | 3 | # | 
|  | 4 |  | 
|  | 5 | config INITRAMFS_SOURCE | 
|  | 6 | string "Initramfs source file(s)" | 
|  | 7 | default "" | 
|  | 8 | help | 
|  | 9 | This can be either a single cpio archive with a .cpio suffix or a | 
|  | 10 | space-separated list of directories and files for building the | 
|  | 11 | initramfs image.  A cpio archive should contain a filesystem archive | 
|  | 12 | to be used as an initramfs image.  Directories should contain a | 
|  | 13 | filesystem layout to be included in the initramfs image.  Files | 
|  | 14 | should contain entries according to the format described by the | 
|  | 15 | "usr/gen_init_cpio" program in the kernel tree. | 
|  | 16 |  | 
|  | 17 | When multiple directories and files are specified then the | 
|  | 18 | initramfs image will be the aggregate of all of them. | 
|  | 19 |  | 
| Alexander E. Patrakov | 0979f37 | 2007-03-16 18:01:45 +0500 | [diff] [blame] | 20 | See <file:Documentation/early-userspace/README> for more details. | 
| Sam Ravnborg | dbec486 | 2005-08-10 20:44:50 +0200 | [diff] [blame] | 21 |  | 
|  | 22 | If you are not sure, leave it blank. | 
|  | 23 |  | 
|  | 24 | config INITRAMFS_ROOT_UID | 
|  | 25 | int "User ID to map to 0 (user root)" | 
|  | 26 | depends on INITRAMFS_SOURCE!="" | 
|  | 27 | default "0" | 
|  | 28 | help | 
|  | 29 | This setting is only meaningful if the INITRAMFS_SOURCE is | 
|  | 30 | contains a directory.  Setting this user ID (UID) to something | 
|  | 31 | other than "0" will cause all files owned by that UID to be | 
|  | 32 | owned by user root in the initial ramdisk image. | 
|  | 33 |  | 
|  | 34 | If you are not sure, leave it set to "0". | 
|  | 35 |  | 
|  | 36 | config INITRAMFS_ROOT_GID | 
|  | 37 | int "Group ID to map to 0 (group root)" | 
|  | 38 | depends on INITRAMFS_SOURCE!="" | 
|  | 39 | default "0" | 
|  | 40 | help | 
|  | 41 | This setting is only meaningful if the INITRAMFS_SOURCE is | 
|  | 42 | contains a directory.  Setting this group ID (GID) to something | 
|  | 43 | other than "0" will cause all files owned by that GID to be | 
|  | 44 | owned by group root in the initial ramdisk image. | 
|  | 45 |  | 
|  | 46 | If you are not sure, leave it set to "0". | 
| H. Peter Anvin | fb9a4ca | 2009-01-07 00:03:49 -0800 | [diff] [blame] | 47 |  | 
|  | 48 | config RD_GZIP | 
| David Rientjes | 6a108a1 | 2011-01-20 14:44:16 -0800 | [diff] [blame] | 49 | bool "Support initial ramdisks compressed using gzip" if EXPERT | 
| H. Peter Anvin | fb9a4ca | 2009-01-07 00:03:49 -0800 | [diff] [blame] | 50 | default y | 
| H. Peter Anvin | 73d8a12 | 2009-03-28 15:49:08 -0700 | [diff] [blame] | 51 | depends on BLK_DEV_INITRD | 
| H. Peter Anvin | fb9a4ca | 2009-01-07 00:03:49 -0800 | [diff] [blame] | 52 | select DECOMPRESS_GZIP | 
|  | 53 | help | 
|  | 54 | Support loading of a gzip encoded initial ramdisk or cpio buffer. | 
|  | 55 | If unsure, say Y. | 
|  | 56 |  | 
|  | 57 | config RD_BZIP2 | 
| David Rientjes | 6a108a1 | 2011-01-20 14:44:16 -0800 | [diff] [blame] | 58 | bool "Support initial ramdisks compressed using bzip2" if EXPERT | 
|  | 59 | default !EXPERT | 
| H. Peter Anvin | 73d8a12 | 2009-03-28 15:49:08 -0700 | [diff] [blame] | 60 | depends on BLK_DEV_INITRD | 
| H. Peter Anvin | fb9a4ca | 2009-01-07 00:03:49 -0800 | [diff] [blame] | 61 | select DECOMPRESS_BZIP2 | 
|  | 62 | help | 
|  | 63 | Support loading of a bzip2 encoded initial ramdisk or cpio buffer | 
|  | 64 | If unsure, say N. | 
|  | 65 |  | 
|  | 66 | config RD_LZMA | 
| David Rientjes | 6a108a1 | 2011-01-20 14:44:16 -0800 | [diff] [blame] | 67 | bool "Support initial ramdisks compressed using LZMA" if EXPERT | 
|  | 68 | default !EXPERT | 
| H. Peter Anvin | 73d8a12 | 2009-03-28 15:49:08 -0700 | [diff] [blame] | 69 | depends on BLK_DEV_INITRD | 
| H. Peter Anvin | fb9a4ca | 2009-01-07 00:03:49 -0800 | [diff] [blame] | 70 | select DECOMPRESS_LZMA | 
|  | 71 | help | 
| H. Peter Anvin | 55d1d26 | 2009-03-28 16:10:59 -0700 | [diff] [blame] | 72 | Support loading of a LZMA encoded initial ramdisk or cpio buffer | 
| H. Peter Anvin | fb9a4ca | 2009-01-07 00:03:49 -0800 | [diff] [blame] | 73 | If unsure, say N. | 
| Alain Knaff | ab76f3d | 2009-02-19 13:43:51 -0800 | [diff] [blame] | 74 |  | 
| Lasse Collin | 3ebe124 | 2011-01-12 17:01:23 -0800 | [diff] [blame] | 75 | config RD_XZ | 
| David Rientjes | 6a108a1 | 2011-01-20 14:44:16 -0800 | [diff] [blame] | 76 | bool "Support initial ramdisks compressed using XZ" if EXPERT | 
|  | 77 | default !EXPERT | 
| Lasse Collin | 3ebe124 | 2011-01-12 17:01:23 -0800 | [diff] [blame] | 78 | depends on BLK_DEV_INITRD | 
|  | 79 | select DECOMPRESS_XZ | 
|  | 80 | help | 
|  | 81 | Support loading of a XZ encoded initial ramdisk or cpio buffer. | 
|  | 82 | If unsure, say N. | 
|  | 83 |  | 
| Albin Tonnerre | cacb246 | 2010-01-08 14:42:46 -0800 | [diff] [blame] | 84 | config RD_LZO | 
| David Rientjes | 6a108a1 | 2011-01-20 14:44:16 -0800 | [diff] [blame] | 85 | bool "Support initial ramdisks compressed using LZO" if EXPERT | 
|  | 86 | default !EXPERT | 
| Albin Tonnerre | cacb246 | 2010-01-08 14:42:46 -0800 | [diff] [blame] | 87 | depends on BLK_DEV_INITRD | 
|  | 88 | select DECOMPRESS_LZO | 
|  | 89 | help | 
|  | 90 | Support loading of a LZO encoded initial ramdisk or cpio buffer | 
|  | 91 | If unsure, say N. | 
|  | 92 |  | 
| Alain Knaff | ab76f3d | 2009-02-19 13:43:51 -0800 | [diff] [blame] | 93 | choice | 
| H. Peter Anvin | 1359096 | 2009-03-31 12:24:17 -0700 | [diff] [blame] | 94 | prompt "Built-in initramfs compression mode" if INITRAMFS_SOURCE!="" | 
| Alain Knaff | ab76f3d | 2009-02-19 13:43:51 -0800 | [diff] [blame] | 95 | help | 
| H. Peter Anvin | 4029792 | 2009-03-28 17:24:03 -0700 | [diff] [blame] | 96 | This option decides by which algorithm the builtin initramfs | 
|  | 97 | will be compressed.  Several compression algorithms are | 
|  | 98 | available, which differ in efficiency, compression and | 
|  | 99 | decompression speed.  Compression speed is only relevant | 
|  | 100 | when building a kernel.  Decompression speed is relevant at | 
|  | 101 | each boot. | 
| Alain Knaff | ab76f3d | 2009-02-19 13:43:51 -0800 | [diff] [blame] | 102 |  | 
| H. Peter Anvin | 55d1d26 | 2009-03-28 16:10:59 -0700 | [diff] [blame] | 103 | If you have any problems with bzip2 or LZMA compressed | 
| Alain Knaff | ab76f3d | 2009-02-19 13:43:51 -0800 | [diff] [blame] | 104 | initramfs, mail me (Alain Knaff) <alain@knaff.lu>. | 
|  | 105 |  | 
| H. Peter Anvin | 4029792 | 2009-03-28 17:24:03 -0700 | [diff] [blame] | 106 | High compression options are mostly useful for users who are | 
|  | 107 | low on RAM, since it reduces the memory consumption during | 
|  | 108 | boot. | 
| Alain Knaff | ab76f3d | 2009-02-19 13:43:51 -0800 | [diff] [blame] | 109 |  | 
|  | 110 | If in doubt, select 'gzip' | 
|  | 111 |  | 
|  | 112 | config INITRAMFS_COMPRESSION_NONE | 
|  | 113 | bool "None" | 
|  | 114 | help | 
|  | 115 | Do not compress the built-in initramfs at all. This may | 
|  | 116 | sound wasteful in space, but, you should be aware that the | 
|  | 117 | built-in initramfs will be compressed at a later stage | 
|  | 118 | anyways along with the rest of the kernel, on those | 
|  | 119 | architectures that support this. | 
|  | 120 | However, not compressing the initramfs may lead to slightly | 
|  | 121 | higher memory consumption during a short time at boot, while | 
|  | 122 | both the cpio image and the unpacked filesystem image will | 
|  | 123 | be present in memory simultaneously | 
|  | 124 |  | 
|  | 125 | config INITRAMFS_COMPRESSION_GZIP | 
|  | 126 | bool "Gzip" | 
|  | 127 | depends on RD_GZIP | 
|  | 128 | help | 
| Albin Tonnerre | cacb246 | 2010-01-08 14:42:46 -0800 | [diff] [blame] | 129 | The old and tried gzip compression. It provides a good balance | 
|  | 130 | between compression ratio and decompression speed. | 
| Alain Knaff | ab76f3d | 2009-02-19 13:43:51 -0800 | [diff] [blame] | 131 |  | 
|  | 132 | config INITRAMFS_COMPRESSION_BZIP2 | 
|  | 133 | bool "Bzip2" | 
|  | 134 | depends on RD_BZIP2 | 
|  | 135 | help | 
|  | 136 | Its compression ratio and speed is intermediate. | 
| Randy Dunlap | 0a4dd35 | 2012-05-31 16:26:46 -0700 | [diff] [blame] | 137 | Decompression speed is slowest among the choices.  The initramfs | 
| Alain Knaff | ab76f3d | 2009-02-19 13:43:51 -0800 | [diff] [blame] | 138 | size is about 10% smaller with bzip2, in comparison to gzip. | 
|  | 139 | Bzip2 uses a large amount of memory. For modern kernels you | 
|  | 140 | will need at least 8MB RAM or more for booting. | 
|  | 141 |  | 
|  | 142 | config INITRAMFS_COMPRESSION_LZMA | 
|  | 143 | bool "LZMA" | 
|  | 144 | depends on RD_LZMA | 
|  | 145 | help | 
| Randy Dunlap | 0a4dd35 | 2012-05-31 16:26:46 -0700 | [diff] [blame] | 146 | This algorithm's compression ratio is best. | 
|  | 147 | Decompression speed is between the other choices. | 
|  | 148 | Compression is slowest. The initramfs size is about 33% | 
| Alain Knaff | ab76f3d | 2009-02-19 13:43:51 -0800 | [diff] [blame] | 149 | smaller with LZMA in comparison to gzip. | 
|  | 150 |  | 
| Lasse Collin | 3ebe124 | 2011-01-12 17:01:23 -0800 | [diff] [blame] | 151 | config INITRAMFS_COMPRESSION_XZ | 
|  | 152 | bool "XZ" | 
|  | 153 | depends on RD_XZ | 
|  | 154 | help | 
|  | 155 | XZ uses the LZMA2 algorithm. The initramfs size is about 30% | 
|  | 156 | smaller with XZ in comparison to gzip. Decompression speed | 
|  | 157 | is better than that of bzip2 but worse than gzip and LZO. | 
|  | 158 | Compression is slow. | 
|  | 159 |  | 
| Albin Tonnerre | cacb246 | 2010-01-08 14:42:46 -0800 | [diff] [blame] | 160 | config INITRAMFS_COMPRESSION_LZO | 
|  | 161 | bool "LZO" | 
|  | 162 | depends on RD_LZO | 
|  | 163 | help | 
| Randy Dunlap | 0a4dd35 | 2012-05-31 16:26:46 -0700 | [diff] [blame] | 164 | Its compression ratio is the poorest among the choices. The kernel | 
| Stephan Sperber | 681b304 | 2010-07-14 11:23:08 +0200 | [diff] [blame] | 165 | size is about 10% bigger than gzip; however its speed | 
| Albin Tonnerre | cacb246 | 2010-01-08 14:42:46 -0800 | [diff] [blame] | 166 | (both compression and decompression) is the fastest. | 
|  | 167 |  | 
| Alain Knaff | ab76f3d | 2009-02-19 13:43:51 -0800 | [diff] [blame] | 168 | endchoice |