3 mainmenu "Buildroot $BR2_VERSION Configuration"
5 config BR2_HAVE_DOT_CONFIG
11 option env="BR2_VERSION_FULL"
13 source "target/Config.in.arch"
21 default "wget --passive-ftp -nd -t 3"
24 string "Subversion (svn) command"
28 string "Bazaar (bzr) command"
36 string "Local files retrieval command"
40 string "Secure copy (scp) command"
44 string "Secure shell (ssh) command"
48 string "Mercurial (hg) command"
55 Command to be used to extract a gzip'ed file to stdout.
56 zcat is identical to gunzip -c except that the former may
57 not be available on your system.
58 Default is "gzip -d -c"
59 Other possible values include "gunzip -c" or "zcat".
62 string "bzcat command"
65 Command to be used to extract a bzip2'ed file to stdout.
66 bzcat is identical to bunzip2 -c except that the former may
67 not be available on your system.
69 Other possible values include "bunzip2 -c" or "bzip2 -d -c".
72 string "xzcat command"
75 Command to be used to extract a xz'ed file to stdout.
78 config BR2_TAR_OPTIONS
82 Options to pass to tar when extracting the sources.
83 E.g. " -v --exclude='*.svn*'" to exclude all .svn internal files
90 default "$(TOPDIR)/dl"
92 Directory to store all the source files that we need to fetch.
93 If the Linux shell environment has defined the BUILDROOT_DL_DIR
94 environment variable, then this overrides this configuration item.
96 The default is $(TOPDIR)/dl
100 default "$(BASE_DIR)/host"
102 Directory to store all the binary files that are built for the host.
103 This includes the cross compilation toolchain when building the
104 internal buildroot toolchain.
106 The default is $(BASE_DIR)/host
108 menu "Mirrors and Download locations"
110 config BR2_PRIMARY_SITE
111 string "Primary download site"
114 Primary site to download from. If this option is set then buildroot
115 will try to download package source first from this site and try the
116 default if the file is not found.
117 Valid URIs are URIs recognized by $(WGET) and scp URIs of the form
118 scp://[user@]host:path.
119 NOTE: This works for all packages using the central package
120 infrastructure (generic, autotools, cmake, ...)
122 config BR2_BACKUP_SITE
123 string "Backup download site"
124 default "http://sources.buildroot.net/"
126 Backup site to download from. If this option is set then buildroot
127 will fall back to download package sources from here if the
128 normal location fails.
130 config BR2_SOURCEFORGE_MIRROR
131 string "Sourceforge mirror site"
134 Sourceforge has a system of mirror sites. Some sites may be
135 closer to your location, and sometimes mirror sites go down
136 and are no longer available. This option allows you to select
137 your preferred Sourceforge mirror site.
139 The list of mirrors is available here:
140 http://sourceforge.net/apps/trac/sourceforge/wiki/Mirrors
142 config BR2_KERNEL_MIRROR
143 string "Kernel.org mirror"
144 default "http://www.kernel.org/pub/"
146 kernel.org is mirrored on a number of servers around the world.
147 The following allows you to select your preferred mirror.
149 Have a look on the kernel.org site for a list of mirrors, then enter
150 the URL to the base directory. Examples:
152 http://www.XX.kernel.org/pub (XX = country code)
153 http://mirror.aarnet.edu.au/pub/ftp.kernel.org
155 config BR2_GNU_MIRROR
156 string "GNU Software mirror"
157 default "http://ftp.gnu.org/pub/gnu"
159 GNU has multiple software mirrors scattered around the world.
160 The following allows you to select your preferred mirror.
162 Have a look on the gnu.org site for a list of mirrors, then enter
163 the URL to the base directory. Examples:
165 http://ftp.gnu.org/pub/gnu
166 http://mirror.aarnet.edu.au/pub/gnu
168 config BR2_DEBIAN_MIRROR
169 string "Debian Software mirror"
170 default "http://ftp.debian.org"
172 Debian has multiple software mirrors scattered around the world.
173 The following allows you to select your preferred mirror.
175 Usually, just add your country code like XX here:
176 http://ftp.XX.debian.org
181 int "Number of jobs to run simultaneously"
184 Number of jobs to run simultaneously
187 bool "Enable compiler cache"
189 This option will enable the use of ccache, a compiler
190 cache. It will cache the result of previous builds to speed
191 up future builds. The cache is stored in
192 $HOME/.buildroot-ccache.
194 Note that Buildroot does not try to invalidate the cache
195 contents when the compiler changes in an incompatible
196 way. Therefore, if you make a change to the compiler version
197 and/or configuration, you are responsible for purging the
198 ccache cache by removing the $HOME/.buildroot-ccache
201 config BR2_CCACHE_DIR
202 string "Compiler cache location"
203 depends on BR2_CCACHE
204 default "$(HOME)/.buildroot-ccache"
206 Where ccache should store cached files.
208 config BR2_DEPRECATED
209 bool "Show packages that are deprecated or obsolete"
211 This option hides outdated/obsolete versions of packages.
213 config BR2_ENABLE_DEBUG
214 bool "build packages with debugging symbols"
216 Build packages with debugging symbols enabled. All libraries
217 and binaries in the 'staging' directory will have debugging
218 symbols, which allows remote debugging even if libraries and
219 binaries are stripped on the target. Whether libraries and
220 binaries are stripped on the target is controlled by the
221 BR2_STRIP_* options below.
225 prompt "gcc debug level"
228 Set the debug level for gcc
233 Debug level 1 produces minimal information, enough
234 for making backtraces in parts of the program that
235 you don't plan to debug. This includes descriptions
236 of functions and external variables, but no information
237 about local variables and no line numbers.
242 The default gcc debug level is 2
247 Level 3 includes extra information, such as all the
248 macro definitions present in the program. Some debuggers
249 support macro expansion when you use -g3.
254 prompt "strip command for binaries on target"
255 default BR2_STRIP_strip
257 config BR2_STRIP_strip
259 depends on !BR2_ELF2FLT
261 Binaries and libraries in the target filesystem will be
262 stripped using the normal 'strip' command. This allows to
263 save space, mainly by removing debugging symbols. Debugging
264 symbols on the target are needed for native debugging, but
265 not when remote debugging is used.
267 config BR2_STRIP_sstrip
269 select BR2_PACKAGE_SSTRIP_HOST
270 depends on !BR2_ELF2FLT
272 Binaries and libraries in the target filesystem will be
273 stripped using the 'sstrip' command, which strips a little
274 bit more than the traditional '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_none
282 Do not strip binaries and libraries in the target
286 config BR2_STRIP_EXCLUDE_FILES
287 string "executables that should not be stripped"
288 depends on !BR2_STRIP_none
291 You may specify a space-separated list of binaries and libraries
292 here that should not be stripped on the target.
294 config BR2_STRIP_EXCLUDE_DIRS
295 string "directories that should be skipped when stripping"
296 depends on !BR2_STRIP_none
299 You may specify a space-separated list of directories that should
300 be skipped when stripping. Binaries and libraries in these
301 directories will not be touched.
302 The directories should be specified relative to the target directory,
303 without leading slash.
306 prompt "gcc optimization level"
307 default BR2_OPTIMIZE_S
309 Set the optimization level for gcc
311 config BR2_OPTIMIZE_0
312 bool "optimization level 0"
314 Do not optimize. This is the default.
316 config BR2_OPTIMIZE_1
317 bool "optimization level 1"
319 Optimize. Optimizing compilation takes somewhat more time,
320 and a lot more memory for a large function. With -O, the
321 compiler tries to reduce code size and execution time,
322 without performing any optimizations that take a great deal
323 of compilation time. -O turns on the following optimization
324 flags: -fdefer-pop -fdelayed-branch -fguess-branch-probability
325 -fcprop-registers -floop-optimize -fif-conversion
326 -fif-conversion2 -ftree-ccp -ftree-dce -ftree-dominator-opts
327 -ftree-dse -ftree-ter -ftree-lrs -ftree-sra -ftree-copyrename
328 -ftree-fre -ftree-ch -funit-at-a-time -fmerge-constants
329 -O also turns on -fomit-frame-pointer on machines where doing
330 so does not interfere with debugging.
332 config BR2_OPTIMIZE_2
333 bool "optimization level 2"
335 Optimize even more. GCC performs nearly all supported optimizations
336 that do not involve a space-speed tradeoff. The compiler does not
337 perform loop unrolling or function inlining when you specify -O2.
338 As compared to -O, this option increases both compilation time and
339 the performance of the generated code. -O2 turns on all optimization
340 flags specified by -O. It also turns on the following optimization
341 flags: -fthread-jumps -fcrossjumping -foptimize-sibling-calls
342 -fcse-follow-jumps -fcse-skip-blocks -fgcse -fgcse-lm
343 -fexpensive-optimizations -fstrength-reduce -frerun-cse-after-loop
344 -frerun-loop-opt -fcaller-saves -fpeephole2 -fschedule-insns
345 -fschedule-insns2 -fsched-interblock -fsched-spec -fregmove
346 -fstrict-aliasing -fdelete-null-pointer-checks -freorder-blocks
347 -freorder-functions -falign-functions -falign-jumps -falign-loops
348 -falign-labels -ftree-vrp -ftree-pre
349 Please note the warning under -fgcse about invoking -O2 on programs
350 that use computed gotos.
352 config BR2_OPTIMIZE_3
353 bool "optimization level 3"
355 Optimize yet more. -O3 turns on all optimizations specified by -O2
356 and also turns on the -finline-functions, -funswitch-loops and
357 -fgcse-after-reload options.
359 config BR2_OPTIMIZE_S
360 bool "optimize for size"
362 Optimize for size. -Os enables all -O2 optimizations that do not
363 typically increase code size. It also performs further optimizations
364 designed to reduce code size. -Os disables the following optimization
365 flags: -falign-functions -falign-jumps -falign-loops -falign-labels
366 -freorder-blocks -freorder-blocks-and-partition -fprefetch-loop-arrays
367 -ftree-vect-loop-version
371 config BR2_PREFER_STATIC_LIB
372 bool "prefer static libraries"
374 Where possible, build and use static libraries for the target.
375 This potentially increases your code size and should only be
376 used if you know what you do.
377 The default is to build dynamic libraries and use those on
378 the target filesystem.
380 WARNING: This is highly experimental at the moment.
382 config BR2_HAVE_DOCUMENTATION
383 bool "documentation on the target"
385 Install the documentation, including manual pages and info
386 pages, on the target.
387 If you say n here, your target will not contain any
390 config BR2_HAVE_DEVFILES
391 bool "development files in target filesystem"
393 Install headers and static libraries in the
396 config BR2_PACKAGE_OVERRIDE_FILE
397 string "location of a package override file"
398 default "$(TOPDIR)/local.mk"
400 A package override file is a short makefile that contains
401 variable definitions of the form <pkg>_OVERRIDE_SRCDIR,
402 which allows to tell Buildroot to use an existing directory
403 as the source directory for a particular package. See the
404 Buildroot documentation for more details on this feature.
408 source "toolchain/Config.in"
410 source "target/generic/Config.in"
412 source "package/Config.in"
414 source "package/Config.in.host"
416 source "fs/Config.in"
418 source "boot/Config.in"
420 source "linux/Config.in"