summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-04-08 10:45:49 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-04-11 18:22:48 +0100
commitcc80d0514198a118fe066672e68382138b067e76 (patch)
tree5b7a7c56a3f74c0d3da9fefea389db0a3b831a2d
parent7406f9312166b94dea253e2aaf1c6e3b97e8c80d (diff)
downloadpoky-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.xml71
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>.