tar: handle -m (--touch) switch, enabled by FEATURE_TAR_NOPRESERVE_TIME
[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 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 FEATURE_GZIP_LONG_OPTIONS
169         bool "Enable long options"
170         default n
171         depends on GZIP && LONG_OPTS
172         help
173           Enable use of long options, increases size by about 106 Bytes
174
175 config LZOP
176         bool "lzop"
177         default n
178         help
179           Lzop compression/decompresion.
180
181 config LZOP_COMPR_HIGH
182         bool "lzop complession levels 7,8,9 (not very useful)"
183         default n
184         depends on LZOP
185         help
186           High levels (7,8,9) of lzop compression. These levels
187           are actually slower than gzip at equivalent compression ratios
188           and take up 3.2K of code.
189
190 config RPM2CPIO
191         bool "rpm2cpio"
192         default n
193         help
194           Converts an RPM file into a CPIO archive.
195
196 config RPM
197         bool "rpm"
198         default n
199         help
200           Mini RPM applet - queries and extracts RPM packages.
201
202 config TAR
203         bool "tar"
204         default n
205         help
206           tar is an archiving program. It's commonly used with gzip to
207           create compressed archives. It's probably the most widely used
208           UNIX archive program.
209
210 if TAR
211
212 config FEATURE_TAR_CREATE
213         bool "Enable archive creation"
214         default y
215         depends on TAR
216         help
217           If you enable this option you'll be able to create
218           tar archives using the `-c' option.
219
220 config FEATURE_TAR_AUTODETECT
221         bool "Autodetect compressed tarballs"
222         default n
223         depends on FEATURE_SEAMLESS_Z || FEATURE_SEAMLESS_GZ || FEATURE_SEAMLESS_BZ2 || FEATURE_SEAMLESS_LZMA
224         help
225           With this option tar can automatically detect compressed
226           tarballs. Currently it works only on files (not pipes etc).
227
228 config FEATURE_TAR_FROM
229         bool "Enable -X (exclude from) and -T (include from) options)"
230         default n
231         depends on TAR
232         help
233           If you enable this option you'll be able to specify
234           a list of files to include or exclude from an archive.
235
236 config FEATURE_TAR_OLDGNU_COMPATIBILITY
237         bool "Support for old tar header format"
238         default N
239         depends on TAR
240         help
241           This option is required to unpack archives created in
242           the old GNU format; help to kill this old format by
243           repacking your ancient archives with the new format.
244
245 config FEATURE_TAR_OLDSUN_COMPATIBILITY
246         bool "Enable untarring of tarballs with checksums produced by buggy Sun tar"
247         default N
248         depends on TAR
249         help
250           This option is required to unpack archives created by some old
251           version of Sun's tar (it was calculating checksum using signed
252           arithmetic). It is said to be fixed in newer Sun tar, but "old"
253           tarballs still exist.
254
255 config FEATURE_TAR_GNU_EXTENSIONS
256         bool "Support for GNU tar extensions (long filenames)"
257         default y
258         depends on TAR
259         help
260           With this option busybox supports GNU long filenames and
261           linknames.
262
263 config FEATURE_TAR_LONG_OPTIONS
264         bool "Enable long options"
265         default n
266         depends on TAR && LONG_OPTS
267         help
268           Enable use of long options, increases size by about 400 Bytes
269
270 config FEATURE_TAR_UNAME_GNAME
271         bool "Enable use of user and group names"
272         default n
273         depends on TAR
274         help
275           Enables use of user and group names in tar. This affects contents
276           listings (-t) and preserving permissions when unpacking (-p).
277           +200 bytes.
278
279 config FEATURE_TAR_NOPRESERVE_TIME
280         bool "Enable -m (do not preserve time) option"
281         default n
282         depends on TAR
283         help
284           With this option busybox supports GNU tar -m (do not preserve time) option.
285
286 endif #tar
287
288 config UNCOMPRESS
289         bool "uncompress"
290         default n
291         help
292           uncompress is used to decompress archives created by compress.
293           Not much used anymore, replaced by gzip/gunzip.
294
295 config UNLZMA
296         bool "unlzma"
297         default n
298         help
299           unlzma is a compression utility using the Lempel-Ziv-Markov chain
300           compression algorithm, and range coding. Compression
301           is generally considerably better than that achieved by the bzip2
302           compressors.
303
304           The BusyBox unlzma applet is limited to de-compression only.
305           On an x86 system, this applet adds about 4K.
306
307           Unless you have a specific application which requires unlzma, you
308           should probably say N here.
309
310 config FEATURE_LZMA_FAST
311         bool "Optimize unlzma for speed"
312         default n
313         depends on UNLZMA
314         help
315           This option reduces decompression time by about 25% at the cost of
316           a 1K bigger binary.
317
318 config UNZIP
319         bool "unzip"
320         default n
321         help
322           unzip will list or extract files from a ZIP archive,
323           commonly found on DOS/WIN systems. The default behavior
324           (with no options) is to extract the archive into the
325           current directory. Use the `-d' option to extract to a
326           directory of your choice.
327
328 endmenu