diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2017-07-18 10:44:37 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2017-07-22 09:19:25 +0100 |
commit | 15901164ee71dec0906dadaff08f3365a66feb05 (patch) | |
tree | a5604781e057606afd6d7b0451826a0118d965b1 /documentation/dev-manual | |
parent | 2217d97ba9f48ded4f229981ed4ad7e846b87db0 (diff) | |
download | poky-15901164ee71dec0906dadaff08f3365a66feb05.tar.gz |
dev-manual, ref-manual: Eliminated pre-built section
Fixes [YOCTO #11630]
I took the section that described how to use a pre-built kernel
and run it through QEMU out. This is basically a QEMU usage
section and is not in that area. There were some QEMU speed
up items suitable for the QEMU concepts section in the ref-manual.
I put those in that area.
(From yocto-docs rev: b081013aa10b42e4eb88ed54940112c5ae106911)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r-- | documentation/dev-manual/dev-manual-start.xml | 59 |
1 files changed, 2 insertions, 57 deletions
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml index 0835650bd3..e70d79e424 100644 --- a/documentation/dev-manual/dev-manual-start.xml +++ b/documentation/dev-manual/dev-manual-start.xml | |||
@@ -858,6 +858,7 @@ | |||
858 | </para> | 858 | </para> |
859 | </section> | 859 | </section> |
860 | 860 | ||
861 | <!-- | ||
861 | <section id='using-pre-built-binaries-and-qemu'> | 862 | <section id='using-pre-built-binaries-and-qemu'> |
862 | <title>Using Pre-Built Binaries and QEMU</title> | 863 | <title>Using Pre-Built Binaries and QEMU</title> |
863 | 864 | ||
@@ -906,64 +907,8 @@ | |||
906 | "<link linkend='dev-manual-qemu'>Using the Quick EMUlator (QEMU)</link>" | 907 | "<link linkend='dev-manual-qemu'>Using the Quick EMUlator (QEMU)</link>" |
907 | section. | 908 | section. |
908 | </para> | 909 | </para> |
909 | |||
910 | <para> | ||
911 | Using QEMU to emulate your hardware can result in speed issues | ||
912 | depending on the target and host architecture mix. | ||
913 | For example, using the <filename>qemux86</filename> image in the emulator | ||
914 | on an Intel-based 32-bit (x86) host machine is fast because the target and | ||
915 | host architectures match. | ||
916 | On the other hand, using the <filename>qemuarm</filename> image on the same Intel-based | ||
917 | host can be slower. | ||
918 | But, you still achieve faithful emulation of ARM-specific issues. | ||
919 | </para> | ||
920 | |||
921 | <para> | ||
922 | To speed things up, the QEMU images support using <filename>distcc</filename> | ||
923 | to call a cross-compiler outside the emulated system. | ||
924 | If you used <filename>runqemu</filename> to start QEMU, and the | ||
925 | <filename>distccd</filename> application is present on the host system, any | ||
926 | BitBake cross-compiling toolchain available from the build system is automatically | ||
927 | used from within QEMU simply by calling <filename>distcc</filename>. | ||
928 | You can accomplish this by defining the cross-compiler variable | ||
929 | (e.g. <filename>export CC="distcc"</filename>). | ||
930 | Alternatively, if you are using a suitable SDK image or the appropriate | ||
931 | stand-alone toolchain is present, | ||
932 | the toolchain is also automatically used. | ||
933 | </para> | ||
934 | |||
935 | <note> | ||
936 | Several mechanisms exist that let you connect to the system running on the | ||
937 | QEMU emulator: | ||
938 | <itemizedlist> | ||
939 | <listitem><para>QEMU provides a framebuffer interface that makes standard | ||
940 | consoles available.</para></listitem> | ||
941 | <listitem><para>Generally, headless embedded devices have a serial port. | ||
942 | If so, you can configure the operating system of the running image | ||
943 | to use that port to run a console. | ||
944 | The connection uses standard IP networking.</para></listitem> | ||
945 | <listitem><para> | ||
946 | SSH servers exist in some QEMU images. | ||
947 | The <filename>core-image-sato</filename> QEMU image has a | ||
948 | Dropbear secure shell (SSH) server that runs with the root | ||
949 | password disabled. | ||
950 | The <filename>core-image-full-cmdline</filename> and | ||
951 | <filename>core-image-lsb</filename> QEMU images | ||
952 | have OpenSSH instead of Dropbear. | ||
953 | Including these SSH servers allow you to use standard | ||
954 | <filename>ssh</filename> and <filename>scp</filename> commands. | ||
955 | The <filename>core-image-minimal</filename> QEMU image, | ||
956 | however, contains no SSH server. | ||
957 | </para></listitem> | ||
958 | <listitem><para>You can use a provided, user-space NFS server to boot the QEMU session | ||
959 | using a local copy of the root filesystem on the host. | ||
960 | In order to make this connection, you must extract a root filesystem tarball by using the | ||
961 | <filename>runqemu-extract-sdk</filename> command. | ||
962 | After running the command, you must then point the <filename>runqemu</filename> | ||
963 | script to the extracted directory instead of a root filesystem image file.</para></listitem> | ||
964 | </itemizedlist> | ||
965 | </note> | ||
966 | </section> | 910 | </section> |
911 | --> | ||
967 | </chapter> | 912 | </chapter> |
968 | <!-- | 913 | <!-- |
969 | vim: expandtab tw=80 ts=4 | 914 | vim: expandtab tw=80 ts=4 |