Transcription of The Buildroot user manual
1 The Buildroot user manualThe Buildroot user manualiiContentsI Getting started11 About Buildroot22 System packages .. packages ..43 Getting Buildroot54 Buildroot quick start65 Community resources8II User guide96 Buildroot toolchain .. toolchain backend .. toolchain backend .. an external toolchain with Buildroot .. toolchain wrapper .. management .. system .. 147 Configuration of other components168 General Buildroot .. when a full rebuild is necessary .. how to rebuild packages .. builds .. 20 The Buildroot user out-of-tree.
2 Variables .. efficiently with filesystem images .. about packages .. the dependencies between packages .. Graphing the build duration .. Graphing the filesystem size contribution of packages .. Top-level parallel build .. Integration with Eclipse .. Advanced usage .. Using the generated toolchain outside Buildroot .. Usinggdbin Buildroot .. Usingccachein Buildroot .. Location of downloaded packages .. Package-specificmaketargets .. Using Buildroot during development .. 289 Project-specific directory structure.
3 Layered customizations .. customizations outside of Buildroot .. of a br2-external tree .. content .. Linux kernel extensions .. layout .. the Buildroot configuration .. the configuration of other components .. the generated target filesystem .. file permissions and ownership and adding custom devices nodes .. custom user accounts .. images have been created .. project-specific patches .. project-specific packages .. Quick guide to storing your project-specific customizations .. 42 The Buildroot user manualiv10 Using SELinux in Enabling SELinux support.
4 SELinux policy tweaking .. 4411 Frequently Asked Questions & The boot hangs afterStarting network.. Why is there no compiler on the target? .. Why are there no development files on the target? .. Why is there no documentation on the target? .. Why are some packages not visible in the Buildroot config menu? .. Why not use the target directory as a chroot directory? .. Why doesn t Buildroot generate binary packages (.deb, .ipkg.. )? .. How to speed-up the build process? .. 4812 Known issues5013 Legal notice and Complying with open source licenses.
5 Complying with the Buildroot license .. Patches to packages .. 5214 Beyond Boot the generated images .. NFS boot .. Live CD .. Chroot .. 53 III Developer guide5415 How Buildroot works5516 Coding .. The documentation .. Support scripts .. 5917 Adding support for a particular board60 The Buildroot user manualv18 Adding new packages to Package directory .. Config files .. Choosingdepends onorselect.. Dependencies on target and toolchain options .. Dependencies on a Linux kernel built by Buildroot .. Dependencies on udev /dev management.
6 Dependencies on features provided by virtual packages .. TheSNNfoostart script .. Infrastructure for packages with specific build systems .. Infrastructure for autotools-based packages .. Infrastructure for CMake-based packages .. Infrastructure for Python packages .. Generating apython-packagefrom a PyPI repository .. backend .. for LuaRocks-based packages .. for Perl/CPAN packages .. for virtual packages .. Virtual package .. Virtual package .. Provider .. Provider .. 88 The Buildroot user Notes on depending on a virtual package.
7 Notes on depending on a specific provider .. for packages using kconfig for configuration files .. for rebar-based packages .. for Waf-based packages .. for Meson-based packages .. of Cargo-based packages .. Cargo-based package .. Cargo-based package .. About Dependencies Management .. for Go packages .. for QMake-based packages .. for packages building kernel modules .. for asciidoc documents .. specific to the Linux kernel package .. linux-kernel-tools .. linux-kernel-extensions .. available in the various build steps.
8 Using thePOST_RSYNC hook .. Target-finalize hook .. integration and interaction with packages .. and tricks .. Package name, config entry name and makefile variable relationship .. How to check the coding style .. How to test your package .. How to add a package from GitHub .. How to add a package from Gitlab .. 108 The Buildroot user manualvii19 Patching a Providing patches .. Downloaded .. Within Buildroot .. Global patch directory .. How patches are applied .. Format and licensing of the package patches .. Integrating patches found on the Web.
9 11120 Download infrastructure11221 Debugging Buildroot11322 Contributing to Reproducing, analyzing and fixing bugs .. Analyzing and fixing autobuild failures .. Reviewing and testing patches .. Applying Patches from Patchwork .. Work on items from the TODO list .. Submitting patches .. The formatting of a patch .. Preparing a patch series .. Cover letter .. Patches for maintenance branches .. Patch revision changelog .. Reporting issues/bugs or getting help .. Using the runtime tests framework .. Creating a test case .. Debugging a test case.
10 Runtime tests and Gitlab CI .. 12223 DEVELOPERS file and get-developers12424 Release Releases .. Development .. 125IV Appendix12625 Makedev syntax documentation12726 Makeusers syntax documentation129 The Buildroot user manualviii27 Migrating from older Buildroot General approach .. Migrating to .. Migrating to .. 132 The Buildroot user manualixBuildroot manual generated on 2022-02-28 20:20:52 UTC from git revision eeb8c004daThe Buildroot manual is written by the Buildroot developers. It is licensed under the GNU General Public License, version to the COPYING file in the Buildroot sources for the full text of this 2004-2020 The Buildroot Buildroot user manual1 / 132 Part IGetting startedThe Buildroot user manual2 / 132 Chapter 1 About BuildrootBuildroot is a tool that simplifies and automates the process of building a complete Linux system for an embedded system, order to achieve this, Buildroot is able to generate a cross-compilation toolchain, a root filesystem, a Linux kernel image and abootloader for your target.
