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." |