getopt: FEATURE_GETOPT_LONG for -l; rename GETOPT_LONG to LONG_OPTS
[platform/upstream/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 FEATURE_SEAMLESS_LZMA
9         bool "Make tar, rpm, modprobe etc understand .lzma data"
10         default n
11         help
12           Make tar, rpm, modprobe etc understand .lzma data.
13
14 config FEATURE_SEAMLESS_BZ2
15         bool "Make tar, rpm, modprobe etc understand .bz2 data"
16         default n
17         help
18           Make tar, rpm, modprobe etc understand .bz2 data.
19
20 config FEATURE_SEAMLESS_GZ
21         bool "Make tar, rpm, modprobe etc understand .gz data"
22         default n
23         help
24           Make tar, rpm, modprobe etc understand .gz data.
25
26 config 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
32 config AR
33         bool "ar"
34         default n
35         help
36           ar is an archival utility program used to create, modify, and
37           extract contents from archives. An archive is a single file holding
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
42           extraction.
43
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.
50           On an x86 system, the ar applet adds about 1K.
51
52           Unless you have a specific application which requires ar, you should
53           probably say N here.
54
55 config FEATURE_AR_LONG_FILENAMES
56         bool "Support for long filenames (not needed for debs)"
57         default n
58         depends on AR
59         help
60           By default the ar format can only store the first 15 characters
61           of the filename, this option removes that limitation.
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.
64
65 config BUNZIP2
66         bool "bunzip2"
67         default n
68         help
69           bunzip2 is a compression utility using the Burrows-Wheeler block
70           sorting text compression algorithm, and Huffman coding. Compression
71           is generally considerably better than that achieved by more
72           conventional LZ77/LZ78-based compressors, and approaches the
73           performance of the PPM family of statistical compressors.
74
75           Unless you have a specific application which requires bunzip2, you
76           should probably say N here.
77
78 config BZIP2
79         bool "bzip2"
80         default n
81         help
82           bzip2 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 bzip2, you
89           should probably say N here.
90
91 config CPIO
92         bool "cpio"
93         default n
94         help
95           cpio is an archival utility program used to create, modify, and
96           extract contents from archives.
97           cpio has 110 bytes of overheads for every stored file.
98
99           This implementation of cpio can extract cpio archives created in the
100           "newc" or "crc" format, it cannot create or modify them.
101
102           Unless you have a specific application which requires cpio, you
103           should probably say N here.
104
105 config 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
113 config FEATURE_CPIO_P
114         bool "Support for passthrough mode"
115         default n
116         depends on FEATURE_CPIO_O
117         help
118           Passthrough mode. Rarely used.
119
120 config DPKG
121         bool "dpkg"
122         default n
123         select FEATURE_SEAMLESS_GZ
124         help
125           dpkg is a medium-level tool to install, build, remove and manage
126           Debian packages.
127
128           This implementation of dpkg has a number of limitations,
129           you should use the official dpkg if possible.
130
131 config DPKG_DEB
132         bool "dpkg_deb"
133         default n
134         select FEATURE_SEAMLESS_GZ
135         help
136           dpkg-deb unpacks and provides information about Debian archives.
137
138           This implementation of dpkg-deb cannot pack archives.
139
140           Unless you have a specific application which requires dpkg-deb,
141           say N here.
142
143 config FEATURE_DPKG_DEB_EXTRACT_ONLY
144         bool "Extract only (-x)"
145         default n
146         depends on DPKG_DEB
147         help
148           This reduces dpkg-deb to the equivalent of
149           "ar -p <deb> data.tar.gz | tar -zx". However it saves space as none
150           of the extra dpkg-deb, ar or tar options are needed, they are linked
151           to internally.
152
153 config GUNZIP
154         bool "gunzip"
155         default n
156         help
157           gunzip is used to decompress archives created by gzip.
158           You can use the `-t' option to test the integrity of
159           an archive, without decompressing it.
160
161 config GZIP
162         bool "gzip"
163         default n
164         help
165           gzip is used to compress files.
166           It's probably the most widely used UNIX compression program.
167
168 config LZOP
169         bool "lzop"
170         default n
171         help
172           Lzop compression/decompresion.
173
174 config LZOP_COMPR_HIGH
175         bool "lzop complession levels 7,8,9 (not very useful)"
176         default n
177         depends on LZOP
178         help
179           High levels (7,8,9) of lzop compression. These levels
180           are actually slower than gzip at equivalent compression ratios
181           and take up 3.2K of code.
182
183 config RPM2CPIO
184         bool "rpm2cpio"
185         default n
186         help
187           Converts an RPM file into a CPIO archive.
188
189 config RPM
190         bool "rpm"
191         default n
192         help
193           Mini RPM applet - queries and extracts RPM packages.
194
195 config TAR
196         bool "tar"
197         default n
198         help
199           tar is an archiving program. It's commonly used with gzip to
200           create compressed archives. It's probably the most widely used
201           UNIX archive program.
202
203 if TAR
204
205 config FEATURE_TAR_CREATE
206         bool "Enable archive creation"
207         default y
208         depends on TAR
209         help
210           If you enable this option you'll be able to create
211           tar archives using the `-c' option.
212
213 config FEATURE_TAR_AUTODETECT
214         bool "Autodetect compressed tarballs"
215         default n
216         depends on FEATURE_SEAMLESS_Z || FEATURE_SEAMLESS_GZ || FEATURE_SEAMLESS_BZ2 || FEATURE_SEAMLESS_LZMA
217         help
218           With this option tar can automatically detect compressed
219           tarballs. Currently it works only on files (not pipes etc).
220
221 config FEATURE_TAR_FROM
222         bool "Enable -X (exclude from) and -T (include from) options)"
223         default n
224         depends on TAR
225         help
226           If you enable this option you'll be able to specify
227           a list of files to include or exclude from an archive.
228
229 config FEATURE_TAR_OLDGNU_COMPATIBILITY
230         bool "Support for old tar header format"
231         default N
232         depends on TAR
233         help
234           This option is required to unpack archives created in
235           the old GNU format; help to kill this old format by
236           repacking your ancient archives with the new format.
237
238 config FEATURE_TAR_OLDSUN_COMPATIBILITY
239         bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
240         default N
241         depends on TAR
242         help
243           This option is required to unpack archives created by some old
244           version of Sun's tar (it was calculating checksum using signed
245           arithmetic). It is said to be fixed in newer Sun tar, but "old"
246           tarballs still exist.
247
248 config FEATURE_TAR_GNU_EXTENSIONS
249         bool "Support for GNU tar extensions (long filenames)"
250         default y
251         depends on TAR
252         help
253           With this option busybox supports GNU long filenames and
254           linknames.
255
256 config FEATURE_TAR_LONG_OPTIONS
257         bool "Enable long options"
258         default n
259         depends on TAR && LONG_OPTS
260         help
261           Enable use of long options, increases size by about 400 Bytes
262
263 config FEATURE_TAR_UNAME_GNAME
264         bool "Enable use of user and group names"
265         default n
266         depends on TAR
267         help
268           Enables use of user and group names in tar. This affects contents
269           listings (-t) and preserving permissions when unpacking (-p).
270           +200 bytes.
271
272 endif #tar
273
274 config UNCOMPRESS
275         bool "uncompress"
276         default n
277         help
278           uncompress is used to decompress archives created by compress.
279           Not much used anymore, replaced by gzip/gunzip.
280
281 config UNLZMA
282         bool "unlzma"
283         default n
284         help
285           unlzma is a compression utility using the Lempel-Ziv-Markov chain
286           compression algorithm, and range coding. Compression
287           is generally considerably better than that achieved by the bzip2
288           compressors.
289
290           The BusyBox unlzma applet is limited to de-compression only.
291           On an x86 system, this applet adds about 4K.
292
293           Unless you have a specific application which requires unlzma, you
294           should probably say N here.
295
296 config FEATURE_LZMA_FAST
297         bool "Optimize unlzma for speed"
298         default n
299         depends on UNLZMA
300         help
301           This option reduces decompression time by about 25% at the cost of
302           a 1K bigger binary.
303
304 config UNZIP
305         bool "unzip"
306         default n
307         help
308           unzip will list or extract files from a ZIP archive,
309           commonly found on DOS/WIN systems. The default behavior
310           (with no options) is to extract the archive into the
311           current directory. Use the `-d' option to extract to a
312           directory of your choice.
313
314 endmenu