Yocto Project Development Tasks Manual
- 1 The Yocto Project Development Tasks Manual
- 2 Setting Up to Use the Yocto Project
- 3 Understanding and Creating Layers
- 3.1 Creating Your Own Layer
- 3.2 Following Best Practices When Creating Layers
- 3.3 Making Sure Your Layer is Compatible With Yocto Project
- 3.4 Enabling Your Layer
- 3.5 Appending Other Layers Metadata With Your Layer
- 3.6 Prioritizing Your Layer
- 3.7 Managing Layers
- 3.8 Creating a General Layer Using the
bitbake-layers
Script - 3.9 Adding a Layer Using the
bitbake-layers
Script
- 4 Customizing Images
- 5 Writing a New Recipe
- 5.1 Overview
- 5.2 Locate or Automatically Create a Base Recipe
- 5.3 Storing and Naming the Recipe
- 5.4 Running a Build on the Recipe
- 5.5 Fetching Code
- 5.6 Unpacking Code
- 5.7 Patching Code
- 5.8 Licensing
- 5.9 Dependencies
- 5.10 Configuring the Recipe
- 5.11 Using Headers to Interface with Devices
- 5.12 Compilation
- 5.13 Installing
- 5.14 Enabling System Services
- 5.15 Packaging
- 5.16 Sharing Files Between Recipes
- 5.17 Using Virtual Providers
- 5.18 Properly Versioning Pre-Release Recipes
- 5.19 Post-Installation Scripts
- 5.20 Testing
- 5.21 Examples
- 5.22 Following Recipe Style Guidelines
- 5.23 Recipe Syntax
- 6 Adding a New Machine
- 7 Adding the Machine Configuration File
- 8 Adding a Kernel for the Machine
- 9 Adding a Formfactor Configuration File
- 10 Upgrading Recipes
- 11 Finding Temporary Source Code
- 12 Using Quilt in Your Workflow
- 13 Using a Development Shell
- 14 Using a Python Development Shell
- 15 Building
- 15.1 Building a Simple Image
- 15.2 Building Images for Multiple Targets Using Multiple Configurations
- 15.3 Building an Initial RAM Filesystem (Initramfs) Image
- 15.4 Building a Tiny System
- 15.5 Building Images for More than One Machine
- 15.6 Building Software from an External Source
- 15.7 Replicating a Build Offline
- 16 Speeding Up a Build
- 17 Working With Libraries
- 18 Working with Pre-Built Libraries
- 19 Using x32 psABI
- 20 Enabling GObject Introspection Support
- 21 Optionally Using an External Toolchain
- 22 Creating Partitioned Images Using Wic
- 23 Flashing Images Using
bmaptool
- 24 Making Images More Secure
- 25 Creating Your Own Distribution
- 26 Creating a Custom Template Configuration Directory
- 27 Conserving Disk Space
- 28 Working with Packages
- 28.1 Excluding Packages from an Image
- 28.2 Incrementing a Package Version
- 28.3 Handling Optional Module Packaging
- 28.4 Using Runtime Package Management
- 28.5 Generating and Using Signed Packages
- 28.6 Testing Packages With ptest
- 28.7 Creating Node Package Manager (NPM) Packages
- 28.8 Adding custom metadata to packages
- 29 Efficiently Fetching Source Files During a Build
- 30 Selecting an Initialization Manager
- 31 Selecting a Device Manager
- 32 Using an External SCM
- 33 Creating a Read-Only Root Filesystem
- 34 Maintaining Build Output Quality
- 35 Performing Automated Runtime Testing
- 36 Debugging Tools and Techniques
- 36.1 Viewing Logs from Failed Tasks
- 36.2 Viewing Variable Values
- 36.3 Viewing Package Information with
oe-pkgdata-util
- 36.4 Viewing Dependencies Between Recipes and Tasks
- 36.5 Viewing Task Variable Dependencies
- 36.6 Debugging signature construction and unexpected task executions
- 36.7 Viewing Metadata Used to Create the Input Signature of a Shared State Task
- 36.8 Invalidating Shared State to Force a Task to Run
- 36.9 Running Specific Tasks
- 36.10 General BitBake Problems
- 36.11 Building with No Dependencies
- 36.12 Recipe Logging Mechanisms
- 36.13 Debugging Parallel Make Races
- 36.14 Debugging With the GNU Project Debugger (GDB) Remotely
- 36.15 Debugging with the GNU Project Debugger (GDB) on the Target
- 36.16 Other Debugging Tips
- 37 Working With Licenses
- 38 Dealing with Vulnerability Reports
- 39 Checking for Vulnerabilities
- 40 Creating a Software Bill of Materials
- 41 Using the Error Reporting Tool
- 42 Using Wayland and Weston
- 43 Using the Quick EMUlator (QEMU)
- 43.1 Overview
- 43.2 Running QEMU
- 43.3 Switching Between Consoles
- 43.4 Removing the Splash Screen
- 43.5 Disabling the Cursor Grab
- 43.6 Running Under a Network File System (NFS) Server
- 43.7 QEMU CPU Compatibility Under KVM
- 43.8 QEMU Performance
- 43.9 QEMU Command-Line Syntax
- 43.10
runqemu
Command-Line Options
The Yocto Project ®
Permission is granted to copy, distribute and/or modify this document under the terms of the Creative Commons Attribution-Share Alike 2.0 UK: England & Wales as published by Creative Commons.
To report any inaccuracies or problems with this (or any other Yocto Project)
manual, or to send additions or changes, please send email/patches to the Yocto
Project documentation mailing list at docs@lists.yoctoproject.org
or
log into the Libera Chat #yocto
channel.