Gitiles
Code Review Sign In
gerrit.nordix.org / codeaurora / busybox / 658f8b1d1ae0e5d5d520d8ec120c8e087954d777 / . / archival / Config.in
blob: 2eab5abfaf3f9dd26c7ebe5dae005a57ca5c0210 [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
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 Andersen53601822002-12-05 21:12:42 +0000[diff] [blame]53
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
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.
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.
76
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.
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.
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".
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]97 However it saves space as none of the extra dpkg-deb, ar or tar options are
98 needed, they are linked to internally.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]99
100config 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
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]105 This is the default compression method inside the debian ar file.
106
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]107 If you want compatibility with standard .deb's you should say yes here.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]108
109config CONFIG_FEATURE_DEB_TAR_BZ2
110 bool " bzip2 debian packages"
111 default n
112 depends on CONFIG_DPKG || CONFIG_DPKG_DEB
113 help
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]114 This allows dpkg and dpkg-deb to extract deb's that are compressed internally
115 with bzip2 instead of gzip.
116
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]117 You only want this if you are creating your own custom debian packages that
Glenn L McGrath0337c462002-12-06 22:40:54 +0000[diff] [blame]118 use an internal control.tar.bz2 or data.tar.bz2.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]119
120config CONFIG_GUNZIP
121 bool "gunzip"
122 default n
123 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]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.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]127
128config CONFIG_FEATURE_GUNZIP_UNCOMPRESS
129 bool " Uncompress support"
130 default n
131 depends on CONFIG_GUNZIP
132 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]133 Enable if you want gunzip to have the ability to decompress
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]134 archives created by the program compress (not much
135 used anymore).
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]136
137config CONFIG_GZIP
138 bool "gzip"
139 default n
140 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]141 gzip is used to compress files.
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]142 It's probably the most widely used UNIX compression program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]143
144config CONFIG_RPM2CPIO
145 bool "rpm2cpio"
146 default n
147 help
Glenn L McGrathb72a7352002-12-10 00:17:22 +0000[diff] [blame]148 Converts an RPM file into a CPIO archive.
149
150config CONFIG_RPM
151 bool "rpm"
152 default n
153 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]154 Mini RPM applet - queries and extracts
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]155
156config CONFIG_TAR
157 bool "tar"
158 default n
159 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]160 tar is an archiving program. It's commonly used with gzip to
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]161 create compressed archives. It's probably the most widely used
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]162 UNIX archive program.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]163
164config CONFIG_FEATURE_TAR_CREATE
165 bool " Enable archive creation"
166 default y
167 depends on CONFIG_TAR
168 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]169 If you enable this option you'll be able to create
170 tar archives using the `-c' option.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]171
172config CONFIG_FEATURE_TAR_BZIP2
173 bool " Enable -j option to handle .tar.bz2 files"
174 default n
175 depends on CONFIG_TAR
176 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]177 If you enable this option you'll be able to extract
178 archives compressed with bzip2.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]179
180config CONFIG_FEATURE_TAR_EXCLUDE
181 bool " Enable -X and --exclude options (exclude files)"
182 default n
183 depends on CONFIG_TAR
184 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]185 If you enable this option you'll be able to specify
186 a list of files to exclude from an archive.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]187
188config CONFIG_FEATURE_TAR_GZIP
189 bool " Enable -z option"
190 default y
191 depends on CONFIG_TAR
192 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]193 If you enable this option tar will be able to call gzip,
194 when creating or extracting tar gziped archives.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]195
Glenn L McGrath56f16b42003-11-18 21:37:52 +0000[diff] [blame]196config 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
Glenn L McGrath21110a02003-01-28 01:45:48 +0000[diff] [blame]204config CONFIG_FEATURE_TAR_OLDGNU_COMPATABILITY
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]205 bool " Enable support for old tar header format"
Glenn L McGrath21110a02003-01-28 01:45:48 +0000[diff] [blame]206 default N
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]207 depends on CONFIG_TAR
208 help
Eric Andersen88c916b2003-10-22 09:58:56 +0000[diff] [blame]209 This option is required to unpack archives created in
210 the old GNU format; help to kill this old format by
Glenn L McGrath21110a02003-01-28 01:45:48 +0000[diff] [blame]211 repacking your ancient archives with the new format.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]212
Glenn L McGrath21110a02003-01-28 01:45:48 +0000[diff] [blame]213config CONFIG_FEATURE_TAR_GNU_EXTENSIONS
214 bool " Enable support for some GNU tar extensions"
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]215 default y
216 depends on CONFIG_TAR
217 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]218 With this option busybox supports GNU long filenames and
219 linknames.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]220
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]221config CONFIG_UNCOMPRESS
222 bool "uncompress"
223 default n
224 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]225 uncompress is used to decompress archives created by compress.
226 Not much used anymore, replaced by gzip/gunzip.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]227
228config CONFIG_UNZIP
229 bool "unzip"
230 default n
231 help
Eric Andersene5642112003-07-14 19:37:08 +0000[diff] [blame]232 unzip will list or extract files from a ZIP archive,
233 commonly found on DOS/WIN systems. The default behavior
234 (with no options) is to extract the archive into the
235 current directory. Use the `-d' option to extract to a
236 directory of your choice.
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]237
Glenn L McGrath6530f0d2003-10-29 04:46:30 +0000[diff] [blame]238comment "Common options for cpio and tar"
239 depends on CONFIG_CPIO || CONFIG_TAR
240
241config CONFIG_FEATURE_UNARCHIVE_TAPE
242 bool " Enable tape drive support"
243 default n
244 depends on CONFIG_CPIO || CONFIG_TAR
245 help
246 I don't think this is needed anymore.
247
Eric Andersenc9f20d92002-12-05 08:41:41 +0000[diff] [blame]248endmenu