mirror of
https://github.com/torvalds/linux.git
synced 2024-11-21 19:41:42 +00:00
Documentation: RCU: Correct spelling
Correct spelling problems for Documentation/RCU/ as reported by codespell. Note: in RTFP.txt, there are other misspellings that are left as is since they were used that way in email Subject: lines or in LWN.net articles. [preemptable, Preemptable, synchonisation] Acked-by: Joel Fernandes (Google) <joel@joelfernandes.org> Signed-off-by: Randy Dunlap <rdunlap@infradead.org> Cc: Jonathan Corbet <corbet@lwn.net> Cc: linux-doc@vger.kernel.org Cc: "Paul E. McKenney" <paulmck@kernel.org> Cc: Frederic Weisbecker <frederic@kernel.org> Cc: Neeraj Upadhyay <quic_neeraju@quicinc.com> Cc: Josh Triplett <josh@joshtriplett.org> Cc: rcu@vger.kernel.org Signed-off-by: Paul E. McKenney <paulmck@kernel.org> Signed-off-by: Joel Fernandes (Google) <joel@joelfernandes.org>
This commit is contained in:
parent
754aa6427e
commit
c4af9e0089
@ -277,7 +277,7 @@ the following access functions:
|
|||||||
|
|
||||||
Again, only one request in a given batch need actually carry out a
|
Again, only one request in a given batch need actually carry out a
|
||||||
grace-period operation, which means there must be an efficient way to
|
grace-period operation, which means there must be an efficient way to
|
||||||
identify which of many concurrent reqeusts will initiate the grace
|
identify which of many concurrent requests will initiate the grace
|
||||||
period, and that there be an efficient way for the remaining requests to
|
period, and that there be an efficient way for the remaining requests to
|
||||||
wait for that grace period to complete. However, that is the topic of
|
wait for that grace period to complete. However, that is the topic of
|
||||||
the next section.
|
the next section.
|
||||||
@ -405,7 +405,7 @@ Use of Workqueues
|
|||||||
In earlier implementations, the task requesting the expedited grace
|
In earlier implementations, the task requesting the expedited grace
|
||||||
period also drove it to completion. This straightforward approach had
|
period also drove it to completion. This straightforward approach had
|
||||||
the disadvantage of needing to account for POSIX signals sent to user
|
the disadvantage of needing to account for POSIX signals sent to user
|
||||||
tasks, so more recent implemementations use the Linux kernel's
|
tasks, so more recent implementations use the Linux kernel's
|
||||||
workqueues (see Documentation/core-api/workqueue.rst).
|
workqueues (see Documentation/core-api/workqueue.rst).
|
||||||
|
|
||||||
The requesting task still does counter snapshotting and funnel-lock
|
The requesting task still does counter snapshotting and funnel-lock
|
||||||
@ -465,7 +465,7 @@ corresponding disadvantage that workqueues cannot be used until they are
|
|||||||
initialized, which does not happen until some time after the scheduler
|
initialized, which does not happen until some time after the scheduler
|
||||||
spawns the first task. Given that there are parts of the kernel that
|
spawns the first task. Given that there are parts of the kernel that
|
||||||
really do want to execute grace periods during this mid-boot “dead
|
really do want to execute grace periods during this mid-boot “dead
|
||||||
zone”, expedited grace periods must do something else during thie time.
|
zone”, expedited grace periods must do something else during this time.
|
||||||
|
|
||||||
What they do is to fall back to the old practice of requiring that the
|
What they do is to fall back to the old practice of requiring that the
|
||||||
requesting task drive the expedited grace period, as was the case before
|
requesting task drive the expedited grace period, as was the case before
|
||||||
|
@ -168,7 +168,7 @@ an ``atomic_add_return()`` of zero) to detect idle CPUs.
|
|||||||
+-----------------------------------------------------------------------+
|
+-----------------------------------------------------------------------+
|
||||||
|
|
||||||
The approach must be extended to handle one final case, that of waking a
|
The approach must be extended to handle one final case, that of waking a
|
||||||
task blocked in ``synchronize_rcu()``. This task might be affinitied to
|
task blocked in ``synchronize_rcu()``. This task might be affined to
|
||||||
a CPU that is not yet aware that the grace period has ended, and thus
|
a CPU that is not yet aware that the grace period has ended, and thus
|
||||||
might not yet be subject to the grace period's memory ordering.
|
might not yet be subject to the grace period's memory ordering.
|
||||||
Therefore, there is an ``smp_mb()`` after the return from
|
Therefore, there is an ``smp_mb()`` after the return from
|
||||||
|
@ -201,7 +201,7 @@ work looked at debugging uses of RCU [Seyster:2011:RFA:2075416.2075425].
|
|||||||
In 2012, Josh Triplett received his Ph.D. with his dissertation
|
In 2012, Josh Triplett received his Ph.D. with his dissertation
|
||||||
covering RCU-protected resizable hash tables and the relationship
|
covering RCU-protected resizable hash tables and the relationship
|
||||||
between memory barriers and read-side traversal order: If the updater
|
between memory barriers and read-side traversal order: If the updater
|
||||||
is making changes in the opposite direction from the read-side traveral
|
is making changes in the opposite direction from the read-side traversal
|
||||||
order, the updater need only execute a memory-barrier instruction,
|
order, the updater need only execute a memory-barrier instruction,
|
||||||
but if in the same direction, the updater needs to wait for a grace
|
but if in the same direction, the updater needs to wait for a grace
|
||||||
period between the individual updates [JoshTriplettPhD]. Also in 2012,
|
period between the individual updates [JoshTriplettPhD]. Also in 2012,
|
||||||
@ -1245,7 +1245,7 @@ Oregon Health and Sciences University"
|
|||||||
[Viewed September 5, 2005]"
|
[Viewed September 5, 2005]"
|
||||||
,annotation={
|
,annotation={
|
||||||
First posting showing how RCU can be safely adapted for
|
First posting showing how RCU can be safely adapted for
|
||||||
preemptable RCU read side critical sections.
|
preemptible RCU read side critical sections.
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -1888,7 +1888,7 @@ Revised:
|
|||||||
\url{https://lore.kernel.org/r/20070910183004.GA3299@linux.vnet.ibm.com}
|
\url{https://lore.kernel.org/r/20070910183004.GA3299@linux.vnet.ibm.com}
|
||||||
[Viewed October 25, 2007]"
|
[Viewed October 25, 2007]"
|
||||||
,annotation={
|
,annotation={
|
||||||
Final patch for preemptable RCU to -rt. (Later patches were
|
Final patch for preemptible RCU to -rt. (Later patches were
|
||||||
to mainline, eventually incorporated.)
|
to mainline, eventually incorporated.)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -2275,7 +2275,7 @@ lot of {Linux} into your technology!!!"
|
|||||||
\url{https://lore.kernel.org/r/20090724001429.GA17374@linux.vnet.ibm.com}
|
\url{https://lore.kernel.org/r/20090724001429.GA17374@linux.vnet.ibm.com}
|
||||||
[Viewed August 15, 2009]"
|
[Viewed August 15, 2009]"
|
||||||
,annotation={
|
,annotation={
|
||||||
First posting of simple and fast preemptable RCU.
|
First posting of simple and fast preemptible RCU.
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -2639,7 +2639,7 @@ lot of {Linux} into your technology!!!"
|
|||||||
RCU-protected hash tables, barriers vs. read-side traversal order.
|
RCU-protected hash tables, barriers vs. read-side traversal order.
|
||||||
.
|
.
|
||||||
If the updater is making changes in the opposite direction from
|
If the updater is making changes in the opposite direction from
|
||||||
the read-side traveral order, the updater need only execute a
|
the read-side traversal order, the updater need only execute a
|
||||||
memory-barrier instruction, but if in the same direction, the
|
memory-barrier instruction, but if in the same direction, the
|
||||||
updater needs to wait for a grace period between the individual
|
updater needs to wait for a grace period between the individual
|
||||||
updates.
|
updates.
|
||||||
|
@ -107,7 +107,7 @@ UP systems, including PREEMPT SMP builds running on UP systems.
|
|||||||
|
|
||||||
Quick Quiz #3:
|
Quick Quiz #3:
|
||||||
Why can't synchronize_rcu() return immediately on UP systems running
|
Why can't synchronize_rcu() return immediately on UP systems running
|
||||||
preemptable RCU?
|
preemptible RCU?
|
||||||
|
|
||||||
.. _answer_quick_quiz_up:
|
.. _answer_quick_quiz_up:
|
||||||
|
|
||||||
@ -143,7 +143,7 @@ Answer to Quick Quiz #2:
|
|||||||
|
|
||||||
Answer to Quick Quiz #3:
|
Answer to Quick Quiz #3:
|
||||||
Why can't synchronize_rcu() return immediately on UP systems
|
Why can't synchronize_rcu() return immediately on UP systems
|
||||||
running preemptable RCU?
|
running preemptible RCU?
|
||||||
|
|
||||||
Because some other task might have been preempted in the middle
|
Because some other task might have been preempted in the middle
|
||||||
of an RCU read-side critical section. If synchronize_rcu()
|
of an RCU read-side critical section. If synchronize_rcu()
|
||||||
|
@ -65,7 +65,7 @@ checking of rcu_dereference() primitives:
|
|||||||
rcu_access_pointer(p):
|
rcu_access_pointer(p):
|
||||||
Return the value of the pointer and omit all barriers,
|
Return the value of the pointer and omit all barriers,
|
||||||
but retain the compiler constraints that prevent duplicating
|
but retain the compiler constraints that prevent duplicating
|
||||||
or coalescsing. This is useful when testing the
|
or coalescing. This is useful when testing the
|
||||||
value of the pointer itself, for example, against NULL.
|
value of the pointer itself, for example, against NULL.
|
||||||
|
|
||||||
The rcu_dereference_check() check expression can be any boolean
|
The rcu_dereference_check() check expression can be any boolean
|
||||||
|
@ -216,7 +216,7 @@ Kernel boot arguments can also be supplied, for example, to control
|
|||||||
rcutorture's module parameters. For example, to test a change to RCU's
|
rcutorture's module parameters. For example, to test a change to RCU's
|
||||||
CPU stall-warning code, use "--bootargs 'rcutorture.stall_cpu=30'".
|
CPU stall-warning code, use "--bootargs 'rcutorture.stall_cpu=30'".
|
||||||
This will of course result in the scripting reporting a failure, namely
|
This will of course result in the scripting reporting a failure, namely
|
||||||
the resuling RCU CPU stall warning. As noted above, reducing memory may
|
the resulting RCU CPU stall warning. As noted above, reducing memory may
|
||||||
require disabling rcutorture's callback-flooding tests::
|
require disabling rcutorture's callback-flooding tests::
|
||||||
|
|
||||||
kvm.sh --cpus 448 --configs '56*TREE04' --memory 128M \
|
kvm.sh --cpus 448 --configs '56*TREE04' --memory 128M \
|
||||||
@ -370,5 +370,5 @@ You can also re-run a previous remote run in a manner similar to kvm.sh:
|
|||||||
tools/testing/selftests/rcutorture/res/2022.11.03-11.26.28-remote \
|
tools/testing/selftests/rcutorture/res/2022.11.03-11.26.28-remote \
|
||||||
--duration 24h
|
--duration 24h
|
||||||
|
|
||||||
In this case, most of the kvm-again.sh parmeters may be supplied following
|
In this case, most of the kvm-again.sh parameters may be supplied following
|
||||||
the pathname of the old run-results directory.
|
the pathname of the old run-results directory.
|
||||||
|
Loading…
Reference in New Issue
Block a user