3 mainmenu "Buildroot $BR2_VERSION Configuration"
5 config BR2_HAVE_DOT_CONFIG
11 option env="BR2_VERSION_FULL"
17 source "target/Config.in.arch"
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_BACKUP_SITE
127 string "Backup download site"
128 default "http://sources.buildroot.net/"
130 Backup site to download from. If this option is set then buildroot
131 will fall back to download package sources from here if the
132 normal location fails.
134 config BR2_SOURCEFORGE_MIRROR
135 string "Sourceforge mirror site"
138 Sourceforge has a system of mirror sites. Some sites may be
139 closer to your location, and sometimes mirror sites go down
140 and are no longer available. This option allows you to select
141 your preferred Sourceforge mirror site.
143 The list of mirrors is available here:
144 http://sourceforge.net/apps/trac/sourceforge/wiki/Mirrors
146 config BR2_KERNEL_MIRROR
147 string "Kernel.org mirror"
148 default "http://www.kernel.org/pub/"
150 kernel.org is mirrored on a number of servers around the world.
151 The following allows you to select your preferred mirror.
153 Have a look on the kernel.org site for a list of mirrors, then enter
154 the URL to the base directory. Examples:
156 http://www.XX.kernel.org/pub (XX = country code)
157 http://mirror.aarnet.edu.au/pub/ftp.kernel.org
159 config BR2_GNU_MIRROR
160 string "GNU Software mirror"
161 default "http://ftp.gnu.org/pub/gnu"
163 GNU has multiple software mirrors scattered around the world.
164 The following allows you to select your preferred mirror.
166 Have a look on the gnu.org site for a list of mirrors, then enter
167 the URL to the base directory. Examples:
169 http://ftp.gnu.org/pub/gnu
170 http://mirror.aarnet.edu.au/pub/gnu
172 config BR2_DEBIAN_MIRROR
173 string "Debian Software mirror"
174 default "http://ftp.debian.org"
176 Debian has multiple software mirrors scattered around the world.
177 The following allows you to select your preferred mirror.
179 Usually, just add your country code like XX here:
180 http://ftp.XX.debian.org
185 int "Number of jobs to run simultaneously (0 for auto)"
188 Number of jobs to run simultaneously. If 0, determine
189 automatically according to number of CPUs on the host
193 bool "Enable compiler cache"
195 This option will enable the use of ccache, a compiler
196 cache. It will cache the result of previous builds to speed
197 up future builds. The cache is stored in
198 $HOME/.buildroot-ccache.
200 Note that Buildroot does not try to invalidate the cache
201 contents when the compiler changes in an incompatible
202 way. Therefore, if you make a change to the compiler version
203 and/or configuration, you are responsible for purging the
204 ccache cache by removing the $HOME/.buildroot-ccache
207 config BR2_CCACHE_DIR
208 string "Compiler cache location"
209 depends on BR2_CCACHE
210 default "$(HOME)/.buildroot-ccache"
212 Where ccache should store cached files.
214 config BR2_DEPRECATED
215 bool "Show packages that are deprecated or obsolete"
217 This option hides outdated/obsolete versions of packages.
219 config BR2_ENABLE_DEBUG
220 bool "build packages with debugging symbols"
222 Build packages with debugging symbols enabled. All libraries
223 and binaries in the 'staging' directory will have debugging
224 symbols, which allows remote debugging even if libraries and
225 binaries are stripped on the target. Whether libraries and
226 binaries are stripped on the target is controlled by the
227 BR2_STRIP_* options below.
231 prompt "gcc debug level"
234 Set the debug level for gcc
239 Debug level 1 produces minimal information, enough
240 for making backtraces in parts of the program that
241 you don't plan to debug. This includes descriptions
242 of functions and external variables, but no information
243 about local variables and no line numbers.
248 The default gcc debug level is 2
253 Level 3 includes extra information, such as all the
254 macro definitions present in the program. Some debuggers
255 support macro expansion when you use -g3.
260 prompt "strip command for binaries on target"
261 default BR2_STRIP_strip
263 config BR2_STRIP_strip
265 depends on !BR2_ELF2FLT
267 Binaries and libraries in the target filesystem will be
268 stripped using the normal 'strip' command. This allows to
269 save space, mainly by removing debugging symbols. Debugging
270 symbols on the target are needed for native debugging, but
271 not when remote debugging is used.
273 config BR2_STRIP_sstrip
275 select BR2_PACKAGE_SSTRIP_HOST
276 depends on !BR2_ELF2FLT
278 Binaries and libraries in the target filesystem will be
279 stripped using the 'sstrip' command, which strips a little
280 bit more than the traditional 'strip' command. This allows to
281 save space, mainly by removing debugging symbols. Debugging
282 symbols on the target are needed for native debugging, but
283 not when remote debugging is used.
285 config BR2_STRIP_none
288 Do not strip binaries and libraries in the target
292 config BR2_STRIP_EXCLUDE_FILES
293 string "executables that should not be stripped"
294 depends on !BR2_STRIP_none
297 You may specify a space-separated list of binaries and libraries
298 here that should not be stripped on the target.
300 config BR2_STRIP_EXCLUDE_DIRS
301 string "directories that should be skipped when stripping"
302 depends on !BR2_STRIP_none
305 You may specify a space-separated list of directories that should
306 be skipped when stripping. Binaries and libraries in these
307 directories will not be touched.
308 The directories should be specified relative to the target directory,
309 without leading slash.
312 prompt "gcc optimization level"
313 default BR2_OPTIMIZE_S
315 Set the optimization level for gcc
317 config BR2_OPTIMIZE_0
318 bool "optimization level 0"
320 Do not optimize. This is the default.
322 config BR2_OPTIMIZE_1
323 bool "optimization level 1"
325 Optimize. Optimizing compilation takes somewhat more time,
326 and a lot more memory for a large function. With -O, the
327 compiler tries to reduce code size and execution time,
328 without performing any optimizations that take a great deal
329 of compilation time. -O turns on the following optimization
330 flags: -fdefer-pop -fdelayed-branch -fguess-branch-probability
331 -fcprop-registers -floop-optimize -fif-conversion
332 -fif-conversion2 -ftree-ccp -ftree-dce -ftree-dominator-opts
333 -ftree-dse -ftree-ter -ftree-lrs -ftree-sra -ftree-copyrename
334 -ftree-fre -ftree-ch -funit-at-a-time -fmerge-constants
335 -O also turns on -fomit-frame-pointer on machines where doing
336 so does not interfere with debugging.
338 config BR2_OPTIMIZE_2
339 bool "optimization level 2"
341 Optimize even more. GCC performs nearly all supported optimizations
342 that do not involve a space-speed tradeoff. The compiler does not
343 perform loop unrolling or function inlining when you specify -O2.
344 As compared to -O, this option increases both compilation time and
345 the performance of the generated code. -O2 turns on all optimization
346 flags specified by -O. It also turns on the following optimization
347 flags: -fthread-jumps -fcrossjumping -foptimize-sibling-calls
348 -fcse-follow-jumps -fcse-skip-blocks -fgcse -fgcse-lm
349 -fexpensive-optimizations -fstrength-reduce -frerun-cse-after-loop
350 -frerun-loop-opt -fcaller-saves -fpeephole2 -fschedule-insns
351 -fschedule-insns2 -fsched-interblock -fsched-spec -fregmove
352 -fstrict-aliasing -fdelete-null-pointer-checks -freorder-blocks
353 -freorder-functions -falign-functions -falign-jumps -falign-loops
354 -falign-labels -ftree-vrp -ftree-pre
355 Please note the warning under -fgcse about invoking -O2 on programs
356 that use computed gotos.
358 config BR2_OPTIMIZE_3
359 bool "optimization level 3"
361 Optimize yet more. -O3 turns on all optimizations specified by -O2
362 and also turns on the -finline-functions, -funswitch-loops and
363 -fgcse-after-reload options.
365 config BR2_OPTIMIZE_S
366 bool "optimize for size"
368 Optimize for size. -Os enables all -O2 optimizations that do not
369 typically increase code size. It also performs further optimizations
370 designed to reduce code size. -Os disables the following optimization
371 flags: -falign-functions -falign-jumps -falign-loops -falign-labels
372 -freorder-blocks -freorder-blocks-and-partition -fprefetch-loop-arrays
373 -ftree-vect-loop-version
377 config BR2_PREFER_STATIC_LIB
378 bool "prefer static libraries"
380 Where possible, build and use static libraries for the target.
381 This potentially increases your code size and should only be
382 used if you know what you do.
383 The default is to build dynamic libraries and use those on
384 the target filesystem.
386 WARNING: This is highly experimental at the moment.
388 config BR2_HAVE_DOCUMENTATION
389 bool "documentation on the target"
391 Install the documentation, including manual pages and info
392 pages, on the target.
393 If you say n here, your target will not contain any
396 config BR2_HAVE_DEVFILES
397 bool "development files in target filesystem"
399 Install headers and static libraries in the
402 config BR2_PACKAGE_OVERRIDE_FILE
403 string "location of a package override file"
404 default "$(TOPDIR)/local.mk"
406 A package override file is a short makefile that contains
407 variable definitions of the form <pkg>_OVERRIDE_SRCDIR,
408 which allows to tell Buildroot to use an existing directory
409 as the source directory for a particular package. See the
410 Buildroot documentation for more details on this feature.
414 source "toolchain/Config.in"
416 source "target/generic/Config.in"
418 source "package/Config.in"
420 source "package/Config.in.host"
422 source "fs/Config.in"
424 source "boot/Config.in"
426 source "linux/Config.in"