2 # OpenEmbedded local configuration file (sample)
4 # Please visit the Wiki at http://openembedded.org/ for more info.
7 # Be SURE to read this file in its entirety and the GettingStarted page on the
8 # wiki before proceeding.
10 # Once you have done that, remove the line at the end of this
11 # file and build away.
13 # WARNING: lines starting with a space (' ') will result in parse failures.
14 # Remove '# ' from commented lines to activate them.
16 # NOTE: Do NOT use $HOME in your paths, BitBake does NOT expand ~ for you. If you
17 # must have paths relative to your homedir use ${HOME} (note the {}'s there
18 # you MUST have them for the variable expansion to be done by BitBake). Your
19 # paths should all be absolute paths (They should all start with a / after
20 # expansion. Stuff like starting with ${HOME} or ${TOPDIR} is ok).
22 # Use this to specify where BitBake should place the downloaded sources into
23 DL_DIR = "${HOME}/sources"
25 # Delete the line below. Then specify which .bb files to consider for
26 # your build. Typically this will be something like BBFILES = "/path/to/openembedded/recipes/*/*.bb"
27 BBFILES := "${@bb.fatal('Edit your conf/local.conf: BBFILES')}"
29 # Use the BBMASK below to instruct BitBake to _NOT_ consider some .bb files
30 # This is a regulary expression, so be sure to get your parenthesis balanced.
33 # Uncomment this if your host distribution has recent enough Linux
34 # Kernel header files. Utilities we use to generate certain types of
35 # target filesystems need somewhat recent header files.
36 # ASSUME_PROVIDED += "linux-libc-headers-native"
38 # Uncomment this if you want to use a prebuilt toolchain. You will need to
39 # provide packages for toolchain and additional libraries yourself. You also
40 # have to set PATH in your environment to make sure BitBake finds additional binaries.
41 # ASSUME_PROVIDED += "virtual/${TARGET_PREFIX}gcc virtual/libc"
43 # Uncomment this if you are building Linux 2.4 Embedix kernels.
44 # i.e. openzaurus-sa-2.4.18 and openzaurus-pxa-2.4.18 - and don't forget
45 # to rename the binaries as instructed in the Wiki.
46 # Most users do not need this anymore thankfully!
47 # ASSUME_PROVIDED += "virtual/arm-linux-gcc-2.95"
49 # Select between multiple alternative providers, if more than one is eligible.
50 PREFERRED_PROVIDERS = "virtual/qte:qte virtual/libqpe:libqpe-opie"
51 PREFERRED_PROVIDERS += " virtual/libsdl:libsdl-x11"
52 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}gcc-initial:gcc-cross-initial"
53 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}gcc-intermediate:gcc-cross-intermediate"
54 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}gcc:gcc-cross"
55 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}g++:gcc-cross"
57 # Uncomment this to specify where BitBake should create its temporary files.
58 # Note that a full build of everything in OpenEmbedded will take GigaBytes of hard
59 # disk space, so make sure to free enough space. The default TMPDIR is
60 # <build directory>/tmp
61 # Don't use symlinks in in the path to avoid problems
62 # TMPDIR = /usr/local/projects/oetmp
64 # Uncomment this to specify a machine to build for. See the conf directory
65 # for machines currently known to OpenEmbedded. This will automatically take care
69 # Use this to specify the target architecture. Note that this is only
70 # needed when building for a machine not known to OpenEmbedded. Better use
71 # the MACHINE attribute (see above)
74 # Use this to specify the target operating system. The default is "linux",
75 # for a normal linux system with glibc. Set this to "linux-uclibc" if you want
76 # to build a uclibc based system.
77 # Normally the DISTRO of your choosing will take care of this
79 # TARGET_OS = "linux-uclibc"
81 # Uncomment this to select a distribution policy. See the conf directory
82 # for distributions currently known to OpenEmbedded.
83 # Although it no longer contain version number in the (file-)name
84 # openzaurus-unstable is a so called "versioned" distro, i.e. they
85 # explicitely select specific versions of various packages.
86 # Stay away from unversioned distros unless you really know what you are doing
87 # DISTRO = "angstrom-2008.1"
89 # So far, angstrom.conf sets ENABLE_BINARY_LOCALE_GENERATION
90 # to generate binary locale packages at build time using qemu-native and
91 # thereby guarantee i18n support on all devices. If your build breaks on
92 # qemu-native consider disabling ENABLE_BINARY_LOCALE_GENERATION (note that
93 # this breaks i18n on devices with less than 128MB RAM) or installing
94 # a working third-party qemu (e.g. provided by your distribution) and
95 # adding qemu-native to ASSUME_PROVIDED. Caveat emptor, since third-party
96 # qemus lack patches needed to work with various OE targets.
97 # ENABLE_BINARY_LOCALE_GENERATION = "0"
98 # ASSUME_PROVIDED += "qemu-native"
100 # If ENABLE_BINARY_LOCALE_GENERATION is set to "1", you can limit locales
101 # generated to the list provided by GLIBC_GENERATE_LOCALES. This is huge
102 # time-savior for developmental builds. Format: list of locale.encoding pairs
103 # with spaces as separators.
104 # GLIBC_GENERATE_LOCALES = "en_US.UTF-8 en_GB.UTF-8 de_DE.UTF-8"
106 # Uncomment this to select a particular major kernel version if the MACHINE setting
107 # supports more than one major kernel version. Currently this is suported by the
108 # following MACHINE types: poodle, tosa and simpad.
109 # MACHINE_KERNEL_VERSION = "2.6"
111 # Uncomment one of these to build packages during the build process.
112 # This is done automatically if you set DISTRO (see above)
113 # INHERIT = "package_ipk"
114 # INHERIT = "package_tar"
116 # Add the required image file system types below. Valid are
117 # jffs2, tar(.gz|bz2), cpio(.gz), cramfs, ext2(.gz), ext3(.gz)
118 # squashfs, squashfs-lzma
119 IMAGE_FSTYPES = "jffs2 tar"
121 # Uncomment this if you want to keep the temporary rootfs
122 # diretory, this can be useful during development.
123 # (Note that this rootfs is NOT usuable as NFS export.)
124 # IMAGE_KEEPROOTFS = "1"
126 # Uncomment this to enable the use of ccache when building. Due to
127 # the nature of our builds this is only helpful in cases when one
128 # is rebuilding a recipe or set of recipes, repeatedly.
129 # CCACHE = "${@bb.which(bb.data.getVar('PATH', d, 1), 'ccache') and 'ccache '}"
131 # Uncomment this to disable the parse cache (not recommended).
134 # Uncomment this if you want BitBake to emit debugging output
137 # Use DEBUG_BUILD to build packages with DEBUG_OPTIMIZATION instead of
142 # If you want to have unstripped ready-to-debug binaries, set this to "no",
143 # although for debugging you can use automatically produced -dbg packages.
144 # If you need to have completely undebuggable builds, set this to "full",
145 # by default gnu.debuglink section is left in the binaries after stripping, so
146 # this might be useful if you want to have checksum-level binary consistency
147 # across successive builds.
148 # PACKAGE_STRIP = "no"
150 # Uncomment these to build a package such that you can use gprof to profile it.
151 # NOTE: This will only work with 'linux' targets, not
152 # 'linux-uclibc', as uClibc doesn't provide the necessary
153 # object files. Also, don't build glibc itself with these
154 # flags, or it'll fail to build.
156 # PROFILE_OPTIMIZATION = "-pg"
157 # SELECTED_OPTIMIZATION = "${PROFILE_OPTIMIZATION}"
160 # Uncomment this to enable parallel make.
161 # This allows make to spawn mutliple processes to take advantage of multiple
162 # processors. Useful on SMP machines. This may break some packages - we're
163 # in the process of marking these so let us know if you find any.
164 # PARALLEL_MAKE = "-j 4"
166 # Uncomment to run multiple bitbake threads in parallel.
167 # Bitbake can do multiple jobs in parallel: Its a good idea make use of
168 # all available resources: e.g. to download sources while some other
169 # piece of software is compiled.
170 # BB_NUMBER_THREADS = "2"
172 # Uncomment this if you want BitBake to emit the log if a build fails.
173 BBINCLUDELOGS = "yes"
175 # Specifies a location to search for pre-generated tarballs when fetching
176 # a cvs:// URI. Outcomment this, if you always want to pull directly from CVS.
177 #CVS_TARBALL_STASH = ""
179 # Uncomment this if you want to install shared libraries directly under their SONAME,
180 # rather than installing as the full version and symlinking to the SONAME.
181 # PACKAGE_SNAP_LIB_SYMLINKS = "1"
183 # EDIT THIS FILE and then remove the line below before using!
184 REMOVE_THIS_LINE:="${@bb.fatal('Read the comments in your conf/local.conf')}"