diff options
Diffstat (limited to 'eng/test-framework.rst')
-rw-r--r-- | eng/test-framework.rst | 46 |
1 files changed, 21 insertions, 25 deletions
diff --git a/eng/test-framework.rst b/eng/test-framework.rst index 1cdf018..25bbad9 100644 --- a/eng/test-framework.rst +++ b/eng/test-framework.rst @@ -1,6 +1,6 @@ .. SPDX-License-Identifier: CC-BY-SA-4.0 -.. Copyright (C) 2018, 2020 embedded brains GmbH +.. Copyright (C) 2018, 2020 embedded brains GmbH & Co. KG .. Copyright (C) 2018, 2020 Sebastian Huber Software Test Framework @@ -131,6 +131,8 @@ two test steps (`N`) and one test failure (`F`). The test case execution duration (`D`) was 0.001657 seconds. For test report details see: :ref:`Test Reporting <RTEMSTestFrameworkTestReporting>`. +.. _RTEMSTestFrameworkFixture: + Test Fixture ------------ @@ -757,9 +759,9 @@ The following test checks for boolean expressions are available: void T_false(bool a, const char *fmt, ...); void T_assert_false(bool a, const char *fmt, ...); - void T_quiet_true(bool a, const char *fmt, ...); - void T_step_true(unsigned int step, bool a, const char *fmt, ...); - void T_step_assert_true(unsigned int step, bool a, const char *fmt, ...); + void T_quiet_false(bool a, const char *fmt, ...); + void T_step_false(unsigned int step, bool a, const char *fmt, ...); + void T_step_assert_false(unsigned int step, bool a, const char *fmt, ...); The message is only printed in case the test check fails. The format parameter is mandatory. @@ -1256,8 +1258,8 @@ T_MEASURE_RUNTIME_ALLOW_CLOCK_ISR T_MEASURE_RUNTIME_REPORT_SAMPLES Report all measurement samples. -T_MEASURE_RUNTIME_DISABLE_VALID_CACHE - Disable the `ValidCache` execution environment variant. +T_MEASURE_RUNTIME_DISABLE_FULL_CACHE + Disable the `FullCache` execution environment variant. T_MEASURE_RUNTIME_DISABLE_HOT_CACHE Disable the `HotCache` execution environment variant. @@ -1275,14 +1277,15 @@ T_MEASURE_RUNTIME_DISABLE_MAX_LOAD The execution environment variants (`M:V`) are: -ValidCache +FullCache Before the `body` request handler is invoked a memory area with twice the size of the outer-most data cache is completely read. This fills the data cache with valid cache lines which are unrelated to the `body` request - handler. + handler. The cache is full with valid data and loading memory used by the + handler needs to evict cache lines. You can disable this variant with the - `T_MEASURE_RUNTIME_DISABLE_VALID_CACHE` request flag. + `T_MEASURE_RUNTIME_DISABLE_FULL_CACHE` request flag. HotCache Before the `body` request handler is invoked the `body` request handler is @@ -1302,14 +1305,14 @@ DirtyCache You can disable this variant with the `T_MEASURE_RUNTIME_DISABLE_DIRTY_CACHE` request flag. -Load +Load/<WorkerCount> This variant tries to get close to worst-case conditions. The cache is set up according to the `DirtyCache` variant. In addition, other processors try to fully load the memory system. The load is produced through writes to a memory area with twice the size of the outer-most data cache. The load variant is performed multiple times with a different set of active - load worker threads (`M:L`). The active workers range from one up to the - processor count. + load worker threads. The <WorkerCount> value is the count of active + workers which ranges from one to the processor count. You can disable these variants with the `T_MEASURE_RUNTIME_DISABLE_MINOR_LOAD` and @@ -1359,7 +1362,7 @@ reported. B:measure_empty P:0:0:UI1:test-rtems-measure.c:18 M:B:Empty - M:V:ValidCache + M:V:FullCache M:N:1024 M:MI:0.000000000 M:Q1:0.000000000 @@ -1392,8 +1395,7 @@ reported. M:D:0.000033244 M:E:Empty:D:1.887834875 M:B:Empty - M:V:Load - M:L:1 + M:V:Load/1 M:N:1024 M:MI:0.000000000 M:Q1:0.000000002 @@ -1406,8 +1408,7 @@ reported. [... 22 more load variants ...] M:E:Empty:D:0.021252583 M:B:Empty - M:V:Load - M:L:24 + M:V:Load/24 M:N:1024 M:MI:0.000000001 M:Q1:0.000000002 @@ -1906,8 +1907,6 @@ M **M:V:<Variant>** - **M:L:<Load>** - **M:N:<SampleCount>** **M:S:<Count>:<Value>** @@ -1935,12 +1934,9 @@ M (`:`). <Variant> - The execution variant which is one of **ValidCache**, **HotCache**, - **DirtyCache**, or **Load**. - - <Load> - The active load workers count which ranges from one to the processor - count. + The execution variant which is one of **FullCache**, **HotCache**, + **DirtyCache**, or **Load/<WorkerCount>**. The <WorkerCount> is the + count of active workers which ranges from one to the processor count. <SampleCount> The sample count as defined by the runtime measurement configuration. |