mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-04 18:09:57 +00:00
![Paul E. McKenney](/assets/img/avatar_default.png)
There is a need for a polling interface for SRCU grace periods, so this commit supplies get_state_synchronize_srcu(), start_poll_synchronize_srcu(), and poll_state_synchronize_srcu() for this purpose. The first can be used if future grace periods are inevitable (perhaps due to a later call_srcu() invocation), the second if future grace periods might not otherwise happen, and the third to check if a grace period has elapsed since the corresponding call to either of the first two. As with get_state_synchronize_rcu() and cond_synchronize_rcu(), the return value from either get_state_synchronize_srcu() or start_poll_synchronize_srcu() must be passed in to a later call to poll_state_synchronize_srcu(). Link: https://lore.kernel.org/rcu/20201112201547.GF3365678@moria.home.lan/ Reported-by: Kent Overstreet <kent.overstreet@gmail.com> [ paulmck: Add EXPORT_SYMBOL_GPL() per kernel test robot feedback. ] [ paulmck: Apply feedback from Neeraj Upadhyay. ] Link: https://lore.kernel.org/lkml/20201117004017.GA7444@paulmck-ThinkPad-P72/ Reviewed-by: Neeraj Upadhyay <neeraju@codeaurora.org> Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
91 lines
2.7 KiB
C
91 lines
2.7 KiB
C
/* SPDX-License-Identifier: GPL-2.0+ */
|
|
/*
|
|
* Sleepable Read-Copy Update mechanism for mutual exclusion,
|
|
* tiny variant.
|
|
*
|
|
* Copyright (C) IBM Corporation, 2017
|
|
*
|
|
* Author: Paul McKenney <paulmck@linux.ibm.com>
|
|
*/
|
|
|
|
#ifndef _LINUX_SRCU_TINY_H
|
|
#define _LINUX_SRCU_TINY_H
|
|
|
|
#include <linux/swait.h>
|
|
|
|
struct srcu_struct {
|
|
short srcu_lock_nesting[2]; /* srcu_read_lock() nesting depth. */
|
|
unsigned short srcu_idx; /* Current reader array element in bit 0x2. */
|
|
unsigned short srcu_idx_max; /* Furthest future srcu_idx request. */
|
|
u8 srcu_gp_running; /* GP workqueue running? */
|
|
u8 srcu_gp_waiting; /* GP waiting for readers? */
|
|
struct swait_queue_head srcu_wq;
|
|
/* Last srcu_read_unlock() wakes GP. */
|
|
struct rcu_head *srcu_cb_head; /* Pending callbacks: Head. */
|
|
struct rcu_head **srcu_cb_tail; /* Pending callbacks: Tail. */
|
|
struct work_struct srcu_work; /* For driving grace periods. */
|
|
#ifdef CONFIG_DEBUG_LOCK_ALLOC
|
|
struct lockdep_map dep_map;
|
|
#endif /* #ifdef CONFIG_DEBUG_LOCK_ALLOC */
|
|
};
|
|
|
|
void srcu_drive_gp(struct work_struct *wp);
|
|
|
|
#define __SRCU_STRUCT_INIT(name, __ignored) \
|
|
{ \
|
|
.srcu_wq = __SWAIT_QUEUE_HEAD_INITIALIZER(name.srcu_wq), \
|
|
.srcu_cb_tail = &name.srcu_cb_head, \
|
|
.srcu_work = __WORK_INITIALIZER(name.srcu_work, srcu_drive_gp), \
|
|
__SRCU_DEP_MAP_INIT(name) \
|
|
}
|
|
|
|
/*
|
|
* This odd _STATIC_ arrangement is needed for API compatibility with
|
|
* Tree SRCU, which needs some per-CPU data.
|
|
*/
|
|
#define DEFINE_SRCU(name) \
|
|
struct srcu_struct name = __SRCU_STRUCT_INIT(name, name)
|
|
#define DEFINE_STATIC_SRCU(name) \
|
|
static struct srcu_struct name = __SRCU_STRUCT_INIT(name, name)
|
|
|
|
void synchronize_srcu(struct srcu_struct *ssp);
|
|
|
|
/*
|
|
* Counts the new reader in the appropriate per-CPU element of the
|
|
* srcu_struct. Can be invoked from irq/bh handlers, but the matching
|
|
* __srcu_read_unlock() must be in the same handler instance. Returns an
|
|
* index that must be passed to the matching srcu_read_unlock().
|
|
*/
|
|
static inline int __srcu_read_lock(struct srcu_struct *ssp)
|
|
{
|
|
int idx;
|
|
|
|
idx = ((READ_ONCE(ssp->srcu_idx) + 1) & 0x2) >> 1;
|
|
WRITE_ONCE(ssp->srcu_lock_nesting[idx], ssp->srcu_lock_nesting[idx] + 1);
|
|
return idx;
|
|
}
|
|
|
|
static inline void synchronize_srcu_expedited(struct srcu_struct *ssp)
|
|
{
|
|
synchronize_srcu(ssp);
|
|
}
|
|
|
|
static inline void srcu_barrier(struct srcu_struct *ssp)
|
|
{
|
|
synchronize_srcu(ssp);
|
|
}
|
|
|
|
/* Defined here to avoid size increase for non-torture kernels. */
|
|
static inline void srcu_torture_stats_print(struct srcu_struct *ssp,
|
|
char *tt, char *tf)
|
|
{
|
|
int idx;
|
|
|
|
idx = ((READ_ONCE(ssp->srcu_idx) + 1) & 0x2) >> 1;
|
|
pr_alert("%s%s Tiny SRCU per-CPU(idx=%d): (%hd,%hd)\n",
|
|
tt, tf, idx,
|
|
READ_ONCE(ssp->srcu_lock_nesting[!idx]),
|
|
READ_ONCE(ssp->srcu_lock_nesting[idx]));
|
|
}
|
|
|
|
#endif
|