From patchwork Mon Oct 2 13:33:57 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: tip-bot2 for Thomas Gleixner X-Patchwork-Id: 147304 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2a8e:b0:403:3b70:6f57 with SMTP id in14csp1444463vqb; Mon, 2 Oct 2023 06:59:07 -0700 (PDT) X-Google-Smtp-Source: AGHT+IElL+DfnbNuuGAlM/xp+xPihtDTq7bB55VLZExKOg5DS/iIfonN4chj9Xsfm/LiT+l+rAxR X-Received: by 2002:a05:6808:2a53:b0:3ac:aae1:6d63 with SMTP id fa19-20020a0568082a5300b003acaae16d63mr10919675oib.44.1696255147373; Mon, 02 Oct 2023 06:59:07 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1696255147; cv=none; d=google.com; s=arc-20160816; b=mmvGKmMM5KbZeXDxuhoafvBXQmDMlyqzwkbAHhoNqmgXSdPSnNHtqqXDqWr3QiNDB7 MZCrE7Lvj6b5w3A40jQ7lxwffFnNovxu3K60u6MZgpFm3DCgUrLekEwzsfr38qnqjGlE asY9KAHPPG+ZXuidjVkmxgsVJkVXq7sjmg3S2dCLPUd8c84Ex4uzgbZO8aqPQ+4gfXKy j/SbzdEuCMmbQUYAw6bu5Nl0MBDw/cbQa9Tx99jWW3afKk6SnEFwraNZH5JhHzMFgoH5 99MFSb0EE8LOS3KhPvjh3NJ/KIPJMaJKxhJaZ0PvQ85ykpA+3lI94OMt9JhWgj7Zx1eo nSqw== 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:references:in-reply-to:cc:subject :to:reply-to:sender:from:dkim-signature:dkim-signature:date; bh=l3B5HvJRTYZooyesqcYO298zFGCQXM3m4DvMYNjoA7c=; fh=LcOZopNn7gm+JFHHAZk0tCihMQOZoWWYJXDCojcFWBU=; b=sAzDFaA56mgmQJuKvw5mIzIJqU6FkUnkjwTrlMe7L4ffRFxnpFfusdCzC+pe/t9g2N gfrVP6unoODebjz6xolU9mgVlq+pJKdr3BDeRv2zz96Jfl8GWEoQXfG6de/QY59Yd8vT MpmGRP1IBVOSc5UEactj9B1k5lLolOG76Ahqv4TdBsFLeQsJSuk+l+x8QXB9iUmhBmWt pa4UMCz5tUltTJ9N+yUzdv8euYmtUXOTwfPJ2l7WQuXrEY0v2KqVz5TxV7ZwmseJqLJ/ 6AHQaliEUGimIKChR7FFqo1K21vl/pc2G95StJsoBv/YlzUd5KGP0FwwSUSgMlA4/a/E fWYg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=obEmbsdT; dkim=neutral (no key) header.i=@linutronix.de; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 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 groat.vger.email (groat.vger.email. [23.128.96.35]) by mx.google.com with ESMTPS id v21-20020a17090a899500b0027902dc4914si7546759pjn.161.2023.10.02.06.59.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 02 Oct 2023 06:59:07 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) client-ip=23.128.96.35; Authentication-Results: mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=obEmbsdT; dkim=neutral (no key) header.i=@linutronix.de; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 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 groat.vger.email (Postfix) with ESMTP id F07388071058; Mon, 2 Oct 2023 06:34:17 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S237415AbjJBNeD (ORCPT + 18 others); Mon, 2 Oct 2023 09:34:03 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56256 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236762AbjJBNeC (ORCPT ); Mon, 2 Oct 2023 09:34:02 -0400 Received: from galois.linutronix.de (Galois.linutronix.de [193.142.43.55]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3CE9394; Mon, 2 Oct 2023 06:33:59 -0700 (PDT) Date: Mon, 02 Oct 2023 13:33:57 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1696253637; 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: in-reply-to:in-reply-to:references:references; bh=l3B5HvJRTYZooyesqcYO298zFGCQXM3m4DvMYNjoA7c=; b=obEmbsdTCjJeQWro29uZKjEhEalKRw8wo8dIQKfGVJXVxXWvS5Sgln0j6z+s4sFDCxgM+R nhmU23Rp1F5wL0m22fezMdVfMAHgE9ZbMA5M8EFVoYVDBNBmHmZBXRx6D9QThxkxwKDMw0 vCAySkzBDvLq6IjfewtnEnAv9JCgpV4M0AmYTmXoMA1OukBez/oD9Aq2pOQzsEEfQNuru3 6GEIyCy7wLimedfC4KY/FcuLOn9O+vw95YcWvsbDvGTqEoCc/jR8Vj2CLAS/J6nC/etA/x ZCVqESDJCimepe+Lz8uVHzKgOH7TmgAYkGfftjd8G+7ATSe8Aslabqh+FM0zDg== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1696253637; 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: in-reply-to:in-reply-to:references:references; bh=l3B5HvJRTYZooyesqcYO298zFGCQXM3m4DvMYNjoA7c=; b=YOD0gdBL4Z+Hmq5vRL+qGAT11iLNNhOzYlTTDTaH/oYU8Fh7tgvZdAhHu1Gl9SPraBAiyo g4WWvGYtvbM8K4Dw== From: "tip-bot2 for Cyril Hrubis" Sender: tip-bot2@linutronix.de Reply-to: linux-kernel@vger.kernel.org To: linux-tip-commits@vger.kernel.org Subject: [tip: sched/core] sched/rt/docs: Clarify & fix sched_rt_* sysctl docs Cc: Cyril Hrubis , Ingo Molnar , x86@kernel.org, linux-kernel@vger.kernel.org In-Reply-To: <20231002115553.3007-3-chrubis@suse.cz> References: <20231002115553.3007-3-chrubis@suse.cz> MIME-Version: 1.0 Message-ID: <169625363717.3135.9382164019084788726.tip-bot2@tip-bot2> Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email 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 (groat.vger.email [0.0.0.0]); Mon, 02 Oct 2023 06:34:18 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1778652437323749028 X-GMAIL-MSGID: 1778652437323749028 The following commit has been merged into the sched/core branch of tip: Commit-ID: e6dbdd8fb75526b01787050087b65d12c76b3666 Gitweb: https://git.kernel.org/tip/e6dbdd8fb75526b01787050087b65d12c76b3666 Author: Cyril Hrubis AuthorDate: Mon, 02 Oct 2023 13:55:52 +02:00 Committer: Ingo Molnar CommitterDate: Mon, 02 Oct 2023 15:17:13 +02:00 sched/rt/docs: Clarify & fix sched_rt_* sysctl docs - Describe explicitly that sched_rt_runtime_us is allocated from sched_rt_period_us and hence always less or equal to that value. - The limit for sched_rt_runtime_us is not INT_MAX-1, but rather it's limited by the value of sched_rt_period_us. If sched_rt_period_us is INT_MAX then sched_rt_runtime_us can be set to INT_MAX as well. Signed-off-by: Cyril Hrubis Signed-off-by: Ingo Molnar Link: https://lore.kernel.org/r/20231002115553.3007-3-chrubis@suse.cz --- Documentation/scheduler/sched-rt-group.rst | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/Documentation/scheduler/sched-rt-group.rst b/Documentation/scheduler/sched-rt-group.rst index 655a096..a16bee8 100644 --- a/Documentation/scheduler/sched-rt-group.rst +++ b/Documentation/scheduler/sched-rt-group.rst @@ -87,18 +87,20 @@ lack an EDF scheduler to make non-uniform periods usable. The system wide settings are configured under the /proc virtual file system: /proc/sys/kernel/sched_rt_period_us: - The scheduling period that is equivalent to 100% CPU bandwidth + The scheduling period that is equivalent to 100% CPU bandwidth. /proc/sys/kernel/sched_rt_runtime_us: - A global limit on how much time realtime scheduling may use. Even without - CONFIG_RT_GROUP_SCHED enabled, this will limit time reserved to realtime - processes. With CONFIG_RT_GROUP_SCHED it signifies the total bandwidth - available to all realtime groups. + A global limit on how much time realtime scheduling may use. This is always + less or equal to the period_us, as it denotes the time allocated from the + period_us for the realtime tasks. Even without CONFIG_RT_GROUP_SCHED enabled, + this will limit time reserved to realtime processes. With + CONFIG_RT_GROUP_SCHED=y it signifies the total bandwidth available to all + realtime groups. * Time is specified in us because the interface is s32. This gives an operating range from 1us to about 35 minutes. * sched_rt_period_us takes values from 1 to INT_MAX. - * sched_rt_runtime_us takes values from -1 to (INT_MAX - 1). + * sched_rt_runtime_us takes values from -1 to sched_rt_period_us. * A run time of -1 specifies runtime == period, ie. no limit.