Vladimir N. Oleynik writes:
[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 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           The stored filename is limited to 15 characters. (for more information
20           see long filename support).
21           ar has 60 bytes of overheads for every stored file.
22
23           This implementation of ar can extract archives, it cannot create or
24           modify them.
25           On an x86 system, the ar applet adds about XXX bytes.
26
27           Unless you have a specific application which requires ar, you should
28           probably say N here.
29
30 config CONFIG_FEATURE_AR_LONG_FILENAMES
31         bool "  Enable support for long filenames (not need for debs)"
32         default n
33         depends on CONFIG_AR
34         help
35           By default the ar format can only store the first 15 characters of the
36           filename, this option removes that limitation.
37           It supports the GNU ar long filename method which moves multiple long
38           filenames into a the data section of a new ar entry.
39
40 config CONFIG_BUNZIP2
41         bool "bunzip2"
42         default n
43         help
44           bunzip2 is an compression utility using the Burrows-Wheeler block
45           sorting text compression algorithm, and Huffman coding.  Compression
46           is generally considerably better than that achieved by more
47           conventional LZ77/LZ78-based compressors, and approaches the
48           performance of the PPM family of statistical compressors.  
49           
50           The BusyBox bunzip2 applet is limited to de-compression only.
51           On an x86 system, this applet adds about XXX bytes.
52           
53           Unless you have a specific application which requires bunzip2, you
54           should probably say N here.
55
56 config CONFIG_CPIO
57         bool "cpio"
58         default n
59         help
60           cpio is an archival utility program used to create, modify, and extract
61           contents from archives.
62           cpio has 110 bytes of overheads for every stored file.
63
64           This implementation of cpio can extract cpio archives created in the
65           "newc" or "crc" format, it cannot create or modify them. 
66
67           Unless you have a specific application which requires cpio, you should
68           probably say N here.
69
70 config CONFIG_DPKG
71         bool "dpkg"
72         default n
73         help
74           dpkg is a medium-level tool to install, build, remove and manage Debian packages.
75           
76           This implementation of dpkg has a number of limitations, you should use the
77           official dpkg if possible.
78
79 config CONFIG_DPKG_DEB
80         bool "dpkg_deb"
81         default n
82         help
83           dpkg-deb packs, unpacks and provides information about Debian archives.
84           
85           This implementation of dpkg-deb cannot pack archives.
86           
87           Unless you have a specific application which requires dpkg-deb, you should
88           probably say N here.
89
90 config CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY
91         bool "  extract only (-x)"
92         default n
93         depends on CONFIG_DPKG_DEB
94         help
95           This reduced dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx".
96           However it saves space as none of the extra dpkg-deb, ar or tar options are 
97           needed, they are linked to internally.
98
99 config CONFIG_FEATURE_DEB_TAR_GZ
100         bool "  gzip debian packages (normal)"
101         default y if CONFIG_DPKG || CONFIG_DPKG_DEB
102         depends on CONFIG_DPKG || CONFIG_DPKG_DEB
103         help
104           This is the default compression method inside the debian ar file.
105           
106           If you want compatability with standard .deb's you should say yes here.
107
108 config CONFIG_FEATURE_DEB_TAR_BZ2
109         bool "  bzip2 debian packages"
110         default n
111         depends on CONFIG_DPKG || CONFIG_DPKG_DEB
112         help
113           This allows dpkg and dpkg-deb to extract deb's that are compressed internally
114           with bzip2 instead of gzip.
115           
116           You only want this is your are creating your own custom debian packages that
117           use an internal control.tar.bz2 or data.tar.bz2.
118
119 config 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 CONFIG_FEATURE_GUNZIP_UNCOMPRESS
128         bool "  Uncompress support"
129         default n
130         depends on CONFIG_GUNZIP
131         help
132           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 CONFIG_GZIP
137         bool "gzip"
138         default n
139         help
140           gzip is used to compress files.
141           It's probably the most used UNIX compression program.
142
143 config CONFIG_RPM2CPIO
144         bool "rpm2cpio"
145         default n
146         help
147           Converts an RPM file into a CPIO archive.
148
149 config CONFIG_RPM
150         bool "rpm"
151         default n
152         help
153           Mini RPM applet - querys and extracts
154
155 config CONFIG_TAR
156         bool "tar"
157         default n
158         help
159           tar is an archiving program. It's commonly used with gzip to
160           create compressed archives. It's probably the most used
161           UNIX archive program.
162
163 config CONFIG_FEATURE_TAR_CREATE
164         bool "  Enable archive creation"
165         default y
166         depends on CONFIG_TAR
167         help
168           If you enable this option you'll be able to create
169           tar archives using the `-c' option.
170
171 config CONFIG_FEATURE_TAR_BZIP2
172         bool "  Enable -j option to handle .tar.bz2 files"
173         default n
174         depends on CONFIG_TAR
175         help
176           If you enable this option you'll be able to extract
177           archives compressed with bzip2.
178
179 config CONFIG_FEATURE_TAR_EXCLUDE
180         bool "  Enable -X and --exclude options (exclude files)"
181         default n
182         depends on CONFIG_TAR
183         help
184           If you enable this option you'll be able to specify
185           a list of files to exclude from an archive.
186
187 config CONFIG_FEATURE_TAR_GZIP
188         bool "  Enable -z option"
189         default y
190         depends on CONFIG_TAR
191         help
192           If you enable this option tar will be able to call gzip,
193           when creating or extracting tar gziped archives.
194
195 config CONFIG_FEATURE_TAR_OLDGNU_COMPATABILITY
196         bool "  Enable support for old tar header format"
197         default N
198         depends on CONFIG_TAR
199         help
200           This option is required to unpack archives created with
201           in the old GNU format, help to kill this old format by
202           repacking your ancient archives with the new format.
203
204 config CONFIG_FEATURE_TAR_GNU_EXTENSIONS
205         bool "  Enable support for some GNU tar extensions"
206         default y
207         depends on CONFIG_TAR
208         help
209           With this option busybox supports GNU long filenames and 
210           linknames.
211
212 config CONFIG_FEATURE_UNARCHIVE_TAPE
213         bool "  Enable tape drive support"
214         default n
215         depends on CONFIG_TAR || CONFIG_CPIO
216         help
217           I dont think this is needed anymore.
218
219 config CONFIG_UNCOMPRESS
220         bool "uncompress"
221         default n
222         help
223           uncompress is used to decompress archives created by compress.
224           Not much used anymore, replaced by gzip/gunzip.
225
226 config CONFIG_UNZIP
227         bool "unzip"
228         default n
229         help
230           unzip will list or extract files from a ZIP archive,
231           commonly found on DOS/WIN systems. The default behavior
232           (with no options) is to extract the archive into the
233           current directory. Use the `-d' option to extract to a
234           directory of your choice.
235
236 endmenu