TREE_RCU-kconfig.txt 2.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. This document gives a brief rationale for the TREE_RCU-related test
  2. cases, a group that includes TREE_PREEMPT_RCU.
  3. Kconfig Parameters:
  4. CONFIG_DEBUG_LOCK_ALLOC -- Do three, covering CONFIG_PROVE_LOCKING & not.
  5. CONFIG_DEBUG_OBJECTS_RCU_HEAD -- Do one.
  6. CONFIG_HOTPLUG_CPU -- Do half. (Every second.)
  7. CONFIG_HZ_PERIODIC -- Do one.
  8. CONFIG_NO_HZ_IDLE -- Do those not otherwise specified. (Groups of two.)
  9. CONFIG_NO_HZ_FULL -- Do two, one with CONFIG_NO_HZ_FULL_SYSIDLE.
  10. CONFIG_NO_HZ_FULL_SYSIDLE -- Do one.
  11. CONFIG_PREEMPT -- Do half. (First three and #8.)
  12. CONFIG_PROVE_LOCKING -- Do all but two, covering CONFIG_PROVE_RCU and not.
  13. CONFIG_PROVE_RCU -- Do all but one under CONFIG_PROVE_LOCKING.
  14. CONFIG_RCU_BOOST -- one of TREE_PREEMPT_RCU.
  15. CONFIG_RCU_BOOST_PRIO -- set to 2 for _BOOST testing.
  16. CONFIG_RCU_CPU_STALL_INFO -- do one with and without _VERBOSE.
  17. CONFIG_RCU_CPU_STALL_VERBOSE -- do one with and without _INFO.
  18. CONFIG_RCU_FANOUT -- Cover hierarchy as currently, but overlap with others.
  19. CONFIG_RCU_FANOUT_EXACT -- Do one.
  20. CONFIG_RCU_FANOUT_LEAF -- Do one non-default.
  21. CONFIG_RCU_FAST_NO_HZ -- Do one, but not with CONFIG_RCU_NOCB_CPU_ALL.
  22. CONFIG_RCU_NOCB_CPU -- Do three, see below.
  23. CONFIG_RCU_NOCB_CPU_ALL -- Do one.
  24. CONFIG_RCU_NOCB_CPU_NONE -- Do one.
  25. CONFIG_RCU_NOCB_CPU_ZERO -- Do one.
  26. CONFIG_RCU_TRACE -- Do half.
  27. CONFIG_SMP -- Need one !SMP for TREE_PREEMPT_RCU.
  28. RCU-bh: Do one with PREEMPT and one with !PREEMPT.
  29. RCU-sched: Do one with PREEMPT but not BOOST.
  30. Hierarchy:
  31. TREE01. CONFIG_NR_CPUS=8, CONFIG_RCU_FANOUT=8, CONFIG_RCU_FANOUT_EXACT=n.
  32. TREE02. CONFIG_NR_CPUS=8, CONFIG_RCU_FANOUT=3, CONFIG_RCU_FANOUT_EXACT=n,
  33. CONFIG_RCU_FANOUT_LEAF=3.
  34. TREE03. CONFIG_NR_CPUS=8, CONFIG_RCU_FANOUT=4, CONFIG_RCU_FANOUT_EXACT=n,
  35. CONFIG_RCU_FANOUT_LEAF=4.
  36. TREE04. CONFIG_NR_CPUS=8, CONFIG_RCU_FANOUT=2, CONFIG_RCU_FANOUT_EXACT=n,
  37. CONFIG_RCU_FANOUT_LEAF=2.
  38. TREE05. CONFIG_NR_CPUS=8, CONFIG_RCU_FANOUT=6, CONFIG_RCU_FANOUT_EXACT=n
  39. CONFIG_RCU_FANOUT_LEAF=6.
  40. TREE06. CONFIG_NR_CPUS=8, CONFIG_RCU_FANOUT=6, CONFIG_RCU_FANOUT_EXACT=y
  41. CONFIG_RCU_FANOUT_LEAF=6.
  42. TREE07. CONFIG_NR_CPUS=16, CONFIG_RCU_FANOUT=2, CONFIG_RCU_FANOUT_EXACT=n,
  43. CONFIG_RCU_FANOUT_LEAF=2.
  44. TREE08. CONFIG_NR_CPUS=16, CONFIG_RCU_FANOUT=3, CONFIG_RCU_FANOUT_EXACT=y,
  45. CONFIG_RCU_FANOUT_LEAF=2.
  46. TREE09. CONFIG_NR_CPUS=1.
  47. Kconfig Parameters Ignored:
  48. CONFIG_64BIT
  49. Used only to check CONFIG_RCU_FANOUT value, inspection suffices.
  50. CONFIG_NO_HZ_FULL_SYSIDLE_SMALL
  51. Defer until Frederic uses this.
  52. CONFIG_PREEMPT_COUNT
  53. CONFIG_PREEMPT_RCU
  54. Redundant with CONFIG_PREEMPT, ignore.
  55. CONFIG_RCU_BOOST_DELAY
  56. Inspection suffices, ignore.
  57. CONFIG_RCU_CPU_STALL_TIMEOUT
  58. Inspection suffices, ignore.
  59. CONFIG_RCU_STALL_COMMON
  60. Implied by TREE_RCU and TREE_PREEMPT_RCU.
  61. CONFIG_RCU_TORTURE_TEST
  62. CONFIG_RCU_TORTURE_TEST_RUNNABLE
  63. Always used in KVM testing.
  64. CONFIG_RCU_USER_QS
  65. Redundant with CONFIG_NO_HZ_FULL.
  66. CONFIG_TREE_PREEMPT_RCU
  67. CONFIG_TREE_RCU
  68. These are controlled by CONFIG_PREEMPT.