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