2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Archival Utilities"
10 config FEATURE_SEAMLESS_XZ
11 bool "Make tar, rpm, modprobe etc understand .xz data"
14 Make tar, rpm, modprobe etc understand .xz data.
16 config FEATURE_SEAMLESS_LZMA
17 bool "Make tar, rpm, modprobe etc understand .lzma data"
20 Make tar, rpm, modprobe etc understand .lzma data.
22 config FEATURE_SEAMLESS_BZ2
23 bool "Make tar, rpm, modprobe etc understand .bz2 data"
26 Make tar, rpm, modprobe etc understand .bz2 data.
28 config FEATURE_SEAMLESS_GZ
29 bool "Make tar, rpm, modprobe etc understand .gz data"
32 Make tar, rpm, modprobe etc understand .gz data.
34 config FEATURE_SEAMLESS_Z
35 bool "Make tar and gunzip understand .Z data"
38 Make tar and gunzip understand .Z data.
42 default n # needs to be improved to be able to replace binutils ar
44 ar is an archival utility program used to create, modify, and
45 extract contents from archives. An archive is a single file holding
46 a collection of other files in a structure that makes it possible to
47 retrieve the original individual files (called archive members).
48 The original files' contents, mode (permissions), timestamp, owner,
49 and group are preserved in the archive, and can be restored on
52 The stored filename is limited to 15 characters. (for more information
53 see long filename support).
54 ar has 60 bytes of overheads for every stored file.
56 This implementation of ar can extract archives, it cannot create or
58 On an x86 system, the ar applet adds about 1K.
60 Unless you have a specific application which requires ar, you should
63 config FEATURE_AR_LONG_FILENAMES
64 bool "Support for long filenames (not needed for debs)"
68 By default the ar format can only store the first 15 characters
69 of the filename, this option removes that limitation.
70 It supports the GNU ar long filename method which moves multiple long
71 filenames into a the data section of a new ar entry.
73 config FEATURE_AR_CREATE
74 bool "Support archive creation"
78 This enables archive creation (-c and -r) with busybox ar.
84 bunzip2 is a compression utility using the Burrows-Wheeler block
85 sorting text compression algorithm, and Huffman coding. Compression
86 is generally considerably better than that achieved by more
87 conventional LZ77/LZ78-based compressors, and approaches the
88 performance of the PPM family of statistical compressors.
90 Unless you have a specific application which requires bunzip2, you
91 should probably say N here.
97 bzip2 is a compression utility using the Burrows-Wheeler block
98 sorting text compression algorithm, and Huffman coding. Compression
99 is generally considerably better than that achieved by more
100 conventional LZ77/LZ78-based compressors, and approaches the
101 performance of the PPM family of statistical compressors.
103 Unless you have a specific application which requires bzip2, you
104 should probably say N here.
110 cpio is an archival utility program used to create, modify, and
111 extract contents from archives.
112 cpio has 110 bytes of overheads for every stored file.
114 This implementation of cpio can extract cpio archives created in the
115 "newc" or "crc" format, it cannot create or modify them.
117 Unless you have a specific application which requires cpio, you
118 should probably say N here.
120 config FEATURE_CPIO_O
121 bool "Support for archive creation"
125 This implementation of cpio can create cpio archives in the "newc"
128 config FEATURE_CPIO_P
129 bool "Support for passthrough mode"
131 depends on FEATURE_CPIO_O
133 Passthrough mode. Rarely used.
138 select FEATURE_SEAMLESS_GZ
140 dpkg is a medium-level tool to install, build, remove and manage
143 This implementation of dpkg has a number of limitations,
144 you should use the official dpkg if possible.
149 select FEATURE_SEAMLESS_GZ
151 dpkg-deb unpacks and provides information about Debian archives.
153 This implementation of dpkg-deb cannot pack archives.
155 Unless you have a specific application which requires dpkg-deb,
158 config FEATURE_DPKG_DEB_EXTRACT_ONLY
159 bool "Extract only (-x)"
163 This reduces dpkg-deb to the equivalent of
164 "ar -p <deb> data.tar.gz | tar -zx". However it saves space as none
165 of the extra dpkg-deb, ar or tar options are needed, they are linked
172 gunzip is used to decompress archives created by gzip.
173 You can use the `-t' option to test the integrity of
174 an archive, without decompressing it.
180 gzip is used to compress files.
181 It's probably the most widely used UNIX compression program.
183 config FEATURE_GZIP_LONG_OPTIONS
184 bool "Enable long options"
186 depends on GZIP && LONG_OPTS
188 Enable use of long options, increases size by about 106 Bytes
194 Lzop compression/decompresion.
196 config LZOP_COMPR_HIGH
197 bool "lzop complession levels 7,8,9 (not very useful)"
201 High levels (7,8,9) of lzop compression. These levels
202 are actually slower than gzip at equivalent compression ratios
203 and take up 3.2K of code.
209 Converts an RPM file into a CPIO archive.
215 Mini RPM applet - queries and extracts RPM packages.
221 tar is an archiving program. It's commonly used with gzip to
222 create compressed archives. It's probably the most widely used
223 UNIX archive program.
225 config FEATURE_TAR_CREATE
226 bool "Enable archive creation"
230 If you enable this option you'll be able to create
231 tar archives using the `-c' option.
233 config FEATURE_TAR_AUTODETECT
234 bool "Autodetect compressed tarballs"
236 depends on TAR && (FEATURE_SEAMLESS_Z || FEATURE_SEAMLESS_GZ || FEATURE_SEAMLESS_BZ2 || FEATURE_SEAMLESS_LZMA || FEATURE_SEAMLESS_XZ)
238 With this option tar can automatically detect compressed
239 tarballs. Currently it works only on files (not pipes etc).
241 config FEATURE_TAR_FROM
242 bool "Enable -X (exclude from) and -T (include from) options)"
246 If you enable this option you'll be able to specify
247 a list of files to include or exclude from an archive.
249 config FEATURE_TAR_OLDGNU_COMPATIBILITY
250 bool "Support for old tar header format"
252 depends on TAR || DPKG
254 This option is required to unpack archives created in
255 the old GNU format; help to kill this old format by
256 repacking your ancient archives with the new format.
258 config FEATURE_TAR_OLDSUN_COMPATIBILITY
259 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
261 depends on TAR || DPKG
263 This option is required to unpack archives created by some old
264 version of Sun's tar (it was calculating checksum using signed
265 arithmetic). It is said to be fixed in newer Sun tar, but "old"
266 tarballs still exist.
268 config FEATURE_TAR_GNU_EXTENSIONS
269 bool "Support for GNU tar extensions (long filenames)"
271 depends on TAR || DPKG
273 With this option busybox supports GNU long filenames and
276 config FEATURE_TAR_LONG_OPTIONS
277 bool "Enable long options"
279 depends on TAR && LONG_OPTS
281 Enable use of long options, increases size by about 400 Bytes
283 config FEATURE_TAR_TO_COMMAND
284 bool "Support for writing to an external program"
286 depends on TAR && FEATURE_TAR_LONG_OPTIONS
288 If you enable this option you'll be able to instruct tar to send
289 the contents of each extracted file to the standard input of an
292 config FEATURE_TAR_UNAME_GNAME
293 bool "Enable use of user and group names"
297 Enables use of user and group names in tar. This affects contents
298 listings (-t) and preserving permissions when unpacking (-p).
301 config FEATURE_TAR_NOPRESERVE_TIME
302 bool "Enable -m (do not preserve time) option"
306 With this option busybox supports GNU tar -m
307 (do not preserve time) option.
309 config FEATURE_TAR_SELINUX
310 bool "Support for extracting SELinux labels"
312 depends on TAR && SELINUX
314 With this option busybox supports restoring SELinux labels
315 when extracting files from tar archives.
321 uncompress is used to decompress archives created by compress.
322 Not much used anymore, replaced by gzip/gunzip.
328 unlzma is a compression utility using the Lempel-Ziv-Markov chain
329 compression algorithm, and range coding. Compression
330 is generally considerably better than that achieved by the bzip2
333 The BusyBox unlzma applet is limited to de-compression only.
334 On an x86 system, this applet adds about 4K.
336 Unless you have a specific application which requires unlzma, you
337 should probably say N here.
339 config FEATURE_LZMA_FAST
340 bool "Optimize unlzma for speed"
344 This option reduces decompression time by about 25% at the cost of
348 bool "Provide lzma alias which supports only unpacking"
352 Enable this option if you want commands like "lzma -d" to work.
353 IOW: you'll get lzma applet, but it will always require -d option.
359 unxz is a unlzma successor.
362 bool "Provide xz alias which supports only unpacking"
366 Enable this option if you want commands like "xz -d" to work.
367 IOW: you'll get xz applet, but it will always require -d option.
373 unzip will list or extract files from a ZIP archive,
374 commonly found on DOS/WIN systems. The default behavior
375 (with no options) is to extract the archive into the
376 current directory. Use the `-d' option to extract to a
377 directory of your choice.