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 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 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 extract
72 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 should
85 dpkg is a medium-level tool to install, build, remove and manage Debian packages.
87 This implementation of dpkg has a number of limitations, you should use the
88 official dpkg if possible.
94 dpkg-deb packs, unpacks and provides information about Debian archives.
96 This implementation of dpkg-deb cannot pack archives.
98 Unless you have a specific application which requires dpkg-deb, you should
101 config FEATURE_DPKG_DEB_EXTRACT_ONLY
102 bool "Extract only (-x)"
106 This reduces dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx".
107 However it saves space as none of the extra dpkg-deb, ar or tar options are
108 needed, they are linked to internally.
114 gunzip is used to decompress archives created by gzip.
115 You can use the `-t' option to test the integrity of
116 an archive, without decompressing it.
118 config FEATURE_GUNZIP_UNCOMPRESS
119 bool "Uncompress support"
123 Enable if you want gunzip to have the ability to decompress
124 archives created by the program compress (not much
131 gzip is used to compress files.
132 It's probably the most widely used UNIX compression program.
138 Converts an RPM file into a CPIO archive.
144 Mini RPM applet - queries and extracts RPM packages.
146 config FEATURE_RPM_BZ2
147 bool "Enable handling of rpms with bzip2-compressed data inside"
151 Enable handling of rpms with bzip2-compressed data inside.
157 tar is an archiving program. It's commonly used with gzip to
158 create compressed archives. It's probably the most widely used
159 UNIX archive program.
161 config FEATURE_TAR_CREATE
162 bool "Enable archive creation"
166 If you enable this option you'll be able to create
167 tar archives using the `-c' option.
169 config FEATURE_TAR_GZIP
170 bool "Enable -z option"
174 If you enable this option tar will be able to call gzip,
175 when creating or extracting tar gziped archives.
177 config FEATURE_TAR_BZIP2
178 bool "Enable -j option to handle .tar.bz2 files"
182 If you enable this option you'll be able to extract
183 archives compressed with bzip2.
185 config FEATURE_TAR_LZMA
186 bool "Enable -a option to handle .tar.lzma files"
190 If you enable this option you'll be able to extract
191 archives compressed with lzma.
193 config FEATURE_TAR_COMPRESS
194 bool "Enable -Z option"
198 If you enable this option tar will be able to call uncompress,
199 when extracting .tar.Z archives.
201 config FEATURE_TAR_AUTODETECT
202 bool "Let tar autodetect gz/bz2 compresses tarballs"
204 depends on FEATURE_TAR_GZIP || FEATURE_TAR_BZIP2
206 With this option tar can automatically detect gzip/bzip2 compressed
207 tarballs. Currently it works only on seekable streams.
209 config FEATURE_TAR_FROM
210 bool "Enable -X (exclude from) and -T (include from) options)"
214 If you enable this option you'll be able to specify
215 a list of files to include or exclude from an archive.
217 config FEATURE_TAR_OLDGNU_COMPATIBILITY
218 bool "Support for old tar header format"
222 This option is required to unpack archives created in
223 the old GNU format; help to kill this old format by
224 repacking your ancient archives with the new format.
226 config FEATURE_TAR_OLDSUN_COMPATIBILITY
227 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
231 This option is required to unpack archives created by some old
232 version of Sun's tar (it was calculating checksum using signed arithmetic).
233 It is said to be fixed in newer Sun tar, but "old" tarballs still exist.
235 config FEATURE_TAR_GNU_EXTENSIONS
236 bool "Support for GNU tar extensions (long filenames)"
240 With this option busybox supports GNU long filenames and
243 config FEATURE_TAR_LONG_OPTIONS
244 bool "Enable long options"
246 depends on TAR && GETOPT_LONG
248 Enable use of long options, increases size by about 400 Bytes
250 config FEATURE_TAR_UNAME_GNAME
251 bool "Enable use of user and group names"
255 Enables use of user and group names in tar. This affects contents
256 listings (-t) and preserving permissions when unpacking (-p).
263 uncompress is used to decompress archives created by compress.
264 Not much used anymore, replaced by gzip/gunzip.
270 unlzma is a compression utility using the Lempel-Ziv-Markov chain
271 compression algorithm, and range coding. Compression
272 is generally considerably better than that achieved by the bzip2
275 The BusyBox unlzma applet is limited to de-compression only.
276 On an x86 system, this applet adds about 4K.
278 Unless you have a specific application which requires unlzma, you
279 should probably say N here.
281 config FEATURE_LZMA_FAST
282 bool "Optimze unlzma for speed"
286 This option reduces decompression time by about 33% at the cost of
293 unzip will list or extract files from a ZIP archive,
294 commonly found on DOS/WIN systems. The default behavior
295 (with no options) is to extract the archive into the
296 current directory. Use the `-d' option to extract to a
297 directory of your choice.
299 comment "Common options for cpio and tar"
300 depends on CPIO || TAR
302 config FEATURE_UNARCHIVE_TAPE
303 bool "Enable tape drive support"
305 depends on CPIO || TAR
307 I don't think this is needed anymore.
309 comment "Common options for dpkg and dpkg_deb"
310 depends on DPKG || DPKG_DEB
312 config FEATURE_DEB_TAR_GZ
313 bool "gzip debian packages (normal)"
314 default y if DPKG || DPKG_DEB
315 depends on DPKG || DPKG_DEB
317 This is the default compression method inside the debian ar file.
319 If you want compatibility with standard .deb's you should say yes here.
321 config FEATURE_DEB_TAR_BZ2
322 bool "bzip2 debian packages"
324 depends on DPKG || DPKG_DEB
326 This allows dpkg and dpkg-deb to extract deb's that are compressed internally
327 with bzip2 instead of gzip.
329 You only want this if you are creating your own custom debian packages that
330 use an internal control.tar.bz2 or data.tar.bz2.
332 config FEATURE_DEB_TAR_LZMA
333 bool "lzma debian packages"
335 depends on DPKG || DPKG_DEB
337 This allows dpkg and dpkg-deb to extract deb's that are compressed
338 internally with lzma instead of gzip.
340 You only want this if you are creating your own custom debian
341 packages that use an internal control.tar.lzma or data.tar.lzma.