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 "Enable 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_DPKG
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.
90 config BUSYBOX_CONFIG_DPKG_DEB
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 BUSYBOX_CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY
102 bool "extract only (-x)"
104 depends on BUSYBOX_CONFIG_DPKG_DEB
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.
110 config BUSYBOX_CONFIG_GUNZIP
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 BUSYBOX_CONFIG_FEATURE_GUNZIP_UNCOMPRESS
119 bool "Uncompress support"
121 depends on BUSYBOX_CONFIG_GUNZIP
123 Enable if you want gunzip to have the ability to decompress
124 archives created by the program compress (not much
127 config BUSYBOX_CONFIG_GZIP
131 gzip is used to compress files.
132 It's probably the most widely used UNIX compression program.
134 config BUSYBOX_CONFIG_IPKG
137 select BUSYBOX_CONFIG_MD5SUM
138 select BUSYBOX_CONFIG_WGET
139 select BUSYBOX_CONFIG_DIFF
140 select BUSYBOX_CONFIG_TAR
141 select BUSYBOX_CONFIG_GUNZIP
143 ipkg is the itsy package management system.
145 config BUSYBOX_CONFIG_RPM2CPIO
149 Converts an RPM file into a CPIO archive.
151 config BUSYBOX_CONFIG_RPM
155 Mini RPM applet - queries and extracts RPM packages.
157 config BUSYBOX_CONFIG_FEATURE_RPM_BZ2
158 bool "Enable handling of rpms with bzip2-compressed data inside"
160 depends on BUSYBOX_CONFIG_RPM
162 Enable handling of rpms with bzip2-compressed data inside.
164 config BUSYBOX_CONFIG_TAR
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.
172 config BUSYBOX_CONFIG_FEATURE_TAR_CREATE
173 bool "Enable archive creation"
175 depends on BUSYBOX_CONFIG_TAR
177 If you enable this option you'll be able to create
178 tar archives using the `-c' option.
180 config BUSYBOX_CONFIG_FEATURE_TAR_BZIP2
181 bool "Enable -j option to handle .tar.bz2 files"
183 depends on BUSYBOX_CONFIG_TAR
185 If you enable this option you'll be able to extract
186 archives compressed with bzip2.
188 config BUSYBOX_CONFIG_FEATURE_TAR_LZMA
189 bool "Enable -a option to handle .tar.lzma files"
191 depends on BUSYBOX_CONFIG_TAR
193 If you enable this option you'll be able to extract
194 archives compressed with lzma.
196 config BUSYBOX_CONFIG_FEATURE_TAR_FROM
197 bool "Enable -X (exclude from) and -T (include from) options)"
199 depends on BUSYBOX_CONFIG_TAR
201 If you enable this option you'll be able to specify
202 a list of files to include or exclude from an archive.
204 config BUSYBOX_CONFIG_FEATURE_TAR_GZIP
205 bool "Enable -z option"
207 depends on BUSYBOX_CONFIG_TAR
209 If you enable this option tar will be able to call gzip,
210 when creating or extracting tar gziped archives.
212 config BUSYBOX_CONFIG_FEATURE_TAR_COMPRESS
213 bool "Enable -Z option"
215 depends on BUSYBOX_CONFIG_TAR
217 If you enable this option tar will be able to call uncompress,
218 when extracting .tar.Z archives.
220 config BUSYBOX_CONFIG_FEATURE_TAR_OLDGNU_COMPATIBILITY
221 bool "Enable support for old tar header format"
223 depends on BUSYBOX_CONFIG_TAR
225 This option is required to unpack archives created in
226 the old GNU format; help to kill this old format by
227 repacking your ancient archives with the new format.
229 config BUSYBOX_CONFIG_FEATURE_TAR_OLDSUN_COMPATIBILITY
230 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
232 depends on BUSYBOX_CONFIG_TAR
234 This option is required to unpack archives created by some old
235 version of Sun's tar (it was calculating checksum using signed arithmetic).
236 It is said to be fixed in newer Sun tar, but "old" tarballs still exist.
238 config BUSYBOX_CONFIG_FEATURE_TAR_GNU_EXTENSIONS
239 bool "Enable support for some GNU tar extensions"
241 depends on BUSYBOX_CONFIG_TAR
243 With this option busybox supports GNU long filenames and
246 config BUSYBOX_CONFIG_FEATURE_TAR_LONG_OPTIONS
247 bool "Enable long options"
249 depends on BUSYBOX_CONFIG_TAR && BUSYBOX_CONFIG_GETOPT_LONG
251 Enable use of long options, increases size by about 400 Bytes
253 config BUSYBOX_CONFIG_UNCOMPRESS
257 uncompress is used to decompress archives created by compress.
258 Not much used anymore, replaced by gzip/gunzip.
260 config BUSYBOX_CONFIG_UNLZMA
264 unlzma is a compression utility using the Lempel-Ziv-Markov chain
265 compression algorithm, and range coding. Compression
266 is generally considerably better than that achieved by the bzip2
269 The BusyBox unlzma applet is limited to de-compression only.
270 On an x86 system, this applet adds about 4K.
272 Unless you have a specific application which requires unlzma, you
273 should probably say N here.
275 config BUSYBOX_CONFIG_FEATURE_LZMA_FAST
276 bool "Optimze unlzma for speed"
278 depends on BUSYBOX_CONFIG_UNLZMA
280 This option reduces decompression time by about 33% at the cost of
283 config BUSYBOX_CONFIG_UNZIP
287 unzip will list or extract files from a ZIP archive,
288 commonly found on DOS/WIN systems. The default behavior
289 (with no options) is to extract the archive into the
290 current directory. Use the `-d' option to extract to a
291 directory of your choice.
293 comment "Common options for cpio and tar"
294 depends on BUSYBOX_CONFIG_CPIO || BUSYBOX_CONFIG_TAR
296 config BUSYBOX_CONFIG_FEATURE_UNARCHIVE_TAPE
297 bool "Enable tape drive support"
299 depends on BUSYBOX_CONFIG_CPIO || BUSYBOX_CONFIG_TAR
301 I don't think this is needed anymore.
303 comment "Common options for dpkg and dpkg_deb"
304 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
306 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_GZ
307 bool "gzip debian packages (normal)"
308 default n if BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
309 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
311 This is the default compression method inside the debian ar file.
313 If you want compatibility with standard .deb's you should say yes here.
315 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_BZ2
316 bool "bzip2 debian packages"
318 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
320 This allows dpkg and dpkg-deb to extract deb's that are compressed internally
321 with bzip2 instead of gzip.
323 You only want this if you are creating your own custom debian packages that
324 use an internal control.tar.bz2 or data.tar.bz2.
326 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_LZMA
327 bool "lzma debian packages"
329 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
331 This allows dpkg and dpkg-deb to extract deb's that are compressed
332 internally with lzma instead of gzip.
334 You only want this if you are creating your own custom debian
335 packages that use an internal control.tar.lzma or data.tar.lzma.