Re: Prototype patch for Linux-kernel memory model

["Paul E. McKenney" <paulmck@linux.vnet.ibm.com>]

On Mon, Nov 13, 2017 at 03:09:11PM -0500, Alan Stern wrote:
> On Mon, 13 Nov 2017, Paul E. McKenney wrote:
> 
> > Hello!
> > 
> > Please see below for the git commit corresponding to a prototype
> > patch for the Linux-kernel memory model.  This addresses the feedback
> > we got at Linux Plumbers Conference:
> > 
> > 1.	There is a Documentation/recipes.txt file giving known-good
> > 	useful examples, along with corresponding litmus tests.
> > 
> > 2.	There is a Documentation/explanation.txt file giving an
> > 	overview of the memory model and its workings.
> > 
> > 3.	There is a Documentation/references.txt file giving some
> > 	background reading.
> > 
> > I believe that we have something that will be extremely useful and
> > valuable to novices and experts alike.
> > 
> > Please note that this version of the memory model does not yet reflect
> > the changes that make DEC Alpha no longer be a special case because
> > those changes have not yet hit mainline.  The model will be updated
> > once this happens.
> > 
> > Thoughts?
> 
> In references.txt, should we add URLs to non-paywalled PDFs?  Or should
> we assume that our readers are capable of using Google to find these 
> things on their own?
> 
> There are a few places where some comments should be resolved/removed
> before submission:
> 
> 	Documentation/references.txt line 98:
> 	Uncategorized stuff (any of this really needed?)
> 
> 	litmus-tests/README line 92:
> 	[ Shouldn't we have one with smp_wmb() in the process with both
> 	  writes, and smp_mb() in the other process. ]

I updated these, recategorizing the "Uncategorized stuff" and removing
the note from litmus-tests/README -- we don't seem to use R in recipes
anyway.

> In the files defining the memory model, we should replace the GPL
> boilerplate with SPDX headers.

We can!

I pushed both commits.

							Thanx, Paul