From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1757759AbcBXFIo (ORCPT ); Wed, 24 Feb 2016 00:08:44 -0500 Received: from e33.co.us.ibm.com ([32.97.110.151]:44780 "EHLO e33.co.us.ibm.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1757904AbcBXFHq (ORCPT ); Wed, 24 Feb 2016 00:07:46 -0500 X-IBM-Helo: d03dlp02.boulder.ibm.com X-IBM-MailFrom: paulmck@linux.vnet.ibm.com X-IBM-RcptTo: linux-kernel@vger.kernel.org Date: Tue, 23 Feb 2016 21:00:21 -0800 From: "Paul E. McKenney" To: linux-kernel@vger.kernel.org Cc: mingo@kernel.org, jiangshanlai@gmail.com, dipankar@in.ibm.com, akpm@linux-foundation.org, mathieu.desnoyers@efficios.com, josh@joshtriplett.org, tglx@linutronix.de, peterz@infradead.org, rostedt@goodmis.org, dhowells@redhat.com, edumazet@google.com, dvhart@linux.intel.com, fweisbec@gmail.com, oleg@redhat.com, bobby.prani@gmail.com Subject: [PATCH tip/core/rcu 0/14] Documentation updates for 4.6 Message-ID: <20160224050021.GA14616@linux.vnet.ibm.com> Reply-To: paulmck@linux.vnet.ibm.com MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.21 (2010-09-15) X-TM-AS-MML: disable X-Content-Scanned: Fidelis XPS MAILER x-cbid: 16022405-0009-0000-0000-000012ACC78A Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hello! This series contains documentation updates as follows: 1. Update the requirements design-level documentation to record RCU's responsibility to avoid injecting OS jitter onto nohz_full CPUs. 2. Fix control-dependency summary of memory-barriers.txt to note that barrier() does not always prevent code reordering when both legs of an "if" statement begin with identical code. 3. Fix memory-barriers.txt section references. 4. Update the requirements design-level documentation to add synchronize_rcu_mult(). 5. Remove obsolete references to RCU-protected array indexes from memory-barriers.txt. 6. Update memory-barriers.txt to explicitly state that rcu_dereference() orders writes to as well as reads from the RCU-protected data item. 7. Update memory-barriers.txt to distinguish between local and global transitivity. 8. Update memory-barriers.txt to add alternative outcome from release-acquire chain. 9. Add design-level documentation for RCU's major data structures. 10. Update the requirements design-level documentation to explain why rcu_read_lock() needs no barrier() for PREEMPT=n. 11. Remove misleading statement that transitivity is cumulativity from memory-barriers.txt. 12. Update the requirements design-level documentation to explicitly state that it is illegal to invoke call_rcu() from an offline CPU. 13. Add text to the design-level documentation for RCU's major data structures stating how the combining tree keeps lock contention under control. 14. Clarify compiler store-fusion example in memory-barriers.txt. Thanx, Paul ------------------------------------------------------------------------ RCU/Design/Data-Structures/BigTreeClassicRCU.svg | 474 ++++ RCU/Design/Data-Structures/BigTreeClassicRCUBH.svg | 499 ++++ RCU/Design/Data-Structures/BigTreeClassicRCUBHdyntick.svg | 695 +++++ RCU/Design/Data-Structures/BigTreePreemptRCUBHdyntick.svg | 741 ++++++ RCU/Design/Data-Structures/BigTreePreemptRCUBHdyntickCB.svg | 858 +++++++ RCU/Design/Data-Structures/Data-Structures.html | 1395 ++++++++++++ RCU/Design/Data-Structures/Data-Structures.htmlx | 1295 +++++++++++ RCU/Design/Data-Structures/HugeTreeClassicRCU.svg | 939 ++++++++ RCU/Design/Data-Structures/TreeLevel.svg | 828 +++++++ RCU/Design/Data-Structures/TreeMapping.svg | 305 ++ RCU/Design/Data-Structures/TreeMappingLevel.svg | 380 +++ RCU/Design/Data-Structures/blkd_task.svg | 843 +++++++ RCU/Design/Data-Structures/nxtlist.svg | 396 +++ RCU/Design/Requirements/Requirements.html | 235 +- RCU/Design/Requirements/Requirements.htmlx | 121 + memory-barriers.txt | 141 - 16 files changed, 10074 insertions(+), 71 deletions(-)