diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-04-08 10:45:49 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-04-11 18:22:48 +0100 |
commit | cc80d0514198a118fe066672e68382138b067e76 (patch) | |
tree | 5b7a7c56a3f74c0d3da9fefea389db0a3b831a2d | |
parent | 7406f9312166b94dea253e2aaf1c6e3b97e8c80d (diff) | |
download | poky-cc80d0514198a118fe066672e68382138b067e76.tar.gz |
dev-manual: Moved list of qemu-specific run information
Fixes [YOCTO #5554]
The list of items that described what happens when you run
tests is really specific to qemu. Consequently, it is better
located in the section describing how to enable and get
set up for those tests.
(From yocto-docs rev: 1f0606f1c5c03c873a295819adcfb6fb51c196bd)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 71 |
1 files changed, 35 insertions, 36 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index dc61170fbf..b0cdc8342e 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
@@ -5712,6 +5712,41 @@ | |||
5712 | by <filename>runqemu</filename>.</para></listitem> | 5712 | by <filename>runqemu</filename>.</para></listitem> |
5713 | </itemizedlist> | 5713 | </itemizedlist> |
5714 | </para> | 5714 | </para> |
5715 | |||
5716 | <para> | ||
5717 | Once you start running the tests, the following happens: | ||
5718 | <itemizedlist> | ||
5719 | <listitem><para>A copy of the root filesystem is written | ||
5720 | to <filename>${WORKDIR}/testimage</filename>. | ||
5721 | </para></listitem> | ||
5722 | <listitem><para>The image is booted under QEMU using the | ||
5723 | standard <filename>runqemu</filename> script. | ||
5724 | </para></listitem> | ||
5725 | <listitem><para>A default timeout of 500 seconds occurs | ||
5726 | to allow for the boot process to reach the login prompt. | ||
5727 | You can change the timeout period by setting | ||
5728 | <ulink url='&YOCTO_DOCS_REF_URL;#var-TEST_QEMUBOOT_TIMEOUT'><filename>TEST_QEMUBOOT_TIMEOUT</filename></ulink> | ||
5729 | in the <filename>local.conf</filename> file. | ||
5730 | </para></listitem> | ||
5731 | <listitem><para>Once the boot process is reached and the | ||
5732 | login prompt appears, the tests run. | ||
5733 | The full boot log is written to | ||
5734 | <filename>${WORKDIR}/testimage/qemu_boot_log</filename>. | ||
5735 | </para></listitem> | ||
5736 | <listitem><para>Each test module loads in the order found | ||
5737 | in <filename>TEST_SUITES</filename>. | ||
5738 | You can find the full output of the commands run over | ||
5739 | SSH in | ||
5740 | <filename>${WORKDIR}/testimgage/ssh_target_log</filename>. | ||
5741 | </para></listitem> | ||
5742 | <listitem><para>If no failures occur, the task running the | ||
5743 | tests ends successfully. | ||
5744 | You can find the output from the | ||
5745 | <filename>unittest</filename> in the task log at | ||
5746 | <filename>${WORKDIR}/temp/log.do_testimage</filename>. | ||
5747 | </para></listitem> | ||
5748 | </itemizedlist> | ||
5749 | </para> | ||
5715 | </section> | 5750 | </section> |
5716 | 5751 | ||
5717 | <section id='hardware-image-enabling-tests'> | 5752 | <section id='hardware-image-enabling-tests'> |
@@ -5796,42 +5831,6 @@ | |||
5796 | </para> | 5831 | </para> |
5797 | 5832 | ||
5798 | <para> | 5833 | <para> |
5799 | Regardless of how you run the tests, once they start, the | ||
5800 | following happens: | ||
5801 | <itemizedlist> | ||
5802 | <listitem><para>A copy of the root filesystem is written | ||
5803 | to <filename>${WORKDIR}/testimage</filename>. | ||
5804 | </para></listitem> | ||
5805 | <listitem><para>The image is booted under QEMU using the | ||
5806 | standard <filename>runqemu</filename> script. | ||
5807 | </para></listitem> | ||
5808 | <listitem><para>A default timeout of 500 seconds occurs | ||
5809 | to allow for the boot process to reach the login prompt. | ||
5810 | You can change the timeout period by setting | ||
5811 | <ulink url='&YOCTO_DOCS_REF_URL;#var-TEST_QEMUBOOT_TIMEOUT'><filename>TEST_QEMUBOOT_TIMEOUT</filename></ulink> | ||
5812 | in the <filename>local.conf</filename> file. | ||
5813 | </para></listitem> | ||
5814 | <listitem><para>Once the boot process is reached and the | ||
5815 | login prompt appears, the tests run. | ||
5816 | The full boot log is written to | ||
5817 | <filename>${WORKDIR}/testimage/qemu_boot_log</filename>. | ||
5818 | </para></listitem> | ||
5819 | <listitem><para>Each test module loads in the order found | ||
5820 | in <filename>TEST_SUITES</filename>. | ||
5821 | You can find the full output of the commands run over | ||
5822 | SSH in | ||
5823 | <filename>${WORKDIR}/testimgage/ssh_target_log</filename>. | ||
5824 | </para></listitem> | ||
5825 | <listitem><para>If no failures occur, the task running the | ||
5826 | tests ends successfully. | ||
5827 | You can find the output from the | ||
5828 | <filename>unittest</filename> in the task log at | ||
5829 | <filename>${WORKDIR}/temp/log.do_testimage</filename>. | ||
5830 | </para></listitem> | ||
5831 | </itemizedlist> | ||
5832 | </para> | ||
5833 | |||
5834 | <para> | ||
5835 | All test files reside in | 5834 | All test files reside in |
5836 | <filename>meta/lib/oeqa/runtime</filename> in the | 5835 | <filename>meta/lib/oeqa/runtime</filename> in the |
5837 | <link linkend='source-directory'>Source Directory</link>. | 5836 | <link linkend='source-directory'>Source Directory</link>. |