summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2014-04-08 12:49:49 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-04-11 18:22:49 +0100
commit4db4dff89fcabd3239eb846fa6c157238753bf5c (patch)
tree8201d2b7bb773e044ce787cf14bd868cd8437259 /documentation/ref-manual
parentf0e3476705408dd4c465ae09bf886afdb0a97734 (diff)
downloadpoky-4db4dff89fcabd3239eb846fa6c157238753bf5c.tar.gz
ref-manual: Added TEST_TARGET variable description.
Fixes [YOCTO #5554] New description. (From yocto-docs rev: b81e056f8ef1a7ba0868857be71d46250382ffa3) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r--documentation/ref-manual/ref-variables.xml65
1 files changed, 65 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 03d2034dba..b41d08d21a 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7484,6 +7484,71 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7484 </glossdef> 7484 </glossdef>
7485 </glossentry> 7485 </glossentry>
7486 7486
7487 <glossentry id='var-TEST_TARGET'><glossterm>TEST_TARGET</glossterm>
7488 <glossdef>
7489 <para>
7490 Specifies the target controller to use when running tests
7491 against a test image.
7492 The default controller to use is "qemu":
7493 <literallayout class='monospaced'>
7494 TEST_TARGET = "qemu"
7495 </literallayout>
7496 A target controller is a class that defines how an
7497 image gets deployed on a target and how a target is started.
7498 A layer can extend the controllers by adding a module
7499 in the layer's <filename>/lib/oeqa/controllers</filename>
7500 directory and by inheriting the
7501 <filename>BaseTarget</filename> class, which is an abstract
7502 class that cannot be used as a value of
7503 <filename>TEST_TARGET</filename>.
7504 </para>
7505
7506 <para>
7507 You can provide the following arguments with
7508 <filename>TEST_TARGET</filename>:
7509 <itemizedlist>
7510 <listitem><para><emphasis>"qemu":</emphasis>
7511 Boots a QEMU image and runs the tests.
7512 See the
7513 "<ulink url='&YOCTO_DOCS_DEV_URL;#qemu-image-enabling-tests'>QEMU</ulink>"
7514 section in the Yocto Project Development Manual for
7515 more information.
7516 </para></listitem>
7517 <listitem><para><emphasis>"QemuTarget":</emphasis>
7518 Identical to "qemu".
7519 </para></listitem>
7520 <listitem><para><emphasis>"simpleremote":</emphasis>
7521 Runs the tests on target hardware that is already
7522 up and running.
7523 The hardware can be on the network or it can be
7524 a device running an image on QEMU.
7525 You must also set
7526 <link linkend='var-TEST_TARGET_IP'><filename>TEST_TARGET_IP</filename></link>
7527 when you use "simpleremote".
7528 <note>
7529 This argument is defined in
7530 <filename>meta/lib/oeqa/targetcontrol.py</filename>.
7531 The small caps names are kept for compatibility
7532 reasons.
7533 </note>
7534 </para></listitem>
7535 <listitem><para><emphasis>"SimpleRemoteTarget":</emphasis>
7536 Identical to "simpleremote".
7537 </para></listitem>
7538 <listitem><para><emphasis>"GummibootTarget":</emphasis>
7539 Automatically deploys and runs tests on an
7540 EFI-enabled machine that has a master image
7541 installed.
7542 <note>
7543 This argument is defined in
7544 <filename>meta/lib/oeqa/controllers/masterimage.py</filename>.
7545 </note>
7546 </para></listitem>
7547 </itemizedlist>
7548 </para>
7549 </glossdef>
7550 </glossentry>
7551
7487 <glossentry id='var-TEST_SUITES'><glossterm>TEST_SUITES</glossterm> 7552 <glossentry id='var-TEST_SUITES'><glossterm>TEST_SUITES</glossterm>
7488 <glossdef> 7553 <glossdef>
7489 <para> 7554 <para>