summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual')
-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>.