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 "Support for long filenames (not need for debs)"
36 By default the ar format can only store the first 15 characters of
37 the 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 Unless you have a specific application which requires bunzip2, you
52 should probably say N here.
58 bzip2 is a compression utility using the Burrows-Wheeler block
59 sorting text compression algorithm, and Huffman coding. Compression
60 is generally considerably better than that achieved by more
61 conventional LZ77/LZ78-based compressors, and approaches the
62 performance of the PPM family of statistical compressors.
64 Unless you have a specific application which requires bzip2, you
65 should probably say N here.
71 cpio is an archival utility program used to create, modify, and
72 extract contents from archives.
73 cpio has 110 bytes of overheads for every stored file.
75 This implementation of cpio can extract cpio archives created in the
76 "newc" or "crc" format, it cannot create or modify them.
78 Unless you have a specific application which requires cpio, you
79 should probably say N here.
82 bool "Support for archive creation"
86 This implementation of cpio can create cpio archives in the "newc"
93 dpkg is a medium-level tool to install, build, remove and manage
96 This implementation of dpkg has a number of limitations,
97 you should use the official dpkg if possible.
103 dpkg-deb packs, unpacks and provides information about Debian
106 This implementation of dpkg-deb cannot pack archives.
108 Unless you have a specific application which requires dpkg-deb,
111 config FEATURE_DPKG_DEB_EXTRACT_ONLY
112 bool "Extract only (-x)"
116 This reduces dpkg-deb to the equivalent of
117 "ar -p <deb> data.tar.gz | tar -zx". However it saves space as none
118 of the extra dpkg-deb, ar or tar options are needed, they are linked
125 gunzip is used to decompress archives created by gzip.
126 You can use the `-t' option to test the integrity of
127 an archive, without decompressing it.
129 config FEATURE_GUNZIP_UNCOMPRESS
130 bool "Uncompress support"
134 Enable if you want gunzip to have the ability to decompress
135 archives created by the program compress (not much
142 gzip is used to compress files.
143 It's probably the most widely used UNIX compression program.
149 Converts an RPM file into a CPIO archive.
155 Mini RPM applet - queries and extracts RPM packages.
157 config FEATURE_RPM_BZ2
158 bool "Enable handling of rpms with bzip2-compressed data inside"
162 Enable handling of rpms with bzip2-compressed data inside.
168 tar is an archiving program. It's commonly used with gzip to
169 create compressed archives. It's probably the most widely used
170 UNIX archive program.
174 config FEATURE_TAR_CREATE
175 bool "Enable archive creation"
179 If you enable this option you'll be able to create
180 tar archives using the `-c' option.
182 config FEATURE_TAR_GZIP
183 bool "Enable -z option"
187 If you enable this option tar will be able to call gzip,
188 when creating or extracting tar gziped archives.
190 config FEATURE_TAR_BZIP2
191 bool "Enable -j option to handle .tar.bz2 files"
195 If you enable this option you'll be able to extract
196 archives compressed with bzip2.
198 config FEATURE_TAR_LZMA
199 bool "Enable -a option to handle .tar.lzma files"
203 If you enable this option you'll be able to extract
204 archives compressed with lzma.
206 config FEATURE_TAR_COMPRESS
207 bool "Enable -Z option"
211 If you enable this option tar will be able to call uncompress,
212 when extracting .tar.Z archives.
214 config FEATURE_TAR_AUTODETECT
215 bool "Autodetect gz/bz2 compresses tarballs"
217 depends on FEATURE_TAR_GZIP || FEATURE_TAR_BZIP2
219 With this option tar can automatically detect gzip/bzip2 compressed
220 tarballs. Currently it works only on files (not pipes etc).
222 config FEATURE_TAR_FROM
223 bool "Enable -X (exclude from) and -T (include from) options)"
227 If you enable this option you'll be able to specify
228 a list of files to include or exclude from an archive.
230 config FEATURE_TAR_OLDGNU_COMPATIBILITY
231 bool "Support for old tar header format"
235 This option is required to unpack archives created in
236 the old GNU format; help to kill this old format by
237 repacking your ancient archives with the new format.
239 config FEATURE_TAR_OLDSUN_COMPATIBILITY
240 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
244 This option is required to unpack archives created by some old
245 version of Sun's tar (it was calculating checksum using signed
246 arithmetic). It is said to be fixed in newer Sun tar, but "old"
247 tarballs still exist.
249 config FEATURE_TAR_GNU_EXTENSIONS
250 bool "Support for GNU tar extensions (long filenames)"
254 With this option busybox supports GNU long filenames and
257 config FEATURE_TAR_LONG_OPTIONS
258 bool "Enable long options"
260 depends on TAR && GETOPT_LONG
262 Enable use of long options, increases size by about 400 Bytes
264 config FEATURE_TAR_UNAME_GNAME
265 bool "Enable use of user and group names"
269 Enables use of user and group names in tar. This affects contents
270 listings (-t) and preserving permissions when unpacking (-p).
279 uncompress is used to decompress archives created by compress.
280 Not much used anymore, replaced by gzip/gunzip.
286 unlzma is a compression utility using the Lempel-Ziv-Markov chain
287 compression algorithm, and range coding. Compression
288 is generally considerably better than that achieved by the bzip2
291 The BusyBox unlzma applet is limited to de-compression only.
292 On an x86 system, this applet adds about 4K.
294 Unless you have a specific application which requires unlzma, you
295 should probably say N here.
297 config FEATURE_LZMA_FAST
298 bool "Optimize unlzma for speed"
302 This option reduces decompression time by about 33% at the cost of
309 unzip will list or extract files from a ZIP archive,
310 commonly found on DOS/WIN systems. The default behavior
311 (with no options) is to extract the archive into the
312 current directory. Use the `-d' option to extract to a
313 directory of your choice.
315 comment "Common options for cpio and tar"
316 depends on CPIO || TAR
318 comment "Common options for dpkg and dpkg_deb"
319 depends on DPKG || DPKG_DEB
321 config FEATURE_DEB_TAR_GZ
322 bool "gzip debian packages (normal)"
323 default y if DPKG || DPKG_DEB
324 depends on DPKG || DPKG_DEB
326 This is the default compression method inside the debian ar file.
328 If you want compatibility with standard .deb's you should say yes
331 config FEATURE_DEB_TAR_BZ2
332 bool "bzip2 debian packages"
334 depends on DPKG || DPKG_DEB
336 This allows dpkg and dpkg-deb to extract deb's that are compressed
337 internally with bzip2 instead of gzip.
339 You only want this if you are creating your own custom debian
340 packages that use an internal control.tar.bz2 or data.tar.bz2.
342 config FEATURE_DEB_TAR_LZMA
343 bool "lzma debian packages"
345 depends on DPKG || DPKG_DEB
347 This allows dpkg and dpkg-deb to extract deb's that are compressed
348 internally with lzma instead of gzip.
350 You only want this if you are creating your own custom debian
351 packages that use an internal control.tar.lzma or data.tar.lzma.