From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752019AbdJDV0x (ORCPT ); Wed, 4 Oct 2017 17:26:53 -0400 Received: from mx0a-001b2d01.pphosted.com ([148.163.156.1]:48924 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751892AbdJDVU6 (ORCPT ); Wed, 4 Oct 2017 17:20:58 -0400 Date: Wed, 4 Oct 2017 14:20:51 -0700 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, fweisbec@gmail.com, oleg@redhat.com Subject: [PATCH tip/core/rcu 0/16] Documentation updates for v4.15 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-GCONF: 00 x-cbid: 17100421-0056-0000-0000-000003D3C733 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00007843; HX=3.00000241; KW=3.00000007; PH=3.00000004; SC=3.00000233; SDB=6.00926530; UDB=6.00466099; IPR=6.00706742; BA=6.00005620; NDR=6.00000001; ZLA=6.00000005; ZF=6.00000009; ZB=6.00000000; ZP=6.00000000; ZH=6.00000000; ZU=6.00000002; MB=3.00017394; XFM=3.00000015; UTC=2017-10-04 21:20:54 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 17100421-0057-0000-0000-0000080AD709 Message-Id: <20171004212051.GA8411@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:,, definitions=2017-10-04_09:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 suspectscore=1 malwarescore=0 phishscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1707230000 definitions=main-1710040296 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hello! This series contains documentation updates, including some updates to docbook header comments: 1. Design documentation illustrating RCU's grace-period memory ordering guarantees. 2. Add verbiage stating that long-running irq handlers can stall RCU grace periods. 3. Add verbiage stating that slow systems can stall RCU grace periods. 4. Update description of RCU CPU stall warning messages. 5. Replace uses of "transitive" in memory-barriers.txt. 6. Rework multicopy-atomicity section of memory-barriers.txt, courtesy of Alan Stern. 7. Fix RCU's docbook options. 8. Add parameters to rcupdate.h docbook comments. 9. Remove extra docbook comment in rculist.h. 10. Fix docbook comments for rcu_sync functions. 11. Fix list and emphasis in rcupdate.h docbook comments. 12. Flag code segment in rcu_pointer_handoff()'s docbook comment. 13. Fix code display in rcu_pointer_handoff()'s docbook comment. 14. Fix tree.c bulleted lists in docbook comments. 15. Fix typo in pairing example in memory-barriers.txt, courtesy of Scott Tsai. 16. Rewrite confusing statement about memory barriers in memory-barriers.txt, courtesy of Guilherme G. Piccoli. Thanx, Paul ------------------------------------------------------------------------ Documentation/RCU/Design/Memory-Ordering/Tree-RCU-Diagram.html | 9 Documentation/RCU/Design/Memory-Ordering/Tree-RCU-Memory-Ordering.html | 707 + Documentation/RCU/Design/Memory-Ordering/TreeRCU-callback-invocation.svg | 486 Documentation/RCU/Design/Memory-Ordering/TreeRCU-callback-registry.svg | 655 + Documentation/RCU/Design/Memory-Ordering/TreeRCU-dyntick.svg | 700 + Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp-cleanup.svg | 1126 ++ Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp-fqs.svg | 1309 ++ Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp-init-1.svg | 656 + Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp-init-2.svg | 656 + Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp-init-3.svg | 632 + Documentation/RCU/Design/Memory-Ordering/TreeRCU-gp.svg | 5135 ++++++++++ Documentation/RCU/Design/Memory-Ordering/TreeRCU-hotplug.svg | 775 + Documentation/RCU/Design/Memory-Ordering/TreeRCU-qs.svg | 1095 ++ Documentation/RCU/Design/Memory-Ordering/rcu_node-lock.svg | 229 Documentation/RCU/stallwarn.txt | 200 Documentation/core-api/kernel-api.rst | 14 Documentation/memory-barriers.txt | 249 include/linux/rculist.h | 2 include/linux/rcupdate.h | 26 kernel/rcu/sync.c | 9 kernel/rcu/tree.c | 18 21 files changed, 14449 insertions(+), 239 deletions(-)