diff options
author | Paul E. McKenney <paulmck@linux.vnet.ibm.com> | 2013-10-08 23:23:47 -0400 |
---|---|---|
committer | Paul E. McKenney <paulmck@linux.vnet.ibm.com> | 2013-10-15 15:53:31 -0400 |
commit | 4102adab9189c8ea2f0cdd2f88345fd25d2790f1 (patch) | |
tree | 235964cfd9c09a5c642a2d0d8745a651a0d4bcfa /Documentation/kernel-parameters.txt | |
parent | 252997330908cb8ee3d5714539ed967b977c2eae (diff) |
rcu: Move RCU-related source code to kernel/rcu directory
Signed-off-by: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
Reviewed-by: Ingo Molnar <mingo@kernel.org>
Diffstat (limited to 'Documentation/kernel-parameters.txt')
-rw-r--r-- | Documentation/kernel-parameters.txt | 95 |
1 files changed, 57 insertions, 38 deletions
diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt index 1a036cd972fb..c3dc13e90a40 100644 --- a/Documentation/kernel-parameters.txt +++ b/Documentation/kernel-parameters.txt | |||
@@ -2595,7 +2595,7 @@ bytes respectively. Such letter suffixes can also be entirely omitted. | |||
2595 | ramdisk_size= [RAM] Sizes of RAM disks in kilobytes | 2595 | ramdisk_size= [RAM] Sizes of RAM disks in kilobytes |
2596 | See Documentation/blockdev/ramdisk.txt. | 2596 | See Documentation/blockdev/ramdisk.txt. |
2597 | 2597 | ||
2598 | rcu_nocbs= [KNL,BOOT] | 2598 | rcu_nocbs= [KNL] |
2599 | In kernels built with CONFIG_RCU_NOCB_CPU=y, set | 2599 | In kernels built with CONFIG_RCU_NOCB_CPU=y, set |
2600 | the specified list of CPUs to be no-callback CPUs. | 2600 | the specified list of CPUs to be no-callback CPUs. |
2601 | Invocation of these CPUs' RCU callbacks will | 2601 | Invocation of these CPUs' RCU callbacks will |
@@ -2608,7 +2608,7 @@ bytes respectively. Such letter suffixes can also be entirely omitted. | |||
2608 | real-time workloads. It can also improve energy | 2608 | real-time workloads. It can also improve energy |
2609 | efficiency for asymmetric multiprocessors. | 2609 | efficiency for asymmetric multiprocessors. |
2610 | 2610 | ||
2611 | rcu_nocb_poll [KNL,BOOT] | 2611 | rcu_nocb_poll [KNL] |
2612 | Rather than requiring that offloaded CPUs | 2612 | Rather than requiring that offloaded CPUs |
2613 | (specified by rcu_nocbs= above) explicitly | 2613 | (specified by rcu_nocbs= above) explicitly |
2614 | awaken the corresponding "rcuoN" kthreads, | 2614 | awaken the corresponding "rcuoN" kthreads, |
@@ -2619,126 +2619,145 @@ bytes respectively. Such letter suffixes can also be entirely omitted. | |||
2619 | energy efficiency by requiring that the kthreads | 2619 | energy efficiency by requiring that the kthreads |
2620 | periodically wake up to do the polling. | 2620 | periodically wake up to do the polling. |
2621 | 2621 | ||
2622 | rcutree.blimit= [KNL,BOOT] | 2622 | rcutree.blimit= [KNL] |
2623 | Set maximum number of finished RCU callbacks to process | 2623 | Set maximum number of finished RCU callbacks to process |
2624 | in one batch. | 2624 | in one batch. |
2625 | 2625 | ||
2626 | rcutree.fanout_leaf= [KNL,BOOT] | 2626 | rcutree.rcu_fanout_leaf= [KNL] |
2627 | Increase the number of CPUs assigned to each | 2627 | Increase the number of CPUs assigned to each |
2628 | leaf rcu_node structure. Useful for very large | 2628 | leaf rcu_node structure. Useful for very large |
2629 | systems. | 2629 | systems. |
2630 | 2630 | ||
2631 | rcutree.jiffies_till_first_fqs= [KNL,BOOT] | 2631 | rcutree.jiffies_till_first_fqs= [KNL] |
2632 | Set delay from grace-period initialization to | 2632 | Set delay from grace-period initialization to |
2633 | first attempt to force quiescent states. | 2633 | first attempt to force quiescent states. |
2634 | Units are jiffies, minimum value is zero, | 2634 | Units are jiffies, minimum value is zero, |
2635 | and maximum value is HZ. | 2635 | and maximum value is HZ. |
2636 | 2636 | ||
2637 | rcutree.jiffies_till_next_fqs= [KNL,BOOT] | 2637 | rcutree.jiffies_till_next_fqs= [KNL] |
2638 | Set delay between subsequent attempts to force | 2638 | Set delay between subsequent attempts to force |
2639 | quiescent states. Units are jiffies, minimum | 2639 | quiescent states. Units are jiffies, minimum |
2640 | value is one, and maximum value is HZ. | 2640 | value is one, and maximum value is HZ. |
2641 | 2641 | ||
2642 | rcutree.qhimark= [KNL,BOOT] | 2642 | rcutree.qhimark= [KNL] |
2643 | Set threshold of queued | 2643 | Set threshold of queued |
2644 | RCU callbacks over which batch limiting is disabled. | 2644 | RCU callbacks over which batch limiting is disabled. |
2645 | 2645 | ||
2646 | rcutree.qlowmark= [KNL,BOOT] | 2646 | rcutree.qlowmark= [KNL] |
2647 | Set threshold of queued RCU callbacks below which | 2647 | Set threshold of queued RCU callbacks below which |
2648 | batch limiting is re-enabled. | 2648 | batch limiting is re-enabled. |
2649 | 2649 | ||
2650 | rcutree.rcu_cpu_stall_suppress= [KNL,BOOT] | 2650 | rcutree.rcu_idle_gp_delay= [KNL] |
2651 | Suppress RCU CPU stall warning messages. | ||
2652 | |||
2653 | rcutree.rcu_cpu_stall_timeout= [KNL,BOOT] | ||
2654 | Set timeout for RCU CPU stall warning messages. | ||
2655 | |||
2656 | rcutree.rcu_idle_gp_delay= [KNL,BOOT] | ||
2657 | Set wakeup interval for idle CPUs that have | 2651 | Set wakeup interval for idle CPUs that have |
2658 | RCU callbacks (RCU_FAST_NO_HZ=y). | 2652 | RCU callbacks (RCU_FAST_NO_HZ=y). |
2659 | 2653 | ||
2660 | rcutree.rcu_idle_lazy_gp_delay= [KNL,BOOT] | 2654 | rcutree.rcu_idle_lazy_gp_delay= [KNL] |
2661 | Set wakeup interval for idle CPUs that have | 2655 | Set wakeup interval for idle CPUs that have |
2662 | only "lazy" RCU callbacks (RCU_FAST_NO_HZ=y). | 2656 | only "lazy" RCU callbacks (RCU_FAST_NO_HZ=y). |
2663 | Lazy RCU callbacks are those which RCU can | 2657 | Lazy RCU callbacks are those which RCU can |
2664 | prove do nothing more than free memory. | 2658 | prove do nothing more than free memory. |
2665 | 2659 | ||
2666 | rcutorture.fqs_duration= [KNL,BOOT] | 2660 | rcutorture.fqs_duration= [KNL] |
2667 | Set duration of force_quiescent_state bursts. | 2661 | Set duration of force_quiescent_state bursts. |
2668 | 2662 | ||
2669 | rcutorture.fqs_holdoff= [KNL,BOOT] | 2663 | rcutorture.fqs_holdoff= [KNL] |
2670 | Set holdoff time within force_quiescent_state bursts. | 2664 | Set holdoff time within force_quiescent_state bursts. |
2671 | 2665 | ||
2672 | rcutorture.fqs_stutter= [KNL,BOOT] | 2666 | rcutorture.fqs_stutter= [KNL] |
2673 | Set wait time between force_quiescent_state bursts. | 2667 | Set wait time between force_quiescent_state bursts. |
2674 | 2668 | ||
2675 | rcutorture.irqreader= [KNL,BOOT] | 2669 | rcutorture.gp_exp= [KNL] |
2676 | Test RCU readers from irq handlers. | 2670 | Use expedited update-side primitives. |
2671 | |||
2672 | rcutorture.gp_normal= [KNL] | ||
2673 | Use normal (non-expedited) update-side primitives. | ||
2674 | If both gp_exp and gp_normal are set, do both. | ||
2675 | If neither gp_exp nor gp_normal are set, still | ||
2676 | do both. | ||
2677 | 2677 | ||
2678 | rcutorture.n_barrier_cbs= [KNL,BOOT] | 2678 | rcutorture.n_barrier_cbs= [KNL] |
2679 | Set callbacks/threads for rcu_barrier() testing. | 2679 | Set callbacks/threads for rcu_barrier() testing. |
2680 | 2680 | ||
2681 | rcutorture.nfakewriters= [KNL,BOOT] | 2681 | rcutorture.nfakewriters= [KNL] |
2682 | Set number of concurrent RCU writers. These just | 2682 | Set number of concurrent RCU writers. These just |
2683 | stress RCU, they don't participate in the actual | 2683 | stress RCU, they don't participate in the actual |
2684 | test, hence the "fake". | 2684 | test, hence the "fake". |
2685 | 2685 | ||
2686 | rcutorture.nreaders= [KNL,BOOT] | 2686 | rcutorture.nreaders= [KNL] |
2687 | Set number of RCU readers. | 2687 | Set number of RCU readers. |
2688 | 2688 | ||
2689 | rcutorture.onoff_holdoff= [KNL,BOOT] | 2689 | rcutorture.object_debug= [KNL] |
2690 | Enable debug-object double-call_rcu() testing. | ||
2691 | |||
2692 | rcutorture.onoff_holdoff= [KNL] | ||
2690 | Set time (s) after boot for CPU-hotplug testing. | 2693 | Set time (s) after boot for CPU-hotplug testing. |
2691 | 2694 | ||
2692 | rcutorture.onoff_interval= [KNL,BOOT] | 2695 | rcutorture.onoff_interval= [KNL] |
2693 | Set time (s) between CPU-hotplug operations, or | 2696 | Set time (s) between CPU-hotplug operations, or |
2694 | zero to disable CPU-hotplug testing. | 2697 | zero to disable CPU-hotplug testing. |
2695 | 2698 | ||
2696 | rcutorture.shuffle_interval= [KNL,BOOT] | 2699 | rcutorture.rcutorture_runnable= [BOOT] |
2700 | Start rcutorture running at boot time. | ||
2701 | |||
2702 | rcutorture.shuffle_interval= [KNL] | ||
2697 | Set task-shuffle interval (s). Shuffling tasks | 2703 | Set task-shuffle interval (s). Shuffling tasks |
2698 | allows some CPUs to go into dyntick-idle mode | 2704 | allows some CPUs to go into dyntick-idle mode |
2699 | during the rcutorture test. | 2705 | during the rcutorture test. |
2700 | 2706 | ||
2701 | rcutorture.shutdown_secs= [KNL,BOOT] | 2707 | rcutorture.shutdown_secs= [KNL] |
2702 | Set time (s) after boot system shutdown. This | 2708 | Set time (s) after boot system shutdown. This |
2703 | is useful for hands-off automated testing. | 2709 | is useful for hands-off automated testing. |
2704 | 2710 | ||
2705 | rcutorture.stall_cpu= [KNL,BOOT] | 2711 | rcutorture.stall_cpu= [KNL] |
2706 | Duration of CPU stall (s) to test RCU CPU stall | 2712 | Duration of CPU stall (s) to test RCU CPU stall |
2707 | warnings, zero to disable. | 2713 | warnings, zero to disable. |
2708 | 2714 | ||
2709 | rcutorture.stall_cpu_holdoff= [KNL,BOOT] | 2715 | rcutorture.stall_cpu_holdoff= [KNL] |
2710 | Time to wait (s) after boot before inducing stall. | 2716 | Time to wait (s) after boot before inducing stall. |
2711 | 2717 | ||
2712 | rcutorture.stat_interval= [KNL,BOOT] | 2718 | rcutorture.stat_interval= [KNL] |
2713 | Time (s) between statistics printk()s. | 2719 | Time (s) between statistics printk()s. |
2714 | 2720 | ||
2715 | rcutorture.stutter= [KNL,BOOT] | 2721 | rcutorture.stutter= [KNL] |
2716 | Time (s) to stutter testing, for example, specifying | 2722 | Time (s) to stutter testing, for example, specifying |
2717 | five seconds causes the test to run for five seconds, | 2723 | five seconds causes the test to run for five seconds, |
2718 | wait for five seconds, and so on. This tests RCU's | 2724 | wait for five seconds, and so on. This tests RCU's |
2719 | ability to transition abruptly to and from idle. | 2725 | ability to transition abruptly to and from idle. |
2720 | 2726 | ||
2721 | rcutorture.test_boost= [KNL,BOOT] | 2727 | rcutorture.test_boost= [KNL] |
2722 | Test RCU priority boosting? 0=no, 1=maybe, 2=yes. | 2728 | Test RCU priority boosting? 0=no, 1=maybe, 2=yes. |
2723 | "Maybe" means test if the RCU implementation | 2729 | "Maybe" means test if the RCU implementation |
2724 | under test support RCU priority boosting. | 2730 | under test support RCU priority boosting. |
2725 | 2731 | ||
2726 | rcutorture.test_boost_duration= [KNL,BOOT] | 2732 | rcutorture.test_boost_duration= [KNL] |
2727 | Duration (s) of each individual boost test. | 2733 | Duration (s) of each individual boost test. |
2728 | 2734 | ||
2729 | rcutorture.test_boost_interval= [KNL,BOOT] | 2735 | rcutorture.test_boost_interval= [KNL] |
2730 | Interval (s) between each boost test. | 2736 | Interval (s) between each boost test. |
2731 | 2737 | ||
2732 | rcutorture.test_no_idle_hz= [KNL,BOOT] | 2738 | rcutorture.test_no_idle_hz= [KNL] |
2733 | Test RCU's dyntick-idle handling. See also the | 2739 | Test RCU's dyntick-idle handling. See also the |
2734 | rcutorture.shuffle_interval parameter. | 2740 | rcutorture.shuffle_interval parameter. |
2735 | 2741 | ||
2736 | rcutorture.torture_type= [KNL,BOOT] | 2742 | rcutorture.torture_type= [KNL] |
2737 | Specify the RCU implementation to test. | 2743 | Specify the RCU implementation to test. |
2738 | 2744 | ||
2739 | rcutorture.verbose= [KNL,BOOT] | 2745 | rcutorture.verbose= [KNL] |
2740 | Enable additional printk() statements. | 2746 | Enable additional printk() statements. |
2741 | 2747 | ||
2748 | rcupdate.rcu_expedited= [KNL] | ||
2749 | Use expedited grace-period primitives, for | ||
2750 | example, synchronize_rcu_expedited() instead | ||
2751 | of synchronize_rcu(). This reduces latency, | ||
2752 | but can increase CPU utilization, degrade | ||
2753 | real-time latency, and degrade energy efficiency. | ||
2754 | |||
2755 | rcupdate.rcu_cpu_stall_suppress= [KNL] | ||
2756 | Suppress RCU CPU stall warning messages. | ||
2757 | |||
2758 | rcupdate.rcu_cpu_stall_timeout= [KNL] | ||
2759 | Set timeout for RCU CPU stall warning messages. | ||
2760 | |||
2742 | rdinit= [KNL] | 2761 | rdinit= [KNL] |
2743 | Format: <full_path> | 2762 | Format: <full_path> |
2744 | Run specified binary instead of /init from the ramdisk, | 2763 | Run specified binary instead of /init from the ramdisk, |