From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id EF721C54E4A for ; Tue, 12 May 2020 15:25:06 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id B74D2206CC for ; Tue, 12 May 2020 15:25:06 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727847AbgELPZG (ORCPT ); Tue, 12 May 2020 11:25:06 -0400 Received: from netrider.rowland.org ([192.131.102.5]:54239 "HELO netrider.rowland.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with SMTP id S1727777AbgELPZG (ORCPT ); Tue, 12 May 2020 11:25:06 -0400 Received: (qmail 2205 invoked by uid 500); 12 May 2020 11:25:05 -0400 Received: from localhost (sendmail-bs@127.0.0.1) by localhost with SMTP; 12 May 2020 11:25:05 -0400 Date: Tue, 12 May 2020 11:25:05 -0400 (EDT) From: Alan Stern X-X-Sender: stern@netrider.rowland.org To: Akira Yokosawa cc: "Joel Fernandes (Google)" , Boqun Feng , "Paul E. McKenney" , , , Jonathan Corbet , Andrea Parri , Will Deacon , Peter Zijlstra , Nicholas Piggin , David Howells , Jade Alglave , Luc Maranget , Daniel Lustig , Subject: Re: [PATCH 4/3] docs: litmus-tests: Clarify about the RCU pre-initialization test In-Reply-To: Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Wed, 13 May 2020, Akira Yokosawa wrote: > From 7bb979aacd8788d174df8a56e9803ba9e5b7a381 Mon Sep 17 00:00:00 2001 > From: Joel Fernandes (Google) > Date: Mon, 11 May 2020 22:06:46 -0400 > Subject: [PATCH 4/3] docs: litmus-tests: Clarify about the RCU pre-initialization test > > Since this test returned to tools/memory-model/, make sure that it is > at least referenced from Documentation/litmus-tests/'s README. > > Co-developed-by: Joel Fernandes (Google) > Co-developed-by: Akira Yokosawa > [Alan: grammar nit] > Suggested-by: Alan Stern > Signed-off-by: Joel Fernandes (Google) > Signed-off-by: Akira Yokosawa > --- > I said in the earlier message: > > > The explanation under tools/memory-model/litmus-tests/README also need the same > > rewording. > > , but obviously I was confused. It is good as is. > > This is on top of my earlier patch series. > > Joel, Alan, does this work with you? > > Thanks, Akira > -- > Documentation/litmus-tests/README | 4 ++++ > 1 file changed, 4 insertions(+) > > diff --git a/Documentation/litmus-tests/README b/Documentation/litmus-tests/README > index ac0b270b456c..b79e640214b9 100644 > --- a/Documentation/litmus-tests/README > +++ b/Documentation/litmus-tests/README > @@ -24,6 +24,10 @@ Atomic-RMW-ops-are-atomic-WRT-atomic_set.litmus > RCU (/rcu directory) > -------------------- > > +MP+onceassign+derefonce.litmus (under tools/memory-model/litmus-tests/) > + Demonstrates the use of rcu_assign_pointer() and rcu_dereference() to > + ensure that an RCU reader will not see pre-initialization garbage. > + > RCU+sync+read.litmus > RCU+sync+free.litmus > Both the above litmus tests demonstrate the RCU grace period guarantee That's fine with me. Alan