3 mainmenu "Buildroot $BR2_VERSION Configuration"
5 config BR2_HAVE_DOT_CONFIG
11 option env="BR2_VERSION_FULL"
17 source "arch/Config.in"
25 default "wget --passive-ftp -nd -t 3"
28 string "Subversion (svn) command"
32 string "Bazaar (bzr) command"
40 string "Local files retrieval command"
44 string "Secure copy (scp) command"
48 string "Secure shell (ssh) command"
52 string "Mercurial (hg) command"
59 Command to be used to extract a gzip'ed file to stdout.
60 zcat is identical to gunzip -c except that the former may
61 not be available on your system.
62 Default is "gzip -d -c"
63 Other possible values include "gunzip -c" or "zcat".
66 string "bzcat command"
69 Command to be used to extract a bzip2'ed file to stdout.
70 bzcat is identical to bunzip2 -c except that the former may
71 not be available on your system.
73 Other possible values include "bunzip2 -c" or "bzip2 -d -c".
76 string "xzcat command"
79 Command to be used to extract a xz'ed file to stdout.
82 config BR2_TAR_OPTIONS
86 Options to pass to tar when extracting the sources.
87 E.g. " -v --exclude='*.svn*'" to exclude all .svn internal files
94 default "$(TOPDIR)/dl"
96 Directory to store all the source files that we need to fetch.
97 If the Linux shell environment has defined the BUILDROOT_DL_DIR
98 environment variable, then this overrides this configuration item.
100 The default is $(TOPDIR)/dl
104 default "$(BASE_DIR)/host"
106 Directory to store all the binary files that are built for the host.
107 This includes the cross compilation toolchain when building the
108 internal buildroot toolchain.
110 The default is $(BASE_DIR)/host
112 menu "Mirrors and Download locations"
114 config BR2_PRIMARY_SITE
115 string "Primary download site"
118 Primary site to download from. If this option is set then buildroot
119 will try to download package source first from this site and try the
120 default if the file is not found.
121 Valid URIs are URIs recognized by $(WGET) and scp URIs of the form
122 scp://[user@]host:path.
123 NOTE: This works for all packages using the central package
124 infrastructure (generic, autotools, cmake, ...)
126 config BR2_PRIMARY_SITE_ONLY
127 bool "Only allow downloads from primary download site"
128 depends on BR2_PRIMARY_SITE != ""
130 If this option is enabled, downloads will only be attempted
131 from the primary download site. Other locations, like the
132 package's official download location or the backup download
133 site, will not be considered. Therefore, if the package is
134 not present on the primary site, the download fails.
136 This is useful for project developers who want to ensure
137 that the project can be built even if the upstream tarball
140 if !BR2_PRIMARY_SITE_ONLY
142 config BR2_BACKUP_SITE
143 string "Backup download site"
144 default "http://sources.buildroot.net/"
146 Backup site to download from. If this option is set then buildroot
147 will fall back to download package sources from here if the
148 normal location fails.
150 config BR2_KERNEL_MIRROR
151 string "Kernel.org mirror"
152 default "http://www.kernel.org/pub/"
154 kernel.org is mirrored on a number of servers around the world.
155 The following allows you to select your preferred mirror.
157 Have a look on the kernel.org site for a list of mirrors, then enter
158 the URL to the base directory. Examples:
160 http://www.XX.kernel.org/pub (XX = country code)
161 http://mirror.aarnet.edu.au/pub/ftp.kernel.org
163 config BR2_GNU_MIRROR
164 string "GNU Software mirror"
165 default "http://ftp.gnu.org/pub/gnu"
167 GNU has multiple software mirrors scattered around the world.
168 The following allows you to select your preferred mirror.
170 Have a look on the gnu.org site for a list of mirrors, then enter
171 the URL to the base directory. Examples:
173 http://ftp.gnu.org/pub/gnu
174 http://mirror.aarnet.edu.au/pub/gnu
176 config BR2_DEBIAN_MIRROR
177 string "Debian Software mirror"
178 default "http://ftp.debian.org"
180 Debian has multiple software mirrors scattered around the world.
181 The following allows you to select your preferred mirror.
183 Usually, just add your country code like XX here:
184 http://ftp.XX.debian.org
191 int "Number of jobs to run simultaneously (0 for auto)"
194 Number of jobs to run simultaneously. If 0, determine
195 automatically according to number of CPUs on the host
199 bool "Enable compiler cache"
201 This option will enable the use of ccache, a compiler
202 cache. It will cache the result of previous builds to speed
203 up future builds. The cache is stored in
204 $HOME/.buildroot-ccache.
206 Note that Buildroot does not try to invalidate the cache
207 contents when the compiler changes in an incompatible
208 way. Therefore, if you make a change to the compiler version
209 and/or configuration, you are responsible for purging the
210 ccache cache by removing the $HOME/.buildroot-ccache
213 config BR2_CCACHE_DIR
214 string "Compiler cache location"
215 depends on BR2_CCACHE
216 default "$(HOME)/.buildroot-ccache"
218 Where ccache should store cached files.
220 config BR2_DEPRECATED
221 bool "Show packages that are deprecated or obsolete"
223 This option hides outdated/obsolete versions of packages.
225 config BR2_ENABLE_DEBUG
226 bool "build packages with debugging symbols"
228 Build packages with debugging symbols enabled. All libraries
229 and binaries in the 'staging' directory will have debugging
230 symbols, which allows remote debugging even if libraries and
231 binaries are stripped on the target. Whether libraries and
232 binaries are stripped on the target is controlled by the
233 BR2_STRIP_* options below.
237 prompt "gcc debug level"
240 Set the debug level for gcc
245 Debug level 1 produces minimal information, enough
246 for making backtraces in parts of the program that
247 you don't plan to debug. This includes descriptions
248 of functions and external variables, but no information
249 about local variables and no line numbers.
254 The default gcc debug level is 2
259 Level 3 includes extra information, such as all the
260 macro definitions present in the program. Some debuggers
261 support macro expansion when you use -g3.
266 prompt "strip command for binaries on target"
267 default BR2_STRIP_strip
269 config BR2_STRIP_strip
271 depends on !BR2_ELF2FLT
273 Binaries and libraries in the target filesystem will be
274 stripped using the normal 'strip' command. This allows to
275 save space, mainly by removing debugging symbols. Debugging
276 symbols on the target are needed for native debugging, but
277 not when remote debugging is used.
279 config BR2_STRIP_sstrip
281 select BR2_PACKAGE_SSTRIP_HOST
282 depends on !BR2_ELF2FLT
284 Binaries and libraries in the target filesystem will be
285 stripped using the 'sstrip' command, which strips a little
286 bit more than the traditional 'strip' command. This allows to
287 save space, mainly by removing debugging symbols. Debugging
288 symbols on the target are needed for native debugging, but
289 not when remote debugging is used.
291 config BR2_STRIP_none
294 Do not strip binaries and libraries in the target
298 config BR2_STRIP_EXCLUDE_FILES
299 string "executables that should not be stripped"
300 depends on !BR2_STRIP_none
303 You may specify a space-separated list of binaries and libraries
304 here that should not be stripped on the target.
306 config BR2_STRIP_EXCLUDE_DIRS
307 string "directories that should be skipped when stripping"
308 depends on !BR2_STRIP_none
311 You may specify a space-separated list of directories that should
312 be skipped when stripping. Binaries and libraries in these
313 directories will not be touched.
314 The directories should be specified relative to the target directory,
315 without leading slash.
318 prompt "gcc optimization level"
319 default BR2_OPTIMIZE_S
321 Set the optimization level for gcc
323 config BR2_OPTIMIZE_0
324 bool "optimization level 0"
326 Do not optimize. This is the default.
328 config BR2_OPTIMIZE_1
329 bool "optimization level 1"
331 Optimize. Optimizing compilation takes somewhat more time,
332 and a lot more memory for a large function. With -O, the
333 compiler tries to reduce code size and execution time,
334 without performing any optimizations that take a great deal
335 of compilation time. -O turns on the following optimization
336 flags: -fdefer-pop -fdelayed-branch -fguess-branch-probability
337 -fcprop-registers -floop-optimize -fif-conversion
338 -fif-conversion2 -ftree-ccp -ftree-dce -ftree-dominator-opts
339 -ftree-dse -ftree-ter -ftree-lrs -ftree-sra -ftree-copyrename
340 -ftree-fre -ftree-ch -funit-at-a-time -fmerge-constants
341 -O also turns on -fomit-frame-pointer on machines where doing
342 so does not interfere with debugging.
344 config BR2_OPTIMIZE_2
345 bool "optimization level 2"
347 Optimize even more. GCC performs nearly all supported optimizations
348 that do not involve a space-speed tradeoff. The compiler does not
349 perform loop unrolling or function inlining when you specify -O2.
350 As compared to -O, this option increases both compilation time and
351 the performance of the generated code. -O2 turns on all optimization
352 flags specified by -O. It also turns on the following optimization
353 flags: -fthread-jumps -fcrossjumping -foptimize-sibling-calls
354 -fcse-follow-jumps -fcse-skip-blocks -fgcse -fgcse-lm
355 -fexpensive-optimizations -fstrength-reduce -frerun-cse-after-loop
356 -frerun-loop-opt -fcaller-saves -fpeephole2 -fschedule-insns
357 -fschedule-insns2 -fsched-interblock -fsched-spec -fregmove
358 -fstrict-aliasing -fdelete-null-pointer-checks -freorder-blocks
359 -freorder-functions -falign-functions -falign-jumps -falign-loops
360 -falign-labels -ftree-vrp -ftree-pre
361 Please note the warning under -fgcse about invoking -O2 on programs
362 that use computed gotos.
364 config BR2_OPTIMIZE_3
365 bool "optimization level 3"
367 Optimize yet more. -O3 turns on all optimizations specified by -O2
368 and also turns on the -finline-functions, -funswitch-loops and
369 -fgcse-after-reload options.
371 config BR2_OPTIMIZE_S
372 bool "optimize for size"
374 Optimize for size. -Os enables all -O2 optimizations that do not
375 typically increase code size. It also performs further optimizations
376 designed to reduce code size. -Os disables the following optimization
377 flags: -falign-functions -falign-jumps -falign-loops -falign-labels
378 -freorder-blocks -freorder-blocks-and-partition -fprefetch-loop-arrays
379 -ftree-vect-loop-version
383 config BR2_PREFER_STATIC_LIB
384 bool "prefer static libraries"
386 Where possible, build and use static libraries for the target.
387 This potentially increases your code size and should only be
388 used if you know what you do.
389 The default is to build dynamic libraries and use those on
390 the target filesystem.
392 WARNING: This is highly experimental at the moment.
394 config BR2_HAVE_DOCUMENTATION
395 bool "documentation on the target"
397 Install the documentation, including manual pages and info
398 pages, on the target.
399 If you say n here, your target will not contain any
402 config BR2_HAVE_DEVFILES
403 bool "development files in target filesystem"
405 Install headers and static libraries in the
408 config BR2_PACKAGE_OVERRIDE_FILE
409 string "location of a package override file"
410 default "$(TOPDIR)/local.mk"
412 A package override file is a short makefile that contains
413 variable definitions of the form <pkg>_OVERRIDE_SRCDIR,
414 which allows to tell Buildroot to use an existing directory
415 as the source directory for a particular package. See the
416 Buildroot documentation for more details on this feature.
420 source "toolchain/Config.in"
422 source "system/Config.in"
424 source "package/Config.in"
426 source "package/Config.in.host"
428 source "fs/Config.in"
430 source "boot/Config.in"
432 source "linux/Config.in"