diff options
Diffstat (limited to 'documentation')
| -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>. |