Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 1 | # BBMASK contains regular expressions that can be used to tell BitBake to ignore |
| 2 | # certain recipes. |
| 3 | #BBMASK = "" |
| 4 | |
| 5 | # |
| 6 | # Parallelism Options |
| 7 | # |
| 8 | # These two options control how much parallelism BitBake should use. The first |
| 9 | # option determines how many tasks bitbake should run in parallel: |
| 10 | # |
| 11 | #BB_NUMBER_THREADS ?= "4" |
| 12 | # |
| 13 | # Default to setting automatically based on cpu count |
| 14 | #BB_NUMBER_THREADS ?= "${@oe.utils.cpu_count()}" |
| 15 | # |
| 16 | # The second option controls how many processes make should run in parallel when |
| 17 | # running compile tasks: |
| 18 | # |
| 19 | #PARALLEL_MAKE ?= "-j 4" |
| 20 | # |
| 21 | # Default to setting automatically based on cpu count |
| 22 | #PARALLEL_MAKE ?= "-j ${@oe.utils.cpu_count()}" |
| 23 | # |
| 24 | # For a quad-core machine, BB_NUMBER_THREADS = "4", PARALLEL_MAKE = "-j 4" would |
| 25 | # be appropriate for example. |
| 26 | |
Brad Bishop | c342db3 | 2019-05-15 21:57:59 -0400 | [diff] [blame] | 27 | # If you want to get an image based on directfb without x11 alter |
| 28 | # DISTRO_FEATURES: |
| 29 | DISTRO_FEATURES_append = " directfb" |
| 30 | DISTRO_FEATURES_remove = "x11" |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 31 | |
| 32 | # ENABLE_BINARY_LOCALE_GENERATION controls the generation of binary locale |
| 33 | # packages at build time using qemu-native. Disabling it (by setting it to 0) |
| 34 | # will save some build time at the expense of breaking i18n on devices with |
| 35 | # less than 128MB RAM. |
| 36 | #ENABLE_BINARY_LOCALE_GENERATION = "1" |
| 37 | |
Brad Bishop | 6e60e8b | 2018-02-01 10:27:11 -0500 | [diff] [blame] | 38 | # If GLIBC_SPLIT_LC_PACKAGES is set to a non-zero value, convert |
| 39 | # glibc-binary-localedata-XX-YY to be a meta package depending on |
| 40 | # glibc-binary-localedata-XX-YY-lc-address and so on. This enables |
| 41 | # saving quite some space if someone doesn't need LC_COLLATE for |
| 42 | # example. |
| 43 | #GLIBC_SPLIT_LC_PACKAGES = "1" |
| 44 | |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 45 | # Set GLIBC_GENERATE_LOCALES to the locales you wish to generate should you not |
| 46 | # wish to perform the time-consuming step of generating all LIBC locales. |
| 47 | # NOTE: If removing en_US.UTF-8 you will also need to uncomment, and set |
| 48 | # appropriate value for IMAGE_LINGUAS. |
| 49 | # WARNING: this may break localisation! |
Brad Bishop | 1a4b7ee | 2018-12-16 17:11:34 -0800 | [diff] [blame] | 50 | # WARNING: some recipes expect certain localizations to be enabled, e.g. |
| 51 | # bash-ptest: fr-fr, de-de |
| 52 | # glib-2.0-ptest: tr-tr, lt-lt, ja-jp.euc-jp, fa-ir, ru-ru, de-de, hr-hr, el-gr, fr-fr, es-es, en-gb |
| 53 | # if you remove some of these and enable ptest, you'll get QA warning like: |
| 54 | # ERROR: glib-2.0-1_2.58.0-r0 do_package_qa: QA Issue: glib-2.0-ptest rdepends on locale-base-de-de, but it isn't a build dependency? [build-deps] |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 55 | #GLIBC_GENERATE_LOCALES = "en_GB.UTF-8 en_US.UTF-8" |
| 56 | #IMAGE_LINGUAS ?= "en-gb" |
| 57 | |
| 58 | # The following are used to control options related to debugging. |
| 59 | # |
| 60 | # Uncomment this to change the optimization to make debugging easer, at the |
| 61 | # possible cost of performance. |
| 62 | # DEBUG_BUILD = "1" |
| 63 | # |
| 64 | # Uncomment this to disable the stripping of the installed binaries |
| 65 | # INHIBIT_PACKAGE_STRIP = "1" |
| 66 | # |
| 67 | # Uncomment this to disable the split of the debug information into -dbg files |
| 68 | # INHIBIT_PACKAGE_DEBUG_SPLIT = "1" |
| 69 | # |
| 70 | # When splitting debug information, the following controls the results of the |
| 71 | # file splitting. |
| 72 | # |
| 73 | # .debug (default): |
| 74 | # When splitting the debug information will be placed into |
| 75 | # a .debug directory in the same dirname of the binary produced: |
| 76 | # /bin/foo -> /bin/.debug/foo |
| 77 | # |
| 78 | # debug-file-directory: |
| 79 | # When splitting the debug information will be placed into |
| 80 | # a central debug-file-directory, /usr/lib/debug: |
| 81 | # /bin/foo -> /usr/lib/debug/bin/foo.debug |
| 82 | # |
| 83 | # Any source code referenced in the debug symbols will be copied |
| 84 | # and made available within the /usr/src/debug directory |
| 85 | # |
| 86 | #PACKAGE_DEBUG_SPLIT_STYLE = '.debug' |
| 87 | # PACKAGE_DEBUG_SPLIT_STYLE = 'debug-file-directory' |
| 88 | |
| 89 | # Uncomment these to build a package such that you can use gprof to profile it. |
| 90 | # NOTE: This will only work with 'linux' targets, not |
| 91 | # 'linux-uclibc', as uClibc doesn't provide the necessary |
| 92 | # object files. Also, don't build glibc itself with these |
| 93 | # flags, or it'll fail to build. |
| 94 | # |
| 95 | # PROFILE_OPTIMIZATION = "-pg" |
| 96 | # SELECTED_OPTIMIZATION = "${PROFILE_OPTIMIZATION}" |
| 97 | # LDFLAGS =+ "-pg" |
| 98 | |
| 99 | # TCMODE controls the characteristics of the generated packages/images by |
| 100 | # telling poky which toolchain 'profile' to use. |
| 101 | # |
| 102 | # The default is "default" which uses the internal toolchain. With |
| 103 | # additional layers, it is possible to set this to use a precompiled |
| 104 | # external toolchain. One example is the Sourcery G++ Toolchain, support |
| 105 | # for which is now in the separate meta-sourcery layer: |
| 106 | # |
| 107 | # http://github.com/MentorEmbedded/meta-sourcery/ |
| 108 | # |
| 109 | # meta-sourcery can be used as a template for adding support for other |
| 110 | # external toolchains. See the link above for further details. |
| 111 | # |
| 112 | # TCMODE points the system to a file in conf/distro/include/tcmode-${TCMODE}.inc, |
| 113 | # so for meta-sourcery which has conf/distro/include/tcmode-external-sourcery.inc |
| 114 | # you would set it as follows: |
| 115 | # |
| 116 | # TCMODE ?= "external-sourcery" |
| 117 | |
| 118 | # mklibs library size optimization is more useful to smaller images, |
| 119 | # and less useful for bigger images. Also mklibs library optimization |
| 120 | # can break the ABI compatibility, so should not be applied to the |
| 121 | # images which are to be extended or upgraded later. |
| 122 | #This enabled mklibs library size optimization just for the specified image. |
| 123 | #MKLIBS_OPTIMIZED_IMAGES ?= "core-image-minimal" |
| 124 | #This enable mklibs library size optimization will be for all the images. |
| 125 | #MKLIBS_OPTIMIZED_IMAGES ?= "all" |
| 126 | |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 127 | # This value is currently used by pseudo to determine if the recipe should |
| 128 | # build both the 32-bit and 64-bit wrapper libraries on a 64-bit build system. |
| 129 | # |
| 130 | # Pseudo will attempt to determine if a 32-bit wrapper is necessary, but |
| 131 | # it doesn't always guess properly. If you have 32-bit executables on |
| 132 | # your 64-bit build system, you likely want to set this to "0", |
| 133 | # otherwise you could end up with incorrect file attributes on the |
| 134 | # target filesystem. |
| 135 | # |
| 136 | # Default is to not build 32 bit libs on 64 bit systems, uncomment this |
| 137 | # if you need the 32 bits libs |
| 138 | #NO32LIBS = "0" |
| 139 | |
| 140 | # Uncomment the following lines to enable multilib builds |
| 141 | #require conf/multilib.conf |
| 142 | #MULTILIBS = "multilib:lib32" |
| 143 | #DEFAULTTUNE_virtclass-multilib-lib32 = "x86" |
| 144 | |
| 145 | # Set RPM_PREFER_ELF_ARCH to configure preferred ABI when using rpm packaging |
| 146 | # backend to generate a rootfs, choices are: |
| 147 | # 1: ELF32 wins |
| 148 | # 2: ELF64 wins |
| 149 | # 4: ELF64 N32 wins (for mips64 or mips64el only) |
| 150 | #RPM_PREFER_ELF_ARCH ?= "2" |
| 151 | |
| 152 | # The network based PR service host and port |
| 153 | # Uncomment the following lines to enable PRservice. |
| 154 | # Set PRSERV_HOST to 'localhost:0' to automatically |
| 155 | # start local PRService. |
| 156 | # Set to other values to use remote PRService. |
| 157 | #PRSERV_HOST = "localhost:0" |
| 158 | |
| 159 | # Additional image generation features |
| 160 | # |
| 161 | # The following is a list of classes to import to use in the generation of images |
| 162 | # currently an example class is image_types_uboot |
| 163 | # IMAGE_CLASSES = " image_types_uboot" |
| 164 | |
| 165 | # The following options will build a companion 'debug filesystem' in addition |
| 166 | # to the normal deployable filesystem. This companion system allows a |
| 167 | # debugger to know the symbols and related sources. It can be used to |
| 168 | # debug a remote 'production' system without having to add the debug symbols |
| 169 | # and sources to remote system. If IMAGE_FSTYPES_DEBUGFS is not defined, it |
| 170 | # defaults to IMAGE_FSTYPES. |
| 171 | #IMAGE_GEN_DEBUGFS = "1" |
| 172 | #IMAGE_FSTYPES_DEBUGFS = "tar.gz" |
| 173 | |
| 174 | # Incremental rpm image generation, the rootfs would be totally removed |
| 175 | # and re-created in the second generation by default, but with |
| 176 | # INC_RPM_IMAGE_GEN = "1", the rpm based rootfs would be kept, and will |
| 177 | # do update(remove/add some pkgs) on it. NOTE: This is not suggested |
| 178 | # when you want to create a productive rootfs |
| 179 | #INC_RPM_IMAGE_GEN = "1" |
| 180 | |
| 181 | # This is a list of packages that require a commercial license to ship |
| 182 | # product. If shipped as part of an image these packages may have |
| 183 | # implications so they are disabled by default. To enable them, |
| 184 | # un-comment the below as appropriate. |
| 185 | #LICENSE_FLAGS_WHITELIST = "commercial_gst-fluendo-mp3 \ |
| 186 | # commercial_gst-openmax \ |
| 187 | # commercial_gst-plugins-ugly \ |
| 188 | # commercial_lame \ |
| 189 | # commercial_libmad \ |
| 190 | # commercial_libomxil \ |
| 191 | # commercial_mpeg2dec" |
| 192 | |
| 193 | |
| 194 | # |
| 195 | # Disk space monitor, take action when the disk space or the amount of |
| 196 | # inode is running low, it is enabled when BB_DISKMON_DIRS is set. |
| 197 | # |
| 198 | # Set the directory for the monitor, the format is: |
| 199 | # "action,directory,minimum_space,minimum_free_inode" |
| 200 | # |
| 201 | # The "action" must be set and should be one of: |
| 202 | # ABORT: Immediately abort |
| 203 | # STOPTASKS: The new tasks can't be executed any more, will stop the build |
| 204 | # when the running tasks have been done. |
| 205 | # WARN: show warnings (see BB_DISKMON_WARNINTERVAL for more information) |
| 206 | # |
| 207 | # The "directory" must be set, any directory is OK. |
| 208 | # |
| 209 | # Either "minimum_space" or "minimum_free_inode" (or both of them) |
| 210 | # should be set, otherwise the monitor would not be enabled, |
| 211 | # the unit can be G, M, K or none, but do NOT use GB, MB or KB |
| 212 | # (B is not needed). |
| 213 | #BB_DISKMON_DIRS = "STOPTASKS,${TMPDIR},1G,100K WARN,${SSTATE_DIR},1G,100K" |
| 214 | # |
| 215 | # Set disk space and inode interval (only works when the action is "WARN", |
| 216 | # the unit can be G, M, or K, but do NOT use the GB, MB or KB |
| 217 | # (B is not needed), the format is: |
| 218 | # "disk_space_interval,disk_inode_interval", the default value is |
| 219 | # "50M,5K" which means that it would warn when the free space is |
| 220 | # lower than the minimum space(or inode), and would repeat the warning |
| 221 | # when the disk space reduces 50M (or the amount of inode reduces 5k). |
| 222 | #BB_DISKMON_WARNINTERVAL = "50M,5K" |
| 223 | |
| 224 | # Archive the source and put them to ${DEPLOY_DIR}/sources/. |
| 225 | # |
| 226 | #INHERIT += "archiver" |
| 227 | # |
| 228 | # The tarball for the patched source will be created by default, and you |
| 229 | # can configure the archiver as follow: |
| 230 | # |
| 231 | # Create archive for: |
| 232 | # 1) original (or unpacked) source: |
| 233 | #ARCHIVER_MODE[src] = "original" |
| 234 | # 2) patched source: (default) |
| 235 | #ARCHIVER_MODE[src] = "patched" |
| 236 | # 3) configured source: |
| 237 | #ARCHIVER_MODE[src] = "configured" |
| 238 | # |
| 239 | # 4) the patches between do_unpack and do_patch: |
| 240 | #ARCHIVER_MODE[diff] = "1" |
| 241 | # set the files that you'd like to exclude from the diff: |
| 242 | #ARCHIVER_MODE[diff-exclude] ?= ".pc autom4te.cache patches" |
| 243 | # |
| 244 | # 5) the environment data, similar to 'bitbake -e recipe': |
| 245 | #ARCHIVER_MODE[dumpdata] = "1" |
| 246 | # |
| 247 | # 6) the recipe (.bb and .inc): |
| 248 | #ARCHIVER_MODE[recipe] = "1" |
| 249 | # |
| 250 | # 7) Whether output the .src.rpm package: |
| 251 | #ARCHIVER_MODE[srpm] = "1" |
| 252 | # |
| 253 | # 8) Filter the license, the recipe whose license in |
| 254 | # COPYLEFT_LICENSE_INCLUDE will be included, and in |
| 255 | # COPYLEFT_LICENSE_EXCLUDE will be excluded. |
| 256 | #COPYLEFT_LICENSE_INCLUDE = 'GPL* LGPL*' |
| 257 | #COPYLEFT_LICENSE_EXCLUDE = 'CLOSED Proprietary' |
| 258 | # |
| 259 | # 9) Config the recipe type that will be archived, the type can be |
| 260 | # target, native, nativesdk, cross, crosssdk and cross-canadian, |
| 261 | # you can set one or more types. Archive all types by default. |
| 262 | #COPYLEFT_RECIPE_TYPES = 'target' |
| 263 | # |
| 264 | |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 265 | # |
| 266 | # GCC/LD FLAGS to enable more secure code generation |
| 267 | # |
| 268 | # By including the security_flags include file you enable flags |
| 269 | # to the compiler and linker that cause them to generate more secure |
Brad Bishop | 79641f2 | 2019-09-10 07:20:22 -0400 | [diff] [blame] | 270 | # code. |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 271 | # This does affect compile speed slightly. |
| 272 | # |
| 273 | # Use the following line to enable the security compiler and linker flags to your build |
| 274 | #require conf/distro/include/security_flags.inc |
| 275 | |
| 276 | # Image level user/group configuration. |
| 277 | # Inherit extrausers to make the setting of EXTRA_USERS_PARAMS effective. |
Brad Bishop | 1932369 | 2019-04-05 15:28:33 -0400 | [diff] [blame] | 278 | #IMAGE_CLASSES += "extrausers" |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 279 | # User / group settings |
Brad Bishop | 1932369 | 2019-04-05 15:28:33 -0400 | [diff] [blame] | 280 | # The settings are separated by the ; character. |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 281 | # Each setting is actually a command. The supported commands are useradd, |
| 282 | # groupadd, userdel, groupdel, usermod and groupmod. |
| 283 | #EXTRA_USERS_PARAMS = "\ |
Brad Bishop | 1932369 | 2019-04-05 15:28:33 -0400 | [diff] [blame] | 284 | # useradd -p '' tester; \ |
| 285 | # groupadd developers; \ |
| 286 | # userdel nobody; \ |
| 287 | # groupdel video; \ |
| 288 | # groupmod -g 1020 developers; \ |
| 289 | # usermod -s /bin/sh tester; \ |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 290 | #" |
| 291 | |
| 292 | # Various packages dynamically add users and groups to the system at package |
| 293 | # install time. For programs that do not care what the uid/gid is of the |
| 294 | # resulting users/groups, the order of the install will determine the final |
| 295 | # uid/gid. This can lead to non-deterministic uid/gid values from one build |
| 296 | # to another. Use the following settings to specify that all user/group adds |
| 297 | # should be created based on a static passwd/group file. |
| 298 | # |
| 299 | # Note, if you enable or disable the useradd-staticids in a configured system, |
| 300 | # the TMPDIR may contain incorrect uid/gid values. Clearing the TMPDIR |
| 301 | # will correct this condition. |
| 302 | # |
| 303 | # By default the system looks in the BBPATH for files/passwd and files/group |
Andrew Geissler | f034379 | 2020-11-18 10:42:21 -0600 | [diff] [blame] | 304 | # the default can be overridden by specifying USERADD_UID/GID_TABLES. |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 305 | # |
| 306 | #USERADDEXTENSION = "useradd-staticids" |
| 307 | #USERADD_UID_TABLES = "files/passwd" |
| 308 | #USERADD_GID_TABLES = "files/group" |
| 309 | # |
| 310 | # In order to prevent generating a system where a dynamicly assigned uid/gid |
| 311 | # can exist, you should enable the following setting. This will force the |
| 312 | # system to error out if the user/group name is not defined in the |
| 313 | # files/passwd or files/group (or specified replacements.) |
| 314 | #USERADD_ERROR_DYNAMIC = "1" |
| 315 | |
| 316 | # Enabling FORTRAN |
| 317 | # Note this is not officially supported and is just illustrated here to |
| 318 | # show an example of how it can be done |
| 319 | # You'll also need your fortran recipe to depend on libgfortran |
| 320 | #FORTRAN_forcevariable = ",fortran" |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 321 | |
| 322 | # |
| 323 | # Kernel image features |
| 324 | # |
| 325 | # The INITRAMFS_IMAGE image variable will cause an additional recipe to |
| 326 | # be built as a dependency to the what ever rootfs recipe you might be |
| 327 | # using such as core-image-sato. The initramfs might be needed for |
| 328 | # the initial boot of of the target system such as to load kernel |
| 329 | # modules prior to mounting the root file system. |
| 330 | # |
| 331 | # INITRAMFS_IMAGE_BUNDLE variable controls if the image recipe |
| 332 | # specified by the INITRAMFS_IMAGE will be run through an extra pass |
| 333 | # through the kernel compilation in order to build a single binary |
| 334 | # which contains both the kernel image and the initramfs. The |
| 335 | # combined binary will be deposited into the tmp/deploy directory. |
| 336 | # NOTE: You can set INITRAMFS_IMAGE in an image recipe, but |
| 337 | # INITRAMFS_IMAGE_BUNDLE can only be set in a conf file. |
| 338 | # |
| 339 | #INITRAMFS_IMAGE = "core-image-minimal-initramfs" |
| 340 | #INITRAMFS_IMAGE_BUNDLE = "1" |
| 341 | |
| 342 | # |
| 343 | # IPK Hierarchical feed |
| 344 | # |
| 345 | # In some cases it may be desirable not to have all package files in the same |
| 346 | # directory. An example would be when package feeds are to be uploaded to a |
| 347 | # shared webhosting service or transferred to a Windows machine which may have |
| 348 | # problems with directories containing multiple thousands of files. |
| 349 | # |
| 350 | # If the IPK_HIERARCHICAL_FEED variable is set to "1", packages will be split |
| 351 | # between subdirectories in a similar way to how Debian package feeds are |
| 352 | # organised. In the hierarchical feed, package files are written to |
| 353 | # <outdir>/<arch>/<pkg_prefix>/<pkg_subdir>, where pkg_prefix is the first |
| 354 | # letter of the package file name for non-lib packages or "lib" plus the 4th |
| 355 | # letter of the package file name for lib packages (eg, 'l' for less, 'libc' for |
| 356 | # libc6). pkg_subdir is the root of the package file name, discarding the |
| 357 | # version and architecture parts and the common suffixes '-dbg', '-dev', '-doc', |
| 358 | # '-staticdev', '-locale' and '-locale-*' which are listed in |
| 359 | # meta/conf/bitbake.conf. |
| 360 | # |
| 361 | # If IPK_HIERARCHICAL_FEED is unset or set to any other value, the traditional |
| 362 | # feed layout is used where package files are placed in <outdir>/<arch>/. |
| 363 | # |
| 364 | #IPK_HIERARCHICAL_FEED = "1" |
| 365 | # |
| 366 | |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 367 | # |
| 368 | # Use busybox/mdev for system initialization |
| 369 | # |
| 370 | #VIRTUAL-RUNTIME_dev_manager = "busybox-mdev" |
| 371 | #VIRTUAL-RUNTIME_login_manager = "busybox" |
| 372 | #VIRTUAL-RUNTIME_init_manager = "busybox" |
| 373 | #VIRTUAL-RUNTIME_initscripts = "initscripts" |
| 374 | #VIRTUAL-RUNTIME_keymaps = "keymaps" |
| 375 | #DISTRO_FEATURES_BACKFILL_CONSIDERED += "sysvinit" |
| 376 | |
| 377 | # |
| 378 | # Use systemd for system initialization |
| 379 | # |
| 380 | #DISTRO_FEATURES_append = " systemd" |
| 381 | #DISTRO_FEATURES_BACKFILL_CONSIDERED += "sysvinit" |
Brad Bishop | 1932369 | 2019-04-05 15:28:33 -0400 | [diff] [blame] | 382 | #VIRTUAL-RUNTIME_login_manager = "shadow-base" |
Patrick Williams | d8c66bc | 2016-06-20 12:57:21 -0500 | [diff] [blame] | 383 | #VIRTUAL-RUNTIME_init_manager = "systemd" |
| 384 | #VIRTUAL-RUNTIME_initscripts = "systemd-compat-units" |