{"id":2196677,"url":"http://patchwork.ozlabs.org/api/1.0/patches/2196677/?format=json","project":{"id":28,"url":"http://patchwork.ozlabs.org/api/1.0/projects/28/?format=json","name":"Linux PCI development","link_name":"linux-pci","list_id":"linux-pci.vger.kernel.org","list_email":"linux-pci@vger.kernel.org","web_url":null,"scm_url":null,"webscm_url":null},"msgid":"","date":"2026-02-16T02:26:38","name":"[v5,2/6] Documentation/kernel-parameters: Add multi-device config_acs example","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"12fa0196f4c1d2ffec8051b2517dd51f443ce09c","submitter":{"id":92382,"url":"http://patchwork.ozlabs.org/api/1.0/people/92382/?format=json","name":"Wei Wang","email":"wei.w.wang@hotmail.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/linux-pci/patch/SI2PR01MB439374DAD3F3E7F95D72E801DC6CA@SI2PR01MB4393.apcprd01.prod.exchangelabs.com/mbox/","series":[{"id":492242,"url":"http://patchwork.ozlabs.org/api/1.0/series/492242/?format=json","date":"2026-02-16T02:26:36","name":"PCI: Add support for ACS Enhanced Capability","version":5,"mbox":"http://patchwork.ozlabs.org/series/492242/mbox/"}],"check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2196677/checks/","tags":{},"headers":{"Return-Path":"\n ","X-Original-To":["incoming@patchwork.ozlabs.org","linux-pci@vger.kernel.org"],"Delivered-To":"patchwork-incoming@legolas.ozlabs.org","Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=hotmail.com header.i=@hotmail.com header.a=rsa-sha256\n header.s=selector1 header.b=HvOX0Q8S;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org\n (client-ip=2600:3c04:e001:36c::12fc:5321; helo=tor.lore.kernel.org;\n envelope-from=linux-pci+bounces-47325-incoming=patchwork.ozlabs.org@vger.kernel.org;\n receiver=patchwork.ozlabs.org)","smtp.subspace.kernel.org;\n\tdkim=pass (2048-bit key) header.d=hotmail.com header.i=@hotmail.com\n header.b=\"HvOX0Q8S\"","smtp.subspace.kernel.org;\n arc=fail smtp.client-ip=52.103.66.59","smtp.subspace.kernel.org;\n dmarc=pass (p=none dis=none) header.from=hotmail.com","smtp.subspace.kernel.org;\n spf=pass smtp.mailfrom=hotmail.com"],"Received":["from tor.lore.kernel.org (tor.lore.kernel.org\n [IPv6:2600:3c04:e001:36c::12fc:5321])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fDms96CRRz1xtN\n\tfor ; Mon, 16 Feb 2026 13:27:57 +1100 (AEDT)","from smtp.subspace.kernel.org (conduit.subspace.kernel.org\n [100.90.174.1])\n\tby tor.lore.kernel.org (Postfix) with ESMTP id 0CCA7301A7E4\n\tfor ; Mon, 16 Feb 2026 02:27:30 +0000 (UTC)","from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 22F382459E7;\n\tMon, 16 Feb 2026 02:27:22 +0000 (UTC)","from OS8PR02CU002.outbound.protection.outlook.com\n (mail-japanwestazolkn19012059.outbound.protection.outlook.com [52.103.66.59])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby smtp.subspace.kernel.org (Postfix) with ESMTPS id CB3D1220F2A;\n\tMon, 16 Feb 2026 02:27:20 +0000 (UTC)","from SI2PR01MB4393.apcprd01.prod.exchangelabs.com\n (2603:1096:4:1b0::7) by SEL0PF89D6F6B8B.apcprd01.prod.exchangelabs.com\n (2603:1096:108:1::5b3) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9611.16; Mon, 16 Feb\n 2026 02:27:16 +0000","from SI2PR01MB4393.apcprd01.prod.exchangelabs.com\n ([fe80::c735:fab8:6e3d:6d1c]) by SI2PR01MB4393.apcprd01.prod.exchangelabs.com\n ([fe80::c735:fab8:6e3d:6d1c%4]) with mapi id 15.20.9611.012; Mon, 16 Feb 2026\n 02:27:16 +0000"],"ARC-Seal":["i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1771208842; cv=fail;\n b=SZaMtbD6i/UQAjpV/kGOMtAgN09m08rnVgu92C6mz+skoJpCbztV/GFfYPKfryXURJTLhpxOSLh939P9Gifsf4jXRw7r3NsdOx9tz2p46Q3ms2eYpPsJWV7Nk/QObyK22heq/42uUV1Lg04LKRzKI1yEWNgkqgzLmzdQe78ljJg=","i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;\n b=dyY4Yx4b+fd9uxF1NqOinYVQd6uuQi64mDkd++wxcPwv5ioa9byB/cwiqZn6Xh4dPN8vn+VzsjmBg+y7zFvDbolwdMuQPD97JAgNP7SFcqlXyjvgIK5/YRIxTxq4QPCslLrMSJBKLEr48DP10gMnb4ax+THcWwSxRRzjKHOAzzyyCiZFdVIc3e8AGCoTY/eYegiDD8zjDFhk4nOS8e9FCdtp63lJ//MZ6WC11yEXYneDaU+EyqEAnFks0zCKXb+TLWd6BiETSpNQqFh1XmNwcljbv8UJd06xB0tzXEaaP/BDUTihBhlOmmPoBtEYv32cQ5q8fdqi9tI1YKz36OmF+A=="],"ARC-Message-Signature":["i=2; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1771208842; c=relaxed/simple;\n\tbh=xs5nQVGPAGV6p210nd6mRn3KhvRsrRDI79ZawuvrUqY=;\n\th=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References:\n\t Content-Type:MIME-Version;\n b=pN33pgn/PLRuR7ZwRiVntmHlrhpfD/cFFCeZvw91oHhtAXSoW7AOiZRUhT9d1SY1TvnnS1x4GPF6C4TZabqw09PPPkcMZLCPo/xRzyVa1ZLYbPVzVebS4i6X7DvkdZpl/+4sMNfZsF5bkw8sU97EiEkUnKm9sBAiCPRzekvN7Ik=","i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector10001;\n 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;\n bh=I7PLXq2SRHEq6nWilsnGkOfA/X1gkzlUkSElH1dAVfo=;\n b=dROtHtbjouj6i1Xb9GjI8p5zJUPo5qYO5ZREUS2iP3Una/g3ickXcGyuws5NzEtcKkiFsZwPIXP6nVtvQxbFFRkDjENCASKOlthtNXWW31qlx30jiHJk6uV6OV+Se9xh5jCLuGBZqHRcQM7pa7aRcFQ3aWqwcbXgb5UQBedgmsd2QR/6Rr17HKNKmQ9cqV9btK6/WwWAlu9BnL+eCYKHePbaQokJeP9hJseoz2LGsX6POTIL3Kz4hElgrlBbXu3S4TanOYGqrDHwx3ziQAL3YH7Y6VrvOfwQkYzATl3aUIZL8g6Bovl2EWf4vT+/3fXwPFamtGR9bZN51P8SO4Aa9Q=="],"ARC-Authentication-Results":["i=2; smtp.subspace.kernel.org;\n dmarc=pass (p=none dis=none) header.from=hotmail.com;\n spf=pass smtp.mailfrom=hotmail.com;\n dkim=pass (2048-bit key) header.d=hotmail.com header.i=@hotmail.com\n header.b=HvOX0Q8S; arc=fail smtp.client-ip=52.103.66.59","i=1; mx.microsoft.com 1; spf=none; dmarc=none;\n dkim=none; arc=none"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=hotmail.com;\n s=selector1;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=I7PLXq2SRHEq6nWilsnGkOfA/X1gkzlUkSElH1dAVfo=;\n b=HvOX0Q8SSxufvjjTUIZmp0ftzJXLLouRC1/lMC0LZAc7g9EdELuUCKwdEE0JE1EnzWL/2Dpftojmt/4p9WpnzfS9XxucvOCc0cI5pvbcHOdfP0RxKLiMSkT46TxK/oXaQQAThIGbk7Pmo+RRLNTyZz+U9n0KcYrk0me5vVpGqG8eglp85iyhp4H/4O/xH+yKAfaJLztcMQjf66OKgKq78JoEJqj0jrT4JJObO2q+DluOOoc6r+T5/TgOVf6Yo6QRPP3bzhIwfNqiQtdyOhAUZzQKxoGRAkUQxoEUEEkjOAcZO/s/PCC9GWlIHc/oxGdIQtIyPkQabcPTK2BaEdU5fA==","From":"Wei Wang ","To":"bhelgaas@google.com,\n\tjgg@nvidia.com,\n\tjonathan.cameron@huawei.com,\n\takpm@linux-foundation.org,\n\tbp@alien8.de,\n\trdunlap@infradead.org,\n\talex@shazbot.org,\n\tkevin.tian@intel.com","Cc":"linux-kernel@vger.kernel.org,\n\tlinux-pci@vger.kernel.org,\n\twei.w.wang@hotmail.com","Subject":"[PATCH v5 2/6] Documentation/kernel-parameters: Add multi-device\n config_acs example","Date":"Mon, 16 Feb 2026 10:26:38 +0800","Message-ID":"\n ","X-Mailer":"git-send-email 2.51.0","In-Reply-To":"\n ","References":"\n ","Content-Type":"text/plain; charset=UTF-8","Content-Transfer-Encoding":"8bit","X-ClientProxiedBy":"TY4P301CA0029.JPNP301.PROD.OUTLOOK.COM\n (2603:1096:405:2be::12) To SI2PR01MB4393.apcprd01.prod.exchangelabs.com\n (2603:1096:4:1b0::7)","X-Microsoft-Original-Message-ID":"\n <20260216022642.112923-3-wei.w.wang@hotmail.com>","Precedence":"bulk","X-Mailing-List":"linux-pci@vger.kernel.org","List-Id":"","List-Subscribe":"","List-Unsubscribe":"","MIME-Version":"1.0","X-MS-Exchange-MessageSentRepresentingType":"1","X-MS-PublicTrafficType":"Email","X-MS-TrafficTypeDiagnostic":"SI2PR01MB4393:EE_|SEL0PF89D6F6B8B:EE_","X-MS-Office365-Filtering-Correlation-Id":"731a1604-8f80-4fbc-4ceb-08de6d02e688","X-Microsoft-Antispam":"\n\tBCL:0;ARA:14566002|15080799012|19110799012|23021999003|41001999006|8060799015|461199028|5072599009|6090799003|37102599003|51005399006|440099028|3412199025|40105399003|1710799026;","X-Microsoft-Antispam-Message-Info":"=?utf-8?q?5ZUEoq08WMpnE/kjNYfKyLn0Pv+0VLw?=\n\t=?utf-8?q?aPKCsxhz+Wy569L0LE0dqaak6Lx32/qhDMkHzFu+F3x/ewVaMOTWLIxsCgAPytBqd?=\n\t=?utf-8?q?FxSKxuB+3v8lbyooF4GHLVF34pT1ZKEN4QJ/REhc/lnSbY9vg/rYl3ITyQXDPbOK5?=\n\t=?utf-8?q?VqKXyqdFKT9qnMEkHA9YVXMpRfhd018/rHeOEHUpZIOUvB+9woY5cwas9jDK1Qg5C?=\n\t=?utf-8?q?GwkfkfBcZCPCZ3F5J7LA63sGKsbiBUPM1c6yzcdYaW+nXaEGgYKlUASIemLZQjRnb?=\n\t=?utf-8?q?llckDqKWS2d88VdqoU8xu8mVNIe0stG2cmXdLSWyowLhRwoCstn0rgod6ftna5Wfk?=\n\t=?utf-8?q?pec0h8MQsYjc2/UPqoRem7P/NdJtGRalGXV4lrHztw4Bw96vQiEr7MbSMjuNPlvS5?=\n\t=?utf-8?q?5DCtUIY4f/1v0d6ixgCEMdXjf2l3yQQ9rWunF9YUP0bc5egbfiw87TsrzcZaRRMqE?=\n\t=?utf-8?q?LV5zL43vRw9z+OuNZZXvmFZ6fiJYqFE05G3QvOb1q1s8pJbZwGowNFjvoXciu0Ut/?=\n\t=?utf-8?q?cVT9LNBOhZcdsd2U16nXf03cUdayNfEaLwYUbnVEVBC9T48z9UhkLue7YX7aZhDpQ?=\n\t=?utf-8?q?0NOUO2+4ZIcm0KuF8SLFlmpiW+0c2gEcNqjl+2M7qxV0fZammhBL7PlpRiu7P7qS9?=\n\t=?utf-8?q?IlE2Sb1aiplgxLUsBLXkUzCAdN7MCO6De3djXt//qmVrC4wNfgzGdHRUzQe5kr3OC?=\n\t=?utf-8?q?A1HPmqLNjfhdKSEz2ZbZrFAMQ1SVGvmb2P6PCTntIibC0aqfAh4VcN0TCYfqNLQfc?=\n\t=?utf-8?q?fM787VeeKsqF0QZznZVIcs72rXlNlhJ1FCasoaMVA8BLteLS38G/qK2gYvdtD/x+V?=\n\t=?utf-8?q?EL8/xStXch6AX0ZsMCrYsA37AQlkZ3abzWLvjXeVAqhwrv6KXGpitizzxguCb51mr?=\n\t=?utf-8?q?0zvIwpFDxJeZdrPBANNP/Q4144U7zN4srnuUbuWeUbKUCce8VjcagEQqCaF5Bu4+r?=\n\t=?utf-8?q?5+1FqxWuL/iDpXmBZNBbdwufLdGtyuvqybnkklQy/ENdKNL9qldDECQE+SFaeinvU?=\n\t=?utf-8?q?TNUc5dQ/jwAD66N0NQdoH2oc+T0R8DrSA4k1fST8JA9oRCkoUBhNfFdLnDwTC4jcK?=\n\t=?utf-8?q?E/3NQ7m/feA/uv9Ib9Lm0ONYueDvvXPY2w6ujeXjYPK1my99kIVY88rCWGWkNOaQu?=\n\t=?utf-8?q?lgAwexSRbvuhP1looX5RI7Q7YExxFi57+HEkgofK/zz24p7I2Qq4lO0AkU8uAyC8r?=\n\t=?utf-8?q?rOIIZL8TYy8GoHzQHna+0+84GnlFpr84dfg0Qxuls2e0jsladNN+Bc7lI=3D?=","X-MS-Exchange-AntiSpam-MessageData-ChunkCount":"1","X-MS-Exchange-AntiSpam-MessageData-0":"=?utf-8?q?Oz9sCaDgvfRPVyjo1rJBqerkRzfu?=\n\t=?utf-8?q?mTkm9Dj1KdHKLHqs0Yhrd3j3d3Joyggv1fEbVntzJyzgmOA3bJVhooqaVn/lunks4?=\n\t=?utf-8?q?lJfzEnEZeAAFTGN+6khFzU6P49bdHOTWiRi50r1Hqcwye9DydYuEqMUhrnqMgTlRI?=\n\t=?utf-8?q?TCAdv0dzK3o0F73tOXSQgHT7ZCOLle3IfQHVoXqB0dyCyDjUuFATq7ALuwveSaMkd?=\n\t=?utf-8?q?xLtWuHQrmnivT419pPMLJgk5RMLQ1pBxe7fWimbT07IpLyNpFkMvns7DxG+XCxabc?=\n\t=?utf-8?q?nIapf3rYW6kBuieHm25vNAVwWh7mjQN7ZMZlSEEG/+mPM10kMyFpSYQSNekCY9u5h?=\n\t=?utf-8?q?JE8f4Rb3hXQv19lIMaAwCVG9gD0YMYsCgsuSpioRIaI+TN+wLywOWYtuGkpf6a6yD?=\n\t=?utf-8?q?0t0z/e5+FfnAqxvYN2g4luo5fFjoP31H5FqtL6fbIHc1R/7uJ7ofDiKco0Oel8hqm?=\n\t=?utf-8?q?FW5945JORQkvNHo1Zp7eOvEzB/e21hWF7MTw/kNKOYFHjeTZ79iHkqrEJwvsyFZmY?=\n\t=?utf-8?q?p+I69mYyP1yhqa+PY4l2Let2dSR8qrIKD/5MyX9yundVCAOPMjNTywoLRERHzAm5y?=\n\t=?utf-8?q?AbVFrGZ9eInB6ICfwhX2tbGJXeZiabq45GJLVSIDQjUOzJwc7c3AbA9NrsNiZxHNJ?=\n\t=?utf-8?q?8APSaP3+Gakm9UGziKheS7sTv34edk/ArX2ZQGerECNl8yB9FxnJ3ihb0Pm2jgH7B?=\n\t=?utf-8?q?chOaL6e7RbWRjePDdlBO0WxcnbtRty1gzvLsrbYs0SLVdokrD3aEYYYR9cJIPIAht?=\n\t=?utf-8?q?U+e88OXpgKj0O9F+iCN8bmvDQsv3L1nvCTnb9UEa9P8slNxX/lZmomFrHPg9IG8KF?=\n\t=?utf-8?q?5ulK554lvF7Pw1T6JORsHvNy7jMlyD+UZzlIGMcRMOr9pIs3OYPv+FiNt9yWqVwLz?=\n\t=?utf-8?q?9fxaVI0D11e69T1SUPYjIvc+FmMoiFYry8BU5k922dVIGFmuNTI1+MR7cUYtGudUc?=\n\t=?utf-8?q?LJqiYO8K6YgnOHZ/dwsK6cc8oS/357XFdkZAKVYHeMXYzhYlFVN0pVkmJdhRYrpK3?=\n\t=?utf-8?q?bRaWujPC0gbO2Gcm1fGhQyNYBi8WM2kL6pKHOK5oV9wOwjRhv6kHib8KSmafXTKXF?=\n\t=?utf-8?q?SJp3aY9RrE4Rubw+0TQPq4crHzkmPw4avoAwXDjV/PTv40bn1+fT1JtO9+Z6OwCA3?=\n\t=?utf-8?q?54lfrw7r5/ZfoRh1BYUmbJbHiZOcU17mlyeYKFwfc7hhMXEXpQkYzR+dpZOdH3Oar?=\n\t=?utf-8?q?1zDjvkwARtmKHIfOS7nrS5W2aXo4r05UIBWfGsFosL1KIod9Nn8Wj/Yjfg3r0omsS?=\n\t=?utf-8?q?vv5ILvKUmsbIYDpKazg7/nzrCF42gp+JRrIDcXk9dgQIkqndJJWpFaU4TlKS8Mxfb?=\n\t=?utf-8?q?M+7DXqBDJ6dSmjy?=","X-OriginatorOrg":"sct-15-20-9412-4-msonline-outlook-5f51e.templateTenant","X-MS-Exchange-CrossTenant-Network-Message-Id":"\n 731a1604-8f80-4fbc-4ceb-08de6d02e688","X-MS-Exchange-CrossTenant-AuthSource":"\n SI2PR01MB4393.apcprd01.prod.exchangelabs.com","X-MS-Exchange-CrossTenant-AuthAs":"Internal","X-MS-Exchange-CrossTenant-OriginalArrivalTime":"16 Feb 2026 02:27:16.2893\n (UTC)","X-MS-Exchange-CrossTenant-FromEntityHeader":"Hosted","X-MS-Exchange-CrossTenant-Id":"84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa","X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg":"\n\t00000000-0000-0000-0000-000000000000","X-MS-Exchange-Transport-CrossTenantHeadersStamped":"SEL0PF89D6F6B8B"},"content":"The config_acs parameter allows configuring ACS settings for multiple PCI\ndevices by separating entries with semicolons. The current documentation\nonly illustrates applying one configuration pattern to all devices, but\ndoes not show how to specify multiple devices with different ACS settings\nin a single parameter. Add an example demonstrating multi-device usage\nwith distinct ACS configurations.\n\nSome bootloaders interpret ';' as a command separator, which can cause\nthe parameter to be split as multiple commands. Document that the entire\nparameter may need to be quoted to avoid bootloader parsing issues. This\navoids confusing bootloader errors such as β€˜can't find command ’\nwhen passing multiple device entries.\n\nSigned-off-by: Wei Wang \n---\n Documentation/admin-guide/kernel-parameters.txt | 9 +++++++--\n 1 file changed, 7 insertions(+), 2 deletions(-)","diff":"diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt\nindex cb850e5290c2..bfd13197658f 100644\n--- a/Documentation/admin-guide/kernel-parameters.txt\n+++ b/Documentation/admin-guide/kernel-parameters.txt\n@@ -5293,15 +5293,20 @@ Kernel parameters\n \t\t\t\t '1' – force enabled\n \t\t\t\t 'x' – unchanged\n \t\t\t\tFor example,\n-\t\t\t\t pci=config_acs=10x@pci:0:0\n+\t\t\t\t- pci=config_acs=10x@pci:0:0\n \t\t\t\twould configure all devices that support\n \t\t\t\tACS to enable P2P Request Redirect, disable\n \t\t\t\tTranslation Blocking, and leave Source\n \t\t\t\tValidation unchanged from whatever power-up\n \t\t\t\tor firmware set it to.\n-\n \t\t\t\tNote: this may remove isolation between devices\n \t\t\t\tand may put more devices in an IOMMU group.\n+\t\t\t\t- 'pci=config_acs=10x@0000:04:00.0;1x101@0000:84:00.0'\n+\t\t\t\tconfigures two devices with different ACS settings.\n+\t\t\t\tNote: Some bootloaders interpret ';' as a command\n+\t\t\t\tseparator. If so, quote the entire parameter to\n+\t\t\t\tensure it is passed to the kernel unchanged.\n+\n \t\tforce_floating\t[S390] Force usage of floating interrupts.\n \t\tnomio\t\t[S390] Do not use MIO instructions.\n \t\tnorid\t\t[S390] ignore the RID field and force use of\n","prefixes":["v5","2/6"]}