Received: by 2002:ac0:a5a6:0:0:0:0:0 with SMTP id m35-v6csp74274imm;
Wed, 29 Aug 2018 14:19:57 -0700 (PDT)
X-Google-Smtp-Source: ANB0VdYPX5rwmRYN3ziVUfhc0lSIW4BfxfnsZBQkiymldkL/cZfoINyw8RMpeu6MPFUyIUWZD0in
X-Received: by 2002:a17:902:b03:: with SMTP id 3-v6mr7374783plq.277.1535577597741;
Wed, 29 Aug 2018 14:19:57 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; t=1535577597; cv=none;
d=google.com; s=arc-20160816;
b=bByEkOTI6axj8ehLIGbIjHZIYsZmoZuwW7Wp17wGaLooKxSk/AxDhdQsZv5EsgU7cX
u8Z1wjLFmL1BWXZ3y23nfjQV8wm1d+abPBwwJ0sAvalT4tEpMUud/YA9J3RjOhHNQdSg
n9lcjsko8jpRw2l8/YvJw64wJ9kNcTkK9p1ctTSpLUKDuqFOgQml5B9igwR94+OcAwAj
z/VlFExF7f8S5UGz+eXHFO/izJhOoJNJS7eJefGc8rcs9e6cpesBTCSwU+zg1v+BbC7U
N9hfEGmvSAs/CTaNSA/PWMQznkZROc2r86jQ5qq6NiTgrkrSTUn1j/NsNmxZnz6ZlUkp
D5+w==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816;
h=list-id:precedence:sender:message-id:references:in-reply-to:date
:subject:cc:to:from:arc-authentication-results;
bh=skiDOOkdl6vwVoYjaCw6+yHO8xuRBwjWqfEEhBJipyc=;
b=0m7HVwRpihibgyDxmxoXpOciWWkKym/nlZs3IeUmuSAsaGI2knnPbbC1NPst0A/nGp
T9+pjIAMsjxFfmcV3AEpLWVBJWxcxaB4PnDOzGi7/4gGjyQ6tr3xE1s1LHiPCbWtgsWM
f4WRgZ8deAYfaSNTNatbGVyxiXe8qHRNh31VwnQX8XkMULFg/qAA/ul+2MfK4OFftGaZ
cQAAkdpiNQGINqj6IokP4cgFx/le6GFOnbkiQaWyQ+zqR427ritdDYTq2cpa648tG9wr
g5ONxoE/UOM8htflhyB3gxK1I9FJUjqH3HvmqivzWQ/EO+QUEEyhXCiVgJWX+jmTmXt+
3peg==
ARC-Authentication-Results: i=1; mx.google.com;
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=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com
Return-Path:
Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67])
by mx.google.com with ESMTP id i13-v6si4228553pgq.426.2018.08.29.14.19.42;
Wed, 29 Aug 2018 14:19:57 -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;
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=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
id S1728969AbeH3BQO (ORCPT
+ 99 others); Wed, 29 Aug 2018 21:16:14 -0400
Received: from mx0b-001b2d01.pphosted.com ([148.163.158.5]:40010 "EHLO
mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-FAIL)
by vger.kernel.org with ESMTP id S1728754AbeH3BQO (ORCPT
);
Wed, 29 Aug 2018 21:16:14 -0400
Received: from pps.filterd (m0098420.ppops.net [127.0.0.1])
by mx0b-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w7TL8p24066065
for ; Wed, 29 Aug 2018 17:17:30 -0400
Received: from e16.ny.us.ibm.com (e16.ny.us.ibm.com [129.33.205.206])
by mx0b-001b2d01.pphosted.com with ESMTP id 2m629dt512-1
(version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT)
for ; Wed, 29 Aug 2018 17:17:29 -0400
Received: from localhost
by e16.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted
for from ;
Wed, 29 Aug 2018 17:17:29 -0400
Received: from b01cxnp22035.gho.pok.ibm.com (9.57.198.25)
by e16.ny.us.ibm.com (146.89.104.203) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted;
(version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256)
Wed, 29 Aug 2018 17:17:24 -0400
Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108])
by b01cxnp22035.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w7TLHN5o33030250
(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL);
Wed, 29 Aug 2018 21:17:23 GMT
Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1])
by IMSVA (Postfix) with ESMTP id 6C05FB2072;
Wed, 29 Aug 2018 17:16:19 -0400 (EDT)
Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1])
by IMSVA (Postfix) with ESMTP id 4B3A5B2068;
Wed, 29 Aug 2018 17:16:19 -0400 (EDT)
Received: from paulmck-ThinkPad-W541 (unknown [9.70.82.159])
by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP;
Wed, 29 Aug 2018 17:16:19 -0400 (EDT)
Received: by paulmck-ThinkPad-W541 (Postfix, from userid 1000)
id A58E816C91C6; Wed, 29 Aug 2018 14:17:23 -0700 (PDT)
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, joel@joelfernandes.org,
"Paul E . McKenney"
Subject: [PATCH tip/core/rcu 3/6] doc: Improve rcu_dynticks::dynticks documentation
Date: Wed, 29 Aug 2018 14:17:19 -0700
X-Mailer: git-send-email 2.17.1
In-Reply-To: <20180829211637.GA20980@linux.vnet.ibm.com>
References: <20180829211637.GA20980@linux.vnet.ibm.com>
X-TM-AS-GCONF: 00
x-cbid: 18082921-0072-0000-0000-000003996244
X-IBM-SpamModules-Scores:
X-IBM-SpamModules-Versions: BY=3.00009636; HX=3.00000242; KW=3.00000007;
PH=3.00000004; SC=3.00000266; SDB=6.01080717; UDB=6.00557481; IPR=6.00860703;
MB=3.00023001; MTD=3.00000008; XFM=3.00000015; UTC=2018-08-29 21:17:27
X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused
x-cbparentid: 18082921-0073-0000-0000-0000493E8E1D
Message-Id: <20180829211722.21694-3-paulmck@linux.vnet.ibm.com>
X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-08-29_04:,,
signatures=0
X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501
malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0
clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0
mlxlogscore=963 adultscore=0 classifier=spam adjust=0 reason=mlx
scancount=1 engine=8.0.1-1807170000 definitions=main-1808290206
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk
List-ID:
X-Mailing-List: linux-kernel@vger.kernel.org
From: "Joel Fernandes (Google)"
The very useful RCU Data-Structures describes that the dynticks counter
of the rcu_dynticks data structure is incremented when we transitions to
or from dynticks-idle mode. However it doesn't mention that it is also
incremented due to transitions to and from user mode which for dynticks
purposes is an extended quiescent state.
I found this with tracing calls to rcu_dynticks_eqs_enter which can also
happen from rcu_user_enter. Lets add this information to the
Data-Structures document.
Signed-off-by: Joel Fernandes (Google)
Signed-off-by: Paul E. McKenney
---
.../RCU/Design/Data-Structures/Data-Structures.html | 8 +++++---
1 file changed, 5 insertions(+), 3 deletions(-)
diff --git a/Documentation/RCU/Design/Data-Structures/Data-Structures.html b/Documentation/RCU/Design/Data-Structures/Data-Structures.html
index f5120a00f511..50be87e59937 100644
--- a/Documentation/RCU/Design/Data-Structures/Data-Structures.html
+++ b/Documentation/RCU/Design/Data-Structures/Data-Structures.html
@@ -1227,9 +1227,11 @@ to overflow the counter, this approach corrects the
CPU enters the idle loop from process context.
The ->dynticks field counts the corresponding
-CPU's transitions to and from dyntick-idle mode, so that this counter
-has an even value when the CPU is in dyntick-idle mode and an odd
-value otherwise.
+CPU's transitions to and from either dyntick-idle or user mode, so
+that this counter has an even value when the CPU is in dyntick-idle
+mode or user mode and an odd value otherwise. The transitions to/from
+user mode need to be counted for user mode adaptive-ticks support
+(see timers/NO_HZ.txt).
The ->rcu_need_heavy_qs field is used
to record the fact that the RCU core code would really like to
--
2.17.1