Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 1 | # |
| 2 | # For a description of the syntax of this configuration file, |
| 3 | # see scripts/kbuild/config-language.txt. |
| 4 | # |
| 5 | |
| 6 | menu "Archival Utilities" |
| 7 | |
| 8 | config CONFIG_AR |
| 9 | bool "ar" |
| 10 | default n |
| 11 | help |
Eric Andersen | 5360182 | 2002-12-05 21:12:42 +0000 | [diff] [blame] | 12 | ar is an archival utility program used to create, modify, and |
| 13 | extract contents from archives. An archive is a single file holding |
| 14 | a collection of other files in a structure that makes it possible to |
| 15 | retrieve the original individual files (called archive members). |
| 16 | The original files' contents, mode (permissions), timestamp, owner, |
| 17 | and group are preserved in the archive, and can be restored on |
Glenn L McGrath | 0337c46 | 2002-12-06 22:40:54 +0000 | [diff] [blame] | 18 | extraction. |
Eric Andersen | 6d3c7e7 | 2003-08-22 21:15:07 +0000 | [diff] [blame] | 19 | |
Glenn L McGrath | 0337c46 | 2002-12-06 22:40:54 +0000 | [diff] [blame] | 20 | The stored filename is limited to 15 characters. (for more information |
| 21 | see long filename support). |
| 22 | ar has 60 bytes of overheads for every stored file. |
| 23 | |
| 24 | This implementation of ar can extract archives, it cannot create or |
| 25 | modify them. |
Eric Andersen | 6d3c7e7 | 2003-08-22 21:15:07 +0000 | [diff] [blame] | 26 | On an x86 system, the ar applet adds about 1K. |
Eric Andersen | 5360182 | 2002-12-05 21:12:42 +0000 | [diff] [blame] | 27 | |
| 28 | Unless you have a specific application which requires ar, you should |
| 29 | probably say N here. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 30 | |
| 31 | config CONFIG_FEATURE_AR_LONG_FILENAMES |
| 32 | bool " Enable support for long filenames (not need for debs)" |
| 33 | default n |
| 34 | depends on CONFIG_AR |
| 35 | help |
Glenn L McGrath | 0337c46 | 2002-12-06 22:40:54 +0000 | [diff] [blame] | 36 | By default the ar format can only store the first 15 characters of the |
| 37 | filename, this option removes that limitation. |
| 38 | It supports the GNU ar long filename method which moves multiple long |
| 39 | filenames into a the data section of a new ar entry. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 40 | |
| 41 | config CONFIG_BUNZIP2 |
| 42 | bool "bunzip2" |
| 43 | default n |
| 44 | help |
Eric Andersen | 5360182 | 2002-12-05 21:12:42 +0000 | [diff] [blame] | 45 | bunzip2 is an compression utility using the Burrows-Wheeler block |
| 46 | sorting text compression algorithm, and Huffman coding. Compression |
| 47 | is generally considerably better than that achieved by more |
| 48 | conventional LZ77/LZ78-based compressors, and approaches the |
| 49 | performance of the PPM family of statistical compressors. |
| 50 | |
Glenn L McGrath | 0337c46 | 2002-12-06 22:40:54 +0000 | [diff] [blame] | 51 | The BusyBox bunzip2 applet is limited to de-compression only. |
Eric Andersen | 6d3c7e7 | 2003-08-22 21:15:07 +0000 | [diff] [blame] | 52 | On an x86 system, this applet adds about 11K. |
Eric Andersen | 5360182 | 2002-12-05 21:12:42 +0000 | [diff] [blame] | 53 | |
| 54 | Unless you have a specific application which requires bunzip2, you |
| 55 | should probably say N here. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 56 | |
| 57 | config CONFIG_CPIO |
| 58 | bool "cpio" |
| 59 | default n |
| 60 | help |
Glenn L McGrath | 0337c46 | 2002-12-06 22:40:54 +0000 | [diff] [blame] | 61 | cpio is an archival utility program used to create, modify, and extract |
| 62 | contents from archives. |
| 63 | cpio has 110 bytes of overheads for every stored file. |
| 64 | |
| 65 | This implementation of cpio can extract cpio archives created in the |
| 66 | "newc" or "crc" format, it cannot create or modify them. |
| 67 | |
| 68 | Unless you have a specific application which requires cpio, you should |
| 69 | probably say N here. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 70 | |
| 71 | config CONFIG_DPKG |
| 72 | bool "dpkg" |
| 73 | default n |
| 74 | help |
Glenn L McGrath | 0337c46 | 2002-12-06 22:40:54 +0000 | [diff] [blame] | 75 | dpkg is a medium-level tool to install, build, remove and manage Debian packages. |
| 76 | |
| 77 | This implementation of dpkg has a number of limitations, you should use the |
| 78 | official dpkg if possible. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 79 | |
| 80 | config CONFIG_DPKG_DEB |
| 81 | bool "dpkg_deb" |
| 82 | default n |
| 83 | help |
Glenn L McGrath | 0337c46 | 2002-12-06 22:40:54 +0000 | [diff] [blame] | 84 | dpkg-deb packs, unpacks and provides information about Debian archives. |
| 85 | |
| 86 | This implementation of dpkg-deb cannot pack archives. |
| 87 | |
| 88 | Unless you have a specific application which requires dpkg-deb, you should |
| 89 | probably say N here. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 90 | |
| 91 | config CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY |
| 92 | bool " extract only (-x)" |
| 93 | default n |
| 94 | depends on CONFIG_DPKG_DEB |
| 95 | help |
Glenn L McGrath | 0337c46 | 2002-12-06 22:40:54 +0000 | [diff] [blame] | 96 | This reduced dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx". |
| 97 | However it saves space as none of the extra dpkg-deb, ar or tar options are |
| 98 | needed, they are linked to internally. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 99 | |
| 100 | config CONFIG_FEATURE_DEB_TAR_GZ |
| 101 | bool " gzip debian packages (normal)" |
| 102 | default y if CONFIG_DPKG || CONFIG_DPKG_DEB |
| 103 | depends on CONFIG_DPKG || CONFIG_DPKG_DEB |
| 104 | help |
Glenn L McGrath | 0337c46 | 2002-12-06 22:40:54 +0000 | [diff] [blame] | 105 | This is the default compression method inside the debian ar file. |
| 106 | |
| 107 | If you want compatability with standard .deb's you should say yes here. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 108 | |
| 109 | config CONFIG_FEATURE_DEB_TAR_BZ2 |
| 110 | bool " bzip2 debian packages" |
| 111 | default n |
| 112 | depends on CONFIG_DPKG || CONFIG_DPKG_DEB |
| 113 | help |
Glenn L McGrath | 0337c46 | 2002-12-06 22:40:54 +0000 | [diff] [blame] | 114 | This allows dpkg and dpkg-deb to extract deb's that are compressed internally |
| 115 | with bzip2 instead of gzip. |
| 116 | |
| 117 | You only want this is your are creating your own custom debian packages that |
| 118 | use an internal control.tar.bz2 or data.tar.bz2. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 119 | |
| 120 | config CONFIG_GUNZIP |
| 121 | bool "gunzip" |
| 122 | default n |
| 123 | help |
Eric Andersen | e564211 | 2003-07-14 19:37:08 +0000 | [diff] [blame] | 124 | gunzip is used to decompress archives created by gzip. |
| 125 | You can use the `-t' option to test the integrity of |
| 126 | an archive, without decompressing it. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 127 | |
| 128 | config CONFIG_FEATURE_GUNZIP_UNCOMPRESS |
| 129 | bool " Uncompress support" |
| 130 | default n |
| 131 | depends on CONFIG_GUNZIP |
| 132 | help |
Eric Andersen | e564211 | 2003-07-14 19:37:08 +0000 | [diff] [blame] | 133 | If you want gunzip to have the ability to decompress |
| 134 | archives created by the program compress (not much |
| 135 | used anymore). |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 136 | |
| 137 | config CONFIG_GZIP |
| 138 | bool "gzip" |
| 139 | default n |
| 140 | help |
Eric Andersen | e564211 | 2003-07-14 19:37:08 +0000 | [diff] [blame] | 141 | gzip is used to compress files. |
| 142 | It's probably the most used UNIX compression program. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 143 | |
| 144 | config CONFIG_RPM2CPIO |
| 145 | bool "rpm2cpio" |
| 146 | default n |
| 147 | help |
Glenn L McGrath | b72a735 | 2002-12-10 00:17:22 +0000 | [diff] [blame] | 148 | Converts an RPM file into a CPIO archive. |
| 149 | |
| 150 | config CONFIG_RPM |
| 151 | bool "rpm" |
| 152 | default n |
| 153 | help |
| 154 | Mini RPM applet - querys and extracts |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 155 | |
| 156 | config CONFIG_TAR |
| 157 | bool "tar" |
| 158 | default n |
| 159 | help |
Eric Andersen | e564211 | 2003-07-14 19:37:08 +0000 | [diff] [blame] | 160 | tar is an archiving program. It's commonly used with gzip to |
| 161 | create compressed archives. It's probably the most used |
| 162 | UNIX archive program. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 163 | |
| 164 | config CONFIG_FEATURE_TAR_CREATE |
| 165 | bool " Enable archive creation" |
| 166 | default y |
| 167 | depends on CONFIG_TAR |
| 168 | help |
Eric Andersen | e564211 | 2003-07-14 19:37:08 +0000 | [diff] [blame] | 169 | If you enable this option you'll be able to create |
| 170 | tar archives using the `-c' option. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 171 | |
| 172 | config CONFIG_FEATURE_TAR_BZIP2 |
| 173 | bool " Enable -j option to handle .tar.bz2 files" |
| 174 | default n |
| 175 | depends on CONFIG_TAR |
| 176 | help |
Eric Andersen | e564211 | 2003-07-14 19:37:08 +0000 | [diff] [blame] | 177 | If you enable this option you'll be able to extract |
| 178 | archives compressed with bzip2. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 179 | |
| 180 | config CONFIG_FEATURE_TAR_EXCLUDE |
| 181 | bool " Enable -X and --exclude options (exclude files)" |
| 182 | default n |
| 183 | depends on CONFIG_TAR |
| 184 | help |
Eric Andersen | e564211 | 2003-07-14 19:37:08 +0000 | [diff] [blame] | 185 | If you enable this option you'll be able to specify |
| 186 | a list of files to exclude from an archive. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 187 | |
| 188 | config CONFIG_FEATURE_TAR_GZIP |
| 189 | bool " Enable -z option" |
| 190 | default y |
| 191 | depends on CONFIG_TAR |
| 192 | help |
Eric Andersen | e564211 | 2003-07-14 19:37:08 +0000 | [diff] [blame] | 193 | If you enable this option tar will be able to call gzip, |
| 194 | when creating or extracting tar gziped archives. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 195 | |
Glenn L McGrath | 21110a0 | 2003-01-28 01:45:48 +0000 | [diff] [blame] | 196 | config CONFIG_FEATURE_TAR_OLDGNU_COMPATABILITY |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 197 | bool " Enable support for old tar header format" |
Glenn L McGrath | 21110a0 | 2003-01-28 01:45:48 +0000 | [diff] [blame] | 198 | default N |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 199 | depends on CONFIG_TAR |
| 200 | help |
Glenn L McGrath | 21110a0 | 2003-01-28 01:45:48 +0000 | [diff] [blame] | 201 | This option is required to unpack archives created with |
| 202 | in the old GNU format, help to kill this old format by |
| 203 | repacking your ancient archives with the new format. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 204 | |
Glenn L McGrath | 21110a0 | 2003-01-28 01:45:48 +0000 | [diff] [blame] | 205 | config CONFIG_FEATURE_TAR_GNU_EXTENSIONS |
| 206 | bool " Enable support for some GNU tar extensions" |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 207 | default y |
| 208 | depends on CONFIG_TAR |
| 209 | help |
Eric Andersen | e564211 | 2003-07-14 19:37:08 +0000 | [diff] [blame] | 210 | With this option busybox supports GNU long filenames and |
| 211 | linknames. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 212 | |
| 213 | config CONFIG_FEATURE_UNARCHIVE_TAPE |
| 214 | bool " Enable tape drive support" |
| 215 | default n |
| 216 | depends on CONFIG_TAR || CONFIG_CPIO |
| 217 | help |
Glenn L McGrath | 21110a0 | 2003-01-28 01:45:48 +0000 | [diff] [blame] | 218 | I dont think this is needed anymore. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 219 | |
| 220 | config CONFIG_UNCOMPRESS |
| 221 | bool "uncompress" |
| 222 | default n |
| 223 | help |
Eric Andersen | e564211 | 2003-07-14 19:37:08 +0000 | [diff] [blame] | 224 | uncompress is used to decompress archives created by compress. |
| 225 | Not much used anymore, replaced by gzip/gunzip. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 226 | |
| 227 | config CONFIG_UNZIP |
| 228 | bool "unzip" |
| 229 | default n |
| 230 | help |
Eric Andersen | e564211 | 2003-07-14 19:37:08 +0000 | [diff] [blame] | 231 | unzip will list or extract files from a ZIP archive, |
| 232 | commonly found on DOS/WIN systems. The default behavior |
| 233 | (with no options) is to extract the archive into the |
| 234 | current directory. Use the `-d' option to extract to a |
| 235 | directory of your choice. |
Eric Andersen | c9f20d9 | 2002-12-05 08:41:41 +0000 | [diff] [blame] | 236 | |
| 237 | endmenu |