1
0
mirror of https://git.yoctoproject.org/poky synced 2026-06-01 13:09:50 +00:00

sdk-manual: Final edits to the extracting root filesystem section

Verified a good example and updated the text to match that example.

(From yocto-docs rev: 8655662b1f031463fafcf11fcd22243a75e817f8)

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-07-10 13:35:21 -07:00
committed by Richard Purdie
parent a3473f32a6
commit 008732dcb6
@@ -278,13 +278,14 @@
Root Filesystem Image File:</emphasis> Root Filesystem Image File:</emphasis>
You need to find and download the root filesystem image You need to find and download the root filesystem image
file that is appropriate for your target system. file that is appropriate for your target system.
These files are kept in the These files are kept in machine-specific folders in the
<ulink url='&YOCTO_DL_URL;/releases/yocto/yocto-&DISTRO;/machines/'>Index of Releases</ulink> <ulink url='&YOCTO_DL_URL;/releases/yocto/yocto-&DISTRO;/machines/'>Index of Releases</ulink>
in the "machines" directory.</para> in the "machines" directory.</para>
<para>The "machines" directory contains tarballs <para>The machine-specific folders of the "machines" directory
(<filename>*.tar.bz2</filename>) for supported machines. contain tarballs (<filename>*.tar.bz2</filename>) for supported
The directory also contains flattened root filesystem machines.
These directories also contain flattened root filesystem
image files (<filename>*.ext4</filename>), which you can use image files (<filename>*.ext4</filename>), which you can use
with QEMU directly.</para> with QEMU directly.</para>
@@ -298,14 +299,15 @@
Where: Where:
<replaceable>profile</replaceable> is the filesystem image's profile: <replaceable>profile</replaceable> is the filesystem image's profile:
lsb, lsb-dev, lsb-sdk, lsb-qt3, minimal, minimal-dev, sato, lsb, lsb-dev, lsb-sdk, minimal, minimal-dev, minimal-initramfs,
sato-dev, sato-sdk, minimal-initramfs, or sdk-ptest. For sato, sato-dev, sato-sdk, sato-sdk-ptest. For information on
information on these types of image profiles, see the these types of image profiles, see the "<ulink url='&YOCTO_DOCS_REF_URL;#ref-images'>Images</ulink>" chapter in
"Images" chapter in the Yocto Project Reference Manual. the Yocto Project Reference Manual.
<replaceable>arch</replaceable> is a string representing the target architecture: <replaceable>arch</replaceable> is a string representing the target architecture:
beaglebone, edgerouter, genericx86, genericx86-64, mpc8315e-rdb, beaglebone-yocto, beaglebone-yocto-lsb, edgerouter, edgerouter-lsb,
and several versions for qemu*. genericx86, genericx86-64, genericx86-64-lsb, genericx86-lsb,
mpc8315e-rdb, mpc8315e-rdb-lsb, and qemu*.
<!--> <!-->
<replaceable>date_time</replaceable> is a date and time stamp. <replaceable>date_time</replaceable> is a date and time stamp.
@@ -317,26 +319,28 @@
<filename>core-image-minimal</filename> images. <filename>core-image-minimal</filename> images.
</para> </para>
<para>For example, if your target hardware system is a <para>For example, if you plan on using a BeagleBone device
BeagleBone board and your image is a as your target hardware and your image is a
<filename>core-image-minimal</filename> image, you need <filename>core-image-sato-sdk</filename>
to download the following root filesystem image file: image, you can download the following file:
<literallayout class='monospaced'> <literallayout class='monospaced'>
core-image-minimal-beaglebone-yocto.tar.bz2 core-image-sato-sdk-beaglebone-yocto.tar.bz2
</literallayout> </literallayout>
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
<emphasis>Initialize the Cross-Development Environment:</emphasis> <emphasis>Initialize the Cross-Development Environment:</emphasis>
You must <filename>source</filename> You must <filename>source</filename> the cross-development
the cross-development environment setup script to establish environment setup script to establish necessary environment
necessary environment variables.</para> variables.</para>
<para>This script is located in the top-level directory in <para>This script is located in the top-level directory in
which you installed the toolchain (e.g. which you installed the toolchain (e.g.
<filename>poky_sdk</filename>).</para> <filename>poky_sdk</filename>).</para>
<para>Following is an example for the BeagleBone Board <para>Following is an example based on the toolchain installed
previously shown: in the
"<link linkend='sdk-locating-pre-built-sdk-installers'>Locating Pre-Built SDK Installers</link>"
section:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ source ~/poky_sdk/environment-setup-core2-64-poky-linux $ source ~/poky_sdk/environment-setup-core2-64-poky-linux
</literallayout> </literallayout>
@@ -353,10 +357,10 @@
This command extracts the root filesystem into the This command extracts the root filesystem into the
<filename>core2-64-sato</filename> directory: <filename>core2-64-sato</filename> directory:
<literallayout class='monospaced'> <literallayout class='monospaced'>
$ runqemu-extract-sdk ~/Downloads/core-image-sato-core2-64.tar.bz2 ~/core2-64-sato $ runqemu-extract-sdk ~/Downloads/core-image-sato-sdk-beaglebone-yocto.tar.bz2 ~/beaglebone-sato
</literallayout> </literallayout>
You could now point to the target sysroot at You could now point to the target sysroot at
<filename>core2-64-sato</filename>. <filename>beablebone-sato</filename>.
</para></listitem> </para></listitem>
</orderedlist> </orderedlist>
</para> </para>