Chapter 9. Reference: Features

Table of Contents

9.1. Distro
9.2. Machine
9.3. Images
9.4. Feature Backfilling

Features provide a mechanism for working out which packages should be included in the generated images. Distributions can select which features they want to support through the DISTRO_FEATURES variable, which is set in the poky.conf distribution configuration file. Machine features are set in the MACHINE_FEATURES variable, which is set in the machine configuration file and specifies the hardware features for a given machine.

These two variables combine to work out which kernel modules, utilities, and other packages to include. A given distribution can support a selected subset of features so some machine features might not be included if the distribution itself does not support them.

One method you can use to determine which recipes are checking to see if a particular feature is contained or not is to grep through the metadata for the feature. Here is an example that discovers the recipes whose build is potentially changed based on a given feature:

     $ cd $HOME/poky
     $ git grep 'contains.*MACHINE_FEATURES.*<feature>'
        

This chapter provides a reference of shipped machine and distro features you can include as part of the image, a reference on image types you can build, and a reference on feature backfilling.