diff options
Diffstat (limited to 'documentation/ref-manual/eclipse/html/poky-ref-manual/ref-features.html')
-rw-r--r-- | documentation/ref-manual/eclipse/html/poky-ref-manual/ref-features.html | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/documentation/ref-manual/eclipse/html/poky-ref-manual/ref-features.html b/documentation/ref-manual/eclipse/html/poky-ref-manual/ref-features.html new file mode 100644 index 0000000000..c10c49cb19 --- /dev/null +++ b/documentation/ref-manual/eclipse/html/poky-ref-manual/ref-features.html | |||
@@ -0,0 +1,60 @@ | |||
1 | <html> | ||
2 | <head> | ||
3 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||
4 | <title>Chapter 9. Reference: Features</title> | ||
5 | <link rel="stylesheet" type="text/css" href="../book.css"> | ||
6 | <meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> | ||
7 | <link rel="home" href="index.html" title="The Yocto Project Reference Manual"> | ||
8 | <link rel="up" href="index.html" title="The Yocto Project Reference Manual"> | ||
9 | <link rel="prev" href="ref-images.html" title="Chapter 8. Images"> | ||
10 | <link rel="next" href="ref-features-distro.html" title="9.1. Distro"> | ||
11 | </head> | ||
12 | <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="chapter" title="Chapter 9. Reference: Features"> | ||
13 | <div class="titlepage"><div><div><h2 class="title"> | ||
14 | <a name="ref-features"></a>Chapter 9. Reference: Features</h2></div></div></div> | ||
15 | <div class="toc"> | ||
16 | <p><b>Table of Contents</b></p> | ||
17 | <dl> | ||
18 | <dt><span class="section"><a href="ref-features-distro.html">9.1. Distro</a></span></dt> | ||
19 | <dt><span class="section"><a href="ref-features-machine.html">9.2. Machine</a></span></dt> | ||
20 | <dt><span class="section"><a href="ref-features-image.html">9.3. Images</a></span></dt> | ||
21 | <dt><span class="section"><a href="ref-features-backfill.html">9.4. Feature Backfilling</a></span></dt> | ||
22 | </dl> | ||
23 | </div> | ||
24 | <p> | ||
25 | Features provide a mechanism for working out which packages | ||
26 | should be included in the generated images. | ||
27 | Distributions can select which features they want to support through the | ||
28 | <code class="filename"><a class="link" href="ref-variables-glos.html#var-DISTRO_FEATURES" title="DISTRO_FEATURES">DISTRO_FEATURES</a></code> | ||
29 | variable, which is set in the <code class="filename">poky.conf</code> distribution configuration file. | ||
30 | Machine features are set in the | ||
31 | <code class="filename"><a class="link" href="ref-variables-glos.html#var-MACHINE_FEATURES" title="MACHINE_FEATURES">MACHINE_FEATURES</a></code> | ||
32 | variable, which is set in the machine configuration file and | ||
33 | specifies the hardware features for a given machine. | ||
34 | </p> | ||
35 | <p> | ||
36 | These two variables combine to work out which kernel modules, | ||
37 | utilities, and other packages to include. | ||
38 | A given distribution can support a selected subset of features so some machine features might not | ||
39 | be included if the distribution itself does not support them. | ||
40 | </p> | ||
41 | <p> | ||
42 | One method you can use to determine which recipes are checking to see if a | ||
43 | particular feature is contained or not is to <code class="filename">grep</code> through | ||
44 | the metadata for the feature. | ||
45 | Here is an example that discovers the recipes whose build is potentially | ||
46 | changed based on a given feature: | ||
47 | </p> | ||
48 | <pre class="literallayout"> | ||
49 | $ cd $HOME/poky | ||
50 | $ git grep 'contains.*MACHINE_FEATURES.*<feature>' | ||
51 | </pre> | ||
52 | <p> | ||
53 | </p> | ||
54 | <p> | ||
55 | This chapter provides a reference of shipped machine and distro features | ||
56 | you can include as part of the image, a reference on image types you can | ||
57 | build, and a reference on feature backfilling. | ||
58 | </p> | ||
59 | </div></body> | ||
60 | </html> | ||