Gitiles
Code Review Sign In
gerrit.nordix.org / codeaurora / busybox / 01ea9716105307f61761eb6ca6e8add3c074fe8d / . / archival / Config.in
blob: 0b5cf37507f622bfd2ea3249c9a1412608ea38c3 [file] [log] [blame]
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]1#
2# For a description of the syntax of this configuration file,
3# see scripts/kbuild/config-language.txt.
4#
5
6menu "Archival Utilities"
7
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000[diff] [blame]8config FEATURE_SEAMLESS_LZMA
Denis Vlasenko540baf62008-08-05 13:16:18 +0000[diff] [blame]9 bool "Make tar, rpm, modprobe etc understand .lzma data"
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000[diff] [blame]10 default n
11 help
Denis Vlasenko540baf62008-08-05 13:16:18 +0000[diff] [blame]12 Make tar, rpm, modprobe etc understand .lzma data.
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000[diff] [blame]13
14config FEATURE_SEAMLESS_BZ2
Denis Vlasenko540baf62008-08-05 13:16:18 +0000[diff] [blame]15 bool "Make tar, rpm, modprobe etc understand .bz2 data"
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000[diff] [blame]16 default n
17 help
Denis Vlasenko540baf62008-08-05 13:16:18 +0000[diff] [blame]18 Make tar, rpm, modprobe etc understand .bz2 data.
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000[diff] [blame]19
20config FEATURE_SEAMLESS_GZ
Denis Vlasenko540baf62008-08-05 13:16:18 +0000[diff] [blame]21 bool "Make tar, rpm, modprobe etc understand .gz data"
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000[diff] [blame]22 default n
23 help
Denis Vlasenko540baf62008-08-05 13:16:18 +0000[diff] [blame]24 Make tar, rpm, modprobe etc understand .gz data.
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000[diff] [blame]25
26config FEATURE_SEAMLESS_Z
27 bool "Make tar and gunzip understand .Z data"
28 default n
29 help
30 Make tar and gunzip understand .Z data.
31
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]32config AR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]33 bool "ar"
34 default n
35 help
Eric Andersen53601822002-12-05 21:12:42 +0000[diff] [blame]36 ar is an archival utility program used to create, modify, and
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000[diff] [blame]37 extract contents from archives. An archive is a single file holding
Eric Andersen53601822002-12-05 21:12:42 +0000[diff] [blame]38 a collection of other files in a structure that makes it possible to
39 retrieve the original individual files (called archive members).
40 The original files' contents, mode (permissions), timestamp, owner,
41 and group are preserved in the archive, and can be restored on
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]42 extraction.
Eric Andersen6d3c7e72003-08-22 21:15:07 +0000[diff] [blame]43
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]44 The stored filename is limited to 15 characters. (for more information
45 see long filename support).
46 ar has 60 bytes of overheads for every stored file.
47
48 This implementation of ar can extract archives, it cannot create or
49 modify them.
Eric Andersen6d3c7e72003-08-22 21:15:07 +0000[diff] [blame]50 On an x86 system, the ar applet adds about 1K.
Eric Andersen53601822002-12-05 21:12:42 +0000[diff] [blame]51
52 Unless you have a specific application which requires ar, you should
53 probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]54
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]55config FEATURE_AR_LONG_FILENAMES
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000[diff] [blame]56 bool "Support for long filenames (not need for debs)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]57 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]58 depends on AR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]59 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000[diff] [blame]60 By default the ar format can only store the first 15 characters of
61 the filename, this option removes that limitation.
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]62 It supports the GNU ar long filename method which moves multiple long
63 filenames into a the data section of a new ar entry.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]64
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]65config BUNZIP2
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]66 bool "bunzip2"
67 default n
68 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]69 bunzip2 is a compression utility using the Burrows-Wheeler block
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000[diff] [blame]70 sorting text compression algorithm, and Huffman coding. Compression
Eric Andersen53601822002-12-05 21:12:42 +0000[diff] [blame]71 is generally considerably better than that achieved by more
72 conventional LZ77/LZ78-based compressors, and approaches the
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]73 performance of the PPM family of statistical compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000[diff] [blame]74
Eric Andersen53601822002-12-05 21:12:42 +0000[diff] [blame]75 Unless you have a specific application which requires bunzip2, you
76 should probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]77
Denis Vlasenko77f1ec12007-10-13 03:36:03 +0000[diff] [blame]78config BZIP2
79 bool "bzip2"
80 default n
81 help
82 bzip2 is a compression utility using the Burrows-Wheeler block
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000[diff] [blame]83 sorting text compression algorithm, and Huffman coding. Compression
Denis Vlasenko77f1ec12007-10-13 03:36:03 +0000[diff] [blame]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.
87
88 Unless you have a specific application which requires bzip2, you
89 should probably say N here.
90
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]91config CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]92 bool "cpio"
93 default n
94 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000[diff] [blame]95 cpio is an archival utility program used to create, modify, and
96 extract contents from archives.
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]97 cpio has 110 bytes of overheads for every stored file.
98
99 This implementation of cpio can extract cpio archives created in the
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]100 "newc" or "crc" format, it cannot create or modify them.
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]101
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000[diff] [blame]102 Unless you have a specific application which requires cpio, you
103 should probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]104
Denis Vlasenko261f2372008-04-05 00:07:46 +0000[diff] [blame]105config FEATURE_CPIO_O
106 bool "Support for archive creation"
107 default n
108 depends on CPIO
109 help
110 This implementation of cpio can create cpio archives in the "newc"
111 format only.
112
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]113config DPKG
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]114 bool "dpkg"
115 default n
Denis Vlasenko8854b352008-10-15 14:50:14 +0000[diff] [blame]116 select FEATURE_SEAMLESS_GZ
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]117 help
Denis Vlasenko0381d422008-07-10 23:06:00 +0000[diff] [blame]118 dpkg is a medium-level tool to install, build, remove and manage
119 Debian packages.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000[diff] [blame]120
Denis Vlasenko0381d422008-07-10 23:06:00 +0000[diff] [blame]121 This implementation of dpkg has a number of limitations,
122 you should use the official dpkg if possible.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]123
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]124config DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]125 bool "dpkg_deb"
126 default n
Denis Vlasenko8854b352008-10-15 14:50:14 +0000[diff] [blame]127 select FEATURE_SEAMLESS_GZ
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]128 help
Denis Vlasenko8854b352008-10-15 14:50:14 +0000[diff] [blame]129 dpkg-deb unpacks and provides information about Debian archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000[diff] [blame]130
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]131 This implementation of dpkg-deb cannot pack archives.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000[diff] [blame]132
Denis Vlasenko0381d422008-07-10 23:06:00 +0000[diff] [blame]133 Unless you have a specific application which requires dpkg-deb,
134 say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]135
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]136config FEATURE_DPKG_DEB_EXTRACT_ONLY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000[diff] [blame]137 bool "Extract only (-x)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]138 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]139 depends on DPKG_DEB
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]140 help
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000[diff] [blame]141 This reduces dpkg-deb to the equivalent of
142 "ar -p <deb> data.tar.gz | tar -zx". However it saves space as none
143 of the extra dpkg-deb, ar or tar options are needed, they are linked
144 to internally.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]145
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]146config GUNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]147 bool "gunzip"
148 default n
149 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]150 gunzip is used to decompress archives created by gzip.
151 You can use the `-t' option to test the integrity of
152 an archive, without decompressing it.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]153
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]154config GZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]155 bool "gzip"
156 default n
157 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]158 gzip is used to compress files.
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]159 It's probably the most widely used UNIX compression program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]160
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]161config RPM2CPIO
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]162 bool "rpm2cpio"
163 default n
164 help
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000[diff] [blame]165 Converts an RPM file into a CPIO archive.
166
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]167config RPM
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000[diff] [blame]168 bool "rpm"
169 default n
170 help
Bernhard Reutner-Fischerbfe19502007-01-04 15:44:49 +0000[diff] [blame]171 Mini RPM applet - queries and extracts RPM packages.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]172
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]173config TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]174 bool "tar"
175 default n
176 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]177 tar is an archiving program. It's commonly used with gzip to
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]178 create compressed archives. It's probably the most widely used
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]179 UNIX archive program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]180
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000[diff] [blame]181if TAR
182
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]183config FEATURE_TAR_CREATE
Rob Landley2ec922e2006-04-13 23:22:16 +0000[diff] [blame]184 bool "Enable archive creation"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]185 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]186 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]187 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]188 If you enable this option you'll be able to create
189 tar archives using the `-c' option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]190
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000[diff] [blame]191config FEATURE_TAR_AUTODETECT
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000[diff] [blame]192 bool "Autodetect gz/bz2 compressed tarballs"
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000[diff] [blame]193 default n
Denis Vlasenkoe9ad84d2008-08-05 13:10:34 +0000[diff] [blame]194 depends on FEATURE_SEAMLESS_Z || FEATURE_SEAMLESS_GZ || FEATURE_SEAMLESS_BZ2 || FEATURE_SEAMLESS_LZMA
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000[diff] [blame]195 help
196 With this option tar can automatically detect gzip/bzip2 compressed
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000[diff] [blame]197 tarballs. Currently it works only on files (not pipes etc).
Denis Vlasenko431a7c92008-02-19 11:26:28 +0000[diff] [blame]198
199config FEATURE_TAR_FROM
200 bool "Enable -X (exclude from) and -T (include from) options)"
201 default n
202 depends on TAR
203 help
204 If you enable this option you'll be able to specify
205 a list of files to include or exclude from an archive.
206
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]207config FEATURE_TAR_OLDGNU_COMPATIBILITY
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000[diff] [blame]208 bool "Support for old tar header format"
Glenn L McGrath21110a02003-01-28 01:45:48 +0000[diff] [blame]209 default N
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]210 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]211 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]212 This option is required to unpack archives created in
213 the old GNU format; help to kill this old format by
Glenn L McGrath21110a02003-01-28 01:45:48 +0000[diff] [blame]214 repacking your ancient archives with the new format.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]215
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000[diff] [blame]216config FEATURE_TAR_OLDSUN_COMPATIBILITY
217 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
218 default N
219 depends on TAR
220 help
221 This option is required to unpack archives created by some old
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000[diff] [blame]222 version of Sun's tar (it was calculating checksum using signed
223 arithmetic). It is said to be fixed in newer Sun tar, but "old"
224 tarballs still exist.
Denis Vlasenkoa80b4a02007-06-21 12:41:59 +0000[diff] [blame]225
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]226config FEATURE_TAR_GNU_EXTENSIONS
Denis Vlasenko4ee7cd42008-03-17 09:13:22 +0000[diff] [blame]227 bool "Support for GNU tar extensions (long filenames)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]228 default y
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]229 depends on TAR
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]230 help
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]231 With this option busybox supports GNU long filenames and
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]232 linknames.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]233
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]234config FEATURE_TAR_LONG_OPTIONS
Rob Landley2ec922e2006-04-13 23:22:16 +0000[diff] [blame]235 bool "Enable long options"
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000[diff] [blame]236 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]237 depends on TAR && GETOPT_LONG
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000[diff] [blame]238 help
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000[diff] [blame]239 Enable use of long options, increases size by about 400 Bytes
240
241config FEATURE_TAR_UNAME_GNAME
242 bool "Enable use of user and group names"
243 default n
Denis Vlasenkoe7b43cf2008-02-19 23:42:22 +0000[diff] [blame]244 depends on TAR
Denis Vlasenkoe00e5022008-02-14 20:37:54 +0000[diff] [blame]245 help
246 Enables use of user and group names in tar. This affects contents
247 listings (-t) and preserving permissions when unpacking (-p).
248 +200 bytes.
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000[diff] [blame]249
Denis Vlasenkobc06fb22008-07-17 18:26:45 +0000[diff] [blame]250endif #tar
251
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]252config UNCOMPRESS
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]253 bool "uncompress"
254 default n
255 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]256 uncompress is used to decompress archives created by compress.
257 Not much used anymore, replaced by gzip/gunzip.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]258
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]259config UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000[diff] [blame]260 bool "unlzma"
261 default n
262 help
263 unlzma is a compression utility using the Lempel-Ziv-Markov chain
Bernhard Reutner-Fischer3e8669f2008-07-22 18:27:53 +0000[diff] [blame]264 compression algorithm, and range coding. Compression
Rob Landleyc1d69902006-01-20 18:28:50 +0000[diff] [blame]265 is generally considerably better than that achieved by the bzip2
266 compressors.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000[diff] [blame]267
Rob Landleyc1d69902006-01-20 18:28:50 +0000[diff] [blame]268 The BusyBox unlzma applet is limited to de-compression only.
269 On an x86 system, this applet adds about 4K.
Tim Rikerc1ef7bd2006-01-25 00:08:53 +0000[diff] [blame]270
Rob Landleyc1d69902006-01-20 18:28:50 +0000[diff] [blame]271 Unless you have a specific application which requires unlzma, you
272 should probably say N here.
273
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]274config FEATURE_LZMA_FAST
Denis Vlasenkoffdcb412008-04-23 05:46:55 +0000[diff] [blame]275 bool "Optimize unlzma for speed"
Rob Landleyc1d69902006-01-20 18:28:50 +0000[diff] [blame]276 default n
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]277 depends on UNLZMA
Rob Landleyc1d69902006-01-20 18:28:50 +0000[diff] [blame]278 help
Bernhard Reutner-Fischer5929edc2006-06-07 20:30:01 +0000[diff] [blame]279 This option reduces decompression time by about 33% at the cost of
Rob Landleyc1d69902006-01-20 18:28:50 +0000[diff] [blame]280 a 2K bigger binary.
281
Denis Vlasenko7d219aa2006-10-05 10:17:08 +0000[diff] [blame]282config UNZIP
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]283 bool "unzip"
284 default n
285 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]286 unzip will list or extract files from a ZIP archive,
287 commonly found on DOS/WIN systems. The default behavior
288 (with no options) is to extract the archive into the
289 current directory. Use the `-d' option to extract to a
290 directory of your choice.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]291
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]292endmenu