diff --git a/documentation/poky-ref-manual/ref-images.xml b/documentation/poky-ref-manual/ref-images.xml
index 7bfca2af41..646e441c17 100644
--- a/documentation/poky-ref-manual/ref-images.xml
+++ b/documentation/poky-ref-manual/ref-images.xml
@@ -5,12 +5,9 @@
Reference: Images
- Poky has several standard images covering most people's standard needs.
- Use the following command to list the supported images:
-
- $ ls meta*/recipes*/images/*.bb
-
- 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 bitbake command you provide a “top-level” recipe
+ that essentially begins the build for the type of image you want.
@@ -25,66 +22,182 @@
+
+ From within the poky Git repository use the following command to list
+ the supported images:
+
+ $ ls meta*/recipes*/images/*.bb
+
+ These recipes reside in the meta/recipes-core/images,
+ meta/recipes-extended/images,
+ meta/recipes-graphics/images, and
+ meta/recipes-sato/images 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:
+
+
- core-image-minimal - A small image just capable
- of allowing a device to boot.
-
-
-
-
- core-image-base - A console-only image that fully
+ core-image-base - A console-only image that fully
supports the target device hardware.
- core-image-core - An X11 image with simple
+ core-image-core - An X11 image with simple
applications such as terminal, editor, and file manager.
- core-image-sato - An X11 image with Sato theme and
- Pimlico applications.
- The image also contains terminal, editor, and file manager.
+ core-image-minimal - A small image just capable
+ of allowing a device to boot.
- core-image-sato-dev - 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.
+ core-image-minimal-dev – A
+ core-image-minimal image suitable for
+ development work.
- core-image-lsb - An image suitable for implementations
+ core-image-minimal-directdisk – A
+ core-image-minimal image that you can
+ copy directly to the disk of the target device.
+
+
+
+
+ core-image-minimal-initramfs –
+ A core-image-minimal image that has the Minimal RAM-based
+ Initial Root Filesystem (initramfs) as part of the kernel,
+ which allows the system to find the first “init” program more efficiently.
+
+
+
+
+ core-image-minimal-live – A
+ core-image-minimal image you can run from a
+ USB device or CD as is.
+
+
+
+
+ core-image-minimal-mtdutils – A
+ core-image-minimal 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.
+
+
+
+
+ core-image-basic – A foundational
+ basic image without support
+ for X that can be reasonably used for customization.
+
+
+
+
+ core-image-lsb - A
+ core-image-basic image suitable for implementations
that conform to Linux Standard Base (LSB).
- meta-toolchain - 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
- /opt/poky directory.
- The tarball also contains a copy of QEMU and the scripts necessary to run
- poky QEMU images.
+ core-image-lsb-dev - A
+ core-image-lsb image that is suitable for development work.
- meta-toolchain-sdk - This image includes everything in
- meta-toolchain but also includes development headers and libraries
- to form a complete standalone SDK.
+ core-image-lsb-live - A
+ core-image-lsb image that you run from a USB device or CD as is.
+
+
+
+
+ core-image-lsb-sdk - A
+ core-image-lsb that includes everything in meta-toolchain
+ but also includes development
+ headers and libraries to form a complete standalone SDK.
See the
External Development Using the Poky SDK section for more information.
+
+
+ core-image-lsb-sdk-live - A
+ core-image-lsb-sdk image with the ability to run the image
+ from a USB device or CD as is.
+
+
+
+
+ core-image-clutter - An image with
+ support for
+ the Open GL-based toolkit Clutter, which enables development of rich and animated
+ graphical user interaces.
+
+
+
+
+ core-image-sato - 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.
+
+
+
+
+ core-image-sato-dev - A
+ core-image-sato 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 core-image-sdk.
+
+
+
+
+ core-image-sato-directdisk - A
+ core-image-sato image that can be copied directly to the
+ disk of the target device.
+
+
+
+
+ core-image-sato-live - A
+ core-image-sato image with the ability to run
+ from a USB device or CD as is.
+
+
+
+
+ core-image-sato-sdk - A
+ core-image-sato image that includes everything in meta-toolchain.
+ The image also includes development headers and libraries to form a complete standalone SDK.
+ See the
+ External Development Using the Poky SDK section for more information..
+
+
+
+
+ core-image-sato-sdk-directdisk - A
+ core-image-sato-sdk image that can be copied directly to the
+ disk of the target device.
+
+
+
+
+ core-image-sato-sdk-live - A
+ core-image-sato-sdk image that you can run
+ from a USB device or CD as is.
+
+