diff options
author | Paul E. McKenney <paul.mckenney@linaro.org> | 2012-10-31 16:22:08 -0400 |
---|---|---|
committer | Paul E. McKenney <paulmck@linux.vnet.ibm.com> | 2012-11-16 12:55:31 -0500 |
commit | d484a215139cf556cb718a7ec7042260b7fc2d28 (patch) | |
tree | 00bf46b82ccaaee360b6181e5479fdb373f4cb50 /Documentation/RCU/trace.txt | |
parent | 40e80c469f1b52a68e09da3808a1228cf9947fa7 (diff) |
rcu: Add documentation for the new rcuexp debugfs trace file
This commit adds the documentation of the rcuexp debugfs trace file
that records statistics for expedited grace periods.
Signed-off-by: Paul E. McKenney <paul.mckenney@linaro.org>
Signed-off-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
Diffstat (limited to 'Documentation/RCU/trace.txt')
-rw-r--r-- | Documentation/RCU/trace.txt | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/Documentation/RCU/trace.txt b/Documentation/RCU/trace.txt index 79ce9891a8c7..c776968f4463 100644 --- a/Documentation/RCU/trace.txt +++ b/Documentation/RCU/trace.txt | |||
@@ -41,6 +41,8 @@ also rcu/rcu_preempt) the following files will be present: | |||
41 | 41 | ||
42 | rcudata: | 42 | rcudata: |
43 | Displays fields in struct rcu_data. | 43 | Displays fields in struct rcu_data. |
44 | rcuexp: | ||
45 | Displays statistics for expedited grace periods. | ||
44 | rcugp: | 46 | rcugp: |
45 | Displays grace-period counters. | 47 | Displays grace-period counters. |
46 | rcuhier: | 48 | rcuhier: |
@@ -233,6 +235,45 @@ o "ktl" is the low-order 16 bits (in hexadecimal) of the count of | |||
233 | This field is displayed only for CONFIG_RCU_BOOST kernels. | 235 | This field is displayed only for CONFIG_RCU_BOOST kernels. |
234 | 236 | ||
235 | 237 | ||
238 | The output of "cat rcu/rcu_preempt/rcuexp" looks as follows: | ||
239 | |||
240 | s=21872 d=21872 w=0 tf=0 wd1=0 wd2=0 n=0 sc=21872 dt=21872 dl=0 dx=21872 | ||
241 | |||
242 | These fields are as follows: | ||
243 | |||
244 | o "s" is the starting sequence number. | ||
245 | |||
246 | o "d" is the ending sequence number. When the starting and ending | ||
247 | numbers differ, there is an expedited grace period in progress. | ||
248 | |||
249 | o "w" is the number of times that the sequence numbers have been | ||
250 | in danger of wrapping. | ||
251 | |||
252 | o "tf" is the number of times that contention has resulted in a | ||
253 | failure to begin an expedited grace period. | ||
254 | |||
255 | o "wd1" and "wd2" are the number of times that an attempt to | ||
256 | start an expedited grace period found that someone else had | ||
257 | completed an expedited grace period that satisfies the | ||
258 | attempted request. "Our work is done." | ||
259 | |||
260 | o "n" is number of times that contention was so great that | ||
261 | the request was demoted from an expedited grace period to | ||
262 | a normal grace period. | ||
263 | |||
264 | o "sc" is the number of times that the attempt to start a | ||
265 | new expedited grace period succeeded. | ||
266 | |||
267 | o "dt" is the number of times that we attempted to update | ||
268 | the "d" counter. | ||
269 | |||
270 | o "dl" is the number of times that we failed to update the "d" | ||
271 | counter. | ||
272 | |||
273 | o "dx" is the number of times that we succeeded in updating | ||
274 | the "d" counter. | ||
275 | |||
276 | |||
236 | The output of "cat rcu/rcu_preempt/rcugp" looks as follows: | 277 | The output of "cat rcu/rcu_preempt/rcugp" looks as follows: |
237 | 278 | ||
238 | completed=31249 gpnum=31250 age=1 max=18 | 279 | completed=31249 gpnum=31250 age=1 max=18 |