Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

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>

authored by

Randy Dunlap and committed by
Joel Fernandes (Google)
c4af9e00 754aa642

+14 -14
+3 -3
Documentation/RCU/Design/Expedited-Grace-Periods/Expedited-Grace-Periods.rst
··· 277 277 278 278 Again, only one request in a given batch need actually carry out a 279 279 grace-period operation, which means there must be an efficient way to 280 - identify which of many concurrent reqeusts will initiate the grace 280 + identify which of many concurrent requests will initiate the grace 281 281 period, and that there be an efficient way for the remaining requests to 282 282 wait for that grace period to complete. However, that is the topic of 283 283 the next section. ··· 405 405 In earlier implementations, the task requesting the expedited grace 406 406 period also drove it to completion. This straightforward approach had 407 407 the disadvantage of needing to account for POSIX signals sent to user 408 - tasks, so more recent implemementations use the Linux kernel's 408 + tasks, so more recent implementations use the Linux kernel's 409 409 workqueues (see Documentation/core-api/workqueue.rst). 410 410 411 411 The requesting task still does counter snapshotting and funnel-lock ··· 465 465 initialized, which does not happen until some time after the scheduler 466 466 spawns the first task. Given that there are parts of the kernel that 467 467 really do want to execute grace periods during this mid-boot “dead 468 - zone”, expedited grace periods must do something else during thie time. 468 + zone”, expedited grace periods must do something else during this time. 469 469 470 470 What they do is to fall back to the old practice of requiring that the 471 471 requesting task drive the expedited grace period, as was the case before
+1 -1
Documentation/RCU/Design/Memory-Ordering/Tree-RCU-Memory-Ordering.rst
··· 168 168 +-----------------------------------------------------------------------+ 169 169 170 170 The approach must be extended to handle one final case, that of waking a 171 - task blocked in ``synchronize_rcu()``. This task might be affinitied to 171 + task blocked in ``synchronize_rcu()``. This task might be affined to 172 172 a CPU that is not yet aware that the grace period has ended, and thus 173 173 might not yet be subject to the grace period's memory ordering. 174 174 Therefore, there is an ``smp_mb()`` after the return from
+5 -5
Documentation/RCU/RTFP.txt
··· 201 201 In 2012, Josh Triplett received his Ph.D. with his dissertation 202 202 covering RCU-protected resizable hash tables and the relationship 203 203 between memory barriers and read-side traversal order: If the updater 204 - is making changes in the opposite direction from the read-side traveral 204 + is making changes in the opposite direction from the read-side traversal 205 205 order, the updater need only execute a memory-barrier instruction, 206 206 but if in the same direction, the updater needs to wait for a grace 207 207 period between the individual updates [JoshTriplettPhD]. Also in 2012, ··· 1245 1245 [Viewed September 5, 2005]" 1246 1246 ,annotation={ 1247 1247 First posting showing how RCU can be safely adapted for 1248 - preemptable RCU read side critical sections. 1248 + preemptible RCU read side critical sections. 1249 1249 } 1250 1250 } 1251 1251 ··· 1888 1888 \url{https://lore.kernel.org/r/20070910183004.GA3299@linux.vnet.ibm.com} 1889 1889 [Viewed October 25, 2007]" 1890 1890 ,annotation={ 1891 - Final patch for preemptable RCU to -rt. (Later patches were 1891 + Final patch for preemptible RCU to -rt. (Later patches were 1892 1892 to mainline, eventually incorporated.) 1893 1893 } 1894 1894 } ··· 2275 2275 \url{https://lore.kernel.org/r/20090724001429.GA17374@linux.vnet.ibm.com} 2276 2276 [Viewed August 15, 2009]" 2277 2277 ,annotation={ 2278 - First posting of simple and fast preemptable RCU. 2278 + First posting of simple and fast preemptible RCU. 2279 2279 } 2280 2280 } 2281 2281 ··· 2639 2639 RCU-protected hash tables, barriers vs. read-side traversal order. 2640 2640 . 2641 2641 If the updater is making changes in the opposite direction from 2642 - the read-side traveral order, the updater need only execute a 2642 + the read-side traversal order, the updater need only execute a 2643 2643 memory-barrier instruction, but if in the same direction, the 2644 2644 updater needs to wait for a grace period between the individual 2645 2645 updates.
+2 -2
Documentation/RCU/UP.rst
··· 107 107 108 108 Quick Quiz #3: 109 109 Why can't synchronize_rcu() return immediately on UP systems running 110 - preemptable RCU? 110 + preemptible RCU? 111 111 112 112 .. _answer_quick_quiz_up: 113 113 ··· 143 143 144 144 Answer to Quick Quiz #3: 145 145 Why can't synchronize_rcu() return immediately on UP systems 146 - running preemptable RCU? 146 + running preemptible RCU? 147 147 148 148 Because some other task might have been preempted in the middle 149 149 of an RCU read-side critical section. If synchronize_rcu()
+1 -1
Documentation/RCU/lockdep.rst
··· 65 65 rcu_access_pointer(p): 66 66 Return the value of the pointer and omit all barriers, 67 67 but retain the compiler constraints that prevent duplicating 68 - or coalescsing. This is useful when testing the 68 + or coalescing. This is useful when testing the 69 69 value of the pointer itself, for example, against NULL. 70 70 71 71 The rcu_dereference_check() check expression can be any boolean
+2 -2
Documentation/RCU/torture.rst
··· 216 216 rcutorture's module parameters. For example, to test a change to RCU's 217 217 CPU stall-warning code, use "--bootargs 'rcutorture.stall_cpu=30'". 218 218 This will of course result in the scripting reporting a failure, namely 219 - the resuling RCU CPU stall warning. As noted above, reducing memory may 219 + the resulting RCU CPU stall warning. As noted above, reducing memory may 220 220 require disabling rcutorture's callback-flooding tests:: 221 221 222 222 kvm.sh --cpus 448 --configs '56*TREE04' --memory 128M \ ··· 370 370 tools/testing/selftests/rcutorture/res/2022.11.03-11.26.28-remote \ 371 371 --duration 24h 372 372 373 - In this case, most of the kvm-again.sh parmeters may be supplied following 373 + In this case, most of the kvm-again.sh parameters may be supplied following 374 374 the pathname of the old run-results directory.