From nobody Sun Feb 8 05:59:59 2026 Received: from NAM12-DM6-obe.outbound.protection.outlook.com (mail-dm6nam12on2046.outbound.protection.outlook.com [40.107.243.46]) (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 7C141153814 for ; Mon, 6 Jan 2025 17:03:24 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=40.107.243.46 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736183005; cv=fail; b=E375/C3rlekdMG2LfenmVWUMbODVHzEBhxKaSvTB3O/TB63XfnnxcUrGfedP8xiMFZvWUxz7qjPS3wf7SxOLMjmK8kFJpyJfu4r1ZAw5181XR2bIhFDPtjYiGBtntxWAhd9XgUw0CdZX1+lDQo0XGkUx4L5GD67Iq9qbA8yky4s= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736183005; c=relaxed/simple; bh=8D4jmKGZJHiCok7jmH2NLGsog2/eGSu1qe92loxPUk4=; h=From:To:Cc:Subject:Date:Message-ID:Content-Type:MIME-Version; b=qM2Ey40u1rSfByh+hblJCZu436qWmiZfa9xi12Idtw2DVjd44ZkAD1cTgqABGCi9HvpDjfm4cGQHqNzpkVIX3ahL0MX8CGe+L8THgUU00llTvpdAHS3sEff/mc5gTgtGYvVThpgU+J03rBClQhQsTMK3qrF0Rag5DFOFofyFp3M= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=nvidia.com; spf=fail smtp.mailfrom=nvidia.com; dkim=pass (2048-bit key) header.d=Nvidia.com header.i=@Nvidia.com header.b=Qrn+JuY5; arc=fail smtp.client-ip=40.107.243.46 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=nvidia.com Authentication-Results: smtp.subspace.kernel.org; spf=fail smtp.mailfrom=nvidia.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=Nvidia.com header.i=@Nvidia.com header.b="Qrn+JuY5" ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=g1sdgBRq2tuQScrq/I3WePuODq7UXk9lYvrGpiu7YE+uVLUIlYtWGDqm/rmQ7ImcJljPCMjark00hk811KQuYR1mrmokG4FXXh01Abdq29yVHdG2l3Cvgxp5n1kmTZclKX1A55h70DiGyQ5kt5Dn5K1SMLx5m1LleEfVnHPACJAklBf+rKm71o7v7JP1pnSj19dk9CVc+rN6QslmOfLXcQRMRrmwsW6QPUskVZgPX2iB1KvsEWd6Drp7d11Y7MGWCO+TsfVFULQrXpJQ3F7Zm28clydpeQkfOwFVE6L5Ckczpj/BQ40qURtNl2RGAnDlOFirWeStyOntYTTA3LvGbw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; 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=qd31AejGD33L0t8vvWGOmGLapPb96tz4TVDMT+cxJ30=; b=MYwQAcWAbqOjz4r8SsXGNpPAmI1I+H1mijbPGoett1Gb/gskuL/ZwHIOImZIS9d0yTyX4pEJvIh3IjH6vwyY3rKW+nLO4CazMBx/EU6JK1/m3tWB7cQCB6uTbEZYPjBkTTYD1mW/UEPrRhE8IAUsEl0dRzxX1jZ4ALEaVEziw+FJvr/IlQF+Xmma6s/6Cd3WUiTSTHu0e0FUuIqWFyHfDK01V7X27y7JrCfNOU4jJOOh886xDk0jys6efzcVvd1rvpeHBkDX0YjHsBql6hA7il+eVZlP5SfBgX+1TKhb8Rt6zPnIEonQChJsAoXLllOFgGfOm6BFdCFBPd9Z6paqgg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nvidia.com; dmarc=pass action=none header.from=nvidia.com; dkim=pass header.d=nvidia.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=qd31AejGD33L0t8vvWGOmGLapPb96tz4TVDMT+cxJ30=; b=Qrn+JuY5WRmRLBuNgYUmeo+SuenZFWJW5n7vzNO4/Sd5I01QETdxuxDppPJRiGLtM1XK2wNNDIzSQP829SeDuWZbzP1IKzyaggbeXvltX9wnYoGlUGXscZp8+dwdk3wzx7XhgvaJ7tk0MVcL6Fv1T1TQXr7P/m+ifXzJOAe7VcwhnIhcRqpN1RpMwA5zqRmltiGPmKimsh4kPJxkal+ZAYthQsnCvmS9vMMJnhDaw0zTSXnxb9chUOxy4M1uth7C1teo90P/bvW76lv457Rl/Phhp8DIJsfhXa2Vv8y43Q1cS+BAmV+ChjQgewPC3pY6QMOE/3zDq0bnUQsOI6Wjqw== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nvidia.com; Received: from CY5PR12MB6405.namprd12.prod.outlook.com (2603:10b6:930:3e::17) by CY8PR12MB8268.namprd12.prod.outlook.com (2603:10b6:930:6c::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8314.17; Mon, 6 Jan 2025 17:03:18 +0000 Received: from CY5PR12MB6405.namprd12.prod.outlook.com ([fe80::2119:c96c:b455:53b5]) by CY5PR12MB6405.namprd12.prod.outlook.com ([fe80::2119:c96c:b455:53b5%3]) with mapi id 15.20.8314.015; Mon, 6 Jan 2025 17:03:18 +0000 From: Andrea Righi To: Tejun Heo , David Vernet , Changwoo Min Cc: Jonathan Corbet , linux-doc@vger.kernel.or, linux-kernel@vger.kernel.org Subject: [PATCH] sched_ext: update scx_bpf_dsq_insert() doc for SCX_DSQ_LOCAL_ON Date: Mon, 6 Jan 2025 18:03:09 +0100 Message-ID: <20250106170309.205385-1-arighi@nvidia.com> X-Mailer: git-send-email 2.47.1 Content-Transfer-Encoding: quoted-printable X-ClientProxiedBy: FR4P281CA0420.DEUP281.PROD.OUTLOOK.COM (2603:10a6:d10:d0::17) To CY5PR12MB6405.namprd12.prod.outlook.com (2603:10b6:930:3e::17) 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: CY5PR12MB6405:EE_|CY8PR12MB8268:EE_ X-MS-Office365-Filtering-Correlation-Id: 6262e509-1031-44a2-fa1c-08dd2e740447 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|366016|1800799024|376014; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?lViAmjQ3yx5IauZeebBfaENn3AXQdf1CcKc8gEL3B2ugFwDit2S5pclySVFE?= =?us-ascii?Q?qI+NiIHvzOUDgqUOsu53dOoiNZ9CZ4prLo71bL+Bo5x3Rp+95NG2NB3hKeBO?= =?us-ascii?Q?T7/ES6EYV019bidzGWwqY7y1NyYiSkBH6j+bQArulngesgTAhbJ/Fh6shc4u?= =?us-ascii?Q?IG//3jM1nKP0WkVeGNRMyUbP0fUTjQp6mOO3OkSAfS3WLXxpw4wwp0QAtVWv?= =?us-ascii?Q?lwhYfq8vPa1Ga5iTW73sfH8YqVnIgprguq1H5frzY5F8m+WwCkquU4yzaZRK?= =?us-ascii?Q?rajcjwyzbSdzs2uv89PsuaMBExKvD+8zdEB5/+PM599fmmdthoNI0NF/H0iZ?= =?us-ascii?Q?AIG37z5MX0EwM+8gmw2lYqMoUdipaqU7Evguc4wKFVHbuhNChOcPSJ/LdpTd?= =?us-ascii?Q?sV+jwrLdAJ9cUbBPAtfPE04l2UUyNasK0Bie67nYyN4DFz3feDSQyqSidZbk?= =?us-ascii?Q?cm0CGa29QnCZNyR3S54xhyKyw3lu2y1o2/XUmPSAf0nkULLf3iAy38Hz4xvB?= =?us-ascii?Q?ZAtwABFuw4D5a+gXBkQ2irctas6xsni94SevA//JYmm2wgDXVNwDj1HjTPZw?= =?us-ascii?Q?nV6gOaWOSRe506u4vN2c3Ql0MFdKKqcCyRng9na7bllHg7+AslVe6eb4Tqo8?= =?us-ascii?Q?Wh+OwpPGGLMTGcTRI74YhJPfh77lMEdjF940EefhkGPNlcAIglcg8uEhHuyI?= =?us-ascii?Q?KEfbxAAXiT8i4HjIaipu9hID2LvDKUhZnqRwiddLg6CJNQg9+hnQiJFd9uxy?= =?us-ascii?Q?7+4T5m/OSzxiJFNkhB1LnHWKl7vKkshykuo4CGzGVB95uj9y2RkogZQK9ZOq?= =?us-ascii?Q?9jungoeGZbdo/d8FCbOAsdAluyKVbOOQGW7GsnVgojqVJexxMiWdJTtw2Otv?= =?us-ascii?Q?MXnxrumjWptfJw9+3IHK13LTXUcTngpvxj1YEH6c21kApQeuYdecJGEORiyB?= =?us-ascii?Q?YM35gni5UsTIADwaX40dub5zW06x7kigtqu5aKGAHpYm8vb0S4z3qS2eX2zD?= =?us-ascii?Q?G/NBkqm9Cly5Do0YDwKPKcILMCcz0/xASa41Ar7b0cdhx4lPwATlPBIJgNJB?= =?us-ascii?Q?RvKswGEYp7IiVDfO6Lho7RVR7PkCHAOgadJ9d7RcwzZNVgoZ2LRTys5cn9yX?= =?us-ascii?Q?PVHyi9ks8NxM/7xJGDgKzzuxRsBGAejFfCngdwWLFThIvFVzQhdJUHZkdji9?= =?us-ascii?Q?Enjl4roW1di3SLuqsDQlDxhtx36B7uZvvVifSSt8FNm3aIaFulviSoDg+Us3?= =?us-ascii?Q?Y7fqK+uskeYhCCa0vasCudLAHSvqS+VQV5gZbBfiiIziasYzopvux5A8ZEs/?= =?us-ascii?Q?i+uWQa/QIs+4hdkZSUsg1JUkMUgagNyEwgwk2yr+b5yOXnSSU522FpzkUs8/?= =?us-ascii?Q?QuLEjoaDaAclHjXGs+/UNXlKdLqk?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:CY5PR12MB6405.namprd12.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(366016)(1800799024)(376014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?cpfquRkBxQjt6xsyILvK4Gqjow8P4ZyYQaKVl6Dir8UOYlJhz19+ME8d5hNi?= =?us-ascii?Q?giL5ZtX/id5WzRkqZNLHA5x143AJYxJ3Xf+vPxSXV+TT/vLeiG0S8a8kTGnE?= =?us-ascii?Q?h3d+W5DGH3XOG/pZ2fOwi6FjtC/1+QNrfN/Epj5MEUwiHQrkebipP7evYgkS?= =?us-ascii?Q?ePMPuRlNfw+uZ4xtZozigMBbvwPeVlc4VIPZDm3x3o0TznNEiyxcs61Un5ba?= =?us-ascii?Q?Tsg6iZ/JNIkdY8EpW7DDxEm7PMpXgO223FrkwfNg4EXoSPy8slr7YFNBQoxn?= =?us-ascii?Q?f8B2D7U+MclQL2IPi9W7zGhUp49x+etk1uuq5ll9r137nfSfjx1OIxwEwPsQ?= =?us-ascii?Q?Gtgyoy0HeJo6OUhJFP6XHZe/QiQl9gzh0WiBYm/WZH8a7yNmPByJzXJqmY7D?= =?us-ascii?Q?dv/MR9cv/w78nb/5/6+puXV3OeWBnVAQvrsFuECqh5wmNZDVxeZFXSctrhUI?= =?us-ascii?Q?0lE6IoSVQtd3RTW9LdDKRuN0fqOjgwgWxjWAFjx5T78A93viZo1LJ9JDFi15?= =?us-ascii?Q?xZ9BGcD3aIhsQqblWh6QfzfglsYMOPIYqimORK1qHYCtxa7twA3kX+izSJWK?= =?us-ascii?Q?w+YcvcSyg8eTFsQ769ozzpnSIqwDkTSESRsi+DayqjaCf4lVtZ3dNhCZrDNX?= =?us-ascii?Q?3pIFVwUmzdr8IdBcwzMAzFhHVqTHEB37s888MewlzVO+3B29wOurX5qsqdUs?= =?us-ascii?Q?9PxwH6wTsIbXGVqXyuAwaCFsswsslDHX/P8N38ce7C5BztcKCZXhoT6nvsRE?= =?us-ascii?Q?4DJkePCxd5aIH5ekl9yacplgFWyuBts/oZXdb+ULTW+3Qqn9og96nz+2dgA8?= =?us-ascii?Q?1ixV8992dutu7fxO5dLwA1vYh3aJDpn4nSR2w23kfDg488Pb6sRjvMqlR6l0?= =?us-ascii?Q?b1i38egfjGbbFb7xcVmcjz44pxAvdZacbaB1cFARQ53HCUCkevdI3cjPXsPv?= =?us-ascii?Q?uQNEZ4SqhKFHcgYimvPEcrV6XcaqFqKntTeIUlMJi+PfuORBp8T3pm4H5Hsz?= =?us-ascii?Q?xYVML9MA3s4GGlbbW/Knc7+i+Ikss4LzI4k2XxhuXNUM9o1d89q3AT/WM7WU?= =?us-ascii?Q?V9r0sPuhdpfQa8idHNpgZ2YHkUZsRP3elko9Sn6PgyS43j4vrM+TyYkVt/H2?= =?us-ascii?Q?MK8WhsfBHnj54deqYozaWRIzjBFSGXNQwtnsZPrhqrypiiWZfjh6Ybe4FQLc?= =?us-ascii?Q?0Z+nrw4llTnbMwM180QnkMBu5+XjNHjcVv+x/rwuYLFkbpWYayKhrdkMYk6I?= =?us-ascii?Q?pd9f3yc2OmveM5twg2ZvF4MGRNKhyErU0s5xgHmypSm23Ge65PsyNnBMdyD5?= =?us-ascii?Q?bqu3ecgSY/1G5UPtWnWw9OvoLhLqN49GQnLJOjEgqJconMzs2U+w/nysyDBa?= =?us-ascii?Q?dGJgSpbp0OnpPHzQS1J/lKnjy5ObGn6Z8KsvhDDYxjVsK1yQ5tX3Dq9q4xnm?= =?us-ascii?Q?PrTeyJMEHXZ4l52pG0rlxQISQuCKkh8xc+YW5nEuVD2lcg5RlVG7EIIabtLH?= =?us-ascii?Q?EGOaxdJknzJaAEvVWyQD5J8f+fmSc6e3Fzxix8nkbr27yE8jydZ8MRFdbSiO?= =?us-ascii?Q?rID788Cg/RUn/jUzNNPkqd83WHNKVo/LTzK51ia2?= X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-Network-Message-Id: 6262e509-1031-44a2-fa1c-08dd2e740447 X-MS-Exchange-CrossTenant-AuthSource: CY5PR12MB6405.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Jan 2025 17:03:18.0984 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: gLTGK7fAk/6oXy/Ye2e1Qf1Q9rGrAzuE/Bgb8MxZDPGWV/P4Rjn58zWLcQ1RdStNW5qidop/BCFMkpeVSp5nGA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY8PR12MB8268 Content-Type: text/plain; charset="utf-8" With commit 5b26f7b920f7 ("sched_ext: Allow SCX_DSQ_LOCAL_ON for direct dispatches"), scx_bpf_dsq_insert() can use SCX_DSQ_LOCAL_ON for direct dispatch from ops.enqueue() to target the local DSQ of any CPU. Update the documentation accordingly. Fixes: 5b26f7b920f7 ("sched_ext: Allow SCX_DSQ_LOCAL_ON for direct dispatch= es") Signed-off-by: Andrea Righi --- Documentation/scheduler/sched-ext.rst | 6 +++--- kernel/sched/ext.c | 4 +--- 2 files changed, 4 insertions(+), 6 deletions(-) diff --git a/Documentation/scheduler/sched-ext.rst b/Documentation/schedule= r/sched-ext.rst index 6cb8b676ce03..a8ceaad63b6a 100644 --- a/Documentation/scheduler/sched-ext.rst +++ b/Documentation/scheduler/sched-ext.rst @@ -242,9 +242,9 @@ The following briefly shows how a waking task is schedu= led and executed. task was inserted directly from ``ops.select_cpu()``). ``ops.enqueue()`` can make one of the following decisions: =20 - * Immediately insert the task into either the global or local DSQ by - calling ``scx_bpf_dsq_insert()`` with ``SCX_DSQ_GLOBAL`` or - ``SCX_DSQ_LOCAL``, respectively. + * Immediately insert the task into either the global or a local DSQ by + calling ``scx_bpf_dsq_insert()`` with one of the following options: + ``SCX_DSQ_GLOBAL``, ``SCX_DSQ_LOCAL``, or ``SCX_DSQ_LOCAL_ON | cpu``. =20 * Immediately insert the task into a custom DSQ by calling ``scx_bpf_dsq_insert()`` with a DSQ ID which is smaller than 2^63. diff --git a/kernel/sched/ext.c b/kernel/sched/ext.c index 010ce7680bbc..c9f2fbb477ed 100644 --- a/kernel/sched/ext.c +++ b/kernel/sched/ext.c @@ -6406,9 +6406,7 @@ __bpf_kfunc_start_defs(); * ops.select_cpu(), and ops.dispatch(). * * When called from ops.select_cpu() or ops.enqueue(), it's for direct dis= patch - * and @p must match the task being enqueued. Also, %SCX_DSQ_LOCAL_ON can'= t be - * used to target the local DSQ of a CPU other than the enqueueing one. Use - * ops.select_cpu() to be on the target CPU in the first place. + * and @p must match the task being enqueued. * * When called from ops.select_cpu(), @enq_flags and @dsp_id are stored, a= nd @p * will be directly inserted into the corresponding dispatch queue after --=20 2.47.1