49070da06fdff8acd665f8f5e3e62b31ad70e716
[oweals/busybox.git] / 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 AR
9         bool "ar"
10         default n
11         help
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
18           extraction.
19
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.
23
24           This implementation of ar can extract archives, it cannot create or
25           modify them.
26           On an x86 system, the ar applet adds about 1K.
27
28           Unless you have a specific application which requires ar, you should
29           probably say N here.
30
31 config FEATURE_AR_LONG_FILENAMES
32         bool "Enable support for long filenames (not need for debs)"
33         default n
34         depends on AR
35         help
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.
40
41 config BUNZIP2
42         bool "bunzip2"
43         default n
44         help
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.
50
51           The BusyBox bunzip2 applet is limited to de-compression only.
52           On an x86 system, this applet adds about 11K.
53
54           Unless you have a specific application which requires bunzip2, you
55           should probably say N here.
56
57 config CPIO
58         bool "cpio"
59         default n
60         help
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.
64
65           This implementation of cpio can extract cpio archives created in the
66           "newc" or "crc" format, it cannot create or modify them.
67
68           Unless you have a specific application which requires cpio, you should
69           probably say N here.
70
71 config DPKG
72         bool "dpkg"
73         default n
74         help
75           dpkg is a medium-level tool to install, build, remove and manage Debian packages.
76
77           This implementation of dpkg has a number of limitations, you should use the
78           official dpkg if possible.
79
80 config DPKG_DEB
81         bool "dpkg_deb"
82         default n
83         help
84           dpkg-deb packs, unpacks and provides information about Debian archives.
85
86           This implementation of dpkg-deb cannot pack archives.
87
88           Unless you have a specific application which requires dpkg-deb, you should
89           probably say N here.
90
91 config FEATURE_DPKG_DEB_EXTRACT_ONLY
92         bool "extract only (-x)"
93         default n
94         depends on DPKG_DEB
95         help
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.
99
100 config GUNZIP
101         bool "gunzip"
102         default n
103         help
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.
107
108 config FEATURE_GUNZIP_UNCOMPRESS
109         bool "Uncompress support"
110         default n
111         depends on GUNZIP
112         help
113           Enable if you want gunzip to have the ability to decompress
114           archives created by the program compress (not much
115           used anymore).
116
117 config GZIP
118         bool "gzip"
119         default n
120         help
121           gzip is used to compress files.
122           It's probably the most widely used UNIX compression program.
123
124 config RPM2CPIO
125         bool "rpm2cpio"
126         default n
127         help
128           Converts an RPM file into a CPIO archive.
129
130 config RPM
131         bool "rpm"
132         default n
133         help
134           Mini RPM applet - queries and extracts RPM packages.
135
136 config FEATURE_RPM_BZ2
137         bool "Enable handling of rpms with bzip2-compressed data inside"
138         default n
139         depends on RPM
140         help
141           Enable handling of rpms with bzip2-compressed data inside.
142
143 config TAR
144         bool "tar"
145         default n
146         help
147           tar is an archiving program. It's commonly used with gzip to
148           create compressed archives. It's probably the most widely used
149           UNIX archive program.
150
151 config FEATURE_TAR_CREATE
152         bool "Enable archive creation"
153         default y
154         depends on TAR
155         help
156           If you enable this option you'll be able to create
157           tar archives using the `-c' option.
158
159 config FEATURE_TAR_BZIP2
160         bool "Enable -j option to handle .tar.bz2 files"
161         default n
162         depends on TAR
163         help
164           If you enable this option you'll be able to extract
165           archives compressed with bzip2.
166
167 config FEATURE_TAR_LZMA
168         bool "Enable -a option to handle .tar.lzma files"
169         default n
170         depends on TAR
171         help
172           If you enable this option you'll be able to extract
173           archives compressed with lzma.
174
175 config FEATURE_TAR_FROM
176         bool "Enable -X (exclude from) and -T (include from) options)"
177         default n
178         depends on TAR
179         help
180           If you enable this option you'll be able to specify
181           a list of files to include or exclude from an archive.
182
183 config FEATURE_TAR_GZIP
184         bool "Enable -z option"
185         default y
186         depends on TAR
187         help
188           If you enable this option tar will be able to call gzip,
189           when creating or extracting tar gziped archives.
190
191 config FEATURE_TAR_COMPRESS
192         bool "Enable -Z option"
193         default n
194         depends on TAR
195         help
196           If you enable this option tar will be able to call uncompress,
197           when extracting .tar.Z archives.
198
199 config FEATURE_TAR_OLDGNU_COMPATIBILITY
200         bool "Enable support for old tar header format"
201         default N
202         depends on TAR
203         help
204           This option is required to unpack archives created in
205           the old GNU format; help to kill this old format by
206           repacking your ancient archives with the new format.
207
208 config FEATURE_TAR_OLDSUN_COMPATIBILITY
209         bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
210         default N
211         depends on TAR
212         help
213           This option is required to unpack archives created by some old
214           version of Sun's tar (it was calculating checksum using signed arithmetic).
215           It is said to be fixed in newer Sun tar, but "old" tarballs still exist.
216
217 config FEATURE_TAR_GNU_EXTENSIONS
218         bool "Enable support for some GNU tar extensions"
219         default y
220         depends on TAR
221         help
222           With this option busybox supports GNU long filenames and
223           linknames.
224
225 config FEATURE_TAR_LONG_OPTIONS
226         bool "Enable long options"
227         default n
228         depends on TAR && GETOPT_LONG
229         help
230                 Enable use of long options, increases size by about 400 Bytes
231
232 config UNCOMPRESS
233         bool "uncompress"
234         default n
235         help
236           uncompress is used to decompress archives created by compress.
237           Not much used anymore, replaced by gzip/gunzip.
238
239 config UNLZMA
240         bool "unlzma"
241         default n
242         help
243           unlzma is a compression utility using the Lempel-Ziv-Markov chain
244           compression algorithm, and range coding.  Compression
245           is generally considerably better than that achieved by the bzip2
246           compressors.
247
248           The BusyBox unlzma applet is limited to de-compression only.
249           On an x86 system, this applet adds about 4K.
250
251           Unless you have a specific application which requires unlzma, you
252           should probably say N here.
253
254 config FEATURE_LZMA_FAST
255         bool "Optimze unlzma for speed"
256         default n
257         depends on UNLZMA
258         help
259           This option reduces decompression time by about 33% at the cost of
260           a 2K bigger binary.
261
262 config UNZIP
263         bool "unzip"
264         default n
265         help
266           unzip will list or extract files from a ZIP archive,
267           commonly found on DOS/WIN systems. The default behavior
268           (with no options) is to extract the archive into the
269           current directory. Use the `-d' option to extract to a
270           directory of your choice.
271
272 comment "Common options for cpio and tar"
273         depends on CPIO || TAR
274
275 config FEATURE_UNARCHIVE_TAPE
276         bool "Enable tape drive support"
277         default n
278         depends on CPIO || TAR
279         help
280           I don't think this is needed anymore.
281
282 comment "Common options for dpkg and dpkg_deb"
283         depends on DPKG || DPKG_DEB
284
285 config FEATURE_DEB_TAR_GZ
286         bool "gzip debian packages (normal)"
287         default y if DPKG || DPKG_DEB
288         depends on DPKG || DPKG_DEB
289         help
290           This is the default compression method inside the debian ar file.
291
292           If you want compatibility with standard .deb's you should say yes here.
293
294 config FEATURE_DEB_TAR_BZ2
295         bool "bzip2 debian packages"
296         default n
297         depends on DPKG || DPKG_DEB
298         help
299           This allows dpkg and dpkg-deb to extract deb's that are compressed internally
300           with bzip2 instead of gzip.
301
302           You only want this if you are creating your own custom debian packages that
303           use an internal control.tar.bz2 or data.tar.bz2.
304
305 config FEATURE_DEB_TAR_LZMA
306         bool "lzma debian packages"
307         default n
308         depends on DPKG || DPKG_DEB
309         help
310           This allows dpkg and dpkg-deb to extract deb's that are compressed
311           internally with lzma instead of gzip.
312
313           You only want this if you are creating your own custom debian
314           packages that use an internal control.tar.lzma or data.tar.lzma.
315
316 endmenu