1424c8673ccf8a23ab1760b695efed31e4068e18
[openwrt/svn-archive/archive.git] / package / busybox / config / archival / Config.in
1 #
2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
4 #
5
6 menu "Archival Utilities"
7
8 config BUSYBOX_CONFIG_FEATURE_SEAMLESS_XZ
9 bool "Make tar, rpm, modprobe etc understand .xz data"
10 default n
11 help
12 Make tar, rpm, modprobe etc understand .xz data.
13
14 config BUSYBOX_CONFIG_FEATURE_SEAMLESS_LZMA
15 bool "Make tar, rpm, modprobe etc understand .lzma data"
16 default n
17 help
18 Make tar, rpm, modprobe etc understand .lzma data.
19
20 config BUSYBOX_CONFIG_FEATURE_SEAMLESS_BZ2
21 bool "Make tar, rpm, modprobe etc understand .bz2 data"
22 default n
23 help
24 Make tar, rpm, modprobe etc understand .bz2 data.
25
26 config BUSYBOX_CONFIG_FEATURE_SEAMLESS_GZ
27 bool "Make tar, rpm, modprobe etc understand .gz data"
28 default y
29 help
30 Make tar, rpm, modprobe etc understand .gz data.
31
32 config BUSYBOX_CONFIG_FEATURE_SEAMLESS_Z
33 bool "Make tar and gunzip understand .Z data"
34 default n
35 help
36 Make tar and gunzip understand .Z data.
37
38 config BUSYBOX_CONFIG_AR
39 bool "ar"
40 default n
41 help
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
48 extraction.
49
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.
53
54 This implementation of ar can extract archives, it cannot create or
55 modify them.
56 On an x86 system, the ar applet adds about 1K.
57
58 Unless you have a specific application which requires ar, you should
59 probably say N here.
60
61 config BUSYBOX_CONFIG_FEATURE_AR_LONG_FILENAMES
62 bool "Support for long filenames (not needed for debs)"
63 default n
64 depends on BUSYBOX_CONFIG_AR
65 help
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.
70
71 config BUSYBOX_CONFIG_FEATURE_AR_CREATE
72 bool "Support archive creation"
73 default n
74 depends on BUSYBOX_CONFIG_AR
75 help
76 This enables archive creation (-c and -r) with busybox ar.
77
78 config BUSYBOX_CONFIG_BUNZIP2
79 bool "bunzip2"
80 default y
81 help
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.
87
88 Unless you have a specific application which requires bunzip2, you
89 should probably say N here.
90
91 config BUSYBOX_CONFIG_BZIP2
92 bool "bzip2"
93 default n
94 help
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.
100
101 Unless you have a specific application which requires bzip2, you
102 should probably say N here.
103
104 config BUSYBOX_CONFIG_CPIO
105 bool "cpio"
106 default n
107 help
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.
111
112 This implementation of cpio can extract cpio archives created in the
113 "newc" or "crc" format, it cannot create or modify them.
114
115 Unless you have a specific application which requires cpio, you
116 should probably say N here.
117
118 config BUSYBOX_CONFIG_FEATURE_CPIO_O
119 bool "Support for archive creation"
120 default n
121 depends on BUSYBOX_CONFIG_CPIO
122 help
123 This implementation of cpio can create cpio archives in the "newc"
124 format only.
125
126 config BUSYBOX_CONFIG_FEATURE_CPIO_P
127 bool "Support for passthrough mode"
128 default n
129 depends on BUSYBOX_CONFIG_FEATURE_CPIO_O
130 help
131 Passthrough mode. Rarely used.
132
133 config BUSYBOX_CONFIG_DPKG
134 bool "dpkg"
135 default n
136 select BUSYBOX_CONFIG_FEATURE_SEAMLESS_GZ
137 help
138 dpkg is a medium-level tool to install, build, remove and manage
139 Debian packages.
140
141 This implementation of dpkg has a number of limitations,
142 you should use the official dpkg if possible.
143
144 config BUSYBOX_CONFIG_DPKG_DEB
145 bool "dpkg_deb"
146 default n
147 select BUSYBOX_CONFIG_FEATURE_SEAMLESS_GZ
148 help
149 dpkg-deb unpacks and provides information about Debian archives.
150
151 This implementation of dpkg-deb cannot pack archives.
152
153 Unless you have a specific application which requires dpkg-deb,
154 say N here.
155
156 config BUSYBOX_CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY
157 bool "Extract only (-x)"
158 default n
159 depends on BUSYBOX_CONFIG_DPKG_DEB
160 help
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
164 to internally.
165
166 config BUSYBOX_CONFIG_GUNZIP
167 bool "gunzip"
168 default y
169 help
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.
173
174 config BUSYBOX_CONFIG_GZIP
175 bool "gzip"
176 default y
177 help
178 gzip is used to compress files.
179 It's probably the most widely used UNIX compression program.
180
181 config BUSYBOX_CONFIG_FEATURE_GZIP_LONG_OPTIONS
182 bool "Enable long options"
183 default n
184 depends on BUSYBOX_CONFIG_GZIP && BUSYBOX_CONFIG_LONG_OPTS
185 help
186 Enable use of long options, increases size by about 106 Bytes
187
188 config BUSYBOX_CONFIG_LZOP
189 bool "lzop"
190 default n
191 help
192 Lzop compression/decompresion.
193
194 config BUSYBOX_CONFIG_LZOP_COMPR_HIGH
195 bool "lzop complession levels 7,8,9 (not very useful)"
196 default n
197 depends on BUSYBOX_CONFIG_LZOP
198 help
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.
202
203 config BUSYBOX_CONFIG_RPM2CPIO
204 bool "rpm2cpio"
205 default n
206 help
207 Converts an RPM file into a CPIO archive.
208
209 config BUSYBOX_CONFIG_RPM
210 bool "rpm"
211 default n
212 help
213 Mini RPM applet - queries and extracts RPM packages.
214
215 config BUSYBOX_CONFIG_TAR
216 bool "tar"
217 default y
218 help
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.
222
223 config BUSYBOX_CONFIG_FEATURE_TAR_CREATE
224 bool "Enable archive creation"
225 default y
226 depends on BUSYBOX_CONFIG_TAR
227 help
228 If you enable this option you'll be able to create
229 tar archives using the `-c' option.
230
231 config BUSYBOX_CONFIG_FEATURE_TAR_AUTODETECT
232 bool "Autodetect compressed tarballs"
233 default n
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)
235 help
236 With this option tar can automatically detect compressed
237 tarballs. Currently it works only on files (not pipes etc).
238
239 config BUSYBOX_CONFIG_FEATURE_TAR_FROM
240 bool "Enable -X (exclude from) and -T (include from) options)"
241 default y
242 depends on BUSYBOX_CONFIG_TAR
243 help
244 If you enable this option you'll be able to specify
245 a list of files to include or exclude from an archive.
246
247 config BUSYBOX_CONFIG_FEATURE_TAR_OLDGNU_COMPATIBILITY
248 bool "Support for old tar header format"
249 default n
250 depends on BUSYBOX_CONFIG_TAR || BUSYBOX_CONFIG_DPKG
251 help
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.
255
256 config BUSYBOX_CONFIG_FEATURE_TAR_OLDSUN_COMPATIBILITY
257 bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
258 default n
259 depends on BUSYBOX_CONFIG_TAR || BUSYBOX_CONFIG_DPKG
260 help
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.
265
266 config BUSYBOX_CONFIG_FEATURE_TAR_GNU_EXTENSIONS
267 bool "Support for GNU tar extensions (long filenames)"
268 default y
269 depends on BUSYBOX_CONFIG_TAR || BUSYBOX_CONFIG_DPKG
270 help
271 With this option busybox supports GNU long filenames and
272 linknames.
273
274 config BUSYBOX_CONFIG_FEATURE_TAR_LONG_OPTIONS
275 bool "Enable long options"
276 default n
277 depends on BUSYBOX_CONFIG_TAR && BUSYBOX_CONFIG_LONG_OPTS
278 help
279 Enable use of long options, increases size by about 400 Bytes
280
281 config BUSYBOX_CONFIG_FEATURE_TAR_TO_COMMAND
282 bool "Support for writing to an external program"
283 default n
284 depends on BUSYBOX_CONFIG_TAR && BUSYBOX_CONFIG_FEATURE_TAR_LONG_OPTIONS
285 help
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
288 external program.
289
290 config BUSYBOX_CONFIG_FEATURE_TAR_UNAME_GNAME
291 bool "Enable use of user and group names"
292 default n
293 depends on BUSYBOX_CONFIG_TAR
294 help
295 Enables use of user and group names in tar. This affects contents
296 listings (-t) and preserving permissions when unpacking (-p).
297 +200 bytes.
298
299 config BUSYBOX_CONFIG_FEATURE_TAR_NOPRESERVE_TIME
300 bool "Enable -m (do not preserve time) option"
301 default n
302 depends on BUSYBOX_CONFIG_TAR
303 help
304 With this option busybox supports GNU tar -m
305 (do not preserve time) option.
306
307 config BUSYBOX_CONFIG_FEATURE_TAR_SELINUX
308 bool "Support for extracting SELinux labels"
309 default n
310 depends on BUSYBOX_CONFIG_TAR && BUSYBOX_CONFIG_SELINUX
311 help
312 With this option busybox supports restoring SELinux labels
313 when extracting files from tar archives.
314
315 config BUSYBOX_CONFIG_UNCOMPRESS
316 bool "uncompress"
317 default n
318 help
319 uncompress is used to decompress archives created by compress.
320 Not much used anymore, replaced by gzip/gunzip.
321
322 config BUSYBOX_CONFIG_UNLZMA
323 bool "unlzma"
324 default n
325 help
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
329 compressors.
330
331 The BusyBox unlzma applet is limited to de-compression only.
332 On an x86 system, this applet adds about 4K.
333
334 Unless you have a specific application which requires unlzma, you
335 should probably say N here.
336
337 config BUSYBOX_CONFIG_FEATURE_LZMA_FAST
338 bool "Optimize unlzma for speed"
339 default n
340 depends on BUSYBOX_CONFIG_UNLZMA
341 help
342 This option reduces decompression time by about 25% at the cost of
343 a 1K bigger binary.
344
345 config BUSYBOX_CONFIG_LZMA
346 bool "Provide lzma alias which supports only unpacking"
347 default n
348 depends on BUSYBOX_CONFIG_UNLZMA
349 help
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.
352
353 config BUSYBOX_CONFIG_UNXZ
354 bool "unxz"
355 default n
356 help
357 unxz is a unlzma successor.
358
359 config BUSYBOX_CONFIG_XZ
360 bool "Provide xz alias which supports only unpacking"
361 default n
362 depends on BUSYBOX_CONFIG_UNXZ
363 help
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.
366
367 config BUSYBOX_CONFIG_UNZIP
368 bool "unzip"
369 default n
370 help
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.
376
377 endmenu