defer: Update Hlist RCU API tables
PATCH 1/2 defer: Update Hlist RCU API tables
From ce79ac6df2f3d3fcb6d24b1b629ce78f69eea6f8 Mon Sep 17 00:00:00 2001
From: Akira Yokosawa <[email protected]>
Date: Sun, 2 Dec 2018 19:05:54 +0900
Subject: [PATCH 1/2] defer: Update Hlist RCU API tables
Current Linux kernel API does not have hlist_add_after_rcu() but has hlist_add_behind_rcu().
It was renamed in the 3.17 development cycle due to swapping of the arguments.
While we are here, add the missing category of "Hlist update" and reference the table by the label instead of just saying "the following table".
--- defer/rcuapi.tex | 14 +++++++++----- defer/rcufundamental.tex | 4 ++-- 2 files changed, 11 insertions(+), 7 deletions(-)
defer/rcuapi.tex +9 -5
@@ -439,8 +439,9 @@ their scope. \label{sec:defer:RCU has Publish-Subscribe and Version-Maintenance APIs} Fortunately, the RCU publish-subscribe and version-maintenance -primitives shown in the following -table apply to all of the variants of RCU discussed above. +primitives shown in +Table~\ref{tab:defer:RCU Publish-Subscribe and Version Maintenance APIs} +apply to all of the variants of RCU discussed above. This commonality can in some cases allow more code to be shared, which certainly reduces the API proliferation that would otherwise occur.
@@ -491,9 +492,12 @@ Hlist traversal & \tco{hlist_for_each_entry_rcu()} & 2.6.8 & Simple instructions (memory barrier on Alpha) \\ -& - \tco{hlist_add_after_rcu()} & - 2.6.14 & +\midrule +Hlist Update & + \tco{hlist_add_behind_rcu()} & + \parbox[t][0.3in][t]{0.8in}{ + 2.6.14 \\ + (renamed in 3.17)} & Memory barrier \\ & \tco{hlist_add_before_rcu()} &
defer/rcufundamental.tex +2 -2
@@ -399,8 +399,8 @@ Lists & \parbox[c][0.37in][c]{1.3in}{ & \tco{list_for_each_entry_rcu()} \\ \midrule Hlists & \parbox[c][0.5in][c]{1.3in}{ - \co{hlist_add_after_rcu()} \\ - \co{hlist_add_before_rcu()} \\ + \co{hlist_add_behind_rcu()} \\ + \co{hlist_add_before_rcu()} \\ \co{hlist_add_head_rcu()} \\ \co{hlist_replace_rcu()} } & \tco{hlist_del_rcu()}
Signature · 1 line
2.7.4
A message that is not in the archive (sent off-list or not yet received): [email protected]
Re: [PATCH v2 1/2] defer: Update Hlist RCU API table
Paul,
IIUC, your work on RCU API consolidation seems to affect Section 9.5.4, especially Table 9.3.
I'm not sure, but one idea would be to keep Table 9.3 for future reference and add a new one representing consolidated set of API.
Just a reminder.
Thanks, Akira
Re: [PATCH v2 1/2] defer: Update Hlist RCU API table
Quoted 9 lines · Akira Yokosawa
Paul,
IIUC, your work on RCU API consolidation seems to affect Section 9.5.4, especially Table 9.3.
I'm not sure, but one idea would be to keep Table 9.3 for future reference and add a new one representing consolidated set of API.
Just a reminder.
And a timely one! Please see attached for a possible LWN article. Though the LWN editors might quite rightly decide that a third RCU API article is one too many, in which case I will blog it.
But either way, thoughts?
Thanx, Paul
Paul E. McKenney
AppliedRe: [PATCH v2 1/2] defer: Update Hlist RCU API table
In reply to a message not in the archiveQuoted 8 lines · Akira Yokosawa
Quoted 1 line
From
8cd7d7bb4b42f67e67d2273c6c048b26a9ec3366Mon Sep 17 00:00:00 2001From: Akira Yokosawa <[email protected]>
Date: Sun, 2 Dec 2018 23:35:43 +0900
Subject: [PATCH v2 1/2] defer: Update Hlist RCU API tableCurrent Linux kernel API does not have
hlist_add_after_rcu()but hashlist_add_behind_rcu().
Quoted 7 lines
It was renamed in the 3.17 development cycle due to swapping of the arguments.
While we are here, reference the table by the label instead of just saying "the following table".
Signed-off-by Akira Yokosawa <[email protected]>
Applied both, thank you!
Thanx, Paul
Quoted 65 lines
---
Hi Paul,This one keeps the original API name in the table.
It also fixes "Hlist Update" -> "Hlist update" for consistency.I'm submitting v2 of [1/2] only.
Thanks, Akira
--defer/rcuapi.tex | 12 ++++++++---- defer/rcufundamental.tex | 4 ++-- 2 files changed, 10 insertions(+), 6 deletions(-)defer/rcuapi.tex +8
-4@@ -439,8 +439,9 @@ their scope. \label{sec:defer:RCU has Publish-Subscribe and Version-Maintenance APIs} Fortunately, the RCU publish-subscribe and version-maintenance -primitives shown in the following -table apply to all of the variants of RCU discussed above. +primitives shown in +Table~\ref{tab:defer:RCU Publish-Subscribe and Version Maintenance APIs} +apply to all of the variants of RCU discussed above. This commonality can in some cases allow more code to be shared, which certainly reduces the API proliferation that would otherwise occur.@@ -491,10 +492,13 @@ Hlist traversal & \tco{hlist_for_each_entry_rcu()} & 2.6.8 & Simple instructions (memory barrier on Alpha) \\ -& - \tco{hlist_add_after_rcu()} & +\midrule +Hlist update & + \tco{hlist_add_behind_rcu()} & 2.6.14 & Memory barrier \\ +& \multicolumn{2}{l}{(Renamed from \tco{hlist_add_after_rcu()} in 3.17)} & + \\ \addlinespace[2pt] & \tco{hlist_add_before_rcu()} & 2.6.14 &defer/rcufundamental.tex +2
-2@@ -399,8 +399,8 @@ Lists & \parbox[c][0.37in][c]{1.3in}{ & \tco{list_for_each_entry_rcu()} \\ \midrule Hlists & \parbox[c][0.5in][c]{1.3in}{ - \co{hlist_add_after_rcu()} \\ - \co{hlist_add_before_rcu()} \\ + \co{hlist_add_behind_rcu()} \\ + \co{hlist_add_before_rcu()} \\ \co{hlist_add_head_rcu()} \\ \co{hlist_replace_rcu()} } & \tco{hlist_del_rcu()}Signature · 1 line
2.7.4