This is an automated email from the ASF dual-hosted git repository.
xiaoxiang781216 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git
The following commit(s) were added to refs/heads/master by this push:
new a0263fc28eb Documentation/ostest: Describe the time slices of the
round-robin test.
a0263fc28eb is described below
commit a0263fc28eb1d2c0ce0a51e24aa839d4f9be04b6
Author: Marco Casaroli <[email protected]>
AuthorDate: Sat Oct 17 22:12:10 2026 +0200
Documentation/ostest: Describe the time slices of the round-robin test.
The round-robin test of ostest now counts the time slices of its two
threads. CONFIG_TESTING_OSTEST_RR_RUNS is the number of time slices of
each thread, and CONFIG_TESTING_OSTEST_RR_RANGE is the end of the range
that the threads search one number at a time.
Describe the two options again.
Assisted-by: Claude Code:claude-opus-5-5
Signed-off-by: Marco Casaroli <[email protected]>
---
.../applications/testing/ostest/index.rst | 24 +++++++++-------------
1 file changed, 10 insertions(+), 14 deletions(-)
diff --git a/Documentation/applications/testing/ostest/index.rst
b/Documentation/applications/testing/ostest/index.rst
index 5476ffb454f..5fc8638db2e 100644
--- a/Documentation/applications/testing/ostest/index.rst
+++ b/Documentation/applications/testing/ostest/index.rst
@@ -24,18 +24,14 @@ The behavior of the ``ostest`` can be modified with the
following settings in th
needed on systems without sufficient memory to start so many threads.
- ``CONFIG_TESTING_OSTEST_RR_RANGE`` – During round-robin scheduling test two
- threads are created. Each of the threads searches for prime numbers in the
- configurable range, doing that configurable number of times. This value
- specifies the end of search range and together with number of runs allows
to
- configure the length of this test – it should last at least a few tens of
- seconds. Allowed values ``[1; 32767]``, default ``30000``.
+ threads are created. Each of the threads searches for prime numbers below
+ this value, one number at a time, and starts again at 1 at the end of the
+ range. The time for one number must be much shorter than
+ ``CONFIG_RR_INTERVAL``. Allowed values ``[1; 32767]``, default ``30000``.
+ A slow board can set this value lower in its defconfig.
-- ``CONFIG_TESTING_OSTEST_RR_RUNS`` – During round-robin scheduling test two
- threads are created. Each of the threads searches for prime numbers in the
- configurable range, doing that configurable number of times. This value
- specifies the number of runs. Allowed values ``[1; 32767]``, default
- ``10``. A slow board can set this value and
- ``CONFIG_TESTING_OSTEST_RR_RANGE`` lower in its defconfig. The test fails
- if one thread finishes the first ``CONFIG_TESTING_OSTEST_RR_RUNS`` runs
- before the other thread finishes one, for example when all its runs fit
- in one time slice (``CONFIG_RR_INTERVAL``).
+- ``CONFIG_TESTING_OSTEST_RR_RUNS`` – The number of time slices of each thread
+ in the round-robin scheduling test. The test takes about
+ ``2 * CONFIG_TESTING_OSTEST_RR_RUNS * CONFIG_RR_INTERVAL`` milliseconds. It
+ passes when the two threads had the same number of time slices, plus or
+ minus one. Allowed values ``[1; 32767]``, default ``10``.
