diff options
| author | Scott Rifenbark <srifenbark@gmail.com> | 2018-10-30 11:41:37 -0700 |
|---|---|---|
| committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2018-11-22 12:20:51 +0000 |
| commit | 01c64b6aa1883419cf0987771136c03fc0e35957 (patch) | |
| tree | 41dd086ba435f70d4c9899b2a516681e5ca47d0b | |
| parent | b131879f0c8d536f7c7cb4d22d0297465442705b (diff) | |
| download | poky-01c64b6aa1883419cf0987771136c03fc0e35957.tar.gz | |
ref-manual, dev-manual: Removed TEST_IMAGE for TESTIMAGE_AUTO.
The TEST_IMAGE variable went away and was replaced with the
TESTIMAGE_AUTO variable. Fixed all related/affected areas.
(From yocto-docs rev: 660da40b4fcdc05666e1877037fa63eb1dfe7227)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
| -rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 7 | ||||
| -rw-r--r-- | documentation/ref-manual/ref-classes.xml | 2 | ||||
| -rw-r--r-- | documentation/ref-manual/ref-tasks.xml | 2 | ||||
| -rw-r--r-- | documentation/ref-manual/ref-variables.xml | 76 |
4 files changed, 46 insertions, 41 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 25f0fab1ac..cee1d40ab4 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
| @@ -11798,16 +11798,15 @@ | |||
| 11798 | To run the tests automatically after the | 11798 | To run the tests automatically after the |
| 11799 | OpenEmbedded build system successfully creates an image, | 11799 | OpenEmbedded build system successfully creates an image, |
| 11800 | first set the | 11800 | first set the |
| 11801 | <ulink url='&YOCTO_DOCS_REF_URL;#var-TEST_IMAGE'><filename>TEST_IMAGE</filename></ulink> | 11801 | <ulink url='&YOCTO_DOCS_REF_URL;#var-TESTIMAGE_AUTO'><filename>TESTIMAGE_AUTO</filename></ulink> |
| 11802 | variable to "1" in your <filename>local.conf</filename> | 11802 | variable to "1" in your <filename>local.conf</filename> |
| 11803 | file in the | 11803 | file in the |
| 11804 | <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>: | 11804 | <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>: |
| 11805 | <literallayout class='monospaced'> | 11805 | <literallayout class='monospaced'> |
| 11806 | TEST_IMAGE = "1" | 11806 | TESTIMAGE_AUTO = "1" |
| 11807 | </literallayout> | 11807 | </literallayout> |
| 11808 | Next, build your image. | 11808 | Next, build your image. |
| 11809 | If the image successfully builds, the tests will be | 11809 | If the image successfully builds, the tests run: |
| 11810 | run: | ||
| 11811 | <literallayout class='monospaced'> | 11810 | <literallayout class='monospaced'> |
| 11812 | bitbake core-image-sato | 11811 | bitbake core-image-sato |
| 11813 | </literallayout></para></listitem> | 11812 | </literallayout></para></listitem> |
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index 24d7a0a99e..d2f5c3ebc1 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml | |||
| @@ -3519,7 +3519,7 @@ This check was removed for YP 2.3 release | |||
| 3519 | </literallayout> | 3519 | </literallayout> |
| 3520 | The <filename>testimage-auto</filename> class runs tests on an image | 3520 | The <filename>testimage-auto</filename> class runs tests on an image |
| 3521 | after the image is constructed (i.e. | 3521 | after the image is constructed (i.e. |
| 3522 | <link linkend='var-TEST_IMAGE'><filename>TEST_IMAGE</filename></link> | 3522 | <link linkend='var-TESTIMAGE_AUTO'><filename>TESTIMAGE_AUTO</filename></link> |
| 3523 | must be set to "1"). | 3523 | must be set to "1"). |
| 3524 | </para> | 3524 | </para> |
| 3525 | 3525 | ||
diff --git a/documentation/ref-manual/ref-tasks.xml b/documentation/ref-manual/ref-tasks.xml index ccd0f85cfd..8f3ff26d24 100644 --- a/documentation/ref-manual/ref-tasks.xml +++ b/documentation/ref-manual/ref-tasks.xml | |||
| @@ -886,7 +886,7 @@ | |||
| 886 | Boots an image and performs runtime tests within the image | 886 | Boots an image and performs runtime tests within the image |
| 887 | immediately after it has been built. | 887 | immediately after it has been built. |
| 888 | This task is enabled when you set | 888 | This task is enabled when you set |
| 889 | <link linkend='var-TEST_IMAGE'><filename>TEST_IMAGE</filename></link> | 889 | <link linkend='var-TESTIMAGE_AUTO'><filename>TESTIMAGE_AUTO</filename></link> |
| 890 | equal to "1". | 890 | equal to "1". |
| 891 | </para> | 891 | </para> |
| 892 | 892 | ||
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 595f2db8b0..c3e36c90cf 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml | |||
| @@ -15195,41 +15195,6 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
| 15195 | </glossdef> | 15195 | </glossdef> |
| 15196 | </glossentry> | 15196 | </glossentry> |
| 15197 | 15197 | ||
| 15198 | <glossentry id='var-TEST_IMAGE'><glossterm>TEST_IMAGE</glossterm> | ||
| 15199 | <info> | ||
| 15200 | TEST_IMAGE[doc] = "Enables test booting of virtual machine images under the QEMU emulator after any root filesystems are created and runs tests against those images." | ||
| 15201 | </info> | ||
| 15202 | <glossdef> | ||
| 15203 | <para role="glossdeffirst"> | ||
| 15204 | <!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> | ||
| 15205 | Automatically runs the series of automated tests for | ||
| 15206 | images when an image is successfully built. | ||
| 15207 | </para> | ||
| 15208 | |||
| 15209 | <para> | ||
| 15210 | These tests are written in Python making use of the | ||
| 15211 | <filename>unittest</filename> module, and the majority of | ||
| 15212 | them run commands on the target system over | ||
| 15213 | <filename>ssh</filename>. | ||
| 15214 | You can set this variable to "1" in your | ||
| 15215 | <filename>local.conf</filename> file in the | ||
| 15216 | <link linkend='build-directory'>Build Directory</link> | ||
| 15217 | to have the OpenEmbedded build system automatically run | ||
| 15218 | these tests after an image successfully builds: | ||
| 15219 | <literallayout class='monospaced'> | ||
| 15220 | TEST_IMAGE = "1" | ||
| 15221 | </literallayout> | ||
| 15222 | For more information on enabling, running, and writing | ||
| 15223 | these tests, see the | ||
| 15224 | "<ulink url='&YOCTO_DOCS_DEV_URL;#performing-automated-runtime-testing'>Performing Automated Runtime Testing</ulink>" | ||
| 15225 | section in the Yocto Project Development Tasks Manual and | ||
| 15226 | the | ||
| 15227 | "<link linkend='ref-classes-testimage*'><filename>testimage*.bbclass</filename></link>" | ||
| 15228 | section. | ||
| 15229 | </para> | ||
| 15230 | </glossdef> | ||
| 15231 | </glossentry> | ||
| 15232 | |||
| 15233 | <glossentry id='var-TEST_LOG_DIR'><glossterm>TEST_LOG_DIR</glossterm> | 15198 | <glossentry id='var-TEST_LOG_DIR'><glossterm>TEST_LOG_DIR</glossterm> |
| 15234 | <info> | 15199 | <info> |
| 15235 | TEST_LOG_DIR[doc] = "Holds the SSH log and the boot log for QEMU machines. The TEST_LOG_DIR variable defaults to "${WORKDIR}/testimage"." | 15200 | TEST_LOG_DIR[doc] = "Holds the SSH log and the boot log for QEMU machines. The TEST_LOG_DIR variable defaults to "${WORKDIR}/testimage"." |
| @@ -15530,6 +15495,47 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
| 15530 | </glossdef> | 15495 | </glossdef> |
| 15531 | </glossentry> | 15496 | </glossentry> |
| 15532 | 15497 | ||
| 15498 | <glossentry id='var-TESTIMAGE_AUTO'><glossterm>TESTIMAGE_AUTO</glossterm> | ||
| 15499 | <info> | ||
| 15500 | TESTIMAGE_AUTO[doc] = "Enables automatic testing of an image once it is built." | ||
| 15501 | </info> | ||
| 15502 | <glossdef> | ||
| 15503 | <para role="glossdeffirst"> | ||
| 15504 | <!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> | ||
| 15505 | Automatically runs the series of automated tests for | ||
| 15506 | images when an image is successfully built. | ||
| 15507 | Setting <filename>TESTIMAGE_AUTO</filename> to "1" | ||
| 15508 | causes any image that successfully builds to automatically | ||
| 15509 | boot under QEMU. | ||
| 15510 | Using the variable also adds in dependencies so that any | ||
| 15511 | SDK for which testing is requested is automatically built | ||
| 15512 | first. | ||
| 15513 | </para> | ||
| 15514 | |||
| 15515 | <para> | ||
| 15516 | These tests are written in Python making use of the | ||
| 15517 | <filename>unittest</filename> module, and the majority of | ||
| 15518 | them run commands on the target system over | ||
| 15519 | <filename>ssh</filename>. | ||
| 15520 | You can set this variable to "1" in your | ||
| 15521 | <filename>local.conf</filename> file in the | ||
| 15522 | <link linkend='build-directory'>Build Directory</link> | ||
| 15523 | to have the OpenEmbedded build system automatically run | ||
| 15524 | these tests after an image successfully builds: | ||
| 15525 | <literallayout class='monospaced'> | ||
| 15526 | TESTIMAGE_AUTO = "1" | ||
| 15527 | </literallayout> | ||
| 15528 | For more information on enabling, running, and writing | ||
| 15529 | these tests, see the | ||
| 15530 | "<ulink url='&YOCTO_DOCS_DEV_URL;#performing-automated-runtime-testing'>Performing Automated Runtime Testing</ulink>" | ||
| 15531 | section in the Yocto Project Development Tasks Manual and | ||
| 15532 | the | ||
| 15533 | "<link linkend='ref-classes-testimage*'><filename>testimage*.bbclass</filename></link>" | ||
| 15534 | section. | ||
| 15535 | </para> | ||
| 15536 | </glossdef> | ||
| 15537 | </glossentry> | ||
| 15538 | |||
| 15533 | <glossentry id='var-THISDIR'><glossterm>THISDIR</glossterm> | 15539 | <glossentry id='var-THISDIR'><glossterm>THISDIR</glossterm> |
| 15534 | <info> | 15540 | <info> |
| 15535 | THISDIR[doc] = "The directory in which the file BitBake is currently parsing is located." | 15541 | THISDIR[doc] = "The directory in which the file BitBake is currently parsing is located." |
