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_AR
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 BUSYBOX_CONFIG_FEATURE_AR_LONG_FILENAMES
32 bool "Support for long filenames (not need for debs)"
34 depends on BUSYBOX_CONFIG_AR
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.
41 config BUSYBOX_CONFIG_BUNZIP2
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.
54 config BUSYBOX_CONFIG_BZIP2
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.
67 config BUSYBOX_CONFIG_CPIO
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
81 config BUSYBOX_CONFIG_FEATURE_CPIO_O
82 bool "Support for archive creation"
84 depends on BUSYBOX_CONFIG_CPIO
86 This implementation of cpio can create cpio archives in the "newc"
89 config BUSYBOX_CONFIG_DPKG
93 dpkg is a medium-level tool to install, build, remove and manage Debian packages.
95 This implementation of dpkg has a number of limitations, you should use the
96 official dpkg if possible.
98 config BUSYBOX_CONFIG_DPKG_DEB
102 dpkg-deb packs, unpacks and provides information about Debian archives.
104 This implementation of dpkg-deb cannot pack archives.
106 Unless you have a specific application which requires dpkg-deb, you should
109 config BUSYBOX_CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY
110 bool "Extract only (-x)"
112 depends on BUSYBOX_CONFIG_DPKG_DEB
114 This reduces dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx".
115 However it saves space as none of the extra dpkg-deb, ar or tar options are
116 needed, they are linked to internally.
118 config BUSYBOX_CONFIG_GUNZIP
122 gunzip is used to decompress archives created by gzip.
123 You can use the `-t' option to test the integrity of
124 an archive, without decompressing it.
126 config BUSYBOX_CONFIG_FEATURE_GUNZIP_UNCOMPRESS
127 bool "Uncompress support"
129 depends on BUSYBOX_CONFIG_GUNZIP
131 Enable if you want gunzip to have the ability to decompress
132 archives created by the program compress (not much
135 config BUSYBOX_CONFIG_GZIP
139 gzip is used to compress files.
140 It's probably the most widely used UNIX compression program.
142 config BUSYBOX_CONFIG_RPM2CPIO
146 Converts an RPM file into a CPIO archive.
148 config BUSYBOX_CONFIG_RPM
152 Mini RPM applet - queries and extracts RPM packages.
154 config BUSYBOX_CONFIG_FEATURE_RPM_BZ2
155 bool "Enable handling of rpms with bzip2-compressed data inside"
157 depends on BUSYBOX_CONFIG_RPM
159 Enable handling of rpms with bzip2-compressed data inside.
161 config BUSYBOX_CONFIG_TAR
165 tar is an archiving program. It's commonly used with gzip to
166 create compressed archives. It's probably the most widely used
167 UNIX archive program.
169 config BUSYBOX_CONFIG_FEATURE_TAR_CREATE
170 bool "Enable archive creation"
172 depends on BUSYBOX_CONFIG_TAR
174 If you enable this option you'll be able to create
175 tar archives using the `-c' option.
177 config BUSYBOX_CONFIG_FEATURE_TAR_GZIP
178 bool "Enable -z option"
180 depends on BUSYBOX_CONFIG_TAR
182 If you enable this option tar will be able to call gzip,
183 when creating or extracting tar gziped archives.
185 config BUSYBOX_CONFIG_FEATURE_TAR_BZIP2
186 bool "Enable -j option to handle .tar.bz2 files"
188 depends on BUSYBOX_CONFIG_TAR
190 If you enable this option you'll be able to extract
191 archives compressed with bzip2.
193 config BUSYBOX_CONFIG_FEATURE_TAR_LZMA
194 bool "Enable -a option to handle .tar.lzma files"
196 depends on BUSYBOX_CONFIG_TAR
198 If you enable this option you'll be able to extract
199 archives compressed with lzma.
201 config BUSYBOX_CONFIG_FEATURE_TAR_COMPRESS
202 bool "Enable -Z option"
204 depends on BUSYBOX_CONFIG_TAR
206 If you enable this option tar will be able to call uncompress,
207 when extracting .tar.Z archives.
209 config BUSYBOX_CONFIG_FEATURE_TAR_AUTODETECT
210 bool "Let tar autodetect gz/bz2 compresses tarballs"
212 depends on BUSYBOX_CONFIG_FEATURE_TAR_GZIP || BUSYBOX_CONFIG_FEATURE_TAR_BZIP2
214 With this option tar can automatically detect gzip/bzip2 compressed
215 tarballs. Currently it works only on seekable streams.
217 config BUSYBOX_CONFIG_FEATURE_TAR_FROM
218 bool "Enable -X (exclude from) and -T (include from) options)"
220 depends on BUSYBOX_CONFIG_TAR
222 If you enable this option you'll be able to specify
223 a list of files to include or exclude from an archive.
225 config BUSYBOX_CONFIG_FEATURE_TAR_OLDGNU_COMPATIBILITY
226 bool "Support for old tar header format"
228 depends on BUSYBOX_CONFIG_TAR
230 This option is required to unpack archives created in
231 the old GNU format; help to kill this old format by
232 repacking your ancient archives with the new format.
234 config BUSYBOX_CONFIG_FEATURE_TAR_OLDSUN_COMPATIBILITY
235 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
237 depends on BUSYBOX_CONFIG_TAR
239 This option is required to unpack archives created by some old
240 version of Sun's tar (it was calculating checksum using signed arithmetic).
241 It is said to be fixed in newer Sun tar, but "old" tarballs still exist.
243 config BUSYBOX_CONFIG_FEATURE_TAR_GNU_EXTENSIONS
244 bool "Support for GNU tar extensions (long filenames)"
246 depends on BUSYBOX_CONFIG_TAR
248 With this option busybox supports GNU long filenames and
251 config BUSYBOX_CONFIG_FEATURE_TAR_LONG_OPTIONS
252 bool "Enable long options"
254 depends on BUSYBOX_CONFIG_TAR && BUSYBOX_CONFIG_GETOPT_LONG
256 Enable use of long options, increases size by about 400 Bytes
258 config BUSYBOX_CONFIG_FEATURE_TAR_UNAME_GNAME
259 bool "Enable use of user and group names"
261 depends on BUSYBOX_CONFIG_TAR
263 Enables use of user and group names in tar. This affects contents
264 listings (-t) and preserving permissions when unpacking (-p).
267 config BUSYBOX_CONFIG_UNCOMPRESS
271 uncompress is used to decompress archives created by compress.
272 Not much used anymore, replaced by gzip/gunzip.
274 config BUSYBOX_CONFIG_UNLZMA
278 unlzma is a compression utility using the Lempel-Ziv-Markov chain
279 compression algorithm, and range coding. Compression
280 is generally considerably better than that achieved by the bzip2
283 The BusyBox unlzma applet is limited to de-compression only.
284 On an x86 system, this applet adds about 4K.
286 Unless you have a specific application which requires unlzma, you
287 should probably say N here.
289 config BUSYBOX_CONFIG_FEATURE_LZMA_FAST
290 bool "Optimize unlzma for speed"
292 depends on BUSYBOX_CONFIG_UNLZMA
294 This option reduces decompression time by about 33% at the cost of
297 config BUSYBOX_CONFIG_UNZIP
301 unzip will list or extract files from a ZIP archive,
302 commonly found on DOS/WIN systems. The default behavior
303 (with no options) is to extract the archive into the
304 current directory. Use the `-d' option to extract to a
305 directory of your choice.
307 comment "Common options for cpio and tar"
308 depends on BUSYBOX_CONFIG_CPIO || BUSYBOX_CONFIG_TAR
310 comment "Common options for dpkg and dpkg_deb"
311 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
313 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_GZ
314 bool "gzip debian packages (normal)"
315 default n if BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
316 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
318 This is the default compression method inside the debian ar file.
320 If you want compatibility with standard .deb's you should say yes here.
322 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_BZ2
323 bool "bzip2 debian packages"
325 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
327 This allows dpkg and dpkg-deb to extract deb's that are compressed internally
328 with bzip2 instead of gzip.
330 You only want this if you are creating your own custom debian packages that
331 use an internal control.tar.bz2 or data.tar.bz2.
333 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_LZMA
334 bool "lzma debian packages"
336 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
338 This allows dpkg and dpkg-deb to extract deb's that are compressed
339 internally with lzma instead of gzip.
341 You only want this if you are creating your own custom debian
342 packages that use an internal control.tar.lzma or data.tar.lzma.