Merge commit 'origin/org.openembedded.dev' into org.openembedded.dev
[openembedded.git] / conf / local.conf.sample
1 #
2 # OpenEmbedded local configuration file (sample)
3 #
4 # Please visit the Wiki at http://openembedded.org/ for more info.
5 #
6 #
7 # Be SURE to read this file in its entirety and the GettingStarted page on the
8 # wiki before proceeding.
9 #
10 # Once you have done that, remove the line at the end of this
11 # file and build away.
12
13 # WARNING: lines starting with a space (' ') will result in parse failures.
14 # Remove '# ' from commented lines to activate them.
15 #
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).
21
22 # Use this to specify where BitBake should place the downloaded sources into
23 DL_DIR = "${HOME}/sources"
24
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/packages/*/*.bb"
27 BBFILES := "${@bb.fatal('Edit your conf/local.conf: BBFILES')}"
28
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.
31 BBMASK = ""
32
33 # Uncomment this if you want to use a prebuilt toolchain. You will need to
34 # provide packages for toolchain and additional libraries yourself. You also
35 # have to set PATH in your environment to make sure BitBake finds additional binaries.
36 # ASSUME_PROVIDED += "virtual/${TARGET_PREFIX}gcc virtual/libc"
37
38 # Uncomment this if you're building for an arch that uses emulated locale 
39 # generation under qemu (mainly arm glibc) and have an external gcc 3.x compiler
40 # that OE recognises. This will mean the gcc-native build is skipped, speeding 
41 # builds up.
42 # ASSUME_PROVIDED += "gcc3-native"
43
44 # Uncomment this if you are building Linux 2.4 Embedix kernels.
45 # i.e. openzaurus-sa-2.4.18 and openzaurus-pxa-2.4.18 - and don't forget
46 # to rename the binaries as instructed in the Wiki.
47 # Most users do not need this anymore thankfully!
48 # ASSUME_PROVIDED += "virtual/arm-linux-gcc-2.95"
49
50 # Select between multiple alternative providers, if more than one is eligible.
51 PREFERRED_PROVIDERS = "virtual/qte:qte virtual/libqpe:libqpe-opie"
52 PREFERRED_PROVIDERS += " virtual/libsdl:libsdl-x11"
53 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}gcc-initial:gcc-cross-initial"
54 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}gcc-intermediate:gcc-cross-intermediate"
55 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}gcc:gcc-cross"
56 PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}g++:gcc-cross"
57
58 # Uncomment this to specify where BitBake should create its temporary files.
59 # Note that a full build of everything in OpenEmbedded will take GigaBytes of hard
60 # disk space, so make sure to free enough space. The default TMPDIR is
61 # <build directory>/tmp
62 # Don't use symlinks in in the path to avoid problems
63 # TMPDIR = /usr/local/projects/oetmp
64
65 # Uncomment this to specify a machine to build for. See the conf directory
66 # for machines currently known to OpenEmbedded. This will automatically take care
67 # of TARGET_ARCH
68 # MACHINE = "c7x0"
69
70 # Use this to specify the target architecture. Note that this is only
71 # needed when building for a machine not known to OpenEmbedded. Better use
72 # the MACHINE attribute (see above)
73 # TARGET_ARCH = "arm"
74
75 # Use this to specify the target operating system.  The default is "linux",
76 # for a normal linux system with glibc. Set this to "linux-uclibc" if you want
77 # to build a uclibc based system.
78 # Normally the DISTRO of your choosing will take care of this 
79 # TARGET_OS = "linux"
80 # TARGET_OS = "linux-uclibc"
81
82 # Uncomment this to select a distribution policy. See the conf directory
83 # for distributions currently known to OpenEmbedded.
84 # Although it no longer contain version number in the (file-)name
85 # openzaurus-unstable is a so called "versioned"  distro, i.e. they 
86 # explicitely select specific versions of various packages.
87 # Stay away from unversioned distros unless you really know what you are doing
88 # DISTRO = "angstrom-2008.1"
89
90 # So far, angstrom.conf sets ENABLE_BINARY_LOCALE_GENERATION
91 # to generate binary locale packages at build time using qemu-native and
92 # thereby guarantee i18n support on all devices. If your build breaks on 
93 # qemu-native consider disabling ENABLE_BINARY_LOCALE_GENERATION (note that
94 # this breaks i18n on devices with less than 128MB RAM) or installing
95 # a working third-party qemu (e.g. provided by your distribution) and
96 # adding qemu-native to ASSUME_PROVIDED. Caveat emptor, since third-party
97 # qemus lack patches needed to work with various OE targets.
98 # ENABLE_BINARY_LOCALE_GENERATION = "0"
99 # ASSUME_PROVIDED += "qemu-native"
100
101 # If ENABLE_BINARY_LOCALE_GENERATION is set to "1", you can limit locales
102 # generated to the list provided by GLIBC_GENERATE_LOCALES. This is huge
103 # time-savior for developmental builds. Format: list of locale.encoding pairs
104 # with spaces as separators.
105 # GLIBC_GENERATE_LOCALES = "en_GB.UTF-8 de_DE.UTF-8"
106
107 # Uncomment this to select a particular major kernel version if the MACHINE setting
108 # supports more than one major kernel version. Currently this is suported by the
109 # following MACHINE types: poodle, tosa and simpad.
110 # MACHINE_KERNEL_VERSION = "2.6"
111
112 # Uncomment one of these to build packages during the build process.
113 # This is done automatically if you set DISTRO (see above)
114 # INHERIT = "package_ipk"
115 # INHERIT = "package_tar"
116
117 # Add the required image file system types below. Valid are 
118 # jffs2, tar(.gz|bz2), cpio(.gz), cramfs, ext2(.gz), ext3(.gz)
119 # squashfs, squashfs-lzma
120 IMAGE_FSTYPES = "jffs2 tar"
121
122 # Uncomment this to disable the parse cache (not recommended).
123 # CACHE = ""
124
125 # Uncomment this if you want BitBake to emit debugging output
126 # BBDEBUG = "yes"
127
128 # Uncomment these two if you want BitBake to build images useful for debugging. 
129 # Note that INHIBIT_PACKAGE_STRIP needs a package format to be defined.
130 # Also note that OE now produces -dbg packages which contain debugging symbols.
131 # DEBUG_BUILD = "1"
132 # INHIBIT_PACKAGE_STRIP = "1"
133
134 # Uncomment these to build a package such that you can use gprof to profile it.
135 # NOTE: This will only work with 'linux' targets, not
136 # 'linux-uclibc', as uClibc doesn't provide the necessary
137 # object files.  Also, don't build glibc itself with these
138 # flags, or it'll fail to build.
139 #
140 # PROFILE_OPTIMIZATION = "-pg"
141 # SELECTED_OPTIMIZATION = "${PROFILE_OPTIMIZATION}"
142 # LDFLAGS =+ "-pg"
143
144 # Uncomment this to enable parallel make.
145 # This allows make to spawn mutliple processes to take advantage of multiple 
146 # processors. Useful on SMP machines. This may break some packages - we're
147 # in the process of marking these so let us know if you find any.
148 # PARALLEL_MAKE = "-j 4"
149
150 # Uncomment this if you want BitBake to emit the log if a build fails.
151 BBINCLUDELOGS = "yes"
152
153 # Specifies a location to search for pre-generated tarballs when fetching
154 # a cvs:// URI. Outcomment this, if you always want to pull directly from CVS.
155 #CVS_TARBALL_STASH = ""
156
157 # Uncomment this if you want to install shared libraries directly under their SONAME,
158 # rather than installing as the full version and symlinking to the SONAME.
159 # PACKAGE_SNAP_LIB_SYMLINKS = "1"
160
161 # EDIT THIS FILE and then remove the line below before using!
162 REMOVE_THIS_LINE:="${@bb.fatal('Read the comments in your conf/local.conf')}"