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 The BusyBox bunzip2 applet is limited to de-compression only.
52 On an x86 system, this applet adds about 11K.
54 Unless you have a specific application which requires bunzip2, you
55 should probably say N here.
57 config BUSYBOX_CONFIG_CPIO
61 cpio is an archival utility program used to create, modify, and extract
62 contents from archives.
63 cpio has 110 bytes of overheads for every stored file.
65 This implementation of cpio can extract cpio archives created in the
66 "newc" or "crc" format, it cannot create or modify them.
68 Unless you have a specific application which requires cpio, you should
71 config BUSYBOX_CONFIG_DPKG
75 dpkg is a medium-level tool to install, build, remove and manage Debian packages.
77 This implementation of dpkg has a number of limitations, you should use the
78 official dpkg if possible.
80 config BUSYBOX_CONFIG_DPKG_DEB
84 dpkg-deb packs, unpacks and provides information about Debian archives.
86 This implementation of dpkg-deb cannot pack archives.
88 Unless you have a specific application which requires dpkg-deb, you should
91 config BUSYBOX_CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY
92 bool "extract only (-x)"
94 depends on BUSYBOX_CONFIG_DPKG_DEB
96 This reduces dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx".
97 However it saves space as none of the extra dpkg-deb, ar or tar options are
98 needed, they are linked to internally.
100 config BUSYBOX_CONFIG_GUNZIP
104 gunzip is used to decompress archives created by gzip.
105 You can use the `-t' option to test the integrity of
106 an archive, without decompressing it.
108 config BUSYBOX_CONFIG_FEATURE_GUNZIP_UNCOMPRESS
109 bool "Uncompress support"
111 depends on BUSYBOX_CONFIG_GUNZIP
113 Enable if you want gunzip to have the ability to decompress
114 archives created by the program compress (not much
117 config BUSYBOX_CONFIG_GZIP
121 gzip is used to compress files.
122 It's probably the most widely used UNIX compression program.
124 config BUSYBOX_CONFIG_IPKG
127 select BUSYBOX_CONFIG_MD5SUM
128 select BUSYBOX_CONFIG_WGET
130 ipkg is the itsy package management system.
132 config BUSYBOX_CONFIG_RPM2CPIO
136 Converts an RPM file into a CPIO archive.
138 config BUSYBOX_CONFIG_RPM
142 Mini RPM applet - queries and extracts
144 config BUSYBOX_CONFIG_TAR
148 tar is an archiving program. It's commonly used with gzip to
149 create compressed archives. It's probably the most widely used
150 UNIX archive program.
152 config BUSYBOX_CONFIG_FEATURE_TAR_CREATE
153 bool "Enable archive creation"
155 depends on BUSYBOX_CONFIG_TAR
157 If you enable this option you'll be able to create
158 tar archives using the `-c' option.
160 config BUSYBOX_CONFIG_FEATURE_TAR_BZIP2
161 bool "Enable -j option to handle .tar.bz2 files"
163 depends on BUSYBOX_CONFIG_TAR
165 If you enable this option you'll be able to extract
166 archives compressed with bzip2.
168 config BUSYBOX_CONFIG_FEATURE_TAR_LZMA
169 bool "Enable -a option to handle .tar.lzma files"
171 depends on BUSYBOX_CONFIG_TAR
173 If you enable this option you'll be able to extract
174 archives compressed with lzma.
176 config BUSYBOX_CONFIG_FEATURE_TAR_FROM
177 bool "Enable -X (exclude from) and -T (include from) options)"
179 depends on BUSYBOX_CONFIG_TAR
181 If you enable this option you'll be able to specify
182 a list of files to include or exclude from an archive.
184 config BUSYBOX_CONFIG_FEATURE_TAR_GZIP
185 bool "Enable -z option"
187 depends on BUSYBOX_CONFIG_TAR
189 If you enable this option tar will be able to call gzip,
190 when creating or extracting tar gziped archives.
192 config BUSYBOX_CONFIG_FEATURE_TAR_COMPRESS
193 bool "Enable -Z option"
195 depends on BUSYBOX_CONFIG_TAR
197 If you enable this option tar will be able to call uncompress,
198 when extracting .tar.Z archives.
200 config BUSYBOX_CONFIG_FEATURE_TAR_OLDGNU_COMPATIBILITY
201 bool "Enable support for old tar header format"
203 depends on BUSYBOX_CONFIG_TAR
205 This option is required to unpack archives created in
206 the old GNU format; help to kill this old format by
207 repacking your ancient archives with the new format.
209 config BUSYBOX_CONFIG_FEATURE_TAR_GNU_EXTENSIONS
210 bool "Enable support for some GNU tar extensions"
212 depends on BUSYBOX_CONFIG_TAR
214 With this option busybox supports GNU long filenames and
217 config BUSYBOX_CONFIG_FEATURE_TAR_LONG_OPTIONS
218 bool "Enable long options"
220 depends on BUSYBOX_CONFIG_TAR && BUSYBOX_CONFIG_GETOPT_LONG
222 Enable use of long options, increases size by about 400 Bytes
224 config BUSYBOX_CONFIG_UNCOMPRESS
228 uncompress is used to decompress archives created by compress.
229 Not much used anymore, replaced by gzip/gunzip.
231 config BUSYBOX_CONFIG_UNLZMA
235 unlzma is a compression utility using the Lempel-Ziv-Markov chain
236 compression algorithm, and range coding. Compression
237 is generally considerably better than that achieved by the bzip2
240 The BusyBox unlzma applet is limited to de-compression only.
241 On an x86 system, this applet adds about 4K.
243 Unless you have a specific application which requires unlzma, you
244 should probably say N here.
246 config BUSYBOX_CONFIG_FEATURE_LZMA_FAST
247 bool "Optimze unlzma for speed"
249 depends on BUSYBOX_CONFIG_UNLZMA
251 This option reduces decompression time by about 33% at the cost of
254 config BUSYBOX_CONFIG_UNZIP
258 unzip will list or extract files from a ZIP archive,
259 commonly found on DOS/WIN systems. The default behavior
260 (with no options) is to extract the archive into the
261 current directory. Use the `-d' option to extract to a
262 directory of your choice.
264 comment "Common options for cpio and tar"
265 depends on BUSYBOX_CONFIG_CPIO || BUSYBOX_CONFIG_TAR
267 config BUSYBOX_CONFIG_FEATURE_UNARCHIVE_TAPE
268 bool "Enable tape drive support"
270 depends on BUSYBOX_CONFIG_CPIO || BUSYBOX_CONFIG_TAR
272 I don't think this is needed anymore.
274 comment "Common options for dpkg and dpkg_deb"
275 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
277 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_GZ
278 bool "gzip debian packages (normal)"
279 default n if BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
280 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
282 This is the default compression method inside the debian ar file.
284 If you want compatibility with standard .deb's you should say yes here.
286 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_BZ2
287 bool "bzip2 debian packages"
289 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
291 This allows dpkg and dpkg-deb to extract deb's that are compressed internally
292 with bzip2 instead of gzip.
294 You only want this if you are creating your own custom debian packages that
295 use an internal control.tar.bz2 or data.tar.bz2.
297 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_LZMA
298 bool "lzma debian packages"
300 depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
302 This allows dpkg and dpkg-deb to extract deb's that are compressed
303 internally with lzma instead of gzip.
305 You only want this if you are creating your own custom debian
306 packages that use an internal control.tar.lzma or data.tar.lzma.