Skip to content

Commit

Permalink
README.md: add more fairness notes
Browse files Browse the repository at this point in the history
  • Loading branch information
Brian Norris committed Aug 14, 2013
1 parent e678e5e commit 4f0f0db
Showing 1 changed file with 9 additions and 1 deletion.
10 changes: 9 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,9 @@ Useful Options
`-f num`

> Turns on alternative fairness support (less desirable than `-y`).
> Turns on alternative fairness support (less desirable than `-y`). A
> necessary alternative for some programs that do not support yield-based
> fairness properly.
`-v`

Expand Down Expand Up @@ -324,6 +326,12 @@ Now, we can examine the end-of-execution summary of one test program:
Other Notes and Pitfalls
------------------------

* Many programs require some form of fairness in order to terminate in a finite
amount of time. CDSChecker supports the `-y num` and `-f num` flags for these
cases. The `-y` option (yield-based fairness) is preferable, but it requires
careful usage of yields (i.e., `thrd_yield()`) in the test program. For
programs without proper `thrd_yield()`, you may consider using `-f` instead.

* Deadlock detection: CDSChecker can detect deadlocks. For instance, try the
following test program.

Expand Down

0 comments on commit 4f0f0db

Please sign in to comment.