Kconfig 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242
  1. #
  2. # RCU-related configuration options
  3. #
  4. menu "RCU Subsystem"
  5. config TREE_RCU
  6. bool
  7. default y if !PREEMPT && SMP
  8. help
  9. This option selects the RCU implementation that is
  10. designed for very large SMP system with hundreds or
  11. thousands of CPUs. It also scales down nicely to
  12. smaller systems.
  13. config PREEMPT_RCU
  14. bool
  15. default y if PREEMPT
  16. help
  17. This option selects the RCU implementation that is
  18. designed for very large SMP systems with hundreds or
  19. thousands of CPUs, but for which real-time response
  20. is also required. It also scales down nicely to
  21. smaller systems.
  22. Select this option if you are unsure.
  23. config TINY_RCU
  24. bool
  25. default y if !PREEMPT && !SMP
  26. help
  27. This option selects the RCU implementation that is
  28. designed for UP systems from which real-time response
  29. is not required. This option greatly reduces the
  30. memory footprint of RCU.
  31. config RCU_EXPERT
  32. bool "Make expert-level adjustments to RCU configuration"
  33. default n
  34. help
  35. This option needs to be enabled if you wish to make
  36. expert-level adjustments to RCU configuration. By default,
  37. no such adjustments can be made, which has the often-beneficial
  38. side-effect of preventing "make oldconfig" from asking you all
  39. sorts of detailed questions about how you would like numerous
  40. obscure RCU options to be set up.
  41. Say Y if you need to make expert-level adjustments to RCU.
  42. Say N if you are unsure.
  43. config SRCU
  44. bool
  45. help
  46. This option selects the sleepable version of RCU. This version
  47. permits arbitrary sleeping or blocking within RCU read-side critical
  48. sections.
  49. config TINY_SRCU
  50. bool
  51. default y if SRCU && TINY_RCU
  52. help
  53. This option selects the single-CPU non-preemptible version of SRCU.
  54. config TREE_SRCU
  55. bool
  56. default y if SRCU && !TINY_RCU
  57. help
  58. This option selects the full-fledged version of SRCU.
  59. config TASKS_RCU
  60. def_bool PREEMPT
  61. select SRCU
  62. help
  63. This option enables a task-based RCU implementation that uses
  64. only voluntary context switch (not preemption!), idle, and
  65. user-mode execution as quiescent states.
  66. config RCU_STALL_COMMON
  67. def_bool ( TREE_RCU || PREEMPT_RCU )
  68. help
  69. This option enables RCU CPU stall code that is common between
  70. the TINY and TREE variants of RCU. The purpose is to allow
  71. the tiny variants to disable RCU CPU stall warnings, while
  72. making these warnings mandatory for the tree variants.
  73. config RCU_NEED_SEGCBLIST
  74. def_bool ( TREE_RCU || PREEMPT_RCU || TREE_SRCU )
  75. config CONTEXT_TRACKING
  76. bool
  77. config CONTEXT_TRACKING_FORCE
  78. bool "Force context tracking"
  79. depends on CONTEXT_TRACKING
  80. default y if !NO_HZ_FULL
  81. help
  82. The major pre-requirement for full dynticks to work is to
  83. support the context tracking subsystem. But there are also
  84. other dependencies to provide in order to make the full
  85. dynticks working.
  86. This option stands for testing when an arch implements the
  87. context tracking backend but doesn't yet fullfill all the
  88. requirements to make the full dynticks feature working.
  89. Without the full dynticks, there is no way to test the support
  90. for context tracking and the subsystems that rely on it: RCU
  91. userspace extended quiescent state and tickless cputime
  92. accounting. This option copes with the absence of the full
  93. dynticks subsystem by forcing the context tracking on all
  94. CPUs in the system.
  95. Say Y only if you're working on the development of an
  96. architecture backend for the context tracking.
  97. Say N otherwise, this option brings an overhead that you
  98. don't want in production.
  99. config RCU_FANOUT
  100. int "Tree-based hierarchical RCU fanout value"
  101. range 2 64 if 64BIT
  102. range 2 32 if !64BIT
  103. depends on (TREE_RCU || PREEMPT_RCU) && RCU_EXPERT
  104. default 64 if 64BIT
  105. default 32 if !64BIT
  106. help
  107. This option controls the fanout of hierarchical implementations
  108. of RCU, allowing RCU to work efficiently on machines with
  109. large numbers of CPUs. This value must be at least the fourth
  110. root of NR_CPUS, which allows NR_CPUS to be insanely large.
  111. The default value of RCU_FANOUT should be used for production
  112. systems, but if you are stress-testing the RCU implementation
  113. itself, small RCU_FANOUT values allow you to test large-system
  114. code paths on small(er) systems.
  115. Select a specific number if testing RCU itself.
  116. Take the default if unsure.
  117. config RCU_FANOUT_LEAF
  118. int "Tree-based hierarchical RCU leaf-level fanout value"
  119. range 2 64 if 64BIT
  120. range 2 32 if !64BIT
  121. depends on (TREE_RCU || PREEMPT_RCU) && RCU_EXPERT
  122. default 16
  123. help
  124. This option controls the leaf-level fanout of hierarchical
  125. implementations of RCU, and allows trading off cache misses
  126. against lock contention. Systems that synchronize their
  127. scheduling-clock interrupts for energy-efficiency reasons will
  128. want the default because the smaller leaf-level fanout keeps
  129. lock contention levels acceptably low. Very large systems
  130. (hundreds or thousands of CPUs) will instead want to set this
  131. value to the maximum value possible in order to reduce the
  132. number of cache misses incurred during RCU's grace-period
  133. initialization. These systems tend to run CPU-bound, and thus
  134. are not helped by synchronized interrupts, and thus tend to
  135. skew them, which reduces lock contention enough that large
  136. leaf-level fanouts work well. That said, setting leaf-level
  137. fanout to a large number will likely cause problematic
  138. lock contention on the leaf-level rcu_node structures unless
  139. you boot with the skew_tick kernel parameter.
  140. Select a specific number if testing RCU itself.
  141. Select the maximum permissible value for large systems, but
  142. please understand that you may also need to set the skew_tick
  143. kernel boot parameter to avoid contention on the rcu_node
  144. structure's locks.
  145. Take the default if unsure.
  146. config RCU_FAST_NO_HZ
  147. bool "Accelerate last non-dyntick-idle CPU's grace periods"
  148. depends on NO_HZ_COMMON && SMP && RCU_EXPERT
  149. default n
  150. help
  151. This option permits CPUs to enter dynticks-idle state even if
  152. they have RCU callbacks queued, and prevents RCU from waking
  153. these CPUs up more than roughly once every four jiffies (by
  154. default, you can adjust this using the rcutree.rcu_idle_gp_delay
  155. parameter), thus improving energy efficiency. On the other
  156. hand, this option increases the duration of RCU grace periods,
  157. for example, slowing down synchronize_rcu().
  158. Say Y if energy efficiency is critically important, and you
  159. don't care about increased grace-period durations.
  160. Say N if you are unsure.
  161. config RCU_BOOST
  162. bool "Enable RCU priority boosting"
  163. depends on RT_MUTEXES && PREEMPT_RCU && RCU_EXPERT
  164. default n
  165. help
  166. This option boosts the priority of preempted RCU readers that
  167. block the current preemptible RCU grace period for too long.
  168. This option also prevents heavy loads from blocking RCU
  169. callback invocation for all flavors of RCU.
  170. Say Y here if you are working with real-time apps or heavy loads
  171. Say N here if you are unsure.
  172. config RCU_BOOST_DELAY
  173. int "Milliseconds to delay boosting after RCU grace-period start"
  174. range 0 3000
  175. depends on RCU_BOOST
  176. default 500
  177. help
  178. This option specifies the time to wait after the beginning of
  179. a given grace period before priority-boosting preempted RCU
  180. readers blocking that grace period. Note that any RCU reader
  181. blocking an expedited RCU grace period is boosted immediately.
  182. Accept the default if unsure.
  183. config RCU_NOCB_CPU
  184. bool "Offload RCU callback processing from boot-selected CPUs"
  185. depends on TREE_RCU || PREEMPT_RCU
  186. depends on RCU_EXPERT || NO_HZ_FULL
  187. default n
  188. help
  189. Use this option to reduce OS jitter for aggressive HPC or
  190. real-time workloads. It can also be used to offload RCU
  191. callback invocation to energy-efficient CPUs in battery-powered
  192. asymmetric multiprocessors.
  193. This option offloads callback invocation from the set of
  194. CPUs specified at boot time by the rcu_nocbs parameter.
  195. For each such CPU, a kthread ("rcuox/N") will be created to
  196. invoke callbacks, where the "N" is the CPU being offloaded,
  197. and where the "x" is "b" for RCU-bh, "p" for RCU-preempt, and
  198. "s" for RCU-sched. Nothing prevents this kthread from running
  199. on the specified CPUs, but (1) the kthreads may be preempted
  200. between each callback, and (2) affinity or cgroups can be used
  201. to force the kthreads to run on whatever set of CPUs is desired.
  202. Say Y here if you want to help to debug reduced OS jitter.
  203. Say N here if you are unsure.
  204. endmenu # "RCU Subsystem"