summaryrefslogtreecommitdiffstats
path: root/documentation/getting-started/eclipse/html/getting-started/metadata-machine-configuration-and-policy-configuration.html
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/getting-started/eclipse/html/getting-started/metadata-machine-configuration-and-policy-configuration.html')
-rw-r--r--documentation/getting-started/eclipse/html/getting-started/metadata-machine-configuration-and-policy-configuration.html93
1 files changed, 93 insertions, 0 deletions
diff --git a/documentation/getting-started/eclipse/html/getting-started/metadata-machine-configuration-and-policy-configuration.html b/documentation/getting-started/eclipse/html/getting-started/metadata-machine-configuration-and-policy-configuration.html
new file mode 100644
index 0000000000..24f32f394f
--- /dev/null
+++ b/documentation/getting-started/eclipse/html/getting-started/metadata-machine-configuration-and-policy-configuration.html
@@ -0,0 +1,93 @@
1<html>
2<head>
3<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
4<title>2.8.2. Metadata, Machine Configuration, and Policy Configuration</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="Getting Started With Yocto Project">
8<link rel="up" href="development-concepts.html" title="2.8. Development Concepts">
9<link rel="prev" href="user-configuration.html" title="2.8.1. User Configuration">
10<link rel="next" href="distro-layer.html" title="2.8.2.1. Distro Layer">
11</head>
12<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="section" title="2.8.2. Metadata, Machine Configuration, and Policy Configuration">
13<div class="titlepage"><div><div><h3 class="title">
14<a name="metadata-machine-configuration-and-policy-configuration"></a>2.8.2. Metadata, Machine Configuration, and Policy Configuration</h3></div></div></div>
15<p>
16 The previous section described the user configurations that
17 define BitBake's global behavior.
18 This section takes a closer look at the layers the build system
19 uses to further control the build.
20 These layers provide Metadata for the software, machine, and
21 policy.
22 </p>
23<p>
24 In general, three types of layer input exist:
25 </p>
26<div class="itemizedlist"><ul class="itemizedlist" type="disc">
27<li class="listitem"><p><span class="emphasis"><em>Policy Configuration:</em></span>
28 Distribution Layers provide top-level or general
29 policies for the image or SDK being built.
30 For example, this layer would dictate whether BitBake
31 produces RPM or IPK packages.</p></li>
32<li class="listitem"><p><span class="emphasis"><em>Machine Configuration:</em></span>
33 Board Support Package (BSP) layers provide machine
34 configurations.
35 This type of information is specific to a particular
36 target architecture.</p></li>
37<li class="listitem"><p><span class="emphasis"><em>Metadata:</em></span>
38 Software layers contain user-supplied recipe files,
39 patches, and append files.
40 </p></li>
41</ul></div>
42<p>
43 </p>
44<p>
45 The following figure shows an expanded representation of the
46 Metadata, Machine Configuration, and Policy Configuration input
47 (layers) boxes of the
48 <a class="link" href="development-concepts.html#general-yocto-environment-figure">general Yocto Project Development Environment figure</a>:
49 </p>
50<p>
51 </p>
52<table border="0" summary="manufactured viewport for HTML img" cellspacing="0" cellpadding="0" width="720"><tr style="height: 675px"><td align="center"><img src="figures/layer-input.png" align="middle" width="720"></td></tr></table>
53<p>
54 </p>
55<p>
56 In general, all layers have a similar structure.
57 They all contain a licensing file
58 (e.g. <code class="filename">COPYING</code>) if the layer is to be
59 distributed, a <code class="filename">README</code> file as good practice
60 and especially if the layer is to be distributed, a
61 configuration directory, and recipe directories.
62 </p>
63<p>
64 The Yocto Project has many layers that can be used.
65 You can see a web-interface listing of them on the
66 <a class="ulink" href="http://git.yoctoproject.org/" target="_self">Source Repositories</a>
67 page.
68 The layers are shown at the bottom categorized under
69 "Yocto Metadata Layers."
70 These layers are fundamentally a subset of the
71 <a class="ulink" href="http://layers.openembedded.org/layerindex/layers/" target="_self">OpenEmbedded Metadata Index</a>,
72 which lists all layers provided by the OpenEmbedded community.
73 </p>
74<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
75<h3 class="title">Note</h3>
76 Layers exist in the Yocto Project Source Repositories that
77 cannot be found in the OpenEmbedded Metadata Index.
78 These layers are either deprecated or experimental in nature.
79 </div>
80<p>
81 </p>
82<p>
83 BitBake uses the <code class="filename">conf/bblayers.conf</code> file,
84 which is part of the user configuration, to find what layers it
85 should be using as part of the build.
86 </p>
87<p>
88 For more information on layers, see the
89 "<a class="link" href="../dev-manual/understanding-and-creating-layers.html" target="_self">Understanding and Creating Layers</a>"
90 section in the Yocto Project Development Tasks Manual.
91 </p>
92</div></body>
93</html>