2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Archival Utilities"
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
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.
24 This implementation of ar can extract archives, it cannot create or
26 On an x86 system, the ar applet adds about 1K.
28 Unless you have a specific application which requires ar, you should
31 config FEATURE_AR_LONG_FILENAMES
32 bool "Enable support for long filenames (not need for debs)"
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.
45 bunzip2 is a 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.
51 The BusyBox bunzip2 applet is limited to de-compression only.
52 On an x86 system, this applet adds about 11K.
54 Unless you have a specific application which requires bunzip2, you
55 should probably say N here.
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.
65 This implementation of cpio can extract cpio archives created in the
66 "newc" or "crc" format, it cannot create or modify them.
68 Unless you have a specific application which requires cpio, you should
75 dpkg is a medium-level tool to install, build, remove and manage Debian packages.
77 This implementation of dpkg has a number of limitations, you should use the
78 official dpkg if possible.
84 dpkg-deb packs, unpacks and provides information about Debian archives.
86 This implementation of dpkg-deb cannot pack archives.
88 Unless you have a specific application which requires dpkg-deb, you should
91 config FEATURE_DPKG_DEB_EXTRACT_ONLY
92 bool "extract only (-x)"
96 This reduces 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.
104 gunzip is used to decompress archives created by gzip.
105 You can use the `-t' option to test the integrity of
106 an archive, without decompressing it.
108 config FEATURE_GUNZIP_UNCOMPRESS
109 bool "Uncompress support"
113 Enable if you want gunzip to have the ability to decompress
114 archives created by the program compress (not much
121 gzip is used to compress files.
122 It's probably the most widely used UNIX compression program.
128 Converts an RPM file into a CPIO archive.
134 Mini RPM applet - queries and extracts RPM packages.
136 config FEATURE_RPM_BZ2
137 bool "Enable handling of rpms with bzip2-compressed data inside"
141 Enable handling of rpms with bzip2-compressed data inside.
147 tar is an archiving program. It's commonly used with gzip to
148 create compressed archives. It's probably the most widely used
149 UNIX archive program.
151 config FEATURE_TAR_CREATE
152 bool "Enable archive creation"
156 If you enable this option you'll be able to create
157 tar archives using the `-c' option.
159 config FEATURE_TAR_BZIP2
160 bool "Enable -j option to handle .tar.bz2 files"
164 If you enable this option you'll be able to extract
165 archives compressed with bzip2.
167 config FEATURE_TAR_LZMA
168 bool "Enable -a option to handle .tar.lzma files"
172 If you enable this option you'll be able to extract
173 archives compressed with lzma.
175 config FEATURE_TAR_FROM
176 bool "Enable -X (exclude from) and -T (include from) options)"
180 If you enable this option you'll be able to specify
181 a list of files to include or exclude from an archive.
183 config FEATURE_TAR_GZIP
184 bool "Enable -z option"
188 If you enable this option tar will be able to call gzip,
189 when creating or extracting tar gziped archives.
191 config FEATURE_TAR_COMPRESS
192 bool "Enable -Z option"
196 If you enable this option tar will be able to call uncompress,
197 when extracting .tar.Z archives.
199 config FEATURE_TAR_OLDGNU_COMPATIBILITY
200 bool "Enable support for old tar header format"
204 This option is required to unpack archives created in
205 the old GNU format; help to kill this old format by
206 repacking your ancient archives with the new format.
208 config FEATURE_TAR_OLDSUN_COMPATIBILITY
209 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
213 This option is required to unpack archives created by some old
214 version of Sun's tar (it was calculating checksum using signed arithmetic).
215 It is said to be fixed in newer Sun tar, but "old" tarballs still exist.
217 config FEATURE_TAR_GNU_EXTENSIONS
218 bool "Enable support for some GNU tar extensions"
222 With this option busybox supports GNU long filenames and
225 config FEATURE_TAR_LONG_OPTIONS
226 bool "Enable long options"
228 depends on TAR && GETOPT_LONG
230 Enable use of long options, increases size by about 400 Bytes
236 uncompress is used to decompress archives created by compress.
237 Not much used anymore, replaced by gzip/gunzip.
243 unlzma is a compression utility using the Lempel-Ziv-Markov chain
244 compression algorithm, and range coding. Compression
245 is generally considerably better than that achieved by the bzip2
248 The BusyBox unlzma applet is limited to de-compression only.
249 On an x86 system, this applet adds about 4K.
251 Unless you have a specific application which requires unlzma, you
252 should probably say N here.
254 config FEATURE_LZMA_FAST
255 bool "Optimze unlzma for speed"
259 This option reduces decompression time by about 33% at the cost of
266 unzip will list or extract files from a ZIP archive,
267 commonly found on DOS/WIN systems. The default behavior
268 (with no options) is to extract the archive into the
269 current directory. Use the `-d' option to extract to a
270 directory of your choice.
272 comment "Common options for cpio and tar"
273 depends on CPIO || TAR
275 config FEATURE_UNARCHIVE_TAPE
276 bool "Enable tape drive support"
278 depends on CPIO || TAR
280 I don't think this is needed anymore.
282 comment "Common options for dpkg and dpkg_deb"
283 depends on DPKG || DPKG_DEB
285 config FEATURE_DEB_TAR_GZ
286 bool "gzip debian packages (normal)"
287 default y if DPKG || DPKG_DEB
288 depends on DPKG || DPKG_DEB
290 This is the default compression method inside the debian ar file.
292 If you want compatibility with standard .deb's you should say yes here.
294 config FEATURE_DEB_TAR_BZ2
295 bool "bzip2 debian packages"
297 depends on DPKG || DPKG_DEB
299 This allows dpkg and dpkg-deb to extract deb's that are compressed internally
300 with bzip2 instead of gzip.
302 You only want this if you are creating your own custom debian packages that
303 use an internal control.tar.bz2 or data.tar.bz2.
305 config FEATURE_DEB_TAR_LZMA
306 bool "lzma debian packages"
308 depends on DPKG || DPKG_DEB
310 This allows dpkg and dpkg-deb to extract deb's that are compressed
311 internally with lzma instead of gzip.
313 You only want this if you are creating your own custom debian
314 packages that use an internal control.tar.lzma or data.tar.lzma.