Documentation/synchro-test.txt

   1 The synchro-test.ko module can be used for testing and benchmarking mutexes,
   2 semaphores and R/W semaphores.
   3
   4 The module is compiled by setting CONFIG_DEBUG_SYNCHRO_TEST to "m" when
   5 configuring the kernel.
   6
   7 Using it is simple:
   8
   9         insmod synchro-test.ko <args>
  10
  11 It will exit with error ENOANO after running the tests and printing the
  12 results to the kernel console log.
  13
  14 The available arguments are:
  15
  16  (*) mx=N
  17
  18         Start up to N mutex thrashing threads, where N is at most 20. All will
  19         try and thrash the same mutex.
  20
  21  (*) sm=N
  22
  23         Start up to N counting semaphore thrashing threads, where N is at most
  24         20. All will try and thrash the same semaphore.
  25
  26  (*) ism=M
  27
  28         Initialise the counting semaphore with M, where M is any positive
  29         integer greater than zero. The default is 4.
  30
  31  (*) rd=N
  32  (*) wr=O
  33  (*) dg=P
  34
  35         Start up to N reader thrashing threads, O writer thrashing threads and
  36         P downgrader thrashing threads, where N, O and P are at most 20
  37         apiece. All will try and thrash the same read/write semaphore.
  38
  39  (*) elapse=N
  40
  41         Run the tests for N seconds. The default is 5.
  42
  43  (*) load=N
  44
  45         Each thread delays for N uS whilst holding the lock. The default is 0.
  46
  47  (*) interval=N
  48
  49         Each thread delays for N uS whilst not holding the lock. The default
  50         is 0.
  51
  52  (*) do_sched=1
  53
  54         Each thread will call schedule if required after each iteration.
  55
  56  (*) v=1
  57
  58         Print more verbose information, including a thread iteration
  59         distribution list.