adt-manual: Edits to "Extracting the Root Filesystem" section
This section was a bit confusing. I added some lists to make it clearer when this step is necessary. I also added some more detail on where to find the setup script. (From yocto-docs rev: 231e1f44da61d4a2fdb5ddb20bce89dfddccf092) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
dc3e39efbd
commit
baa03f300e
|
@ -516,31 +516,62 @@
|
||||||
<title>Extracting the Root Filesystem</title>
|
<title>Extracting the Root Filesystem</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
You must extract the root filesystem if you want to boot the image using NFS
|
If you install your toolchain by hand or build it using BitBake and
|
||||||
or you want to use the root filesystem as the target sysroot.
|
you need a root filesystem, you need to extract it separately.
|
||||||
For example, the Eclipse IDE environment with the Eclipse Yocto Plug-in installed allows you
|
If you use the ADT Installer to install the ADT, the root
|
||||||
to use QEMU to boot under NFS.
|
filesystem is automatically extracted and installed.
|
||||||
Another example is if you want to develop your target application using the
|
</para>
|
||||||
root filesystem as the target sysroot.
|
|
||||||
|
<para>
|
||||||
|
Here are some cases where you need to extract the root filesystem:
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem><para>You want to boot the image using NFS.
|
||||||
|
</para></listitem>
|
||||||
|
<listitem><para>You want to use the root filesystem as the
|
||||||
|
target sysroot.
|
||||||
|
For example, the Eclipse IDE environment with the Eclipse
|
||||||
|
Yocto Plug-in installed allows you to use QEMU to boot
|
||||||
|
under NFS.</para></listitem>
|
||||||
|
<listitem><para>You want to develop your target application
|
||||||
|
using the root filesystem as the target sysroot.
|
||||||
|
</para></listitem>
|
||||||
|
</itemizedlist>
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
To extract the root filesystem, first <filename>source</filename>
|
To extract the root filesystem, first <filename>source</filename>
|
||||||
the cross-development environment setup script and then
|
the cross-development environment setup script.
|
||||||
use the <filename>runqemu-extract-sdk</filename> command on the
|
If you built the toolchain in the Build Directory, you will find
|
||||||
|
the toolchain environment script in the
|
||||||
|
<filename>tmp</filename> directory.
|
||||||
|
If you installed the toolchain by hand, the environment setup
|
||||||
|
script is located in <filename>opt/poky/&DISTRO;</filename>.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
After sourcing the environment script, use the
|
||||||
|
<filename>runqemu-extract-sdk</filename> command and provide the
|
||||||
filesystem image.
|
filesystem image.
|
||||||
For example, the following commands set up the environment and then extract
|
</para>
|
||||||
the root filesystem from a previously built filesystem image tarball named
|
|
||||||
<filename>core-image-sato-sdk-qemux86-2011091411831.rootfs.tar.bz2</filename>.
|
<para>
|
||||||
The example extracts the root filesystem into the <filename>$HOME/qemux86-sato</filename>
|
Following is an example.
|
||||||
directory:
|
The second command sets up the environment.
|
||||||
|
In this case, the setup script is located in the
|
||||||
|
<filename>/opt/poky/&DISTRO;</filename> directory.
|
||||||
|
The third command extracts the root filesystem from a previously
|
||||||
|
built filesystem that is located in the
|
||||||
|
<filename>~/Downloads</filename> directory.
|
||||||
|
Furthermore, this command extracts the root filesystem into the
|
||||||
|
<filename>$HOME/qemux86-sato</filename> directory:
|
||||||
<literallayout class='monospaced'>
|
<literallayout class='monospaced'>
|
||||||
$ source $HOME/toolchain_dir/environment-setup-i586-poky-linux
|
$ cd ~
|
||||||
|
$ source /opt/poky/&DISTRO;/environment-setup-i586-poky-linux
|
||||||
$ runqemu-extract-sdk \
|
$ runqemu-extract-sdk \
|
||||||
~Downloads/core-image-sato-sdk-qemux86-2011091411831.rootfs.tar.bz2 \
|
~Downloads/core-image-sato-sdk-qemux86-2011091411831.rootfs.tar.bz2 \
|
||||||
$HOME/qemux86-sato
|
$HOME/qemux86-sato
|
||||||
</literallayout>
|
</literallayout>
|
||||||
In this case, you could now point to the target sysroot at
|
You could now point to the target sysroot at
|
||||||
<filename>$HOME/qemux86-sato</filename>.
|
<filename>$HOME/qemux86-sato</filename>.
|
||||||
</para>
|
</para>
|
||||||
</section>
|
</section>
|
||||||
|
|
Loading…
Reference in New Issue