Received: by 2002:a25:824b:0:0:0:0:0 with SMTP id d11csp3161765ybn; Fri, 27 Sep 2019 02:02:14 -0700 (PDT) X-Google-Smtp-Source: APXvYqyPiXa3yJ5aluAwvhC84zSlQyEj4LH+RRFuIL4PH1t0mWDZKzXmU36G5+uW09QPNI9CqgHe X-Received: by 2002:a50:f152:: with SMTP id z18mr3173682edl.141.1569574934628; Fri, 27 Sep 2019 02:02:14 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1569574934; cv=none; d=google.com; s=arc-20160816; b=YaDF8t6rouwhVerdocO6Hw6iTky3m4GFTMF0f1KKi0snRbumqGIsJGNgvmI8W9JUnl Fbkyy5qcddckIG7KJSNJUB4X9eVes+3sYWzoUNlQhx4nwzXjmAZvEl5eXaZepl+tHETN Jn/ca7UMemmRl3Df0JLNW5c3A5Fu7I8RsqYRE4AcF2HYuGO+PjWYCLC2aTI3P4gnzALJ I6FqQ/aNxBWDyR/bb3f11jKL1lSzyGCleN+w7kOe7+jEc0w1+Jwn24QTBv4IZURKK9H0 ZB3qUoYWNUKGgwjLL8OhCmgdP6ZaALMNeNrqPBI7YRHG5063kAOHClxMX6fSeeyjA0+o Pkfg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:user-agent:in-reply-to :content-disposition:mime-version:references:message-id:subject:cc :to:from:date:dkim-signature; bh=tNF0gT64dteptCicFixUzKp0+ngnIZBYeMCP9JMRvz8=; b=oHhO7t38UJ9eTuUgQBDazrDciUuLjw79PJtcBTyYLO8kEJFgIdFsh1lmYc9pA8nHWu 3V9BHo5hJQ3XCHUyi7/xofb7FUoUPVRe4y4JsmX3NX/ddYj/EDms+CrZR8D8z+Fj3cbZ si+SACc5Z3xtRIggOOUytiIly35Junq40mDCjxx1Jsf11NU5V+SKqeIL89EsEgTPriiS fa6gcjRAK53bybtqprDykoTl71NHr7xNUpl8V0qcI3ea8OtUX5FLpQdUgV8/44Vp1N6j 258LLV2k9H4Sa6X/cfHW0KPT3Kg5i5Zy5kG4BAlyFfPMqzE4ujKGrsi1HC5/r8JLacpr ruAw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=W1EKSGrv; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id m20si1131480eds.363.2019.09.27.02.01.47; Fri, 27 Sep 2019 02:02:14 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=W1EKSGrv; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726080AbfI0I7Q (ORCPT + 99 others); Fri, 27 Sep 2019 04:59:16 -0400 Received: from mail-wm1-f52.google.com ([209.85.128.52]:39771 "EHLO mail-wm1-f52.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725882AbfI0I7Q (ORCPT ); Fri, 27 Sep 2019 04:59:16 -0400 Received: by mail-wm1-f52.google.com with SMTP id v17so5297683wml.4 for ; Fri, 27 Sep 2019 01:59:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=tNF0gT64dteptCicFixUzKp0+ngnIZBYeMCP9JMRvz8=; b=W1EKSGrvi5u5fblYEDRskbG4MDTxt8ynUMPlosjMY+a5t1Ur01lNeAS8HyJ4Zd7HX8 liSaDghQF5XuQ5HQiQeOI7WsN3ZOAQXJBAeqOXV9Dalb9oaNRHNMUEGh89vL8fx5IXMy 774dpjFn5lAOETOY9r1sTMuh1jCdwhpyxJS6a/qpo68lBAkuIxkg2aMQi9lZu82SNXH8 dXzJqyoft4LkCqHt6xgoMJxrV7bbEILlKGA+E+GW4xK8yruesn3vonmPKHSgSciGILZt 2iCLNDobZxc88xD1FTSWVS7OIPj3MURaCZPI1gqZ7aOYKN99DDUSMj2yAanyn00lXC/N i4Zw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=tNF0gT64dteptCicFixUzKp0+ngnIZBYeMCP9JMRvz8=; b=p23Mf9weT1g4qJGfe59Fw7f64CPmFvxtxPBDCRlQt1k3VSNS9KVlJRCifmMcZg3V+6 /yFLDgLzCpaaq1F4IbfjTCF//iWlPKGJZGXtG0zLZ/KBXOPKzOfLKErGONp0PoIMOpcX kEo6kBJnq3og2hqCea+vZkwiYebegTruefQq122fRKH8+/2yw2wsZ4LI/wFPAn5urgpc ReMQNnWNGdjT9x0odQi3CbmNuzCvJri/pqZLYp2QXJCFzsDq9n3jj+epxdT8qhSErPAU GgJeovnbZXA+mU0IN1JXGJytqJN//YYmx6L6paP/BEIIMy7TD0coS39HY3+P8XyBLgu5 z2gQ== X-Gm-Message-State: APjAAAU1pkKl8PuyfYksHwBnaIHaN8cPanzN5QwWVpnPHTDZBRo5eTP1 qkKJG7/tkkCFXlKlwJqo0ZM= X-Received: by 2002:a7b:c00e:: with SMTP id c14mr6393188wmb.60.1569574752545; Fri, 27 Sep 2019 01:59:12 -0700 (PDT) Received: from andrea (userh626.uk.uudial.com. [194.69.102.253]) by smtp.gmail.com with ESMTPSA id z125sm9719718wme.37.2019.09.27.01.59.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Sep 2019 01:59:11 -0700 (PDT) Date: Fri, 27 Sep 2019 10:59:05 +0200 From: Andrea Parri To: Alan Stern Cc: LKMM Maintainers -- Akira Yokosawa , Boqun Feng , Daniel Lustig , David Howells , Jade Alglave , Luc Maranget , Nicholas Piggin , "Paul E. McKenney" , Peter Zijlstra , Will Deacon , Kernel development list Subject: Re: Documentation for plain accesses and data races Message-ID: <20190927085905.GA11454@andrea> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.10.1 (2018-07-13) Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, Sep 06, 2019 at 02:11:29PM -0400, Alan Stern wrote: > Folks: > > I have spent some time writing up a section for > tools/memory-model/Documentation/explanation.txt on plain accesses and > data races. The initial version is below. > > I'm afraid it's rather long and perhaps gets too bogged down in > complexities. On the other hand, this is a complicated topic so to > some extent this is unavoidable. > > In any case, I'd like to hear your comments and reviews. Thank you for writing this up, Alan, and sorry for the delayed reply. The section looks great to me, and I have no further suggestions besides the minor fixes which have been already pointed out in the thread. Looking forward to your v2 (an actual patch), Andrea