mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-06-01 00:59:48 +00:00
Code Issues Projects Releases Wiki Activity

ref-manual: Read-through edits to "Closer Look" chapter.

Browse Source 
Minor fixes throughout.

(From yocto-docs rev: d44ae0da21d84acbe1556824e228c7ab0af1ba2c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2014-03-28 17:21:30 -06:00
committed by Richard Purdie
parent 4a3a747c77
commit ec27a7873b
1 changed files with 56 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/ref-manual/closer-look.xml
+56 -35
View File
@@ -33,13 +33,14 @@
<listitem><para><emphasis>Source Files:</emphasis> <listitem><para><emphasis>Source Files:</emphasis>
Upstream releases, local projects, and SCMs.</para></listitem> Upstream releases, local projects, and SCMs.</para></listitem>
<listitem><para><emphasis>Build System:</emphasis> <listitem><para><emphasis>Build System:</emphasis>
Processes under the control of BitBake. Processes under the control of
<ulink url='&YOCTO_DOCS_DEV_URL;#bitbake-term'>BitBake</ulink>.
This block expands on how BitBake fetches source, applies This block expands on how BitBake fetches source, applies
patches, completes compilation, analyzes output for package patches, completes compilation, analyzes output for package
generation, creates and tests packages, generates images, and generation, creates and tests packages, generates images, and
generates cross-development tools.</para></listitem> generates cross-development tools.</para></listitem>
<listitem><para><emphasis>Package Feeds:</emphasis> <listitem><para><emphasis>Package Feeds:</emphasis>
Directories containing output packages (rpm, deb or ipk), Directories containing output packages (RPM, DEB or IPK),
which are subsequently used in the construction of an image or which are subsequently used in the construction of an image or
SDK, produced by the build system. SDK, produced by the build system.
These feeds can also be copied and shared using a web server or These feeds can also be copied and shared using a web server or
@@ -48,8 +49,6 @@
enabled.</para></listitem> enabled.</para></listitem>
<listitem><para><emphasis>Images:</emphasis> <listitem><para><emphasis>Images:</emphasis>
Images produced by the development process. Images produced by the development process.
Where do they go?
Can you mess with them (i.e. freely delete them or move them?).
</para></listitem> </para></listitem>
<listitem><para><emphasis>Application Development SDK:</emphasis> <listitem><para><emphasis>Application Development SDK:</emphasis>
Cross-development tools that are produced along with an image Cross-development tools that are produced along with an image
@@ -545,7 +544,7 @@
<para> <para>
The canonical method through which to include a local project The canonical method through which to include a local project
is to use the is to use the
<link linkend='ref-classes-externalsrc'><filename>externalsrc.bbclass</filename></link> <link linkend='ref-classes-externalsrc'><filename>externalsrc</filename></link>
class to include that local project. class to include that local project.
You use either the <filename>local.conf</filename> or a You use either the <filename>local.conf</filename> or a
recipe's append file to override or set the recipe's append file to override or set the
@@ -555,7 +554,7 @@
<para> <para>
For information on how to use the For information on how to use the
<filename>externalsrc.bbclass</filename>, see the <filename>externalsrc</filename> class, see the
"<link linkend='ref-classes-externalsrc'><filename>externalsrc.bbclass</filename></link>" "<link linkend='ref-classes-externalsrc'><filename>externalsrc.bbclass</filename></link>"
section. section.
</para> </para>
@@ -639,13 +638,13 @@
<para> <para>
Package feeds are an intermediary step in the build process. Package feeds are an intermediary step in the build process.
BitBake generates packages whose type is defined by the BitBake generates packages whose types are defined by the
<link linkend='var-PACKAGE_CLASSES'><filename>PACKAGE_CLASSES</filename></link> <link linkend='var-PACKAGE_CLASSES'><filename>PACKAGE_CLASSES</filename></link>
variable. variable.
Before placing the packages into package feeds, Before placing the packages into package feeds,
the build process validates them with generated output quality the build process validates them with generated output quality
assurance checks through the assurance checks through the
<link linkend='ref-classes-insane'><filename>insane.bbclass</filename></link> <link linkend='ref-classes-insane'><filename>insane</filename></link>
class. class.
</para> </para>
@@ -674,13 +673,22 @@
<title>BitBake</title> <title>BitBake</title>
<para> <para>
The OpenEmbedded build system uses BitBake to produce images. The OpenEmbedded build system uses
<ulink url='&YOCTO_DOCS_DEV_URL;#bitbake-term'>BitBake</ulink>
to produce images.
You can see from the You can see from the
<link linkend='general-yocto-environment-figure'>general Yocto Project Development Environment figure</link>, <link linkend='general-yocto-environment-figure'>general Yocto Project Development Environment figure</link>,
the BitBake area consists of several functional areas. the BitBake area consists of several functional areas.
This section takes a closer look at each of those areas. This section takes a closer look at each of those areas.
</para> </para>
<para>
Separate documentation exists for the BitBake tool.
See the
<ulink url='&YOCTO_DOCS_BB_URL;#bitbake-user-manual'>BitBake User Manual</ulink>
for reference material on BitBake.
</para>
<section id='source-fetching-dev-environment'> <section id='source-fetching-dev-environment'>
<title>Source Fetching</title> <title>Source Fetching</title>
@@ -713,31 +721,34 @@
You can see the variables that define these directories You can see the variables that define these directories
by looking at the figure: by looking at the figure:
<itemizedlist> <itemizedlist>
<listitem><para><link linkend='var-TMPDIR'><filename>TMPDIR</filename></link> <listitem><para><link linkend='var-TMPDIR'><filename>TMPDIR</filename></link> -
The base directory where the OpenEmbedded build system
performs all its work during the build.
</para></listitem> </para></listitem>
<listitem><para><link linkend='var-PACKAGE_ARCH'><filename>PACKAGE_ARCH</filename></link> <listitem><para><link linkend='var-PACKAGE_ARCH'><filename>PACKAGE_ARCH</filename></link> -
The architecture of the built package or packages.
</para></listitem> </para></listitem>
<listitem><para><link linkend='var-TARGET_OS'><filename>TARGET_OS</filename></link> <listitem><para><link linkend='var-TARGET_OS'><filename>TARGET_OS</filename></link> -
The operating system of the target device.
</para></listitem> </para></listitem>
<listitem><para><link linkend='var-PN'><filename>PN</filename></link> <listitem><para><link linkend='var-PN'><filename>PN</filename></link> -
The name of the built package.
</para></listitem> </para></listitem>
<listitem><para><link linkend='var-PV'><filename>PV</filename></link> <listitem><para><link linkend='var-PV'><filename>PV</filename></link> -
The version of the recipe used to build the package.
</para></listitem> </para></listitem>
<listitem><para><link linkend='var-PR'><filename>PR</filename></link> <listitem><para><link linkend='var-PR'><filename>PR</filename></link> -
The revision of the recipe used to build the package.
</para></listitem> </para></listitem>
<listitem><para><link linkend='var-WORKDIR'><filename>WORKDIR</filename></link> <listitem><para><link linkend='var-WORKDIR'><filename>WORKDIR</filename></link> -
The location within <filename>TMPDIR</filename> where
a specific package is built.
</para></listitem> </para></listitem>
<listitem><para><link linkend='var-S'><filename>S</filename></link> <listitem><para><link linkend='var-S'><filename>S</filename></link> -
Contains the unpacked source files for a given recipe.
</para></listitem> </para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
<para>
Briefly, the <filename>S</filename> directory contains the
unpacked source files for a recipe.
The <filename>WORKDIR</filename> directory is where all the
building goes on for a given recipe.
</para>
</section> </section>
<section id='patching-dev-environment'> <section id='patching-dev-environment'>
@@ -802,8 +813,9 @@
to source code configuration for the source code to source code configuration for the source code
being built by the recipe.</para> being built by the recipe.</para>
<para>If you are using <para>If you are using the
<link linkend='ref-classes-autotools'><filename>autotools.bbclass</filename></link>, <link linkend='ref-classes-autotools'><filename>autotools</filename></link>
class,
you can add additional configuration options by using you can add additional configuration options by using
the <link linkend='var-EXTRA_OECONF'><filename>EXTRA_OECONF</filename></link> the <link linkend='var-EXTRA_OECONF'><filename>EXTRA_OECONF</filename></link>
variable. variable.
@@ -861,21 +873,30 @@
Working, staged, and intermediate results of the analysis Working, staged, and intermediate results of the analysis
and package splitting process use these areas: and package splitting process use these areas:
<itemizedlist> <itemizedlist>
<listitem><para><link linkend='var-PKGD'><filename>PKGD</filename></link> <listitem><para><link linkend='var-PKGD'><filename>PKGD</filename></link> -
The destination directory for packages before they are
split.
</para></listitem> </para></listitem>
<listitem><para><link linkend='var-PKGDATA_DIR'><filename>PKGDATA_DIR</filename></link> <listitem><para><link linkend='var-PKGDATA_DIR'><filename>PKGDATA_DIR</filename></link> -
A shared, global-state directory that holds data
generated during the packaging process.
</para></listitem> </para></listitem>
<listitem><para><link linkend='var-PKGDESTWORK'><filename>PKGDESTWORK</filename></link> <listitem><para><link linkend='var-PKGDESTWORK'><filename>PKGDESTWORK</filename></link> -
A temporary work area used by the
<filename>do_package</filename> task.
</para></listitem> </para></listitem>
<listitem><para><link linkend='var-PKGDEST'><filename>PKGDEST</filename></link> <listitem><para><link linkend='var-PKGDEST'><filename>PKGDEST</filename></link> -
The parent directory for packages after they have
been split.
</para></listitem> </para></listitem>
</itemizedlist> </itemizedlist>
The <link linkend='var-FILES'><filename>FILES</filename></link> The <link linkend='var-FILES'><filename>FILES</filename></link>
variable defines the files that go into each package in variable defines the files that go into each package in
<link linkend='var-PACKAGES'><filename>PACKAGES</filename></link>. <link linkend='var-PACKAGES'><filename>PACKAGES</filename></link>.
If you want details on how this is accomplished, you can If you want details on how this is accomplished, you can
look at look at the
<link linkend='ref-classes-package'><filename>package.bbclass</filename></link>. <link linkend='ref-classes-package'><filename>package</filename></link>
class.
</para> </para>
<para> <para>
@@ -954,8 +975,8 @@
If you are using a If you are using a
<ulink url='&YOCTO_DOCS_DEV_URL;#creating-a-read-only-root-filesystem'>read-only root filesystem</ulink>, <ulink url='&YOCTO_DOCS_DEV_URL;#creating-a-read-only-root-filesystem'>read-only root filesystem</ulink>,
all the post installation scripts must succeed during the all the post installation scripts must succeed during the
package installation phase since the root filesystem cannot be package installation phase since the root filesystem is
written into. read-only.
</para> </para>
<para> <para>
@@ -1075,7 +1096,7 @@
root filesystem that are ready to boot on a target device. root filesystem that are ready to boot on a target device.
You can see from the You can see from the
<link linkend='general-yocto-environment-figure'>general Yocto Project Development Environment figure</link> <link linkend='general-yocto-environment-figure'>general Yocto Project Development Environment figure</link>
that BitBake output in part consists of images. that BitBake output, in part, consists of images.
This section is going to look more closely at this output: This section is going to look more closely at this output:
<imagedata fileref="figures/images.png" align="center" width="5.5in" depth="5.5in" /> <imagedata fileref="figures/images.png" align="center" width="5.5in" depth="5.5in" />
</para> </para>