From patchwork Thu Feb 9 07:13:52 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 54758 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp183984wrn; Wed, 8 Feb 2023 23:16:11 -0800 (PST) X-Google-Smtp-Source: AK7set/AAD7DXBprL1IKxAlecLlrBl22wo4TYSYqj+3l+/4i6zOsWqO0XaQEsM8PoTjLGvR6wom4 X-Received: by 2002:a17:906:180c:b0:884:930:b017 with SMTP id v12-20020a170906180c00b008840930b017mr11483820eje.60.1675926971231; Wed, 08 Feb 2023 23:16:11 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1675926971; cv=none; d=google.com; s=arc-20160816; b=Z7T1SQnNiPhLulixX07gZcAYLKqwqIucm2YztD9QRsoPenWhSWQ49qjAeTS7eSNMjD ZKfQoafkvLJC9aNdh2NQNTzlSEjyR5PYIKjNbMyrqxsumYQ40A6d8QlbA7FgM5MjxQfq f7qf7LnF/PxnasElMKE3v+Af7la7Y0AONv3ny8kzSrpfyQXaPo84xRrvik6TvQLH/Piu Z4TRyJZdWaAtpdu4+ICvbcszbnqcb5CY1TzWHCzIhjoZ7yy1CTSYIGSv0dQTbtfneuvG 8kW1QTJ0dVDr/8PpuxFKikBIPhxlfuWTxfwWqVUZVwzUt1GxBaNgdbMqjniRtL4yKN5b sObg== 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=r8hE41Mkp5EbgMrksb3KX7Dta0yeg7VtidU0DErrk9U=; b=BKXW8SB7FsSsuOYjKJ7ejz0y16gf7PEudddYB+KCVvUMkQA7xJ24VepPVvidPrQEQ5 qBTSO0EFHoJrj8/ib5DDG5o4FqQOCFlUjN8EbGlmGih3pWw0samEZBrvVYmebVpyhLHf FyzscqDa0BEzXK/s7xODHlam2KzcYuLuuEtsmOJtVRmTUlrXCju/buGQSEwCW23yEQvb 5RZkDBzYTzcrUaObV4JpsuXClBTskbFZt85Bd/cyq4yKJQJMQAhE0ydiEmzbM4SbK1zK PpFL0ZOZ11GBrxJ0lADpVwa1Pq9gTV1lApw0ajLXUvPoFyUpT88T+Q6JmzoSZfwRHJtv HrXw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=SSwLatKO; 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 ge24-20020a170907909800b00888d1e28772si1751838ejb.100.2023.02.08.23.15.46; Wed, 08 Feb 2023 23:16:11 -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=SSwLatKO; 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 S229802AbjBIHOw (ORCPT + 99 others); Thu, 9 Feb 2023 02:14:52 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48758 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229450AbjBIHOM (ORCPT ); Thu, 9 Feb 2023 02:14:12 -0500 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B899CA24A; Wed, 8 Feb 2023 23:14:11 -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=r8hE41Mkp5EbgMrksb3KX7Dta0yeg7VtidU0DErrk9U=; b=SSwLatKOiislYacsoo/Qi3JMlm b47ynisAwSrwGZYUASI66PxrUlyXGIC+yTFVomaUau58oZFIBo8jpLh1nKCHpGG1hzYaKwBa1fm5V MGzmE4oBMeEqrdn5s5zpFUd8r4fPoJzBc5Ip5AwXp99OeI1O5RmT/VlSbt0BYAksgp45OfAwRygNx i/pzyJ1nycNY+Xw/zZ/bZ4J0UyKubduraexKOGpFEp+Z26FQ29A6BoKJCASscbE4D41ElbfTj4DLm CFJF1BTGKjk9PTmvQUBILAJfIGvPULY2mO3cn6qHTxry4AKsGjQ6XNrMZ74qioxOvAb4QQpypQ9Ag iioQY5nQ==; Received: from [2601:1c2:980:9ec0::df2f] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1pQ18F-000LPt-A5; Thu, 09 Feb 2023 07:14:11 +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, Mukesh Ojha Subject: [PATCH 16/24] Documentation: scheduler: correct spelling Date: Wed, 8 Feb 2023 23:13:52 -0800 Message-Id: <20230209071400.31476-17-rdunlap@infradead.org> X-Mailer: git-send-email 2.39.1 In-Reply-To: <20230209071400.31476-1-rdunlap@infradead.org> References: <20230209071400.31476-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?1757336799819369707?= X-GMAIL-MSGID: =?utf-8?q?1757336799819369707?= 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 Acked-by: Vincent Guittot --- 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