From patchwork Sun Nov 26 15:31:56 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: tip-bot2 for Thomas Gleixner X-Patchwork-Id: 169874 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:ce62:0:b0:403:3b70:6f57 with SMTP id o2csp2537097vqx; Sun, 26 Nov 2023 07:32:07 -0800 (PST) X-Google-Smtp-Source: AGHT+IGLXH9s7ItYjB+eXc5ZlsIVlZqN1zYwg7V8hRiaV3zRULXtGCzhvO9qAsy8KTBZsR+rlcOb X-Received: by 2002:a17:902:64d0:b0:1ca:e4b:148d with SMTP id y16-20020a17090264d000b001ca0e4b148dmr7259126pli.65.1701012727232; Sun, 26 Nov 2023 07:32:07 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1701012727; cv=none; d=google.com; s=arc-20160816; b=pBRmqyJVKXPEjOljU5wcHB31ms651By/UQ0AJSUQAMt2R1Nx8QoPfi0/y2AsOLFNte CnOPAvn9Y4lfEPrFig0YboUrMRhl6o7l1UZ6Fwo8+uwqU/Z3+ix/2WHevai2IhhGH/AG i4KY37M/47x/fZrWM56AA8+4F0Ce9cDO8lnrQagsHx7wIPxgzvPODhFuKwBYqeSHDpko ZFsdOG2w7CRAiuMTRDCcmTY2qNj0PF8HbTecVG8/37c7R5FIxcc2cE3KKwOGeimYGsFe O/Z6kFGNGpadp8NhAoPDfedijw37LpaduS7Htxd6bfNhelw43LlacbWat2Auyw5wBnwc WSXg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:robot-unsubscribe :robot-id:message-id:mime-version:cc:subject:to:reply-to:sender:from :dkim-signature:dkim-signature:date; bh=wZDQzpYPwIXy7ZkVo94d38dNrCZu2lgYfd/Ae+T13JE=; fh=ZOohaFziOthepnjzGlB8D/JzwwzDUY/Ut+COtQ74rIo=; b=dBOKJEQ3NOQapOuW1fd7XpkRersYerVjvFnyR0hlSz5xD87kHEpfZ3MeC36BaJiLI0 Cau7xYx5NWl/6p4R0C3qjApbg0jMQDXJwLvINAJsZUbP/yB9zqzMdN91u0UuFVcC8LmV UDbz66cIArtvgrxUOnAHU0mxWUHaCpBpZvqRBjMhnsx6k49+tM+AtlJLV0lt4SJmlt+E O7FH/UbTHfuSGQU7LmNxcW4RiCzUVmNdUgdkLF3NTOzWgbML2Bw2IspijgWLC/Xhaqsh TYwt6O/cfS+R7tGFKdR+/IcJFWPat1o2TwXCKr3LtBdfQabYiYPLQXMRnLH1alWEy1iG v9Dg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b="l/Yx75me"; dkim=neutral (no key) header.i=@linutronix.de header.s=2020e header.b="e/EcHhnR"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Received: from snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id j5-20020a170903024500b001c75540d9fesi8047525plh.587.2023.11.26.07.32.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 26 Nov 2023 07:32:07 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b="l/Yx75me"; dkim=neutral (no key) header.i=@linutronix.de header.s=2020e header.b="e/EcHhnR"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id 9360A8090F89; Sun, 26 Nov 2023 07:32:05 -0800 (PST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229562AbjKZPby (ORCPT + 99 others); Sun, 26 Nov 2023 10:31:54 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51282 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229437AbjKZPbx (ORCPT ); Sun, 26 Nov 2023 10:31:53 -0500 Received: from galois.linutronix.de (Galois.linutronix.de [193.142.43.55]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 717ABE1; Sun, 26 Nov 2023 07:31:59 -0800 (PST) Date: Sun, 26 Nov 2023 15:31:56 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1701012717; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=wZDQzpYPwIXy7ZkVo94d38dNrCZu2lgYfd/Ae+T13JE=; b=l/Yx75me2qv9uPm3StKp3F84Dn2i8AowPa8+JsxlC3s9edMt5atCTVjrEp6c5EzrH2dJdo RpOurV3ySaU3588fje6EFa67L1jskBMafPdCgwWdzEHip7c8R/nbH5cgVEtlv0X0OtaeZs Sklo9TBFsxj22BT6fxDlzOilWKKpVWr34bx0THYH1ZpJ0Ab0Magm4I1B1aB3lVEqr52Rp2 HdB01gibNdoSdktp4snx3dI0aDCCctHnOSvdABqPSCQA+CVjXgfstMGmJimeRz54uAc2vV EGciTPfub7Fvda7Rj0p2e2/JKTj/+xszgze3ZQrPT/4wGVP9qipl/Un2adq5lg== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1701012717; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=wZDQzpYPwIXy7ZkVo94d38dNrCZu2lgYfd/Ae+T13JE=; b=e/EcHhnRCGvYrYbIo3jmGMMPG3AxIpanaE4d/2wYSEJzyJzIlDorsIsBExT2kj5EwRgztk ClWKIlXJpE2tD2Bg== From: "tip-bot2 for Wenyu Huang" Sender: tip-bot2@linutronix.de Reply-to: linux-kernel@vger.kernel.org To: linux-tip-commits@vger.kernel.org Subject: [tip: sched/core] sched/doc: Update documentation after renames and synchronize Chinese version Cc: Wenyu Huang , Ingo Molnar , linux-kernel@vger.kernel.org, x86@kernel.org MIME-Version: 1.0 Message-ID: <170101271629.398.13171090108678818524.tip-bot2@tip-bot2> Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE,WEIRD_QUOTING 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-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Sun, 26 Nov 2023 07:32:05 -0800 (PST) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1783641121336637048 X-GMAIL-MSGID: 1783641121336637048 The following commit has been merged into the sched/core branch of tip: Commit-ID: 0257e5a3c26b3810831359d39c0821397af8bf29 Gitweb: https://git.kernel.org/tip/0257e5a3c26b3810831359d39c0821397af8bf29 Author: Wenyu Huang AuthorDate: Sat, 25 Nov 2023 02:05:27 Committer: Ingo Molnar CommitterDate: Sun, 26 Nov 2023 16:24:48 +01:00 sched/doc: Update documentation after renames and synchronize Chinese version Update the documentation after these changes, which didn't entirely propagate the changes: e23edc86b09d ("sched/fair: Rename check_preempt_curr() to wakeup_preempt()") 03b7fad167ef ("sched: Add task_struct pointer to sched_class::set_curr_task") 2f88c8e802c8 ("sched/eevdf/doc: Modify the documented knob to base_slice_ns as well") [ mingo: Reworked the changelog. ] Signed-off-by: Wenyu Huang Signed-off-by: Ingo Molnar Cc: linux-kernel@vger.kernel.org --- Documentation/scheduler/sched-design-CFS.rst | 8 +++---- Documentation/translations/zh_CN/scheduler/sched-design-CFS.rst | 8 +++---- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/Documentation/scheduler/sched-design-CFS.rst b/Documentation/scheduler/sched-design-CFS.rst index f689198..6cffffe 100644 --- a/Documentation/scheduler/sched-design-CFS.rst +++ b/Documentation/scheduler/sched-design-CFS.rst @@ -180,7 +180,7 @@ This is the (partial) list of the hooks: compat_yield sysctl is turned on; in that case, it places the scheduling entity at the right-most end of the red-black tree. - - check_preempt_curr(...) + - wakeup_preempt(...) This function checks if a task that entered the runnable state should preempt the currently running task. @@ -189,10 +189,10 @@ This is the (partial) list of the hooks: This function chooses the most appropriate task eligible to run next. - - set_curr_task(...) + - set_next_task(...) - This function is called when a task changes its scheduling class or changes - its task group. + This function is called when a task changes its scheduling class, changes + its task group or is scheduled. - task_tick(...) diff --git a/Documentation/translations/zh_CN/scheduler/sched-design-CFS.rst b/Documentation/translations/zh_CN/scheduler/sched-design-CFS.rst index 3076402..abc6709 100644 --- a/Documentation/translations/zh_CN/scheduler/sched-design-CFS.rst +++ b/Documentation/translations/zh_CN/scheduler/sched-design-CFS.rst @@ -80,7 +80,7 @@ p->se.vruntime。一旦p->se.vruntime变得足够大，其它的任务将成为� CFS使用纳秒粒度的计时，不依赖于任何jiffies或HZ的细节。因此CFS并不像之前的调度器那样 有“时间片”的概念，也没有任何启发式的设计。唯一可调的参数（你需要打开CONFIG_SCHED_DEBUG）是： - /sys/kernel/debug/sched/min_granularity_ns + /sys/kernel/debug/sched/base_slice_ns 它可以用来将调度器从“桌面”模式（也就是低时延）调节为“服务器”（也就是高批处理）模式。 它的默认设置是适合桌面的工作负载。SCHED_BATCH也被CFS调度器模块处理。 @@ -147,7 +147,7 @@ array）。 这个函数的行为基本上是出队，紧接着入队，除非compat_yield sysctl被开启。在那种情况下， 它将调度实体放在红黑树的最右端。 - - check_preempt_curr(...) + - wakeup_preempt(...) 这个函数检查进入可运行状态的任务能否抢占当前正在运行的任务。 @@ -155,9 +155,9 @@ array）。 这个函数选择接下来最适合运行的任务。 - - set_curr_task(...) + - set_next_task(...) - 这个函数在任务改变调度类或改变任务组时被调用。 + 这个函数在任务改变调度类，改变任务组时，或者任务被调度时被调用。 - task_tick(...)