Skip to content

Commit b1326d7

Browse files
paulmckrcuFrederic Weisbecker
authored andcommitted
doc: Catch-up update for locktorture module parameters
This commit documents recently added locktorture module parameters. Signed-off-by: Paul E. McKenney <paulmck@kernel.org> Cc: Joel Fernandes <joel@joelfernandes.org> Signed-off-by: Frederic Weisbecker <frederic@kernel.org>
1 parent 7f99362 commit b1326d7

File tree

1 file changed

+47
-3
lines changed

1 file changed

+47
-3
lines changed

Documentation/admin-guide/kernel-parameters.txt

Lines changed: 47 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2913,13 +2913,30 @@
29132913
to extract confidential information from the kernel
29142914
are also disabled.
29152915

2916+
locktorture.acq_writer_lim= [KNL]
2917+
Set the time limit in jiffies for a lock
2918+
acquisition. Acquisitions exceeding this limit
2919+
will result in a splat once they do complete.
2920+
29162921
locktorture.call_rcu_chains= [KNL]
29172922
Specify the number of self-propagating call_rcu()
29182923
chains to set up. These are used to ensure that
29192924
there is a high probability of an RCU grace period
29202925
in progress at any given time. Defaults to 0,
29212926
which disables these call_rcu() chains.
29222927

2928+
locktorture.long_hold= [KNL]
2929+
Specify the duration in milliseconds for the
2930+
occasional long-duration lock hold time. Defaults
2931+
to 100 milliseconds. Select 0 to disable.
2932+
2933+
locktorture.nested_locks= [KNL]
2934+
Specify the maximum lock nesting depth that
2935+
locktorture is to exercise, up to a limit of 8
2936+
(MAX_NESTED_LOCKS). Specify zero to disable.
2937+
Note that this parameter is ineffective on types
2938+
of locks that do not support nested acquisition.
2939+
29232940
locktorture.nreaders_stress= [KNL]
29242941
Set the number of locking read-acquisition kthreads.
29252942
Defaults to being automatically set based on the
@@ -2935,6 +2952,29 @@
29352952
Set time (s) between CPU-hotplug operations, or
29362953
zero to disable CPU-hotplug testing.
29372954

2955+
locktorture.readers_bind= [KNL]
2956+
Specify the list of CPUs to which the readers are
2957+
to be bound.
2958+
2959+
locktorture.rt_boost= [KNL]
2960+
Do periodic testing of real-time lock priority
2961+
boosting. Select 0 to disable, 1 to boost
2962+
only rt_mutex, and 2 to boost unconditionally.
2963+
Defaults to 2, which might seem to be an
2964+
odd choice, but which should be harmless for
2965+
non-real-time spinlocks, due to their disabling
2966+
of preemption. Note that non-realtime mutexes
2967+
disable boosting.
2968+
2969+
locktorture.rt_boost_factor= [KNL]
2970+
Number that determines how often and for how
2971+
long priority boosting is exercised. This is
2972+
scaled down by the number of writers, so that the
2973+
number of boosts per unit time remains roughly
2974+
constant as the number of writers increases.
2975+
On the other hand, the duration of each boost
2976+
increases with the number of writers.
2977+
29382978
locktorture.shuffle_interval= [KNL]
29392979
Set task-shuffle interval (jiffies). Shuffling
29402980
tasks allows some CPUs to go into dyntick-idle
@@ -2957,13 +2997,17 @@
29572997
locktorture.torture_type= [KNL]
29582998
Specify the locking implementation to test.
29592999

3000+
locktorture.verbose= [KNL]
3001+
Enable additional printk() statements.
3002+
3003+
locktorture.writers_bind= [KNL]
3004+
Specify the list of CPUs to which the writers are
3005+
to be bound.
3006+
29603007
locktorture.writer_fifo= [KNL]
29613008
Run the write-side locktorture kthreads at
29623009
sched_set_fifo() real-time priority.
29633010

2964-
locktorture.verbose= [KNL]
2965-
Enable additional printk() statements.
2966-
29673011
logibm.irq= [HW,MOUSE] Logitech Bus Mouse Driver
29683012
Format: <irq>
29693013

0 commit comments

Comments
 (0)