From patchwork Tue Jan 30 03:32:08 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Chenggang Wang X-Patchwork-Id: 193828 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2087:b0:106:209c:c626 with SMTP id gs7csp977927dyb; Mon, 29 Jan 2024 19:33:13 -0800 (PST) X-Google-Smtp-Source: AGHT+IEsfhf7Kfb+b7wAAqgYWXewNMnS200EkjVuu3ZTE7XKtr2DknqKuoVaxR/2ZnZ5eCb0Q48E X-Received: by 2002:a05:6402:34c:b0:55f:32ef:77d2 with SMTP id r12-20020a056402034c00b0055f32ef77d2mr839120edw.13.1706585593049; Mon, 29 Jan 2024 19:33:13 -0800 (PST) Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id y15-20020a056402358f00b0055ef175013bsi1871062edc.283.2024.01.29.19.33.12 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Jan 2024 19:33:13 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-43899-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; dkim=pass header.i=@vivo.com header.s=selector2 header.b=D6otkuMi; arc=fail (signature failed); spf=pass (google.com: domain of linux-kernel+bounces-43899-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-43899-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=vivo.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id A09B01F24525 for ; Tue, 30 Jan 2024 03:33:06 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id B2A4A374CC; Tue, 30 Jan 2024 03:32:45 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=vivo.com header.i=@vivo.com header.b="D6otkuMi" Received: from APC01-TYZ-obe.outbound.protection.outlook.com (mail-tyzapc01on2107.outbound.protection.outlook.com [40.107.117.107]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 8179137169; Tue, 30 Jan 2024 03:32:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=40.107.117.107 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706585561; cv=fail; b=uSa3xeLmUaeWwz9E+rWbDFuKN2E8FsIi1rKsgTWt+ZlU73LKaF0iz9LNwiShgOAE0BkdPfYDWVnN9anM1D1cqgKizsUU30ga2FSXdLYVo6VYNJa6hblJlKFl5/Q0+i3tfHZ82OwLmaF7KBYMM0W/cQs+x+cFt37X88MY6aD9UVk= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706585561; c=relaxed/simple; bh=t2fuw6cIz3fW47nCOwUFFm7p4CyDcBp2gvMyOeo6Hlo=; h=From:To:Subject:Date:Message-Id:In-Reply-To:References: Content-Type:MIME-Version; b=dn6tgQlnljh+PPdrLT1KLGvzWKmgtrsCU2zQ14bfJ9YjiRud2z11ykQCTxZ2ibIQkPSACFHKpgMNsOX5Ocr1uZCYy4GA1FxOczr5X+lTVi6ymvDT63juwI/qw3vLv9c3/BsKFLdxtcRnIxVGR//VlMv4z/QNq7CXWwMEueUF76s= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=vivo.com; spf=pass smtp.mailfrom=vivo.com; dkim=pass (2048-bit key) header.d=vivo.com header.i=@vivo.com header.b=D6otkuMi; arc=fail smtp.client-ip=40.107.117.107 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=vivo.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=vivo.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=K0DPvNIZBblIemIjoa41Z91FHmz831KcoOv9nll1UYfaJkOY6kBhhhhnMrkOJl+4vUpS47xmLzhHf+I+tVRgAv0riZL8pwQoOaz0pikJRtvM4UQ5mWMgN+0PpA6LAceIhRN5pGBgdOHtFT6cQLfIFsV0MN/fekNbnMQoln3Ave4iFnSS4BvU3NKe7s69CiS8aw4vF1KG41t30vqb4bwZxFBXgfkymC4M7PgEFqbfR6aaOZky8jPksSF6F0aw3f24sU+V1L++sjYK23kFq51ej8bOvGl7JE80o1AOivQEprZxaCnMMEMpV+okUu1aDuz3dytMr4SMhbivU19q9bWIQg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=TTTciFZWZ6p1TobMqmGz7s+9kkdKPuCltgFV97ItH5Q=; b=AzSnDJj/E3PDkIhTHJxf82InkswIw5JvmN2iOsA6+6w1tz8Ccc3jK/QxpGYurtj96vj6+niihND562Ypg7kqHAF+qs6Oeli2bM+13DBkWTaepjjHrCPMJxDZinuzYiBLFqNKz9N27oZm0Heb1d6XPbWcKZsexNOyUYHD19xkG8wvLv/LWy2LhCM567oktTHEIl/P5oPD+Cvt6btggXcE0/sI1cPUo1s7QiYD0b/DUE1xNG1mWjVzDbVlGVXFoZ9/90BRV3sZnw0cp72huUYD1h+YKN5M9U4bYgMoluQnTlYohafJbd6k8U4phMbe2MM5uSZJdvmwMhoqqmBZt88oFg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=vivo.com; dmarc=pass action=none header.from=vivo.com; dkim=pass header.d=vivo.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=vivo.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=TTTciFZWZ6p1TobMqmGz7s+9kkdKPuCltgFV97ItH5Q=; b=D6otkuMiO5//7HUK9+wNxnabDRwQb3COByXY0QiaPmBJa/EZgjjDX4qC02trr8ARcx8K+zDwmyfj3NXyPhUmfV5hWjSIltTIqiQiG6lQOdWtdNcUSfZ0TEnidU4OQdwjVGem+lWXFooo20mHZgc7/Y1JI6m8/7gw2n0GyfqgmEJ9vxLd0GoG/s/OFVmHUWyOM3Rfk+2pkPpkHyWG9QYKwFZMU8U3l0uxA0BoOgrQdenBvTvsAEwU4ISdVaUSyKLfuvsmMlODkvAIvL9JYAq501kkUcV4FJxTfPHwRmg2Wip3/ATvX1k4BkkXJQmqwpf0uyJweKsShmUiKKBO2UGS9A== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=vivo.com; Received: from TY0PR06MB5470.apcprd06.prod.outlook.com (2603:1096:400:264::9) by KL1PR06MB6394.apcprd06.prod.outlook.com (2603:1096:820:99::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7228.32; Tue, 30 Jan 2024 03:32:34 +0000 Received: from TY0PR06MB5470.apcprd06.prod.outlook.com ([fe80::adf8:c18e:5c1b:55d0]) by TY0PR06MB5470.apcprd06.prod.outlook.com ([fe80::adf8:c18e:5c1b:55d0%5]) with mapi id 15.20.7228.028; Tue, 30 Jan 2024 03:32:34 +0000 From: Chenggang Wang To: Jonathan Corbet , Alex Shi , Yanteng Si , Pierre Gondois , Bjorn Helgaas , Dietmar Eggemann , Lukasz Luba , Chenggang Wang , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH] sched/doc: Update EM API em_pd_energy to em_cpu_energy Date: Tue, 30 Jan 2024 11:32:08 +0800 Message-Id: <1706585531-24072-1-git-send-email-wangchenggang@vivo.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: References: X-ClientProxiedBy: SGBP274CA0019.SGPP274.PROD.OUTLOOK.COM (2603:1096:4:b0::31) To TY0PR06MB5470.apcprd06.prod.outlook.com (2603:1096:400:264::9) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: TY0PR06MB5470:EE_|KL1PR06MB6394:EE_ X-MS-Office365-Filtering-Correlation-Id: 3147b298-4560-426c-ce8a-08dc214418db X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 5ol35oxjq2CvZZOLpB37X5i/WD2V36mMhtimZk9fr0DnidbYzAQj+bSStYCs7wubEi1wNszaua/07yiluYg86xkXdwDSTbNAHR7Pff8L86FvirLf3vQbh27r5bW4PVkBsHMIzTt+mwq7/CN31tHL9Y4kWr42DrjSls6+k3oEVsg6ZKb9b+I63HPQCl9Y7sTVKusVHkcEwlrSoytdxK/YmPZuYWeqOErllDotQW0J0b6QioRABsLycpiqvpMvWCXwVpGPjubaYAt3JCulsw6L7vVC/TpR191P/HTMfMdd4yrovmwBbXUF0AinM5/l/jFVpZxgI6c8VAvM16IOZPkIg0RS9yEEuDb4RxW1m4HKJXdKzqn36XU5S73TCI4Qi9DV7rwtQh0NkgQpOEKO9NKuseL1MU0+AEhiyHBiq3QFykr89JbAaeRzlHNr18Dz9LcdWnn6qmft4tMsQIuYQSlyhVGTJEFi1JRiAifnvL0NNgB8WNiNmf7v2S/IHd71kn2rFwJGfFmkkelr1ToJGrz4XtbLMFoeNWogGz3ywnmTKh+cnAge4TgvFXlArbwud4U9jtPkFk3UYDuEx6IVEept2UHEL3kroPk+9y7W0Tk5bbOA6LuhHJ1qkmTuhBtUkVhvcCQsT9CCsh4iXjCpq8K3tw== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:zh-cn;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:TY0PR06MB5470.apcprd06.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(39860400002)(136003)(396003)(376002)(366004)(346002)(230922051799003)(451199024)(186009)(64100799003)(1800799012)(921011)(41300700001)(26005)(2616005)(316002)(38350700005)(36756003)(6512007)(52116002)(478600001)(6506007)(6486002)(83380400001)(6666004)(66946007)(38100700002)(66476007)(66556008)(2906002)(110136005)(86362001)(5660300002)(8676002)(8936002);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?5eWnCkFqX7anRox1hljdec0r3hNs?= =?utf-8?q?TJULtfMnGziMgjncTAtwmKphKVCp3rAAcg+q/oDAaezfH33mrI8GpLucAdBbRFWJ2?= =?utf-8?q?1YqXXKVpE5r73KmRzPTp7H0PYLxAoQa8TtrROWPZ778Wete3yQoMTqhP3GMLQ5enR?= =?utf-8?q?mdJYfWU7d6S9FpmMWv5eoJ3TNsxc/PcUfCIZlumOEYZbsWNVhHgSzqbQYHFcdE8KG?= =?utf-8?q?IY/dxItmYns6hX2zlPdhywrR1YJQwwAMzGOet+F2iztAEE4rtNiRlSEchPG07OQpV?= =?utf-8?q?pgrbLWkzy0IblANG+3iDHl8xfpAE+HLo9gBDvR1D2tRu3IzLUunwK/9Jp/DhWwTZO?= =?utf-8?q?td78pHkpNy2tP+WIr2oodobZ+Au8VfAL5eM/0UItXmneiGFfT1vzG+clywXV8UbQJ?= =?utf-8?q?1/yhMBP8QgZDhFUWL+GrnsktE8r16BQh5bvAtSHCX30aKoi77FRPdJntrfgEZywFq?= =?utf-8?q?C+YUVw+ROnJQ4SAK6XYC4n9l7diHnvX3Xw8Twh5WNN2L1hyFOG7K0SjXT4D/wGAoQ?= =?utf-8?q?NeZPv0NDjqz2LtC1c1PKS4BwrfzDw2hveU+MP44anl5kUYXTINtw8w8KwP5cw/C2I?= =?utf-8?q?/lI1SD7lQkbOWY+VQnwFP6/Goc6SD3lFColHV9iU5qf9XW4MLSx2/M7ZnwqsnwRq/?= =?utf-8?q?Q1KG9R8vXtPbQuvX/X4NcTepwgfQ/P6PjYIKYVC1HtdOBiVEOfLqlwZh6syN5aEQB?= =?utf-8?q?MSIAiUJ36k1ceOe9mwil7BG44Cg8bgFhybPNGkfmR2OQq2hKwI0gGeksgh8XccGfK?= =?utf-8?q?xqcBPo4zgtoRTwdQKgA+mCFaCLGYZ371TKvIWmAFCESlIqgYSmlbR+9LDZfkH/Pmv?= =?utf-8?q?2zdjLQb3NK+supvGNx0arrVXWDlA1iphj/+EuuuYS+KHchs79nDVESXo5+eMW4xBl?= =?utf-8?q?T6K4EqdY30QVs1DevDieLc0yKHjDhrR6Q24qW8z85pMDU9vQxSg5IMLBULSjUWMW1?= =?utf-8?q?VIzhzKlkAtxDpPO4+s0bnLNOUm1B+MuNePPhiuAXVfIbNZprt40ygtfdogMR7yYDl?= =?utf-8?q?XvWTGniNaeVZ50f86C7cIQcvgpUrP32HXLuBwjitQ4hiEELQpisfyJTnXG/vVJ1uz?= =?utf-8?q?4Znug4FkGbfwENsxtrYj1R4g0GoSbMoeFlmP1TwgcUJ1wri1CfKdGc9m2ace/go3G?= =?utf-8?q?9pImc8tGexa0RlpeYkfw7Y7P95bsqVzRqEkrYM9ehOQQ40H93LQGyj4kryg62dUFp?= =?utf-8?q?f729+kVrhZRdXp2guR+cyLaR4w5VEoa4+jx5vbs8dBwEVhRBzA0nidfQAAiPJhLe4?= =?utf-8?q?sWNPaZ3cU0iGoPp9745XklyoOvgS5noIdty1/xsymRQd41uRWI3oLRJW+LSyr58qg?= =?utf-8?q?uvY9wmE7NANn4BoKKKcmdK0FzOl+ulgsTchcV5yzBLCrrAu4jraESiJyW9DPehaR9?= =?utf-8?q?ffdAP4XbljHO9bWHA6RhcSTJCRM4A6Rq46XxKQc6JwBQsusEj2NHIx4Lmo7WujXiB?= =?utf-8?q?jSoSUNJb3tZs07cfhBRA6uO26moM9drw/Ssee9uqiNvzWx1yJ1bcBrjeghbobxnaT?= =?utf-8?q?y2dv/9UloSKi?= X-OriginatorOrg: vivo.com X-MS-Exchange-CrossTenant-Network-Message-Id: 3147b298-4560-426c-ce8a-08dc214418db X-MS-Exchange-CrossTenant-AuthSource: TY0PR06MB5470.apcprd06.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Jan 2024 03:32:34.0188 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 923e42dc-48d5-4cbe-b582-1a797a6412ed X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: Zo5zPmMz1ZMAjjlRRyrOXBbOqHbjwot86TMUPW7ht/Bkt8awm0VVxhJ7z4+/VAJomHemD3zth8u6IZJESZ3inQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: KL1PR06MB6394 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1789480001900401750 X-GMAIL-MSGID: 1789484694977359256 The em_pd_energy function name is obsolete and non-existent now. --- Documentation/scheduler/sched-energy.rst | 2 +- Documentation/translations/zh_CN/scheduler/sched-energy.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/scheduler/sched-energy.rst b/Documentation/scheduler/sched-energy.rst index 70e2921..84b37a2 100644 --- a/Documentation/scheduler/sched-energy.rst +++ b/Documentation/scheduler/sched-energy.rst @@ -141,7 +141,7 @@ in its previous activation. find_energy_efficient_cpu() uses compute_energy() to estimate what will be the energy consumed by the system if the waking task was migrated. compute_energy() looks at the current utilization landscape of the CPUs and adjusts it to -'simulate' the task migration. The EM framework provides the em_pd_energy() API +'simulate' the task migration. The EM framework provides the em_cpu_energy() API which computes the expected energy consumption of each performance domain for the given utilization landscape. diff --git a/Documentation/translations/zh_CN/scheduler/sched-energy.rst b/Documentation/translations/zh_CN/scheduler/sched-energy.rst index fdbf6cf..03dedc6 100644 --- a/Documentation/translations/zh_CN/scheduler/sched-energy.rst +++ b/Documentation/translations/zh_CN/scheduler/sched-energy.rst @@ -119,7 +119,7 @@ EAS覆盖了CFS的任务唤醒平衡代码。在唤醒平衡时，它使用平 如果唤醒的任务被迁移，find_energy_efficient_cpu()使用compute_energy()来估算 系统将消耗多少能量。compute_energy()检查各CPU当前的利用率情况，并尝试调整来 -“模拟”任务迁移。EM框架提供了API em_pd_energy()计算每个性能域在给定的利用率条件 +“模拟”任务迁移。EM框架提供了API em_cpu_energy()计算每个性能域在给定的利用率条件 下的预期能量消耗。 下面详细介绍一个优化能量消耗的任务放置决策的例子。