Received: by 2002:a05:6a10:a841:0:0:0:0 with SMTP id d1csp204966pxy; Wed, 28 Apr 2021 02:34:54 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzCdz9AZOWf1slv9JyJ90VqeV0GuNkjz4BwPGSasKbmdfZbgaJIZSZvYO/OPxwU/v/7LDEq X-Received: by 2002:a05:6402:3514:: with SMTP id b20mr9712769edd.348.1619602494045; Wed, 28 Apr 2021 02:34:54 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1619602494; cv=none; d=google.com; s=arc-20160816; b=rf2TaHt5eV9ps/KxyHprFAIoxK8E+qvDFDQ3BLhvcCvDuIISPBG5FqQQxsFUe+1Gf2 vKHnAw0Rnc5fZo+e19XbglqWkiCum1ys0L+21izO/WNPszt7SiKKsY3cCQJv2vkmImJ8 G9jlf+eXAdFC18AvdNiIPwwkIjvsXt/ynzDA9eQfPrUxb1y1cs19CP3R69SVQXYc1qeg SbuDieW1JgOIdGn0UorEtGTnr7d1LD9bV1pS5t5yxJnM6xglcPLOITAihp4uzddXlEAq AvhKE48FAI2rbgGxPrm/evsBnv9QPSdCL1p2i7RBUxWBu8GR6UsZYjioRRLpNy8aoJK0 ffUA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:references:in-reply-to:message-id:date:subject :cc:to:from; bh=jEN7cQJg1siDIOX7HZWo4TYJzqwAuQAxP6s9Ffng2Q0=; b=ySqYaYAFIEBuHo2mRzpKrZNwq519RrOtqPKlIjwalwbVjDP2Ire4vabu/uaVQiHQMn QBEdtx0C3J54iXM63Sg8zKnOnwaU0ywOSSVa6pmNdOej3F2WJJSgucvLBlxzbeMQFfQZ JtQGjQY0T+eE7y26e8t7s+xRUL6cJEpkprPYsHmTZYqZYRZPAWlbv6t1pl3P2A/LbDqN +hGrv++a1XvB5k80Ig8QPJgqgMtAO81rn6lSDfBlpHSPuj+lVS6qsstaohYE4zObkPyC BhffTwA+1D0nMQ8PJmxmAfFCVcp5Z+dj2I7sZiHNoe7PbTYBCVaR5IfoANT7kVF2c5h8 TvZA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=arm.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id n13si2563376ejk.5.2021.04.28.02.34.30; Wed, 28 Apr 2021 02:34:54 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=arm.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S238324AbhD1Jd5 (ORCPT + 99 others); Wed, 28 Apr 2021 05:33:57 -0400 Received: from foss.arm.com ([217.140.110.172]:38010 "EHLO foss.arm.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230301AbhD1Jd4 (ORCPT ); Wed, 28 Apr 2021 05:33:56 -0400 Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 867F51063; Wed, 28 Apr 2021 02:33:11 -0700 (PDT) Received: from e113131-lin.cambridge.arm.com (e113131-lin.cambridge.arm.com [10.1.195.76]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id 4EF043F70D; Wed, 28 Apr 2021 02:33:10 -0700 (PDT) From: Beata Michalska To: linux-kernel@vger.kernel.org Cc: peterz@infradead.org, mingo@redhat.com, juri.lelli@redhat.com, vincent.guittot@linaro.org, valentin.schneider@arm.com, dietmar.eggemann@arm.com, corbet@lwn.net, linux-doc@vger.kernel.org Subject: [RFC PATCH v2 3/3] sched/doc: Update the CPU capacity asymmetry bits Date: Wed, 28 Apr 2021 10:32:43 +0100 Message-Id: <1619602363-1305-4-git-send-email-beata.michalska@arm.com> In-Reply-To: <1619602363-1305-1-git-send-email-beata.michalska@arm.com> References: <1619602363-1305-1-git-send-email-beata.michalska@arm.com> Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Update the documentation bits referring to capacity aware scheduling with regards to newly introduced SD_ASYM_CPUCAPACITY_FULL shed_domain flag. Signed-off-by: Beata Michalska --- Documentation/scheduler/sched-capacity.rst | 6 ++++-- Documentation/scheduler/sched-energy.rst | 2 +- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/Documentation/scheduler/sched-capacity.rst b/Documentation/scheduler/sched-capacity.rst index 9b7cbe4..92d16e7 100644 --- a/Documentation/scheduler/sched-capacity.rst +++ b/Documentation/scheduler/sched-capacity.rst @@ -284,8 +284,10 @@ whether the system exhibits asymmetric CPU capacities. Should that be the case: - The sched_asym_cpucapacity static key will be enabled. -- The SD_ASYM_CPUCAPACITY flag will be set at the lowest sched_domain level that - spans all unique CPU capacity values. +- The SD_ASYM_CPUCAPACITY_FULL flag will be set at the lowest sched_domain + level that spans all unique CPU capacity values. +- The SD_ASYM_CPUCAPACITY flag will be set for any sched_domain that spans + cpus with any range of asymmetry. The sched_asym_cpucapacity static key is intended to guard sections of code that cater to asymmetric CPU capacity systems. Do note however that said key is diff --git a/Documentation/scheduler/sched-energy.rst b/Documentation/scheduler/sched-energy.rst index afe02d3..8fbce5e 100644 --- a/Documentation/scheduler/sched-energy.rst +++ b/Documentation/scheduler/sched-energy.rst @@ -328,7 +328,7 @@ section lists these dependencies and provides hints as to how they can be met. As mentioned in the introduction, EAS is only supported on platforms with asymmetric CPU topologies for now. This requirement is checked at run-time by -looking for the presence of the SD_ASYM_CPUCAPACITY flag when the scheduling +looking for the presence of the SD_ASYM_CPUCAPACITY_FULL flag when the scheduling domains are built. See Documentation/scheduler/sched-capacity.rst for requirements to be met for this -- 2.7.4