From 30343d465a99bcfafefb4334a9e080a4499f0b48 Mon Sep 17 00:00:00 2001 From: John Ousterhout Date: Thu, 30 Apr 2020 22:20:48 -0700 Subject: [PATCH] Document threads tests that may fail under jitter --- doc/threads.texi | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/threads.texi b/doc/threads.texi index 5a18ec4..bf8546e 100644 --- a/doc/threads.texi +++ b/doc/threads.texi @@ -643,6 +643,17 @@ to cause many of the tests to fail. @xref{Testing}. +@item Should I try running the tests with jitter? + +Using the jitter feature in Bochs (@pxref{Debugging versus Testing}) +is a great way to discover bugs that are timing dependent. However, +the following tests are known to +fail with jitter even if your code is correct: @code{alarm-simultaneous}, +@code{mlfqs-recent-1}, @code{mlfqs-fair-2}, @code{mlfqs-fair-20}, +@code{mlfqs-nice-2}, @code{mlfqs-nice-10}, and @code{priority-fifo}. +The behavior of these tests can sometimes vary based on timing (e.g., +if a timer interrupt arrives at an inconvenient time). + @item Why do I get a test failure in @func{pass}? @anchor{The pass function fails} -- 2.30.2