BitBake User Manual
�	�	�Next

BitBake User Manual

BitBake Team

This work is licensed under the Creative Commons Attribution License. To view a copy of this license, visit http://creativecommons.org/licenses/by/2.5/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.

Table of Contents

1. Introduction

Overview
Background and goals

2. Metadata

Description

Basic variable setting
Variable expansion
Setting a default value (?=)
Setting a weak default value (??=)
Immediate variable expansion (:=)
Appending (+=) and prepending (=+)
Appending (.=) and prepending (=.) without spaces
Conditional metadata set
Conditional appending
Inclusion
Requiring inclusion
Python variable expansion
Defining executable metadata
Defining Python functions into the global Python namespace
Variable flags
Inheritance
Tasks
Task Flags
Events
Variants

Variable interaction: Worked Examples

Override and append ordering
Key Expansion

Dependency handling

Dependencies internal to the .bb file
Build Dependencies
Runtime Dependencies
Recursive Dependencies
Inter task

Parsing

Configuration files
Classes
.bb files

3. File download support

Overview
Local file fetcher
CVS fetcher
HTTP/FTP fetcher
SVN fetcher
GIT fetcher

4. The BitBake command

Introduction

Usage and syntax

Special variables

BB_NUMBER_THREADS

Metadata

List of Examples

4.1. Executing a task against a single .bb
4.2. Executing tasks against a set of .bb files
4.3. Generating dependency graphs
4.4. Setting BBFILES
4.5. Depending on another .bb
4.6. Using PROVIDES
4.7. Specifying version preference
4.8. Using “bbfile collections”