Isolate code better for unused options, config option to enable long
[people/mcb30/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 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 CONFIG_FEATURE_AR_LONG_FILENAMES
32         bool "  Enable support for long filenames (not need for debs)"
33         default n
34         depends on 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 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 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 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 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 CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY
92         bool "  extract only (-x)"
93         default n
94         depends on CONFIG_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 CONFIG_FEATURE_DEB_TAR_GZ
101         bool "  gzip debian packages (normal)"
102         default y if CONFIG_DPKG || CONFIG_DPKG_DEB
103         depends on CONFIG_DPKG || CONFIG_DPKG_DEB
104         help
105           This is the default compression method inside the debian ar file.
106           
107           If you want compatibility with standard .deb's you should say yes here.
108
109 config CONFIG_FEATURE_DEB_TAR_BZ2
110         bool "  bzip2 debian packages"
111         default n
112         depends on CONFIG_DPKG || CONFIG_DPKG_DEB
113         help
114           This allows dpkg and dpkg-deb to extract deb's that are compressed internally
115           with bzip2 instead of gzip.
116           
117           You only want this if you are creating your own custom debian packages that
118           use an internal control.tar.bz2 or data.tar.bz2.
119
120 config CONFIG_GUNZIP
121         bool "gunzip"
122         default n
123         help
124           gunzip is used to decompress archives created by gzip.
125           You can use the `-t' option to test the integrity of
126           an archive, without decompressing it.
127
128 config CONFIG_FEATURE_GUNZIP_UNCOMPRESS
129         bool "  Uncompress support"
130         default n
131         depends on CONFIG_GUNZIP
132         help
133           Enable if you want gunzip to have the ability to decompress
134           archives created by the program compress (not much
135           used anymore).
136
137 config CONFIG_GZIP
138         bool "gzip"
139         default n
140         help
141           gzip is used to compress files.
142           It's probably the most widely used UNIX compression program.
143
144 config CONFIG_RPM2CPIO
145         bool "rpm2cpio"
146         default n
147         help
148           Converts an RPM file into a CPIO archive.
149
150 config CONFIG_RPM
151         bool "rpm"
152         default n
153         help
154           Mini RPM applet - queries and extracts
155
156 config CONFIG_TAR
157         bool "tar"
158         default n
159         help
160           tar is an archiving program. It's commonly used with gzip to
161           create compressed archives. It's probably the most widely used
162           UNIX archive program.
163
164 config CONFIG_FEATURE_TAR_CREATE
165         bool "  Enable archive creation"
166         default y
167         depends on CONFIG_TAR
168         help
169           If you enable this option you'll be able to create
170           tar archives using the `-c' option.
171
172 config CONFIG_FEATURE_TAR_BZIP2
173         bool "  Enable -j option to handle .tar.bz2 files"
174         default n
175         depends on CONFIG_TAR
176         help
177           If you enable this option you'll be able to extract
178           archives compressed with bzip2.
179
180 config CONFIG_FEATURE_TAR_FROM
181         bool "  Enable -X (exclude from) and -T (include from) options)"
182         default n
183         depends on CONFIG_TAR
184         help
185           If you enable this option you'll be able to specify
186           a list of files to include or exclude from an archive.
187
188 config CONFIG_FEATURE_TAR_GZIP
189         bool "  Enable -z option"
190         default y
191         depends on CONFIG_TAR
192         help
193           If you enable this option tar will be able to call gzip,
194           when creating or extracting tar gziped archives.
195
196 config CONFIG_FEATURE_TAR_COMPRESS
197         bool "  Enable -Z option"
198         default n
199         depends on CONFIG_TAR
200         help
201           If you enable this option tar will be able to call uncompress,
202           when extracting .tar.Z archives.
203
204 config CONFIG_FEATURE_TAR_OLDGNU_COMPATABILITY
205         bool "  Enable support for old tar header format"
206         default N
207         depends on CONFIG_TAR
208         help
209           This option is required to unpack archives created in
210           the old GNU format; help to kill this old format by
211           repacking your ancient archives with the new format.
212
213 config CONFIG_FEATURE_TAR_GNU_EXTENSIONS
214         bool "  Enable support for some GNU tar extensions"
215         default y
216         depends on CONFIG_TAR
217         help
218           With this option busybox supports GNU long filenames and 
219           linknames.
220
221 config CONFIG_FEATURE_TAR_LONG_OPTIONS
222         bool "  Enable long options"
223         default n
224         depends on CONFIG_TAR
225         help
226                 Enable use of long options, increases size by about 400 Bytes
227
228 config CONFIG_UNCOMPRESS
229         bool "uncompress"
230         default n
231         help
232           uncompress is used to decompress archives created by compress.
233           Not much used anymore, replaced by gzip/gunzip.
234
235 config CONFIG_UNZIP
236         bool "unzip"
237         default n
238         help
239           unzip will list or extract files from a ZIP archive,
240           commonly found on DOS/WIN systems. The default behavior
241           (with no options) is to extract the archive into the
242           current directory. Use the `-d' option to extract to a
243           directory of your choice.
244
245 comment "Common options for cpio and tar"
246         depends on CONFIG_CPIO || CONFIG_TAR
247
248 config CONFIG_FEATURE_UNARCHIVE_TAPE
249         bool "  Enable tape drive support"
250         default n
251         depends on CONFIG_CPIO || CONFIG_TAR
252         help
253           I don't think this is needed anymore.
254
255 endmenu