diff options
author | Paul E. McKenney <paulmck@linux.vnet.ibm.com> | 2013-03-27 14:32:12 -0400 |
---|---|---|
committer | Paul E. McKenney <paulmck@linux.vnet.ibm.com> | 2013-06-10 16:45:52 -0400 |
commit | 7807acdb6b794b3af42dfa1912edd4fba8d0b622 (patch) | |
tree | 789dfa74747a79cb3a6b148f7bd1badf148a6c6e /Documentation/RCU | |
parent | 318bdcd95938ec3a530fc789da662ce159d50d46 (diff) |
rcu: Remove TINY_PREEMPT_RCU tracing documentation
Because TINY_PREEMPT_RCU is no more, this commit removes its tracing
formats from the documentation.
Signed-off-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
Reviewed-by: Josh Triplett <josh@joshtriplett.org>
Diffstat (limited to 'Documentation/RCU')
-rw-r--r-- | Documentation/RCU/trace.txt | 100 |
1 files changed, 4 insertions, 96 deletions
diff --git a/Documentation/RCU/trace.txt b/Documentation/RCU/trace.txt index c776968f4463..f3778f8952da 100644 --- a/Documentation/RCU/trace.txt +++ b/Documentation/RCU/trace.txt | |||
@@ -530,113 +530,21 @@ o "nos" counts the number of times we balked for other | |||
530 | reasons, e.g., the grace period ended first. | 530 | reasons, e.g., the grace period ended first. |
531 | 531 | ||
532 | 532 | ||
533 | CONFIG_TINY_RCU and CONFIG_TINY_PREEMPT_RCU debugfs Files and Formats | 533 | CONFIG_TINY_RCU debugfs Files and Formats |
534 | 534 | ||
535 | These implementations of RCU provides a single debugfs file under the | 535 | These implementations of RCU provides a single debugfs file under the |
536 | top-level directory RCU, namely rcu/rcudata, which displays fields in | 536 | top-level directory RCU, namely rcu/rcudata, which displays fields in |
537 | rcu_bh_ctrlblk, rcu_sched_ctrlblk and, for CONFIG_TINY_PREEMPT_RCU, | 537 | rcu_bh_ctrlblk and rcu_sched_ctrlblk. |
538 | rcu_preempt_ctrlblk. | ||
539 | 538 | ||
540 | The output of "cat rcu/rcudata" is as follows: | 539 | The output of "cat rcu/rcudata" is as follows: |
541 | 540 | ||
542 | rcu_preempt: qlen=24 gp=1097669 g197/p197/c197 tasks=... | ||
543 | ttb=. btg=no ntb=184 neb=0 nnb=183 j=01f7 bt=0274 | ||
544 | normal balk: nt=1097669 gt=0 bt=371 b=0 ny=25073378 nos=0 | ||
545 | exp balk: bt=0 nos=0 | ||
546 | rcu_sched: qlen: 0 | 541 | rcu_sched: qlen: 0 |
547 | rcu_bh: qlen: 0 | 542 | rcu_bh: qlen: 0 |
548 | 543 | ||
549 | This is split into rcu_preempt, rcu_sched, and rcu_bh sections, with the | 544 | This is split into rcu_sched and rcu_bh sections. The field is as |
550 | rcu_preempt section appearing only in CONFIG_TINY_PREEMPT_RCU builds. | 545 | follows: |
551 | The last three lines of the rcu_preempt section appear only in | ||
552 | CONFIG_RCU_BOOST kernel builds. The fields are as follows: | ||
553 | 546 | ||
554 | o "qlen" is the number of RCU callbacks currently waiting either | 547 | o "qlen" is the number of RCU callbacks currently waiting either |
555 | for an RCU grace period or waiting to be invoked. This is the | 548 | for an RCU grace period or waiting to be invoked. This is the |
556 | only field present for rcu_sched and rcu_bh, due to the | 549 | only field present for rcu_sched and rcu_bh, due to the |
557 | short-circuiting of grace period in those two cases. | 550 | short-circuiting of grace period in those two cases. |
558 | |||
559 | o "gp" is the number of grace periods that have completed. | ||
560 | |||
561 | o "g197/p197/c197" displays the grace-period state, with the | ||
562 | "g" number being the number of grace periods that have started | ||
563 | (mod 256), the "p" number being the number of grace periods | ||
564 | that the CPU has responded to (also mod 256), and the "c" | ||
565 | number being the number of grace periods that have completed | ||
566 | (once again mode 256). | ||
567 | |||
568 | Why have both "gp" and "g"? Because the data flowing into | ||
569 | "gp" is only present in a CONFIG_RCU_TRACE kernel. | ||
570 | |||
571 | o "tasks" is a set of bits. The first bit is "T" if there are | ||
572 | currently tasks that have recently blocked within an RCU | ||
573 | read-side critical section, the second bit is "N" if any of the | ||
574 | aforementioned tasks are blocking the current RCU grace period, | ||
575 | and the third bit is "E" if any of the aforementioned tasks are | ||
576 | blocking the current expedited grace period. Each bit is "." | ||
577 | if the corresponding condition does not hold. | ||
578 | |||
579 | o "ttb" is a single bit. It is "B" if any of the blocked tasks | ||
580 | need to be priority boosted and "." otherwise. | ||
581 | |||
582 | o "btg" indicates whether boosting has been carried out during | ||
583 | the current grace period, with "exp" indicating that boosting | ||
584 | is in progress for an expedited grace period, "no" indicating | ||
585 | that boosting has not yet started for a normal grace period, | ||
586 | "begun" indicating that boosting has bebug for a normal grace | ||
587 | period, and "done" indicating that boosting has completed for | ||
588 | a normal grace period. | ||
589 | |||
590 | o "ntb" is the total number of tasks subjected to RCU priority boosting | ||
591 | periods since boot. | ||
592 | |||
593 | o "neb" is the number of expedited grace periods that have had | ||
594 | to resort to RCU priority boosting since boot. | ||
595 | |||
596 | o "nnb" is the number of normal grace periods that have had | ||
597 | to resort to RCU priority boosting since boot. | ||
598 | |||
599 | o "j" is the low-order 16 bits of the jiffies counter in hexadecimal. | ||
600 | |||
601 | o "bt" is the low-order 16 bits of the value that the jiffies counter | ||
602 | will have at the next time that boosting is scheduled to begin. | ||
603 | |||
604 | o In the line beginning with "normal balk", the fields are as follows: | ||
605 | |||
606 | o "nt" is the number of times that the system balked from | ||
607 | boosting because there were no blocked tasks to boost. | ||
608 | Note that the system will balk from boosting even if the | ||
609 | grace period is overdue when the currently running task | ||
610 | is looping within an RCU read-side critical section. | ||
611 | There is no point in boosting in this case, because | ||
612 | boosting a running task won't make it run any faster. | ||
613 | |||
614 | o "gt" is the number of times that the system balked | ||
615 | from boosting because, although there were blocked tasks, | ||
616 | none of them were preventing the current grace period | ||
617 | from completing. | ||
618 | |||
619 | o "bt" is the number of times that the system balked | ||
620 | from boosting because boosting was already in progress. | ||
621 | |||
622 | o "b" is the number of times that the system balked from | ||
623 | boosting because boosting had already completed for | ||
624 | the grace period in question. | ||
625 | |||
626 | o "ny" is the number of times that the system balked from | ||
627 | boosting because it was not yet time to start boosting | ||
628 | the grace period in question. | ||
629 | |||
630 | o "nos" is the number of times that the system balked from | ||
631 | boosting for inexplicable ("not otherwise specified") | ||
632 | reasons. This can actually happen due to races involving | ||
633 | increments of the jiffies counter. | ||
634 | |||
635 | o In the line beginning with "exp balk", the fields are as follows: | ||
636 | |||
637 | o "bt" is the number of times that the system balked from | ||
638 | boosting because there were no blocked tasks to boost. | ||
639 | |||
640 | o "nos" is the number of times that the system balked from | ||
641 | boosting for inexplicable ("not otherwise specified") | ||
642 | reasons. | ||