summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-09-20 12:04:25 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-09-22 12:20:49 +0100
commitb9bb27800f55c8142e052299333f71137b230740 (patch)
tree385f5b736ab7f801b4bcb289cbd6b58efbdbafdc /documentation/ref-manual
parent06cddebe6df3b6a8b6263a666023c7ac8e292b65 (diff)
downloadpoky-b9bb27800f55c8142e052299333f71137b230740.tar.gz
ref-manual: New variable descriptions to support QEMU image tests
Added variable descriptions for TEST_SUITES and TEST_QEMUBOOT_TIMEOUT. (From yocto-docs rev: 8ca24bbb5388040a4aa5b70bac9babf1805bbb6e) 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.xml72
1 files changed, 72 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 1fb6cfadb9..2404a73dd3 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -5217,6 +5217,78 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
5217 </glossdef> 5217 </glossdef>
5218 </glossentry> 5218 </glossentry>
5219 5219
5220 <glossentry id='var-TEST_QEMUBOOT_TIMEOUT'><glossterm>TEST_QEMUBOOT_TIMEOUT</glossterm>
5221 <glossdef>
5222 <para>
5223 The time in seconds allowed for a QEMU image to boot before
5224 tests begin to run against the image using the following
5225 command:
5226 <literallayout class='monospaced'>
5227 bitbake &lt;qemu_image&gt; -c testimage
5228 </literallayout>
5229 </para>
5230
5231 <para>
5232 The default timeout period to allow the boot process to
5233 reach the login prompt is 500 seconds.
5234 You can edit this default value in the
5235 <filename>local.conf</filename> file.
5236 </para>
5237
5238 <para>
5239 For more information on testing QEMU images, see the
5240 "<ulink url='running-and-writing-tests-for-a-qemu-image'>Running and Writing Tests for a QEMU Image</ulink>"
5241 section in the Yocto Project Development Manual.
5242 </para>
5243 </glossdef>
5244 </glossentry>
5245
5246 <glossentry id='var-TEST_SUITES'><glossterm>TEST_SUITES</glossterm>
5247 <glossdef>
5248 <para>
5249 An ordered list of tests (modules) to run against
5250 a QEMU image using the following command:
5251 <literallayout class='monospaced'>
5252 bitbake &lt;qemu_image&gt; -c testimage
5253 </literallayout>
5254 </para>
5255
5256 <para>
5257 The Yocto Project provides a core set of tests that can
5258 be used against QEMU images.
5259 Tests include <filename>ping</filename>,
5260 <filename>ssh</filename>, <filename>df</filename> among
5261 others.
5262 You can add your own tests to the list of tests by
5263 appending <filename>TEST_SUITES</filename> as follows:
5264 <literallayout class='monospaced'>
5265 TEST_SUITES_append = " mytest"
5266 </literallayout>
5267 </para>
5268
5269 <para>
5270 The order in which tests are run is important.
5271 Tests that depend on another test must appear later in the
5272 list than the test on which they depend.
5273 For example, if you append the list of tests with two
5274 tests (<filename>test_A</filename> and
5275 <filename>test_B</filename>) where
5276 <filename>test_B</filename> is dependent on
5277 <filename>test_A</filename>, then you must order the tests
5278 as follows:
5279 <literallayout class='monospaced'>
5280 TEST_SUITES = " test_A test_B"
5281 </literallayout>
5282 </para>
5283
5284 <para>
5285 For more information on testing QEMU images, see the
5286 "<ulink url='running-and-writing-tests-for-a-qemu-image'>Running and Writing Tests for a QEMU Image</ulink>"
5287 section in the Yocto Project Development Manual.
5288 </para>
5289 </glossdef>
5290 </glossentry>
5291
5220 <glossentry id='var-THISDIR'><glossterm>THISDIR</glossterm> 5292 <glossentry id='var-THISDIR'><glossterm>THISDIR</glossterm>
5221 <glossdef> 5293 <glossdef>
5222 <para> 5294 <para>