Gitiles
Code Review Sign In
gerrit.nordix.org / codeaurora / busybox / ba50217281e9265aa5935d184f698204143e765f / . / archival / Config.in
blob: db358db08e41293aad6bf3c69a7daf20955c7efe [file] [log] [blame]
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]1#
2# For a description of the syntax of this configuration file,
3# see scripts/kbuild/config-language.txt.
4#
5
6menu "Archival Utilities"
7
8config CONFIG_AR
9 bool "ar"
10 default n
11 help
Eric Andersen53601822002-12-05 21:12:42 +0000[diff] [blame]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
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]18 extraction.
Eric Andersen6d3c7e72003-08-22 21:15:07 +0000[diff] [blame]19
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]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.
Eric Andersen6d3c7e72003-08-22 21:15:07 +0000[diff] [blame]26 On an x86 system, the ar applet adds about 1K.
Eric Andersen53601822002-12-05 21:12:42 +0000[diff] [blame]27
28 Unless you have a specific application which requires ar, you should
29 probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]30
31config 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
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]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.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]40
41config CONFIG_BUNZIP2
42 bool "bunzip2"
43 default n
44 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]45 bunzip2 is a compression utility using the Burrows-Wheeler block
Eric Andersen53601822002-12-05 21:12:42 +0000[diff] [blame]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
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]49 performance of the PPM family of statistical compressors.
50
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]51 The BusyBox bunzip2 applet is limited to de-compression only.
Eric Andersen6d3c7e72003-08-22 21:15:07 +0000[diff] [blame]52 On an x86 system, this applet adds about 11K.
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]53
Eric Andersen53601822002-12-05 21:12:42 +0000[diff] [blame]54 Unless you have a specific application which requires bunzip2, you
55 should probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]56
57config CONFIG_CPIO
58 bool "cpio"
59 default n
60 help
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]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
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]66 "newc" or "crc" format, it cannot create or modify them.
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]67
68 Unless you have a specific application which requires cpio, you should
69 probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]70
71config CONFIG_DPKG
72 bool "dpkg"
73 default n
74 help
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]75 dpkg is a medium-level tool to install, build, remove and manage Debian packages.
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]76
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]77 This implementation of dpkg has a number of limitations, you should use the
78 official dpkg if possible.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]79
80config CONFIG_DPKG_DEB
81 bool "dpkg_deb"
82 default n
83 help
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]84 dpkg-deb packs, unpacks and provides information about Debian archives.
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]85
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]86 This implementation of dpkg-deb cannot pack archives.
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]87
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]88 Unless you have a specific application which requires dpkg-deb, you should
89 probably say N here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]90
91config CONFIG_FEATURE_DPKG_DEB_EXTRACT_ONLY
92 bool " extract only (-x)"
93 default n
94 depends on CONFIG_DPKG_DEB
95 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]96 This reduces dpkg-deb to the equivalent of "ar -p <deb> data.tar.gz | tar -zx".
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]97 However it saves space as none of the extra dpkg-deb, ar or tar options are
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]98 needed, they are linked to internally.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]99
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]100config CONFIG_GUNZIP
101 bool "gunzip"
102 default n
103 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]104 gunzip is used to decompress archives created by gzip.
105 You can use the `-t' option to test the integrity of
106 an archive, without decompressing it.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]107
108config CONFIG_FEATURE_GUNZIP_UNCOMPRESS
109 bool " Uncompress support"
110 default n
111 depends on CONFIG_GUNZIP
112 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]113 Enable if you want gunzip to have the ability to decompress
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]114 archives created by the program compress (not much
115 used anymore).
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]116
117config CONFIG_GZIP
118 bool "gzip"
119 default n
120 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]121 gzip is used to compress files.
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]122 It's probably the most widely used UNIX compression program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]123
124config CONFIG_RPM2CPIO
125 bool "rpm2cpio"
126 default n
127 help
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000[diff] [blame]128 Converts an RPM file into a CPIO archive.
129
130config CONFIG_RPM
131 bool "rpm"
132 default n
133 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]134 Mini RPM applet - queries and extracts
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]135
136config CONFIG_TAR
137 bool "tar"
138 default n
139 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]140 tar is an archiving program. It's commonly used with gzip to
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]141 create compressed archives. It's probably the most widely used
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]142 UNIX archive program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]143
144config CONFIG_FEATURE_TAR_CREATE
145 bool " Enable archive creation"
146 default y
147 depends on CONFIG_TAR
148 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]149 If you enable this option you'll be able to create
150 tar archives using the `-c' option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]151
152config CONFIG_FEATURE_TAR_BZIP2
153 bool " Enable -j option to handle .tar.bz2 files"
154 default n
155 depends on CONFIG_TAR
156 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]157 If you enable this option you'll be able to extract
158 archives compressed with bzip2.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]159
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000[diff] [blame]160config CONFIG_FEATURE_TAR_FROM
161 bool " Enable -X (exclude from) and -T (include from) options)"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]162 default n
163 depends on CONFIG_TAR
164 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]165 If you enable this option you'll be able to specify
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000[diff] [blame]166 a list of files to include or exclude from an archive.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]167
168config CONFIG_FEATURE_TAR_GZIP
169 bool " Enable -z option"
170 default y
171 depends on CONFIG_TAR
172 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]173 If you enable this option tar will be able to call gzip,
174 when creating or extracting tar gziped archives.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]175
Glenn L McGrath56f16b42003-11-18 21:37:52 +0000[diff] [blame]176config CONFIG_FEATURE_TAR_COMPRESS
177 bool " Enable -Z option"
178 default n
179 depends on CONFIG_TAR
180 help
181 If you enable this option tar will be able to call uncompress,
182 when extracting .tar.Z archives.
183
Glenn L McGrath21110a02003-01-28 01:45:48 +0000[diff] [blame]184config CONFIG_FEATURE_TAR_OLDGNU_COMPATABILITY
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]185 bool " Enable support for old tar header format"
Glenn L McGrath21110a02003-01-28 01:45:48 +0000[diff] [blame]186 default N
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]187 depends on CONFIG_TAR
188 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]189 This option is required to unpack archives created in
190 the old GNU format; help to kill this old format by
Glenn L McGrath21110a02003-01-28 01:45:48 +0000[diff] [blame]191 repacking your ancient archives with the new format.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]192
Glenn L McGrath21110a02003-01-28 01:45:48 +0000[diff] [blame]193config CONFIG_FEATURE_TAR_GNU_EXTENSIONS
194 bool " Enable support for some GNU tar extensions"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]195 default y
196 depends on CONFIG_TAR
197 help
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]198 With this option busybox supports GNU long filenames and
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]199 linknames.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]200
Glenn L McGrathce91c8a2003-12-26 14:01:37 +0000[diff] [blame]201config CONFIG_FEATURE_TAR_LONG_OPTIONS
202 bool " Enable long options"
203 default n
204 depends on CONFIG_TAR
205 help
206 Enable use of long options, increases size by about 400 Bytes
207
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]208config CONFIG_UNCOMPRESS
209 bool "uncompress"
210 default n
211 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]212 uncompress is used to decompress archives created by compress.
213 Not much used anymore, replaced by gzip/gunzip.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]214
215config CONFIG_UNZIP
216 bool "unzip"
217 default n
218 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]219 unzip will list or extract files from a ZIP archive,
220 commonly found on DOS/WIN systems. The default behavior
221 (with no options) is to extract the archive into the
222 current directory. Use the `-d' option to extract to a
223 directory of your choice.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]224
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000[diff] [blame]225comment "Common options for cpio and tar"
226 depends on CONFIG_CPIO || CONFIG_TAR
227
228config CONFIG_FEATURE_UNARCHIVE_TAPE
229 bool " Enable tape drive support"
230 default n
231 depends on CONFIG_CPIO || CONFIG_TAR
232 help
233 I don't think this is needed anymore.
234
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000[diff] [blame]235comment "Common options for dpkg and dpkg_deb"
236 depends on CONFIG_DPKG || CONFIG_DPKG_DEB
237
238config CONFIG_FEATURE_DEB_TAR_GZ
239 bool " gzip debian packages (normal)"
240 default y if CONFIG_DPKG || CONFIG_DPKG_DEB
241 depends on CONFIG_DPKG || CONFIG_DPKG_DEB
242 help
243 This is the default compression method inside the debian ar file.
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]244
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000[diff] [blame]245 If you want compatibility with standard .deb's you should say yes here.
246
247config CONFIG_FEATURE_DEB_TAR_BZ2
248 bool " bzip2 debian packages"
249 default n
250 depends on CONFIG_DPKG || CONFIG_DPKG_DEB
251 help
252 This allows dpkg and dpkg-deb to extract deb's that are compressed internally
253 with bzip2 instead of gzip.
Eric Andersenc7bda1c2004-03-15 08:29:22 +0000[diff] [blame]254
Glenn L McGrathb03be7f2004-01-17 03:24:05 +0000[diff] [blame]255 You only want this if you are creating your own custom debian packages that
256 use an internal control.tar.bz2 or data.tar.bz2.
257
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]258endmenu