2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Archival Utilities"
8 config BUSYBOX_CONFIG_FEATURE_SEAMLESS_XZ
9 bool "Make tar, rpm, modprobe etc understand .xz data"
12 Make tar, rpm, modprobe etc understand .xz data.
14 config BUSYBOX_CONFIG_FEATURE_SEAMLESS_LZMA
15 bool "Make tar, rpm, modprobe etc understand .lzma data"
18 Make tar, rpm, modprobe etc understand .lzma data.
20 config BUSYBOX_CONFIG_FEATURE_SEAMLESS_BZ2
21 bool "Make tar, rpm, modprobe etc understand .bz2 data"
24 Make tar, rpm, modprobe etc understand .bz2 data.
26 config BUSYBOX_CONFIG_FEATURE_SEAMLESS_GZ
27 bool "Make tar, rpm, modprobe etc understand .gz data"
30 Make tar, rpm, modprobe etc understand .gz data.
32 config BUSYBOX_CONFIG_FEATURE_SEAMLESS_Z
33 bool "Make tar and gunzip understand .Z data"
36 Make tar and gunzip understand .Z data.
38 config BUSYBOX_CONFIG_AR
42 ar is an archival utility program used to create, modify, and
43 extract contents from archives. An archive is a single file holding
44 a collection of other files in a structure that makes it possible to
45 retrieve the original individual files (called archive members).
46 The original files' contents, mode (permissions), timestamp, owner,
47 and group are preserved in the archive, and can be restored on
50 The stored filename is limited to 15 characters. (for more information
51 see long filename support).
52 ar has 60 bytes of overheads for every stored file.
54 This implementation of ar can extract archives, it cannot create or
56 On an x86 system, the ar applet adds about 1K.
58 Unless you have a specific application which requires ar, you should
61 config BUSYBOX_CONFIG_FEATURE_AR_LONG_FILENAMES
62 bool "Support for long filenames (not needed for debs)"
64 depends on BUSYBOX_CONFIG_AR
66 By default the ar format can only store the first 15 characters
67 of the filename, this option removes that limitation.
68 It supports the GNU ar long filename method which moves multiple long
69 filenames into a the data section of a new ar entry.
71 config BUSYBOX_CONFIG_FEATURE_AR_CREATE
72 bool "Support archive creation"
74 depends on BUSYBOX_CONFIG_AR
76 This enables archive creation (-c and -r) with busybox ar.
78 config BUSYBOX_CONFIG_BUNZIP2
82 bunzip2 is a compression utility using the Burrows-Wheeler block
83 sorting text compression algorithm, and Huffman coding. Compression
84 is generally considerably better than that achieved by more
85 conventional LZ77/LZ78-based compressors, and approaches the
86 performance of the PPM family of statistical compressors.
88 Unless you have a specific application which requires bunzip2, you
89 should probably say N here.
91 config BUSYBOX_CONFIG_BZIP2
95 bzip2 is a compression utility using the Burrows-Wheeler block
96 sorting text compression algorithm, and Huffman coding. Compression
97 is generally considerably better than that achieved by more
98 conventional LZ77/LZ78-based compressors, and approaches the
99 performance of the PPM family of statistical compressors.
101 Unless you have a specific application which requires bzip2, you
102 should probably say N here.
104 config BUSYBOX_CONFIG_CPIO
108 cpio is an archival utility program used to create, modify, and
109 extract contents from archives.
110 cpio has 110 bytes of overheads for every stored file.
112 This implementation of cpio can extract cpio archives created in the
113 "newc" or "crc" format, it cannot create or modify them.
115 Unless you have a specific application which requires cpio, you
116 should probably say N here.
118 config BUSYBOX_CONFIG_FEATURE_CPIO_O
119 bool "Support for archive creation"
121 depends on BUSYBOX_CONFIG_CPIO
123 This implementation of cpio can create cpio archives in the "newc"
126 config BUSYBOX_CONFIG_FEATURE_CPIO_P
127 bool "Support for passthrough mode"
129 depends on BUSYBOX_CONFIG_FEATURE_CPIO_O
131 Passthrough mode. Rarely used.
133 config BUSYBOX_CONFIG_DPKG
136 select BUSYBOX_CONFIG_FEATURE_SEAMLESS_GZ
138 dpkg is a medium-level tool to install, build, remove and manage
141 This implementation of dpkg has a number of limitations,
142 you should use the official dpkg if possible.
144 config BUSYBOX_CONFIG_DPKG_DEB
147 select BUSYBOX_CONFIG_FEATURE_SEAMLESS_GZ
149 dpkg-deb unpacks and provides information about Debian archives.
151 This implementation of dpkg-deb cannot pack archives.
153 Unless you have a specific application which requires dpkg-deb,
156 config BUSYBOX_CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY
157 bool "Extract only (-x)"
159 depends on BUSYBOX_CONFIG_DPKG_DEB
161 This reduces dpkg-deb to the equivalent of
162 "ar -p <deb> data.tar.gz | tar -zx". However it saves space as none
163 of the extra dpkg-deb, ar or tar options are needed, they are linked
166 config BUSYBOX_CONFIG_GUNZIP
170 gunzip is used to decompress archives created by gzip.
171 You can use the `-t' option to test the integrity of
172 an archive, without decompressing it.
174 config BUSYBOX_CONFIG_GZIP
178 gzip is used to compress files.
179 It's probably the most widely used UNIX compression program.
181 config BUSYBOX_CONFIG_FEATURE_GZIP_LONG_OPTIONS
182 bool "Enable long options"
184 depends on BUSYBOX_CONFIG_GZIP && BUSYBOX_CONFIG_LONG_OPTS
186 Enable use of long options, increases size by about 106 Bytes
188 config BUSYBOX_CONFIG_LZOP
192 Lzop compression/decompresion.
194 config BUSYBOX_CONFIG_LZOP_COMPR_HIGH
195 bool "lzop complession levels 7,8,9 (not very useful)"
197 depends on BUSYBOX_CONFIG_LZOP
199 High levels (7,8,9) of lzop compression. These levels
200 are actually slower than gzip at equivalent compression ratios
201 and take up 3.2K of code.
203 config BUSYBOX_CONFIG_RPM2CPIO
207 Converts a RPM file into a CPIO archive.
209 config BUSYBOX_CONFIG_RPM
213 Mini RPM applet - queries and extracts RPM packages.
215 config BUSYBOX_CONFIG_TAR
219 tar is an archiving program. It's commonly used with gzip to
220 create compressed archives. It's probably the most widely used
221 UNIX archive program.
223 config BUSYBOX_CONFIG_FEATURE_TAR_CREATE
224 bool "Enable archive creation"
226 depends on BUSYBOX_CONFIG_TAR
228 If you enable this option you'll be able to create
229 tar archives using the `-c' option.
231 config BUSYBOX_CONFIG_FEATURE_TAR_AUTODETECT
232 bool "Autodetect compressed tarballs"
234 depends on BUSYBOX_CONFIG_TAR && (BUSYBOX_CONFIG_FEATURE_SEAMLESS_Z || BUSYBOX_CONFIG_FEATURE_SEAMLESS_GZ || BUSYBOX_CONFIG_FEATURE_SEAMLESS_BZ2 || BUSYBOX_CONFIG_FEATURE_SEAMLESS_LZMA || BUSYBOX_CONFIG_FEATURE_SEAMLESS_XZ)
236 With this option tar can automatically detect compressed
237 tarballs. Currently it works only on files (not pipes etc).
239 config BUSYBOX_CONFIG_FEATURE_TAR_FROM
240 bool "Enable -X (exclude from) and -T (include from) options)"
242 depends on BUSYBOX_CONFIG_TAR
244 If you enable this option you'll be able to specify
245 a list of files to include or exclude from an archive.
247 config BUSYBOX_CONFIG_FEATURE_TAR_OLDGNU_COMPATIBILITY
248 bool "Support for old tar header format"
250 depends on BUSYBOX_CONFIG_TAR || BUSYBOX_CONFIG_DPKG
252 This option is required to unpack archives created in
253 the old GNU format; help to kill this old format by
254 repacking your ancient archives with the new format.
256 config BUSYBOX_CONFIG_FEATURE_TAR_OLDSUN_COMPATIBILITY
257 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
259 depends on BUSYBOX_CONFIG_TAR || BUSYBOX_CONFIG_DPKG
261 This option is required to unpack archives created by some old
262 version of Sun's tar (it was calculating checksum using signed
263 arithmetic). It is said to be fixed in newer Sun tar, but "old"
264 tarballs still exist.
266 config BUSYBOX_CONFIG_FEATURE_TAR_GNU_EXTENSIONS
267 bool "Support for GNU tar extensions (long filenames)"
269 depends on BUSYBOX_CONFIG_TAR || BUSYBOX_CONFIG_DPKG
271 With this option busybox supports GNU long filenames and
274 config BUSYBOX_CONFIG_FEATURE_TAR_LONG_OPTIONS
275 bool "Enable long options"
277 depends on BUSYBOX_CONFIG_TAR && BUSYBOX_CONFIG_LONG_OPTS
279 Enable use of long options, increases size by about 400 Bytes
281 config BUSYBOX_CONFIG_FEATURE_TAR_TO_COMMAND
282 bool "Support for writing to an external program"
284 depends on BUSYBOX_CONFIG_TAR && BUSYBOX_CONFIG_FEATURE_TAR_LONG_OPTIONS
286 If you enable this option you'll be able to instruct tar to send
287 the contents of each extracted file to the standard input of an
290 config BUSYBOX_CONFIG_FEATURE_TAR_UNAME_GNAME
291 bool "Enable use of user and group names"
293 depends on BUSYBOX_CONFIG_TAR
295 Enables use of user and group names in tar. This affects contents
296 listings (-t) and preserving permissions when unpacking (-p).
299 config BUSYBOX_CONFIG_FEATURE_TAR_NOPRESERVE_TIME
300 bool "Enable -m (do not preserve time) option"
302 depends on BUSYBOX_CONFIG_TAR
304 With this option busybox supports GNU tar -m
305 (do not preserve time) option.
307 config BUSYBOX_CONFIG_FEATURE_TAR_SELINUX
308 bool "Support for extracting SELinux labels"
310 depends on BUSYBOX_CONFIG_TAR && BUSYBOX_CONFIG_SELINUX
312 With this option busybox supports restoring SELinux labels
313 when extracting files from tar archives.
315 config BUSYBOX_CONFIG_UNCOMPRESS
319 uncompress is used to decompress archives created by compress.
320 Not much used anymore, replaced by gzip/gunzip.
322 config BUSYBOX_CONFIG_UNLZMA
326 unlzma is a compression utility using the Lempel-Ziv-Markov chain
327 compression algorithm, and range coding. Compression
328 is generally considerably better than that achieved by the bzip2
331 The BusyBox unlzma applet is limited to de-compression only.
332 On an x86 system, this applet adds about 4K.
334 Unless you have a specific application which requires unlzma, you
335 should probably say N here.
337 config BUSYBOX_CONFIG_FEATURE_LZMA_FAST
338 bool "Optimize unlzma for speed"
340 depends on BUSYBOX_CONFIG_UNLZMA
342 This option reduces decompression time by about 25% at the cost of
345 config BUSYBOX_CONFIG_LZMA
346 bool "Provide lzma alias which supports only unpacking"
348 depends on BUSYBOX_CONFIG_UNLZMA
350 Enable this option if you want commands like "lzma -d" to work.
351 IOW: you'll get lzma applet, but it will always require -d option.
353 config BUSYBOX_CONFIG_UNXZ
357 unxz is a unlzma successor.
359 config BUSYBOX_CONFIG_XZ
360 bool "Provide xz alias which supports only unpacking"
362 depends on BUSYBOX_CONFIG_UNXZ
364 Enable this option if you want commands like "xz -d" to work.
365 IOW: you'll get xz applet, but it will always require -d option.
367 config BUSYBOX_CONFIG_UNZIP
371 unzip will list or extract files from a ZIP archive,
372 commonly found on DOS/WIN systems. The default behavior
373 (with no options) is to extract the archive into the
374 current directory. Use the `-d' option to extract to a
375 directory of your choice.