include/linux/rcupdate.h

112  * RCU_NONIDLE - Indicate idle-loop code that needs RCU readers
113  * @a: Code that RCU needs to pay attention to.
115  * RCU read-side critical sections are forbidden in the inner idle loop,
116  * that is, between the rcu_idle_enter() and the rcu_idle_exit() -- RCU
121  * will tell RCU that it needs to pay attention, invoke its argument
123  * and then tell RCU to go back to ignoring this CPU.  It is permissible
137  * Note a quasi-voluntary context switch for RCU-tasks's benefit.
193  * cond_resched_tasks_rcu_qs - Report potential quiescent states to RCU
196  * report potential quiescent states to RCU-tasks even if the cond_resched()
215 #error "Unknown RCU implementation specified to kernel configuration"
313 			 "Illegal context switch in RCU read-side critical section");  in rcu_preempt_sleep_check()
323 				 "Illegal context switch in RCU-bh read-side critical section"); \
325 				 "Illegal context switch in RCU-sched read-side critical section"); \
339  * multiple pointers markings to match different RCU implementations
378  * RCU_INITIALIZER() - statically initialize an RCU-protected global variable
384  * rcu_assign_pointer() - assign to RCU-protected pointer
388  * Assigns the specified value to the specified RCU-protected
389  * pointer, ensuring that any concurrent RCU readers will see
396  * will be dereferenced by RCU read-side code.
426  * rcu_replace_pointer() - replace an RCU pointer, returning its old value
427  * @rcu_ptr: RCU pointer, whose old value is returned
431  * Perform a replacement, where @rcu_ptr is an RCU-annotated
444  * rcu_access_pointer() - fetch RCU pointer with no dereferencing
447  * Return the value of the specified RCU-protected pointer, but omit the
448  * lockdep checks for being in an RCU read-side critical section.  This is
450  * not dereferenced, for example, when testing an RCU-protected pointer
457  * is the case in the context of the RCU callback that is freeing up
473  * An implicit check for being in an RCU read-side critical section
494  * which pointers are protected by RCU and checks that the pointer is
505  * This is the RCU-bh counterpart to rcu_dereference_check().
515  * This is the RCU-sched counterpart to rcu_dereference_check().
522  * The tracing infrastructure traces RCU (we want that), but unfortunately
523  * some of the RCU checks causes tracing to lock up the system.
531  * rcu_dereference_protected() - fetch RCU pointer when updates prevented
535  * Return the value of the specified RCU-protected pointer, but omit
551  * rcu_dereference() - fetch RCU-protected pointer for dereferencing
559  * rcu_dereference_bh() - fetch an RCU-bh-protected pointer for dereferencing
567  * rcu_dereference_sched() - fetch RCU-sched-protected pointer for dereferencing
575  * rcu_pointer_handoff() - Hand off a pointer from RCU to other mechanism
579  * is handed off from RCU to some other synchronization mechanism, for
597  * rcu_read_lock() - mark the beginning of an RCU read-side critical section
600  * are within RCU read-side critical sections, then the
603  * on one CPU while other CPUs are within RCU read-side critical
604  * sections, invocation of the corresponding RCU callback is deferred
607  * Note, however, that RCU callbacks are permitted to run concurrently
608  * with new RCU read-side critical sections.  One way that this can happen
609  * is via the following sequence of events: (1) CPU 0 enters an RCU
611  * an RCU callback, (3) CPU 0 exits the RCU read-side critical section,
612  * (4) CPU 2 enters a RCU read-side critical section, (5) the RCU
613  * callback is invoked.  This is legal, because the RCU read-side critical
615  * therefore might be referencing something that the corresponding RCU
617  * RCU callback is invoked.
619  * RCU read-side critical sections may be nested.  Any deferred actions
620  * will be deferred until the outermost RCU read-side critical section
624  * following this rule: don't put anything in an rcu_read_lock() RCU
628  * In non-preemptible RCU implementations (pure TREE_RCU and TINY_RCU),
629  * it is illegal to block while in an RCU read-side critical section.
630  * In preemptible RCU implementations (PREEMPT_RCU) in CONFIG_PREEMPTION
631  * kernel builds, RCU read-side critical sections may be preempted,
632  * but explicit blocking is illegal.  Finally, in preemptible RCU
633  * implementations in real-time (with -rt patchset) kernel builds, RCU
640 	__acquire(RCU);  in rcu_read_lock()
648  * way for writers to lock out RCU readers.  This is a feature, not
649  * a bug -- this property is what provides RCU's performance benefits.
652  * used as well.  RCU does not care how the writers keep out of each
657  * rcu_read_unlock() - marks the end of an RCU read-side critical section.
667  * That said, RCU readers are never priority boosted unless they were
669  * that preemption never happens within any RCU read-side critical
677  * that that preemption never happens within any RCU read-side critical
693 	__release(RCU);  in rcu_read_unlock()
699  * rcu_read_lock_bh() - mark the beginning of an RCU-bh critical section
703  * an RCU read-side critical section.
720  * rcu_read_unlock_bh() - marks the end of a softirq-only RCU critical section
734  * rcu_read_lock_sched() - mark the beginning of a RCU-sched critical section
762  * rcu_read_unlock_sched() - marks the end of a RCU-classic critical section
783  * RCU_INIT_POINTER() - initialize an RCU protected pointer
787  * Initialize an RCU-protected pointer in special cases where readers
793  *	RCU readers from concurrently accessing this pointer *or*
806  * will look OK in crash dumps, but any concurrent RCU readers might
810  * If you are creating an RCU-protected linked structure that is accessed
811  * by a single external-to-structure RCU-protected pointer, then you may
812  * use RCU_INIT_POINTER() to initialize the internal RCU-protected
827  * RCU_POINTER_INITIALIZER() - statically initialize an RCU protected pointer
831  * GCC-style initialization for an RCU-protected pointer in a structure field.
856  * Many rcu callbacks functions just call kfree() on the base structure.
964  * in an RCU read-side critical section that includes a read-side fetch