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

overview-manual: Minor edits to the SDK generation section.

Browse Source 
Added the descriptions for the SDK_HOST_MANIFEST and
SDK_TARGET_MANIFEST variables.

(From yocto-docs rev: 212d6c5b3290016431604e67dfb27a1408ac0463)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2018-05-11 09:08:28 -07:00
committed by Richard Purdie
parent e20dc4814b
commit 7bf6af45ef
1 changed files with 74 additions and 60 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/overview-manual/overview-manual-concepts.xml
+74 -60
View File
@@ -2048,24 +2048,26 @@
<para> <para>
In the In the
<link linkend='general-workflow-figure'>general Yocto Project Development Environment figure</link>, <link linkend='general-workflow-figure'>general workflow figure</link>,
the output labeled "Application Development SDK" represents an the output labeled "Application Development SDK" represents an
SDK. SDK.
The SDK generation process differs depending on whether you The SDK generation process differs depending on whether you
build a standard SDK (e.g. build an extensible SDK (e.g.
<filename>bitbake -c populate_sdk</filename> <replaceable>imagename</replaceable>) <filename>bitbake -c populate_sdk_ext</filename> <replaceable>imagename</replaceable>)
or an extensible SDK (e.g. or a standard SDK (e.g.
<filename>bitbake -c populate_sdk_ext</filename> <replaceable>imagename</replaceable>). <filename>bitbake -c populate_sdk</filename> <replaceable>imagename</replaceable>).
This section is going to take a closer look at this output: This section takes a closer look at this output:
<imagedata fileref="figures/sdk.png" align="center" width="9in" depth="7.25in" /> <imagedata fileref="figures/sdk.png" align="center" width="9in" depth="7.25in" />
</para> </para>
<para> <para>
The specific form of this output is a self-extracting The specific form of this output is a set of files that
SDK installer (<filename>*.sh</filename>) that, when run, includes a self-extracting SDK installer
installs the SDK, which consists of a cross-development (<filename>*.sh</filename>), host and target manifest files,
toolchain, a set of libraries and headers, and an SDK and files used for SDK testing.
environment setup script. When the SDK installer file is run, it installs the SDK.
The SDK consists of a cross-development toolchain, a set of
libraries and headers, and an SDK environment setup script.
Running this installer essentially sets up your Running this installer essentially sets up your
cross-development environment. cross-development environment.
You can think of the cross-toolchain as the "host" You can think of the cross-toolchain as the "host"
@@ -2102,55 +2104,13 @@
</note> </note>
<para> <para>
Once built, the SDK installers are written out to the All the output files for an SDK are written to the
<filename>deploy/sdk</filename> folder inside the <filename>deploy/sdk</filename> folder inside the
<ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink> <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>
as shown in the figure at the beginning of this section. as shown in the previous figure.
Depending on the type of SDK, several variables exist that help Depending on the type of SDK, several variables exist that help
configure these files. configure these files.
The following list shows the variables associated with The following list shows the variables associated with an
a standard SDK:
<itemizedlist>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-DEPLOY_DIR'><filename>DEPLOY_DIR</filename></ulink>:
Points to the <filename>deploy</filename>
directory.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDKMACHINE'><filename>SDKMACHINE</filename></ulink>:
Specifies the architecture of the machine
on which the cross-development tools are run to
create packages for the target hardware.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDKIMAGE_FEATURES'><filename>SDKIMAGE_FEATURES</filename></ulink>:
Lists the features to include in the "target" part
of the SDK.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-TOOLCHAIN_HOST_TASK'><filename>TOOLCHAIN_HOST_TASK</filename></ulink>:
Lists packages that make up the host
part of the SDK (i.e. the part that runs on
the <filename>SDKMACHINE</filename>).
When you use
<filename>bitbake -c populate_sdk <replaceable>imagename</replaceable></filename>
to create the SDK, a set of default packages
apply.
This variable allows you to add more packages.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-TOOLCHAIN_TARGET_TASK'><filename>TOOLCHAIN_TARGET_TASK</filename></ulink>:
Lists packages that make up the target part
of the SDK (i.e. the part built for the
target hardware).
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDKPATH'><filename>SDKPATH</filename></ulink>:
Defines the default SDK installation path offered
by the installation script.
</para></listitem>
</itemizedlist>
This next list, shows the variables associated with an
extensible SDK: extensible SDK:
<itemizedlist> <itemizedlist>
<listitem><para> <listitem><para>
@@ -2166,13 +2126,12 @@
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_INCLUDE_PKGDATA'><filename>SDK_INCLUDE_PKGDATA</filename></ulink>: <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_INCLUDE_PKGDATA'><filename>SDK_INCLUDE_PKGDATA</filename></ulink>:
Specifies whether or not packagedata will be Specifies whether or not packagedata is included in the
included in the extensible SDK for all recipes in extensible SDK for all recipes in the "world" target.
the "world" target.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_INCLUDE_TOOLCHAIN'><filename>SDK_INCLUDE_TOOLCHAIN</filename></ulink>: <ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_INCLUDE_TOOLCHAIN'><filename>SDK_INCLUDE_TOOLCHAIN</filename></ulink>:
Specifies whether or not the toolchain will be included Specifies whether or not the toolchain is included
when building the extensible SDK. when building the extensible SDK.
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
@@ -2194,6 +2153,61 @@
value globally within the extensible SDK configuration. value globally within the extensible SDK configuration.
</para></listitem> </para></listitem>
</itemizedlist> </itemizedlist>
This next list, shows the variables associated with a standard
SDK:
<itemizedlist>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-DEPLOY_DIR'><filename>DEPLOY_DIR</filename></ulink>:
Points to the <filename>deploy</filename> directory.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDKMACHINE'><filename>SDKMACHINE</filename></ulink>:
Specifies the architecture of the machine on which the
cross-development tools are run to create packages for
the target hardware.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDKIMAGE_FEATURES'><filename>SDKIMAGE_FEATURES</filename></ulink>:
Lists the features to include in the "target" part
of the SDK.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-TOOLCHAIN_HOST_TASK'><filename>TOOLCHAIN_HOST_TASK</filename></ulink>:
Lists packages that make up the host part of the SDK
(i.e. the part that runs on the
<filename>SDKMACHINE</filename>).
When you use
<filename>bitbake -c populate_sdk <replaceable>imagename</replaceable></filename>
to create the SDK, a set of default packages apply.
This variable allows you to add more packages.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-TOOLCHAIN_TARGET_TASK'><filename>TOOLCHAIN_TARGET_TASK</filename></ulink>:
Lists packages that make up the target part of the SDK
(i.e. the part built for the target hardware).
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDKPATH'><filename>SDKPATH</filename></ulink>:
Defines the default SDK installation path offered by
the installation script.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_HOST_MANIFEST'><filename>SDK_HOST_MANIFEST</filename></ulink>:
Lists all the installed packages that make up the host
part of the SDK.
This variable also plays a minor role for extensible
SDK development as well.
However, it is mainly used for the standard SDK.
</para></listitem>
<listitem><para>
<ulink url='&YOCTO_DOCS_REF_URL;#var-SDK_TARGET_MANIFEST'><filename>SDK_TARGET_MANIFEST</filename></ulink>:
Lists all the installed packages that make up the
target part of the SDK.
This variable also plays a minor role for extensible
SDK development as well.
However, it is mainly used for the standard SDK.
</para></listitem>
</itemizedlist>
</para> </para>
</section> </section>
</section> </section>