documentation/poky-ref-manual/ref-images.xml: Updated the list of images.

The list of images has grown.  I added all images reported in the
1.1_M2 build using the 'ls meta*/recipes*/images/*.bb' command.

(From yocto-docs rev: 62e12a71c73a5e3a20c6887d754a96eb9e754b48)

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 2011-08-02 09:22:56 -07:00 committed by Richard Purdie
parent 898e161009
commit 52435ce880
1 changed files with 145 additions and 32 deletions

View File

@ -5,12 +5,9 @@
<title>Reference: Images</title>
<para>
Poky has several standard images covering most people's standard needs.
Use the following command to list the supported images:
<literallayout class='monospaced'>
$ ls meta*/recipes*/images/*.bb
</literallayout>
Images are listed below along with details of what they contain:
The Yocto Project build process supports several types of images to satisfy different needs.
When you issue the <filename>bitbake</filename> command you provide a “top-level” recipe
that essentially begins the build for the type of image you want.
</para>
<note>
@ -25,66 +22,182 @@
</literallayout>
</note>
<para>
From within the <filename>poky</filename> Git repository use the following command to list
the supported images:
<literallayout class='monospaced'>
$ ls meta*/recipes*/images/*.bb
</literallayout>
These recipes reside in the <filename>meta/recipes-core/images</filename>,
<filename>meta/recipes-extended/images</filename>,
<filename>meta/recipes-graphics/images</filename>, and
<filename>meta/recipes-sato/images</filename> directories of your local Yocto Project
file structure (Git repository or extracted release tarball).
Although the recipe names are somewhat explanatory, here is a list that describes them:
</para>
<itemizedlist>
<listitem>
<para>
<emphasis>core-image-minimal</emphasis> - A small image just capable
of allowing a device to boot.
</para>
</listitem>
<listitem>
<para>
<emphasis>core-image-base</emphasis> - A console-only image that fully
<emphasis><filename>core-image-base</filename></emphasis> - A console-only image that fully
supports the target device hardware.
</para>
</listitem>
<listitem>
<para>
<emphasis>core-image-core</emphasis> - An X11 image with simple
<emphasis><filename>core-image-core</filename></emphasis> - An X11 image with simple
applications such as terminal, editor, and file manager.
</para>
</listitem>
<listitem>
<para>
<emphasis>core-image-sato</emphasis> - An X11 image with Sato theme and
Pimlico applications.
The image also contains terminal, editor, and file manager.
<emphasis><filename>core-image-minimal</filename></emphasis> - A small image just capable
of allowing a device to boot.
</para>
</listitem>
<listitem>
<para>
<emphasis>core-image-sato-dev</emphasis> - An X11 image similar to
core-image-sato but
also includes a native toolchain and libraries needed to build applications
on the device itself. The image also includes testing and profiling tools
as well as debug symbols. This image was formerly core-image-sdk.
<emphasis><filename>core-image-minimal-dev</filename></emphasis> A
<filename>core-image-minimal</filename> image suitable for
development work.
</para>
</listitem>
<listitem>
<para>
<emphasis>core-image-lsb</emphasis> - An image suitable for implementations
<emphasis><filename>core-image-minimal-directdisk</filename></emphasis> A
<filename>core-image-minimal</filename> image that you can
copy directly to the disk of the target device.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-minimal-initramfs</filename></emphasis>
A <filename>core-image-minimal</filename> image that has the Minimal RAM-based
Initial Root Filesystem (<filename>initramfs</filename>) as part of the kernel,
which allows the system to find the first “init” program more efficiently.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-minimal-live</filename></emphasis> A
<filename>core-image-minimal</filename> image you can run from a
USB device or CD as is.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-minimal-mtdutils</filename></emphasis> A
<filename>core-image-minimal</filename> image that has support
for the Minimal MTD Utilities, which let the user interact with the
MTD subsystem in the kernel to perform operations on flash devices.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-basic</filename></emphasis> A foundational
basic image without support
for X that can be reasonably used for customization.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-lsb</filename></emphasis> - A
<filename>core-image-basic</filename> image suitable for implementations
that conform to Linux Standard Base (LSB).
</para>
</listitem>
<listitem>
<para>
<emphasis>meta-toolchain</emphasis> - This image generates a tarball
that contains a stand-alone toolchain that can be used externally to Poky.
The tarball is self-contained and unpacks to the
<filename class="directory">/opt/poky</filename> directory.
The tarball also contains a copy of QEMU and the scripts necessary to run
poky QEMU images.
<emphasis><filename>core-image-lsb-dev</filename></emphasis> - A
<filename>core-image-lsb</filename> image that is suitable for development work.
</para>
</listitem>
<listitem>
<para>
<emphasis>meta-toolchain-sdk</emphasis> - This image includes everything in
meta-toolchain but also includes development headers and libraries
to form a complete standalone SDK.
<emphasis><filename>core-image-lsb-live</filename></emphasis> - A
<filename>core-image-lsb</filename> image that you run from a USB device or CD as is.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-lsb-sdk</filename></emphasis> - A
<filename>core-image-lsb</filename> that includes everything in meta-toolchain
but also includes development
headers and libraries to form a complete standalone SDK.
See the <link linkend='platdev-appdev-external-sdk'>
External Development Using the Poky SDK</link> section for more information.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-lsb-sdk-live</filename></emphasis> - A
<filename>core-image-lsb-sdk</filename> image with the ability to run the image
from a USB device or CD as is.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-clutter</filename></emphasis> - An image with
support for
the Open GL-based toolkit Clutter, which enables development of rich and animated
graphical user interaces.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-sato</filename></emphasis> - An image with Sato support,
a mobile environment and visual style that works well with mobile devices.
The image supports X11 with a Sato theme and Pimlico applications and also
contains terminal, editor, and file manager.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-sato-dev</filename></emphasis> - A
<filename>core-image-sato</filename> image suitable for development
that also includes a native toolchain and libraries needed to build applications on
the device itself.
The image also includes testing and profiling tools as well as debug symbols.
This image was formerly <filename>core-image-sdk</filename>.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-sato-directdisk</filename></emphasis> - A
<filename>core-image-sato</filename> image that can be copied directly to the
disk of the target device.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-sato-live</filename></emphasis> - A
<filename>core-image-sato</filename> image with the ability to run
from a USB device or CD as is.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-sato-sdk</filename></emphasis> - A
<filename>core-image-sato</filename> image that includes everything in meta-toolchain.
The image also includes development headers and libraries to form a complete standalone SDK.
See the <link linkend='platdev-appdev-external-sdk'>
External Development Using the Poky SDK</link> section for more information..
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-sato-sdk-directdisk</filename></emphasis> - A
<filename>core-image-sato-sdk</filename> image that can be copied directly to the
disk of the target device.
</para>
</listitem>
<listitem>
<para>
<emphasis><filename>core-image-sato-sdk-live</filename></emphasis> - A
<filename>core-image-sato-sdk</filename> image that you can run
from a USB device or CD as is.
</para>
</listitem>
</itemizedlist>
</appendix>
<!--