From patchwork Fri Jan 27 06:39:54 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 49093 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp685578wrn; Thu, 26 Jan 2023 22:44:04 -0800 (PST) X-Google-Smtp-Source: AK7set/K8G/GATe5UJsWCfzMOZQR+ZyQ/GzPNWPC64q3rY3WsgIpVBaVsNFWczvg47jCkzs9YCsV X-Received: by 2002:a05:6402:2687:b0:4a0:a8d6:f9b9 with SMTP id w7-20020a056402268700b004a0a8d6f9b9mr11769975edd.39.1674801843994; Thu, 26 Jan 2023 22:44:03 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1674801843; cv=none; d=google.com; s=arc-20160816; b=cFm3/Uqzcqjb9TR+xOVQlSJSkYaIqCvFZP4i5OVOxuD5MiFAnHwCvj9wPdh1lq/G1I 4KaJyOXI3RNwpciEQPbs6L8JBGpdmaOsReuGeeh5JHvsXiAsGOxx2ah8FRS+Y/XhDfsN yJ6Mc/rz7/HAYxBQgnEWlcCpsWUJ/Xqcpe+oA/qf/3DLMoueIhW76qdhoOE0OEGfXw3t p8QE4wtsQxlJSYfNs7QOcasngEgSXSN6kGbYnrvORrQVCupzpMPvSouG4e/ra61t85GX ugm2X7Rl7mapfaNwSWPMdWI9RZKdFsGOcZE/6j/TJmnmYgyTR3BUZqD+aswgq2FHMqfk tqPQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=Wun9IWjPOiXfWyu4nd7AeW7blLAxtTp1bpFLmKHOfzY=; b=Pyi1aTqU3ImiD3wZczNne3//wPU261WajE2qf3iFeMSvgH47xJ78v4ozZzIKlB1ogI 5pJBFG0vQHcPfpDL0/SxA91Z8IxCkT65PC+9YRzhKhtQca+RhzEzBTCA5MWprvvD65A0 TvT0W7iZHquVqBK8jbIklS2IhgONCipZQHY7go8UHLfKLgkWKQj+2i6851Rxx0ZAMwx6 R1tZMWXbkWrj6vWfgw3aMPsq+s1vSNuSrzR4O4KGAvzT9qnoEFC906B9k4J8V60RibvS IRpcxOeZpV9xkzxcnQYX3d1z6EEc9+shSD4lH+7yiflhuD6neAaIZpDZbNmzOVOz/Afc 2IaQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=R9a6XKEi; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id m2-20020a509302000000b0046b2d74c08csi4624052eda.38.2023.01.26.22.43.37; Thu, 26 Jan 2023 22:44:03 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=R9a6XKEi; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229996AbjA0GlA (ORCPT + 99 others); Fri, 27 Jan 2023 01:41:00 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39114 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231895AbjA0GkW (ORCPT ); Fri, 27 Jan 2023 01:40:22 -0500 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B40026A71B; Thu, 26 Jan 2023 22:40:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=Wun9IWjPOiXfWyu4nd7AeW7blLAxtTp1bpFLmKHOfzY=; b=R9a6XKEirvXzcHf8cZIUgDZV7w BUPLqZHmj+7bGb80sLBAUb316zl6ummU4jCayQprUY8gpPUKWGH2EvYJJOjiqKuR86k0427uvhou2 veRv9z87rI8+87jBgexh+4zgBLOMCUQa6qB5Fd8ZTv4xHI8FjnBoTkmJ5tcFL07xB+cO1XsljY+U7 hkeByf/KSIdcEZIsarBq6P0tnH+B6eMHJ3oH+s0JlQ2Gqcu/ZYfhmM2H7rkuVgmtu2XVM0CKbBgts C1BwqiybCAwvpBAL/FLaS3xH/ZVFgZKFwPKEY4fyp6S8CBnmBcGSIsvxoX31BrBagnpl5HujhucEe fIAypYAw==; Received: from [2601:1c2:d80:3110::9307] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1pLIPN-00DM0u-5b; Fri, 27 Jan 2023 06:40:21 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Ingo Molnar , Peter Zijlstra , Juri Lelli , Vincent Guittot , Jonathan Corbet , linux-doc@vger.kernel.org Subject: [PATCH 24/35] Documentation: scheduler: correct spelling Date: Thu, 26 Jan 2023 22:39:54 -0800 Message-Id: <20230127064005.1558-25-rdunlap@infradead.org> X-Mailer: git-send-email 2.39.1 In-Reply-To: <20230127064005.1558-1-rdunlap@infradead.org> References: <20230127064005.1558-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1756157018367242705?= X-GMAIL-MSGID: =?utf-8?q?1756157018367242705?= Correct spelling problems for Documentation/scheduler/ as reported by codespell. Signed-off-by: Randy Dunlap Cc: Ingo Molnar Cc: Peter Zijlstra Cc: Juri Lelli Cc: Vincent Guittot Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org Reviewed-by: Mukesh Ojha --- Documentation/scheduler/sched-bwc.rst | 2 +- Documentation/scheduler/sched-energy.rst | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff -- a/Documentation/scheduler/sched-bwc.rst b/Documentation/scheduler/sched-bwc.rst --- a/Documentation/scheduler/sched-bwc.rst +++ b/Documentation/scheduler/sched-bwc.rst @@ -186,7 +186,7 @@ average usage, albeit over a longer time also limits the burst ability to no more than 1ms per cpu. This provides better more predictable user experience for highly threaded applications with small quota limits on high core count machines. It also eliminates the -propensity to throttle these applications while simultanously using less than +propensity to throttle these applications while simultaneously using less than quota amounts of cpu. Another way to say this, is that by allowing the unused portion of a slice to remain valid across periods we have decreased the possibility of wastefully expiring quota on cpu-local silos that don't need a diff -- a/Documentation/scheduler/sched-energy.rst b/Documentation/scheduler/sched-energy.rst --- a/Documentation/scheduler/sched-energy.rst +++ b/Documentation/scheduler/sched-energy.rst @@ -82,7 +82,7 @@ through the arch_scale_cpu_capacity() ca The rest of platform knowledge used by EAS is directly read from the Energy Model (EM) framework. The EM of a platform is composed of a power cost table per 'performance domain' in the system (see Documentation/power/energy-model.rst -for futher details about performance domains). +for further details about performance domains). The scheduler manages references to the EM objects in the topology code when the scheduling domains are built, or re-built. For each root domain (rd), the @@ -281,7 +281,7 @@ mechanism called 'over-utilization'. From a general standpoint, the use-cases where EAS can help the most are those involving a light/medium CPU utilization. Whenever long CPU-bound tasks are being run, they will require all of the available CPU capacity, and there isn't -much that can be done by the scheduler to save energy without severly harming +much that can be done by the scheduler to save energy without severely harming throughput. In order to avoid hurting performance with EAS, CPUs are flagged as 'over-utilized' as soon as they are used at more than 80% of their compute capacity. As long as no CPUs are over-utilized in a root domain, load balancing