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 |
