* [PATCH] doc: Update recent SRCU API additions to whatisRCU.rst
@ 2026-10-10 10:28 Zqiang
2026-10-11 0:15 ` Joel Fernandes
2026-10-14 3:28 ` KunWu Chan
0 siblings, 2 replies; 4+ messages in thread
From: Zqiang @ 2026-10-10 10:28 UTC (permalink / raw)
To: paulmck, frederic, neeraj.upadhyay, joelagnelf, urezki, boqun
Cc: qiang.zhang, kunwu.chan, rcu, linux-kernel
The commit 'dab06d6f9379 ("srcutree: Add an atomic Tree SRCU")'
introduces some new APIs:
srcu_read_lock_atomic
srcu_read_unlock_atomic
synchronize_srcu_atomic
DEFINE_SRCU_ATOMIC
DEFINE_STATIC_SRCU_ATOMIC
init_srcu_struct_atomic
This commit therefore update thems to whatisRCU.rst.
Signed-off-by: Zqiang <qiang.zhang@linux.dev>
---
Documentation/RCU/whatisRCU.rst | 7 ++++++-
1 file changed, 6 insertions(+), 1 deletion(-)
diff --git a/Documentation/RCU/whatisRCU.rst b/Documentation/RCU/whatisRCU.rst
index e6767baff2d3..75c50f2f6d79 100644
--- a/Documentation/RCU/whatisRCU.rst
+++ b/Documentation/RCU/whatisRCU.rst
@@ -1209,11 +1209,13 @@ SRCU::
srcu_read_lock_nmisafe start_poll_synchronize_srcu
srcu_read_unlock_nmisafe start_poll_synchronize_srcu_expedited
srcu_read_lock_notrace poll_state_synchronize_srcu
- srcu_read_unlock_notrace
+ srcu_read_unlock_notrace synchronize_srcu_atomic
srcu_down_read
srcu_up_read
srcu_down_read_fast
srcu_up_read_fast
+ srcu_read_lock_atomic
+ srcu_read_unlock_atomic
guard(srcu)()
scoped_guard(srcu)
srcu_read_lock_held
@@ -1229,8 +1231,11 @@ SRCU: Initialization/cleanup/ordering::
DEFINE_STATIC_SRCU
DEFINE_SRCU_FAST // for srcu_read_lock_fast() and friends
DEFINE_STATIC_SRCU_FAST // for srcu_read_lock_fast() and friends
+ DEFINE_SRCU_ATOMIC
+ DEFINE_STATIC_SRCU_ATOMIC
init_srcu_struct
init_srcu_struct_fast
+ init_srcu_struct_atomic
cleanup_srcu_struct
smp_mb__after_srcu_read_unlock
--
2.17.1
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] doc: Update recent SRCU API additions to whatisRCU.rst
2026-10-10 10:28 [PATCH] doc: Update recent SRCU API additions to whatisRCU.rst Zqiang
@ 2026-10-11 0:15 ` Joel Fernandes
2026-10-19 14:12 ` Zqiang
2026-10-14 3:28 ` KunWu Chan
1 sibling, 1 reply; 4+ messages in thread
From: Joel Fernandes @ 2026-10-11 0:15 UTC (permalink / raw)
To: Zqiang
Cc: paulmck, frederic, neeraj.upadhyay, urezki, boqun, kunwu.chan,
rcu, linux-kernel
On Sat, Oct 10, 2026 at 06:28:13PM +0800, Zqiang wrote:
> The commit 'dab06d6f9379 ("srcutree: Add an atomic Tree SRCU")'
> introduces some new APIs:
>
> srcu_read_lock_atomic
> srcu_read_unlock_atomic
> synchronize_srcu_atomic
> DEFINE_SRCU_ATOMIC
> DEFINE_STATIC_SRCU_ATOMIC
> init_srcu_struct_atomic
>
> This commit therefore update thems to whatisRCU.rst.
>
> Signed-off-by: Zqiang <qiang.zhang@linux.dev>
Reviewed-by: Joel Fernandes <joelagnelf@nvidia.com>
Applying for 7.5.
thanks,
Joel Fernandes
> ---
> Documentation/RCU/whatisRCU.rst | 7 ++++++-
> 1 file changed, 6 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/RCU/whatisRCU.rst b/Documentation/RCU/whatisRCU.rst
> index e6767baff2d3..75c50f2f6d79 100644
> --- a/Documentation/RCU/whatisRCU.rst
> +++ b/Documentation/RCU/whatisRCU.rst
> @@ -1209,11 +1209,13 @@ SRCU::
> srcu_read_lock_nmisafe start_poll_synchronize_srcu
> srcu_read_unlock_nmisafe start_poll_synchronize_srcu_expedited
> srcu_read_lock_notrace poll_state_synchronize_srcu
> - srcu_read_unlock_notrace
> + srcu_read_unlock_notrace synchronize_srcu_atomic
> srcu_down_read
> srcu_up_read
> srcu_down_read_fast
> srcu_up_read_fast
> + srcu_read_lock_atomic
> + srcu_read_unlock_atomic
> guard(srcu)()
> scoped_guard(srcu)
> srcu_read_lock_held
> @@ -1229,8 +1231,11 @@ SRCU: Initialization/cleanup/ordering::
> DEFINE_STATIC_SRCU
> DEFINE_SRCU_FAST // for srcu_read_lock_fast() and friends
> DEFINE_STATIC_SRCU_FAST // for srcu_read_lock_fast() and friends
> + DEFINE_SRCU_ATOMIC
> + DEFINE_STATIC_SRCU_ATOMIC
> init_srcu_struct
> init_srcu_struct_fast
> + init_srcu_struct_atomic
> cleanup_srcu_struct
> smp_mb__after_srcu_read_unlock
>
> --
> 2.17.1
>
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] doc: Update recent SRCU API additions to whatisRCU.rst
2026-10-10 10:28 [PATCH] doc: Update recent SRCU API additions to whatisRCU.rst Zqiang
2026-10-11 0:15 ` Joel Fernandes
@ 2026-10-14 3:28 ` KunWu Chan
1 sibling, 0 replies; 4+ messages in thread
From: KunWu Chan @ 2026-10-14 3:28 UTC (permalink / raw)
To: Zqiang
Cc: paulmck, frederic, neeraj.upadhyay, joelagnelf, urezki, boqun,
rcu, linux-kernel
Reviewed-by: Kunwu Chan <chentao@kylinos.cn>
On Sat, Oct 10, 2026 at 6:28 PM Zqiang <qiang.zhang@linux.dev> wrote:
>
> The commit 'dab06d6f9379 ("srcutree: Add an atomic Tree SRCU")'
> introduces some new APIs:
>
> srcu_read_lock_atomic
> srcu_read_unlock_atomic
> synchronize_srcu_atomic
> DEFINE_SRCU_ATOMIC
> DEFINE_STATIC_SRCU_ATOMIC
> init_srcu_struct_atomic
>
> This commit therefore update thems to whatisRCU.rst.
>
> Signed-off-by: Zqiang <qiang.zhang@linux.dev>
> ---
> Documentation/RCU/whatisRCU.rst | 7 ++++++-
> 1 file changed, 6 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/RCU/whatisRCU.rst b/Documentation/RCU/whatisRCU.rst
> index e6767baff2d3..75c50f2f6d79 100644
> --- a/Documentation/RCU/whatisRCU.rst
> +++ b/Documentation/RCU/whatisRCU.rst
> @@ -1209,11 +1209,13 @@ SRCU::
> srcu_read_lock_nmisafe start_poll_synchronize_srcu
> srcu_read_unlock_nmisafe start_poll_synchronize_srcu_expedited
> srcu_read_lock_notrace poll_state_synchronize_srcu
> - srcu_read_unlock_notrace
> + srcu_read_unlock_notrace synchronize_srcu_atomic
> srcu_down_read
> srcu_up_read
> srcu_down_read_fast
> srcu_up_read_fast
> + srcu_read_lock_atomic
> + srcu_read_unlock_atomic
> guard(srcu)()
> scoped_guard(srcu)
> srcu_read_lock_held
> @@ -1229,8 +1231,11 @@ SRCU: Initialization/cleanup/ordering::
> DEFINE_STATIC_SRCU
> DEFINE_SRCU_FAST // for srcu_read_lock_fast() and friends
> DEFINE_STATIC_SRCU_FAST // for srcu_read_lock_fast() and friends
> + DEFINE_SRCU_ATOMIC
> + DEFINE_STATIC_SRCU_ATOMIC
> init_srcu_struct
> init_srcu_struct_fast
> + init_srcu_struct_atomic
> cleanup_srcu_struct
> smp_mb__after_srcu_read_unlock
>
> --
> 2.17.1
>
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] doc: Update recent SRCU API additions to whatisRCU.rst
2026-10-11 0:15 ` Joel Fernandes
@ 2026-10-19 14:12 ` Zqiang
0 siblings, 0 replies; 4+ messages in thread
From: Zqiang @ 2026-10-19 14:12 UTC (permalink / raw)
To: Joel Fernandes
Cc: paulmck, frederic, neeraj.upadhyay, urezki, boqun, kunwu.chan,
rcu, linux-kernel
>
> On Sat, Oct 10, 2026 at 06:28:13PM +0800, Zqiang wrote:
>
> >
> > The commit 'dab06d6f9379 ("srcutree: Add an atomic Tree SRCU")'
> > introduces some new APIs:
> >
> > srcu_read_lock_atomic
> > srcu_read_unlock_atomic
> > synchronize_srcu_atomic
> > DEFINE_SRCU_ATOMIC
> > DEFINE_STATIC_SRCU_ATOMIC
> > init_srcu_struct_atomic
> >
> > This commit therefore update thems to whatisRCU.rst.
> >
> > Signed-off-by: Zqiang <qiang.zhang@linux.dev>
> >
> Reviewed-by: Joel Fernandes <joelagnelf@nvidia.com>
Hi, Joel
I have been update v2 resend.
Thanks
>
> Applying for 7.5.
>
> thanks,
>
> Joel Fernandes
>
> >
> > ---
> > Documentation/RCU/whatisRCU.rst | 7 ++++++-
> > 1 file changed, 6 insertions(+), 1 deletion(-)
> >
> > diff --git a/Documentation/RCU/whatisRCU.rst b/Documentation/RCU/whatisRCU.rst
> > index e6767baff2d3..75c50f2f6d79 100644
> > --- a/Documentation/RCU/whatisRCU.rst
> > +++ b/Documentation/RCU/whatisRCU.rst
> > @@ -1209,11 +1209,13 @@ SRCU::
> > srcu_read_lock_nmisafe start_poll_synchronize_srcu
> > srcu_read_unlock_nmisafe start_poll_synchronize_srcu_expedited
> > srcu_read_lock_notrace poll_state_synchronize_srcu
> > - srcu_read_unlock_notrace
> > + srcu_read_unlock_notrace synchronize_srcu_atomic
> > srcu_down_read
> > srcu_up_read
> > srcu_down_read_fast
> > srcu_up_read_fast
> > + srcu_read_lock_atomic
> > + srcu_read_unlock_atomic
> > guard(srcu)()
> > scoped_guard(srcu)
> > srcu_read_lock_held
> > @@ -1229,8 +1231,11 @@ SRCU: Initialization/cleanup/ordering::
> > DEFINE_STATIC_SRCU
> > DEFINE_SRCU_FAST // for srcu_read_lock_fast() and friends
> > DEFINE_STATIC_SRCU_FAST // for srcu_read_lock_fast() and friends
> > + DEFINE_SRCU_ATOMIC
> > + DEFINE_STATIC_SRCU_ATOMIC
> > init_srcu_struct
> > init_srcu_struct_fast
> > + init_srcu_struct_atomic
> > cleanup_srcu_struct
> > smp_mb__after_srcu_read_unlock
> >
> > --
> > 2.17.1
> >
>
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2026-10-19 14:12 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2026-10-10 10:28 [PATCH] doc: Update recent SRCU API additions to whatisRCU.rst Zqiang
2026-10-11 0:15 ` Joel Fernandes
2026-10-19 14:12 ` Zqiang
2026-10-14 3:28 ` KunWu Chan
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®