Source of customize.txt - buildroot

xxxxxxxxxx

// -*- mode:doc; -*-

// vim: set syntax=asciidoc:

[[customize]]

== Project-specific customization

Typical actions you may need to perform for a given project are:

* configuring Buildroot (including build options and toolchain,

  bootloader, kernel, package and filesystem image type selection)

* configuring other components, like the Linux kernel and BusyBox

* customizing the generated target filesystem

  ** adding or overwriting files on the target filesystem (using

     +BR2_ROOTFS_OVERLAY+)

  ** modifying or deleting files on the target filesystem (using

     +BR2_ROOTFS_POST_BUILD_SCRIPT+)

  ** running arbitrary commands prior to generating the filesystem image

     (using +BR2_ROOTFS_POST_BUILD_SCRIPT+)

  ** setting file permissions and ownership (using

     +BR2_ROOTFS_DEVICE_TABLE+)

  ** adding custom devices nodes (using

     +BR2_ROOTFS_STATIC_DEVICE_TABLE+)

* adding custom user accounts (using +BR2_ROOTFS_USERS_TABLES+)

* running arbitrary commands after generating the filesystem image

  (using +BR2_ROOTFS_POST_IMAGE_SCRIPT+)

* adding project-specific patches to some packages (using

  +BR2_GLOBAL_PATCH_DIR+)

* adding project-specific packages

An important note regarding such 'project-specific' customizations:

please carefully consider which changes are indeed project-specific and

which changes are also useful to developers outside your project. The

Buildroot community highly recommends and encourages the upstreaming of

improvements, packages and board support to the official Buildroot

project. Of course, it is sometimes not possible or desirable to

upstream because the changes are highly specific or proprietary.

This chapter describes how to make such project-specific customizations

in Buildroot and how to store them in a way that you can build the same

image in a reproducible way, even after running 'make clean'. By

following the recommended strategy, you can even use the same Buildroot

tree to build multiple distinct projects!

include::customize-directory-structure.txt[]

include::customize-outside-br.txt[]

include::customize-configuration.txt[]

include::customize-rootfs.txt[]

include::customize-users-tables.txt[]

include::customize-post-image.txt[]

include::customize-patches.txt[]

include::customize-packages.txt[]

include::customize-quick-guide.txt[]