0cfbbcc3da3c0f52c022decfa41c4f3b669b930b
[openwrt.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_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 BUSYBOX_CONFIG_FEATURE_AR_LONG_FILENAMES
32         bool "Enable support for long filenames (not need for debs)"
33         default n
34         depends on BUSYBOX_CONFIG_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 BUSYBOX_CONFIG_BUNZIP2
42         bool "bunzip2"
43         default y
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 BUSYBOX_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 BUSYBOX_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 BUSYBOX_CONFIG_DPKG
82         bool "dpkg"
83         default n
84         help
85           dpkg is a medium-level tool to install, build, remove and manage Debian packages.
86
87           This implementation of dpkg has a number of limitations, you should use the
88           official dpkg if possible.
89
90 config BUSYBOX_CONFIG_DPKG_DEB
91         bool "dpkg_deb"
92         default n
93         help
94           dpkg-deb packs, unpacks and provides information about Debian archives.
95
96           This implementation of dpkg-deb cannot pack archives.
97
98           Unless you have a specific application which requires dpkg-deb, you should
99           probably say N here.
100
101 config BUSYBOX_CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY
102         bool "extract only (-x)"
103         default n
104         depends on BUSYBOX_CONFIG_DPKG_DEB
105         help
106           This reduces dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx".
107           However it saves space as none of the extra dpkg-deb, ar or tar options are
108           needed, they are linked to internally.
109
110 config BUSYBOX_CONFIG_GUNZIP
111         bool "gunzip"
112         default y
113         help
114           gunzip is used to decompress archives created by gzip.
115           You can use the `-t' option to test the integrity of
116           an archive, without decompressing it.
117
118 config BUSYBOX_CONFIG_FEATURE_GUNZIP_UNCOMPRESS
119         bool "Uncompress support"
120         default y
121         depends on BUSYBOX_CONFIG_GUNZIP
122         help
123           Enable if you want gunzip to have the ability to decompress
124           archives created by the program compress (not much
125           used anymore).
126
127 config BUSYBOX_CONFIG_GZIP
128         bool "gzip"
129         default y
130         help
131           gzip is used to compress files.
132           It's probably the most widely used UNIX compression program.
133
134 config BUSYBOX_CONFIG_IPKG
135         bool "ipkg"
136         default n
137         select BUSYBOX_CONFIG_MD5SUM
138         select BUSYBOX_CONFIG_WGET
139         select BUSYBOX_CONFIG_DIFF
140         select BUSYBOX_CONFIG_TAR
141         select BUSYBOX_CONFIG_GUNZIP
142         help
143           ipkg is the itsy package management system.
144
145 config BUSYBOX_CONFIG_RPM2CPIO
146         bool "rpm2cpio"
147         default n
148         help
149           Converts an RPM file into a CPIO archive.
150
151 config BUSYBOX_CONFIG_RPM
152         bool "rpm"
153         default n
154         help
155           Mini RPM applet - queries and extracts RPM packages.
156
157 config BUSYBOX_CONFIG_FEATURE_RPM_BZ2
158         bool "Enable handling of rpms with bzip2-compressed data inside"
159         default n
160         depends on BUSYBOX_CONFIG_RPM
161         help
162           Enable handling of rpms with bzip2-compressed data inside.
163
164 config BUSYBOX_CONFIG_TAR
165         bool "tar"
166         default y
167         help
168           tar is an archiving program. It's commonly used with gzip to
169           create compressed archives. It's probably the most widely used
170           UNIX archive program.
171
172 config BUSYBOX_CONFIG_FEATURE_TAR_CREATE
173         bool "Enable archive creation"
174         default y
175         depends on BUSYBOX_CONFIG_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 BUSYBOX_CONFIG_FEATURE_TAR_BZIP2
181         bool "Enable -j option to handle .tar.bz2 files"
182         default y
183         depends on BUSYBOX_CONFIG_TAR
184         help
185           If you enable this option you'll be able to extract
186           archives compressed with bzip2.
187
188 config BUSYBOX_CONFIG_FEATURE_TAR_LZMA
189         bool "Enable -a option to handle .tar.lzma files"
190         default n
191         depends on BUSYBOX_CONFIG_TAR
192         help
193           If you enable this option you'll be able to extract
194           archives compressed with lzma.
195
196 config BUSYBOX_CONFIG_FEATURE_TAR_FROM
197         bool "Enable -X (exclude from) and -T (include from) options)"
198         default y
199         depends on BUSYBOX_CONFIG_TAR
200         help
201           If you enable this option you'll be able to specify
202           a list of files to include or exclude from an archive.
203
204 config BUSYBOX_CONFIG_FEATURE_TAR_GZIP
205         bool "Enable -z option"
206         default y
207         depends on BUSYBOX_CONFIG_TAR
208         help
209           If you enable this option tar will be able to call gzip,
210           when creating or extracting tar gziped archives.
211
212 config BUSYBOX_CONFIG_FEATURE_TAR_COMPRESS
213         bool "Enable -Z option"
214         default n
215         depends on BUSYBOX_CONFIG_TAR
216         help
217           If you enable this option tar will be able to call uncompress,
218           when extracting .tar.Z archives.
219
220 config BUSYBOX_CONFIG_FEATURE_TAR_OLDGNU_COMPATIBILITY
221         bool "Enable support for old tar header format"
222         default n
223         depends on BUSYBOX_CONFIG_TAR
224         help
225           This option is required to unpack archives created in
226           the old GNU format; help to kill this old format by
227           repacking your ancient archives with the new format.
228
229 config BUSYBOX_CONFIG_FEATURE_TAR_OLDSUN_COMPATIBILITY
230         bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
231         default n
232         depends on BUSYBOX_CONFIG_TAR
233         help
234           This option is required to unpack archives created by some old
235           version of Sun's tar (it was calculating checksum using signed arithmetic).
236           It is said to be fixed in newer Sun tar, but "old" tarballs still exist.
237
238 config BUSYBOX_CONFIG_FEATURE_TAR_GNU_EXTENSIONS
239         bool "Enable support for some GNU tar extensions"
240         default y
241         depends on BUSYBOX_CONFIG_TAR
242         help
243           With this option busybox supports GNU long filenames and
244           linknames.
245
246 config BUSYBOX_CONFIG_FEATURE_TAR_LONG_OPTIONS
247         bool "Enable long options"
248         default n
249         depends on BUSYBOX_CONFIG_TAR && BUSYBOX_CONFIG_GETOPT_LONG
250         help
251                 Enable use of long options, increases size by about 400 Bytes
252
253 config BUSYBOX_CONFIG_UNCOMPRESS
254         bool "uncompress"
255         default n
256         help
257           uncompress is used to decompress archives created by compress.
258           Not much used anymore, replaced by gzip/gunzip.
259
260 config BUSYBOX_CONFIG_UNLZMA
261         bool "unlzma"
262         default n
263         help
264           unlzma is a compression utility using the Lempel-Ziv-Markov chain
265           compression algorithm, and range coding.  Compression
266           is generally considerably better than that achieved by the bzip2
267           compressors.
268
269           The BusyBox unlzma applet is limited to de-compression only.
270           On an x86 system, this applet adds about 4K.
271
272           Unless you have a specific application which requires unlzma, you
273           should probably say N here.
274
275 config BUSYBOX_CONFIG_FEATURE_LZMA_FAST
276         bool "Optimze unlzma for speed"
277         default n
278         depends on BUSYBOX_CONFIG_UNLZMA
279         help
280           This option reduces decompression time by about 33% at the cost of
281           a 2K bigger binary.
282
283 config BUSYBOX_CONFIG_UNZIP
284         bool "unzip"
285         default n
286         help
287           unzip will list or extract files from a ZIP archive,
288           commonly found on DOS/WIN systems. The default behavior
289           (with no options) is to extract the archive into the
290           current directory. Use the `-d' option to extract to a
291           directory of your choice.
292
293 comment "Common options for cpio and tar"
294         depends on BUSYBOX_CONFIG_CPIO || BUSYBOX_CONFIG_TAR
295
296 config BUSYBOX_CONFIG_FEATURE_UNARCHIVE_TAPE
297         bool "Enable tape drive support"
298         default n
299         depends on BUSYBOX_CONFIG_CPIO || BUSYBOX_CONFIG_TAR
300         help
301           I don't think this is needed anymore.
302
303 comment "Common options for dpkg and dpkg_deb"
304         depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
305
306 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_GZ
307         bool "gzip debian packages (normal)"
308         default n if BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
309         depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
310         help
311           This is the default compression method inside the debian ar file.
312
313           If you want compatibility with standard .deb's you should say yes here.
314
315 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_BZ2
316         bool "bzip2 debian packages"
317         default n
318         depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
319         help
320           This allows dpkg and dpkg-deb to extract deb's that are compressed internally
321           with bzip2 instead of gzip.
322
323           You only want this if you are creating your own custom debian packages that
324           use an internal control.tar.bz2 or data.tar.bz2.
325
326 config BUSYBOX_CONFIG_FEATURE_DEB_TAR_LZMA
327         bool "lzma debian packages"
328         default n
329         depends on BUSYBOX_CONFIG_DPKG || BUSYBOX_CONFIG_DPKG_DEB
330         help
331           This allows dpkg and dpkg-deb to extract deb's that are compressed
332           internally with lzma instead of gzip.
333
334           You only want this if you are creating your own custom debian
335           packages that use an internal control.tar.lzma or data.tar.lzma.
336
337 endmenu