From nobody Sun Dec 14 12:17:06 2025 Received: from jpms-ob02.noc.sony.co.jp (jpms-ob02.noc.sony.co.jp [211.125.140.165]) (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 DF7365D8F0; Thu, 22 May 2025 02:08:41 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=211.125.140.165 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1747879724; cv=none; b=PBAg5lUDRnDEyiPKHF7YSY+KPz38BTsmgT8h8m66xiK3a6BgdWfRQyEtlS13Tgev5yJNJc9myeQ+vyLqMFMDdHm7uyP+oAf/IYxXV4I9b9nfKSFeQNhNsdcx0/jeFWTUHXtxvEX2vz5YwaFsc6U/OAEyneZWHYVr/GYAoHpYlbs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1747879724; c=relaxed/simple; bh=F17YJTre7W8ETwjYAoQoTHhUJ0XEXPmZDTHsHCtLFyo=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=FdU0QneBzyV6lg1g12Vz892/8KIc7eAyiZmo+/tFNNmy8szAQ/zcVoxp4mO5mcw3YiZtUVYc2sb8a2Ss/kDN/hwX5jXb/Rp6PRVe28xY5z3lP1ewKSXSgrQJwz64dvg+GmMP4zxW7tQabtkeeBhSRq/6TKOq6lpFnyca60v4DaY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=sony.com; spf=pass smtp.mailfrom=sony.com; dkim=pass (2048-bit key) header.d=sony.com header.i=@sony.com header.b=X/BbIOCB; arc=none smtp.client-ip=211.125.140.165 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=sony.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=sony.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=sony.com header.i=@sony.com header.b="X/BbIOCB" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sony.com; s=s1jp; t=1747879722; x=1779415722; h=from:date:subject:mime-version:content-transfer-encoding: message-id:references:in-reply-to:to:cc; bh=Gl9iGIrJoqNq1g0Gx7GgNroGdFROGDZiL+YPwHC/zd8=; b=X/BbIOCBlGXQdVUjAAQY6qW7dw4mMU/sXYtGb6DXxy2aXHyluRlbRfuk EoiWToOsZGP2HTP/6MggrsJr3ZrBNjfnHGcESxO2ZPeNztHW1evd2FOnu c0VuSVWbLNuT7vN8UxRcHhKp4nxc6GLOux4VMwQtrSLMS87DWBoM7pNH/ gtUyeVRj+nBSbOOtJuZ0S41W5WOP7xa2BNtB+0tI2M63sjmouN0a8dt57 7X52ydwEwBCpT1EdfyWu6bF3ca40HC8p4P61L4ktGZbvqM8mcC71O6dxT f8zegEnBY0XM7Nw7P0OiCkei3QvNFpIEgXGktmNIEQavBSgttez3PkmL8 w==; Received: from unknown (HELO jpmta-ob1.noc.sony.co.jp) ([IPv6:2001:cf8:0:6e7::6]) by jpms-ob02.noc.sony.co.jp with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 May 2025 11:08:37 +0900 X-IronPort-AV: E=Sophos;i="6.15,304,1739804400"; d="scan'208";a="562451314" Received: from unknown (HELO [127.0.1.1]) ([IPv6:2001:cf8:1:573:0:dddd:6b3e:119e]) by jpmta-ob1.noc.sony.co.jp with ESMTP; 22 May 2025 11:08:37 +0900 From: Shashank Balaji Date: Thu, 22 May 2025 11:08:12 +0900 Subject: [PATCH v3 1/3] cgroup, docs: convert space indentation to tab indentation Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250522-rt-and-cpu-controller-doc-v3-1-483fc9cca591@sony.com> References: <20250522-rt-and-cpu-controller-doc-v3-0-483fc9cca591@sony.com> In-Reply-To: <20250522-rt-and-cpu-controller-doc-v3-0-483fc9cca591@sony.com> To: Tejun Heo , Johannes Weiner , =?utf-8?q?Michal_Koutn=C3=BD?= , Jonathan Corbet Cc: cgroups@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Shinya Takumi , Shashank Balaji X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=3179; i=shashank.mahadasyam@sony.com; h=from:subject:message-id; bh=F17YJTre7W8ETwjYAoQoTHhUJ0XEXPmZDTHsHCtLFyo=; b=owGbwMvMwCV2mPH4Ij++H1mMp9WSGDL02pWT7tgr1536cGZHwglDg4Nzog5tOLSp9KHGttCzO wvucPCu6yhlYRDjYpAVU2R5J7PuwkEry6avxxm+wcxhZQIZwsDFKQATKVdn+KfTcnLax3TJw76a ZaZeIevWt52c7v0zqjVceIXIlW+b171nZJh8fseEf4vvfGhJXCWz/E6HVNKhrfxKP3/fuOF6zsi N/SQzAA== X-Developer-Key: i=shashank.mahadasyam@sony.com; a=openpgp; fpr=EE1CAED0C13A3982F5C700F6C301C7A24E0EF86A The paragraphs on cpu.uclamp.{min,max} are space indented. Convert them to tab indentation to make them uniform with the other paragraphs. Signed-off-by: Shashank Balaji --- Documentation/admin-guide/cgroup-v2.rst | 36 +++++++++++++++++------------= ---- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/Documentation/admin-guide/cgroup-v2.rst b/Documentation/admin-= guide/cgroup-v2.rst index 1a16ce68a4d7f6f8c9070be89c4975dbfa79077e..226fc7f9212eafcbf83c81f5b08= 391f215c1d894 100644 --- a/Documentation/admin-guide/cgroup-v2.rst +++ b/Documentation/admin-guide/cgroup-v2.rst @@ -1162,30 +1162,32 @@ All time durations are in microseconds. :ref:`Documentation/accounting/psi.rst ` for details. =20 cpu.uclamp.min - A read-write single value file which exists on non-root cgroups. - The default is "0", i.e. no utilization boosting. + A read-write single value file which exists on non-root cgroups. + The default is "0", i.e. no utilization boosting. =20 - The requested minimum utilization (protection) as a percentage - rational number, e.g. 12.34 for 12.34%. + The requested minimum utilization (protection) as a percentage + rational number, e.g. 12.34 for 12.34%. =20 - This interface allows reading and setting minimum utilization clamp - values similar to the sched_setattr(2). This minimum utilization - value is used to clamp the task specific minimum utilization clamp. + This interface allows reading and setting minimum utilization clamp + values similar to the sched_setattr(2). This minimum utilization + value is used to clamp the task specific minimum utilization clamp, + including those of realtime processes. =20 - The requested minimum utilization (protection) is always capped by - the current value for the maximum utilization (limit), i.e. - `cpu.uclamp.max`. + The requested minimum utilization (protection) is always capped by + the current value for the maximum utilization (limit), i.e. + `cpu.uclamp.max`. =20 cpu.uclamp.max - A read-write single value file which exists on non-root cgroups. - The default is "max". i.e. no utilization capping + A read-write single value file which exists on non-root cgroups. + The default is "max". i.e. no utilization capping =20 - The requested maximum utilization (limit) as a percentage rational - number, e.g. 98.76 for 98.76%. + The requested maximum utilization (limit) as a percentage rational + number, e.g. 98.76 for 98.76%. =20 - This interface allows reading and setting maximum utilization clamp - values similar to the sched_setattr(2). This maximum utilization - value is used to clamp the task specific maximum utilization clamp. + This interface allows reading and setting maximum utilization clamp + values similar to the sched_setattr(2). This maximum utilization + value is used to clamp the task specific maximum utilization clamp, + including those of realtime processes. =20 cpu.idle A read-write single value file which exists on non-root cgroups. --=20 2.43.0 From nobody Sun Dec 14 12:17:06 2025 Received: from jpms-ob02.noc.sony.co.jp (jpms-ob02.noc.sony.co.jp [211.125.140.165]) (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 33CB6126BFF; Thu, 22 May 2025 02:08:42 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=211.125.140.165 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1747879725; cv=none; b=CLBrIn8I3Tv/380oKIjguUgCkBkiSuqiQrMjK60dAP11uB0ANKUES7aqGIBCvDPd2uNSXcbLVA2eR8BTG1+nUCQG/YQ0f8Xjv2ej0L8G2CNV7FwOTBETRkuhN2VdCmoivDLFemS2upZlkVZpbyVihQ5TOFBfk2qqHQ3NEWYpIM4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1747879725; c=relaxed/simple; bh=G22jshGU7C2aVZ8VKgfdgmdlNKbB41JU/ZUJNKMIxpo=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=FY2SCWBZl3gyxGqz3e7QEbO+rboBpIfoGDdGOsDO0nljHTXMbVAaXiPoROQAPYI9OrNlIj5GChk7s+Va1fawhTVHcaW2dpwVFTVqL9QBnFb6NZ2SK4OPWYe+Z7MFtTO7sX9aBOkNhxjqU7Nf7ZU3FUpw3WhQFGzW6noiVPgobUU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=sony.com; spf=pass smtp.mailfrom=sony.com; dkim=pass (2048-bit key) header.d=sony.com header.i=@sony.com header.b=ZuY0X4q/; arc=none smtp.client-ip=211.125.140.165 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=sony.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=sony.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=sony.com header.i=@sony.com header.b="ZuY0X4q/" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sony.com; s=s1jp; t=1747879723; x=1779415723; h=from:date:subject:mime-version:content-transfer-encoding: message-id:references:in-reply-to:to:cc; bh=IriCGEyxogMDnCjn4gvwdcT8fXmdiv5bTxbWQrLz6dA=; b=ZuY0X4q/E7tJfBLQnfWZZfG5maaZF9ipCynegnLoQjVaLxNjEJPDt6MT vOepMT9o+0ykKMabIPDTNFGvkwnyz59JZjRxeG2b3iY53pWDp2lkdZ59W wdRH4RXEExI+12dI7vtD7DhFnvIRrkFzjXriNXQJ1Gp+bIa+NJ6OsxHOU BIn31+clE5vbGdt7J56LEifHtamQiwVROvgriQcjq0+IowczJ+GInDULI 8bYBu1kebksA3+9hH22ch+cZQdtMHDWpe7t5oC7sU+llRo5yXQX+Atb5O 4OOaAxbR+RT0yPRxydU6zOxfHvpc9YbSMuGezYsHXzewAFIqCwzuCb2j0 g==; Received: from unknown (HELO jpmta-ob1.noc.sony.co.jp) ([IPv6:2001:cf8:0:6e7::6]) by jpms-ob02.noc.sony.co.jp with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 May 2025 11:08:37 +0900 X-IronPort-AV: E=Sophos;i="6.15,304,1739804400"; d="scan'208";a="562451315" Received: from unknown (HELO [127.0.1.1]) ([IPv6:2001:cf8:1:573:0:dddd:6b3e:119e]) by jpmta-ob1.noc.sony.co.jp with ESMTP; 22 May 2025 11:08:37 +0900 From: Shashank Balaji Date: Thu, 22 May 2025 11:08:13 +0900 Subject: [PATCH v3 2/3] sched_ext, docs: convert mentions of "CFS" to "fair-class scheduler" Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250522-rt-and-cpu-controller-doc-v3-2-483fc9cca591@sony.com> References: <20250522-rt-and-cpu-controller-doc-v3-0-483fc9cca591@sony.com> In-Reply-To: <20250522-rt-and-cpu-controller-doc-v3-0-483fc9cca591@sony.com> To: Tejun Heo , Johannes Weiner , =?utf-8?q?Michal_Koutn=C3=BD?= , Jonathan Corbet Cc: cgroups@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Shinya Takumi , Shashank Balaji X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1965; i=shashank.mahadasyam@sony.com; h=from:subject:message-id; bh=G22jshGU7C2aVZ8VKgfdgmdlNKbB41JU/ZUJNKMIxpo=; b=owGbwMvMwCV2mPH4Ij++H1mMp9WSGDL02pUZIpi983ZXKkskf6zOORl4/5q1Xcw2X+aegty4i DONy/93lLIwiHExyIopsryTWXfhoJVl09fjDN9g5rAygQ3h4hSAiRifZmQ4fCN5Xfw598dP3dh+ zDjy4ekxEwO9m/1/E9d5zHnt/qdsNSNDq6HvxB9dwmn/0joqHpw9UhhgybB25x42f8fvPPWHytr 5AA== X-Developer-Key: i=shashank.mahadasyam@sony.com; a=openpgp; fpr=EE1CAED0C13A3982F5C700F6C301C7A24E0EF86A Mentions of CFS are stale since the fair-class scheduler is implemented usi= ng EEVDF. So, convert such mentions to "fair-class scheduler" to stay algorithm-name agnostic. Signed-off-by: Shashank Balaji --- Documentation/scheduler/sched-ext.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/scheduler/sched-ext.rst b/Documentation/schedule= r/sched-ext.rst index 0b2654e2164b8e6139db19fc8b68e6c5c289503d..ceca6f8966eeeb5f029a9ae41c0= 39d67c1db7be8 100644 --- a/Documentation/scheduler/sched-ext.rst +++ b/Documentation/scheduler/sched-ext.rst @@ -47,8 +47,8 @@ options should be enabled to use sched_ext: sched_ext is used only when the BPF scheduler is loaded and running. =20 If a task explicitly sets its scheduling policy to ``SCHED_EXT``, it will = be -treated as ``SCHED_NORMAL`` and scheduled by CFS until the BPF scheduler is -loaded. +treated as ``SCHED_NORMAL`` and scheduled by the fair-class scheduler unti= l the +BPF scheduler is loaded. =20 When the BPF scheduler is loaded and ``SCX_OPS_SWITCH_PARTIAL`` is not set in ``ops->flags``, all ``SCHED_NORMAL``, ``SCHED_BATCH``, ``SCHED_IDLE``, = and @@ -57,11 +57,11 @@ in ``ops->flags``, all ``SCHED_NORMAL``, ``SCHED_BATCH`= `, ``SCHED_IDLE``, and However, when the BPF scheduler is loaded and ``SCX_OPS_SWITCH_PARTIAL`` is set in ``ops->flags``, only tasks with the ``SCHED_EXT`` policy are schedu= led by sched_ext, while tasks with ``SCHED_NORMAL``, ``SCHED_BATCH`` and -``SCHED_IDLE`` policies are scheduled by CFS. +``SCHED_IDLE`` policies are scheduled by the fair-class scheduler. =20 Terminating the sched_ext scheduler program, triggering `SysRq-S`, or detection of any internal error including stalled runnable tasks aborts the -BPF scheduler and reverts all tasks back to CFS. +BPF scheduler and reverts all tasks back to the fair-class scheduler. =20 .. code-block:: none =20 --=20 2.43.0 From nobody Sun Dec 14 12:17:06 2025 Received: from jpms-ob02.noc.sony.co.jp (jpms-ob02.noc.sony.co.jp [211.125.140.165]) (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 4149113C8EA; Thu, 22 May 2025 02:08:45 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=211.125.140.165 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1747879728; cv=none; b=k9Ep1kzQly8UKwY+XE1A0UYPUSejQc6Wg1CZe74Yzz+V/6mIqm9SlwEzW97O7IClR5MHDD+EL+MoRDf/4PR5Fe8WFv9fRzs6gNx13KYfFRKZ6+QIkOJZ7eu7SgrUGlZMxX+0bYQiYXDN6UVp2T8HJBRK6C9yGGDFNX2rYlWhfuQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1747879728; c=relaxed/simple; bh=MGo2TrgSAZGTFTpzSDFpvC5bIS+2JtNwvhLtjp0qW2Q=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=eNaakyT4iXdmk59tHP+G/WgOU8O1xFuCK8duos4YoTnLlEjtBjtkXOYgRI7pYuL9EW55S5dXeYnjLgDy9jEMP+FPn43IBEeBCvEQbuYdrdFfrvdG1Ef0ewp8htPZi3zbWgEqXcqmXViEdOKODBWvtuk9ZmqONNR7lsFLpQ9MIL8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=sony.com; spf=pass smtp.mailfrom=sony.com; dkim=pass (2048-bit key) header.d=sony.com header.i=@sony.com header.b=U/B8bx8S; arc=none smtp.client-ip=211.125.140.165 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=sony.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=sony.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=sony.com header.i=@sony.com header.b="U/B8bx8S" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sony.com; s=s1jp; t=1747879725; x=1779415725; h=from:date:subject:mime-version:content-transfer-encoding: message-id:references:in-reply-to:to:cc; bh=WbwhPICS6LwqTgL/dS5U0nx5A28yOdYsAxPjKnNaSCg=; b=U/B8bx8SScSRuVXCDD6Q4G4qWT0RlG4S+89p6xs0OOQhPeiw6WXkdGLx +XKK8AprtMf5Z0SVwdnVKoisyswFxX7u0/WWufK8ddio11citAUG5/bTM M7bwvlcTVjek1MnjzPF/33qqqciOamDKdTM2rKmdoGSVwICiVnixRRJjD fn7htdFVniir9WIBqLjDMsWM5krJXmUuMkdsfy6zm0GTnWMYnejFZxCFn L2xeWfUjicOyt8UEHqJtt9Zr+JbBOPiVd8sZYLx2ABdEpeThPxZ79ymD8 1r0RaCwAIrloAz5xm8hUrBEr797BFZ3GEwFmvb6sQHdogClhEVi4g+RVD Q==; Received: from unknown (HELO jpmta-ob1.noc.sony.co.jp) ([IPv6:2001:cf8:0:6e7::6]) by jpms-ob02.noc.sony.co.jp with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 May 2025 11:08:37 +0900 X-IronPort-AV: E=Sophos;i="6.15,304,1739804400"; d="scan'208";a="562451316" Received: from unknown (HELO [127.0.1.1]) ([IPv6:2001:cf8:1:573:0:dddd:6b3e:119e]) by jpmta-ob1.noc.sony.co.jp with ESMTP; 22 May 2025 11:08:37 +0900 From: Shashank Balaji Date: Thu, 22 May 2025 11:08:14 +0900 Subject: [PATCH v3 3/3] cgroup, docs: cpu controller's interaction with various scheduling policies Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250522-rt-and-cpu-controller-doc-v3-3-483fc9cca591@sony.com> References: <20250522-rt-and-cpu-controller-doc-v3-0-483fc9cca591@sony.com> In-Reply-To: <20250522-rt-and-cpu-controller-doc-v3-0-483fc9cca591@sony.com> To: Tejun Heo , Johannes Weiner , =?utf-8?q?Michal_Koutn=C3=BD?= , Jonathan Corbet Cc: cgroups@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Shinya Takumi , Shashank Balaji X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=4929; i=shashank.mahadasyam@sony.com; h=from:subject:message-id; bh=MGo2TrgSAZGTFTpzSDFpvC5bIS+2JtNwvhLtjp0qW2Q=; b=owGbwMvMwCV2mPH4Ij++H1mMp9WSGDL02lUuXjsg/PfQj6Q/J+9qFta4bw6+zLM7feWK6nViA vebiprDO0pZGMS4GGTFFFneyay7cNDKsunrcYZvMHNYmUCGMHBxCsBEZIQY/vDnRrj/eltRvoAj 4tfThfcXqqf9sO5adTU9z1WKY7L+wV8M/4MO+nPM8Za9zNG1vM1eZzpHwM67e3S+CXzzKMg7YrD +Ah8A X-Developer-Key: i=shashank.mahadasyam@sony.com; a=openpgp; fpr=EE1CAED0C13A3982F5C700F6C301C7A24E0EF86A The cpu controller interface files account for or affect processes differently based on their scheduling policy, and the underlying scheduler used (fair-class vs. BPF scheduler). Document these differences Signed-off-by: Shashank Balaji --- Documentation/admin-guide/cgroup-v2.rst | 41 +++++++++++++++++++++++++++++= ---- 1 file changed, 37 insertions(+), 4 deletions(-) diff --git a/Documentation/admin-guide/cgroup-v2.rst b/Documentation/admin-= guide/cgroup-v2.rst index 226fc7f9212eafcbf83c81f5b08391f215c1d894..f6dc95608d239d586b482154c43= 67baaf5614fb6 100644 --- a/Documentation/admin-guide/cgroup-v2.rst +++ b/Documentation/admin-guide/cgroup-v2.rst @@ -1095,19 +1095,34 @@ realtime processes irrespective of CONFIG_RT_GROUP_= SCHED. CPU Interface Files ~~~~~~~~~~~~~~~~~~~ =20 -All time durations are in microseconds. +The interaction of a process with the cpu controller depends on its schedu= ling +policy and the underlying scheduler. From the point of view of the cpu con= troller, +processes can be categorized as follows: + +* Processes under the fair-class scheduler +* Processes under a BPF scheduler with the ``cgroup_set_weight`` callback +* Everything else: ``SCHED_{FIFO,RR,DEADLINE}`` and processes under a BPF = scheduler + without the ``cgroup_set_weight`` callback + +For details on when a process is under the fair-class scheduler or a BPF s= cheduler, +check out :ref:`Documentation/scheduler/sched-ext.rst `. + +For each of the following interface files, the above categories +will be referred to. All time durations are in microseconds. =20 cpu.stat A read-only flat-keyed file. This file exists whether the controller is enabled or not. =20 - It always reports the following three stats: + It always reports the following three stats, which account for all the + processes in the cgroup: =20 - usage_usec - user_usec - system_usec =20 - and the following five when the controller is enabled: + and the following five when the controller is enabled, which account for + only the processes under the fair-class scheduler: =20 - nr_periods - nr_throttled @@ -1125,6 +1140,10 @@ All time durations are in microseconds. If the cgroup has been configured to be SCHED_IDLE (cpu.idle =3D 1), then the weight will show as a 0. =20 + This file affects only processes under the fair-class scheduler and a BPF + scheduler with the ``cgroup_set_weight`` callback depending on what the + callback actually does. + cpu.weight.nice A read-write single value file which exists on non-root cgroups. The default is "0". @@ -1137,6 +1156,10 @@ All time durations are in microseconds. granularity is coarser for the nice values, the read value is the closest approximation of the current weight. =20 + This file affects only processes under the fair-class scheduler and a BPF + scheduler with the ``cgroup_set_weight`` callback depending on what the + callback actually does. + cpu.max A read-write two value file which exists on non-root cgroups. The default is "max 100000". @@ -1149,18 +1172,24 @@ All time durations are in microseconds. $PERIOD duration. "max" for $MAX indicates no limit. If only one number is written, $MAX is updated. =20 + This file affects only processes under the fair-class scheduler. + cpu.max.burst A read-write single value file which exists on non-root cgroups. The default is "0". =20 The burst in the range [0, $MAX]. =20 + This file affects only processes under the fair-class scheduler. + cpu.pressure A read-write nested-keyed file. =20 Shows pressure stall information for CPU. See :ref:`Documentation/accounting/psi.rst ` for details. =20 + This file accounts for all the processes in the cgroup. + cpu.uclamp.min A read-write single value file which exists on non-root cgroups. The default is "0", i.e. no utilization boosting. @@ -1177,6 +1206,8 @@ All time durations are in microseconds. the current value for the maximum utilization (limit), i.e. `cpu.uclamp.max`. =20 + This file affects all the processes in the cgroup. + cpu.uclamp.max A read-write single value file which exists on non-root cgroups. The default is "max". i.e. no utilization capping @@ -1189,6 +1220,8 @@ All time durations are in microseconds. value is used to clamp the task specific maximum utilization clamp, including those of realtime processes. =20 + This file affects all the processes in the cgroup. + cpu.idle A read-write single value file which exists on non-root cgroups. The default is 0. @@ -1199,7 +1232,7 @@ All time durations are in microseconds. own relative priorities, but the cgroup itself will be treated as very low priority relative to its peers. =20 - + This file affects only processes under the fair-class scheduler. =20 Memory ------ --=20 2.43.0