Re: [NOT A PATCH -perfbook] index of 'Non-Blocking' in Glossary

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Fri, Jan 21, 2022 at 09:29:24AM +0900, Akira Yokosawa wrote:
> Not-signed-off-by: Akira Yokosawa <akiyks@xxxxxxxxx>
> ---
> Hi Paul,
> 
> This is a reminder in sent as a patch.
> 
> I find the indexing tag you put to "Non-Blocking" looks strange.
> This entry talks about some classes of forward-progress guarantees,
> not much about synchronization.
> Also, the existing tags of NBS are \IXacr{}.  You therefore
> need to use \glsuseriii{nbs} as shown below in a separate entry
> of "Non-Blocking Synchronization (NBS)".
> 
> I think NBS deserves its own entry in the Glossary.
> 
>         Thanks, Akira
> 
> --
>  glossary.tex | 4 +++-
>  1 file changed, 3 insertions(+), 1 deletion(-)
> 
> diff --git a/glossary.tex b/glossary.tex
> index 86d9a025..4ea87f60 100644
> --- a/glossary.tex
> +++ b/glossary.tex
> @@ -425,7 +425,7 @@
>  	These are used for hardware-specific purposes such as profiling.
>  	The advantage of using NMIs for profiling is that it allows you
>  	to profile code that runs with interrupts disabled.
> -\item[\IXGaltr{Non-Blocking}{Non-blocking synchronization (NBS)}:]
> +\item[\IXG{Non-Blocking}:]
>  	A group of academic forward-progress guarantees that includes
>  	bounded population-oblivious wait free,
>  	bounded wait free,
> @@ -437,6 +437,8 @@
>  	deadlock free.
>  	See \cref{sec:advsync:Non-Blocking Synchronization}
>  	for more information.
> +\item[Non-Blocking Synchronization (NBS):]\glsuseriii{nbs}
> +	%@@@ Need expansion @@@
>  \item[NUCA:]\glsuseriii{nuca}
>  	Non-uniform cache architecture, where groups of CPUs share
>  	caches and/or store buffers.

Good points!

How about like this?

							Thanx, Paul

------------------------------------------------------------------------

commit a8152ff934df7cfaccb8bdc1fa376c5d11737995
Author: Paul E. McKenney <paulmck@xxxxxxxxxx>
Date:   Fri Jan 21 16:11:09 2022 -0800

    glossary: Update non-blocking and add NBS
    
    Took index-addition commands from Akira's email dated January 20.
    
    Suggested-by: Akira Yokosawa <akiyks@xxxxxxxxx>
    Signed-off-by: Paul E. McKenney <paulmck@xxxxxxxxxx>

diff --git a/glossary.tex b/glossary.tex
index 86d9a025..1d4a2404 100644
--- a/glossary.tex
+++ b/glossary.tex
@@ -425,7 +425,7 @@
 	These are used for hardware-specific purposes such as profiling.
 	The advantage of using NMIs for profiling is that it allows you
 	to profile code that runs with interrupts disabled.
-\item[\IXGaltr{Non-Blocking}{Non-blocking synchronization (NBS)}:]
+\item[\IXG{Non-Blocking}:]
 	A group of academic forward-progress guarantees that includes
 	bounded population-oblivious wait free,
 	bounded wait free,
@@ -437,6 +437,13 @@
 	deadlock free.
 	See \cref{sec:advsync:Non-Blocking Synchronization}
 	for more information.
+\item[Non-Blocking Synchronization (NBS):]\glsuseriii{nbs}
+	The use of algorithms, mechanisms, or techniques that provide
+	non-blocking forward-progress guarantees.
+	NBS is often used in a more restrictive sense of providing one
+	of the stronger forward-progress guarantee, usually wait free or
+	lock free, but sometimes also obstruction free.
+	(See ``Non-blocking''.)
 \item[NUCA:]\glsuseriii{nuca}
 	Non-uniform cache architecture, where groups of CPUs share
 	caches and/or store buffers.



[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Index of Archives]     [Linux NFS]     [Linux NILFS]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]

  Powered by Linux