Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/113446/?format=api
{ "id": 113446, "url": "http://patches.dpdk.org/api/patches/113446/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220624131956.75160-5-dkozlyuk@nvidia.com/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20220624131956.75160-5-dkozlyuk@nvidia.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20220624131956.75160-5-dkozlyuk@nvidia.com", "date": "2022-06-24T13:19:55", "name": "[v4,4/5] doc: update instructions for running as non-root for MLX5", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "73a7eca43154045f9f2fea914ce8f78abd2c179e", "submitter": { "id": 2248, "url": "http://patches.dpdk.org/api/people/2248/?format=api", "name": "Dmitry Kozlyuk", "email": "dkozlyuk@nvidia.com" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20220624131956.75160-5-dkozlyuk@nvidia.com/mbox/", "series": [ { "id": 23767, "url": "http://patches.dpdk.org/api/series/23767/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=23767", "date": "2022-06-24T13:19:51", "name": "Improve documentation for running as non-root", "version": 4, "mbox": "http://patches.dpdk.org/series/23767/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/113446/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/113446/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 8EEBCA0032;\n\tFri, 24 Jun 2022 15:20:32 +0200 (CEST)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 9055442B6F;\n\tFri, 24 Jun 2022 15:20:13 +0200 (CEST)", "from NAM11-DM6-obe.outbound.protection.outlook.com\n (mail-dm6nam11on2082.outbound.protection.outlook.com [40.107.223.82])\n by mails.dpdk.org (Postfix) with ESMTP id 1D7E6427FF;\n Fri, 24 Jun 2022 15:20:10 +0200 (CEST)", "from DS7PR05CA0096.namprd05.prod.outlook.com (2603:10b6:8:56::28) by\n MN2PR12MB3247.namprd12.prod.outlook.com (2603:10b6:208:ad::13) with\n Microsoft\n SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.5353.20; Fri, 24 Jun 2022 13:20:07 +0000", "from DM6NAM11FT053.eop-nam11.prod.protection.outlook.com\n (2603:10b6:8:56:cafe::6c) by DS7PR05CA0096.outlook.office365.com\n (2603:10b6:8:56::28) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5395.6 via Frontend\n Transport; Fri, 24 Jun 2022 13:20:07 +0000", "from mail.nvidia.com (12.22.5.238) by\n DM6NAM11FT053.mail.protection.outlook.com (10.13.173.74) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id\n 15.20.5373.15 via Frontend Transport; Fri, 24 Jun 2022 13:20:07 +0000", "from rnnvmail201.nvidia.com (10.129.68.8) by DRHQMAIL105.nvidia.com\n (10.27.9.14) with Microsoft SMTP Server (TLS) id 15.0.1497.32;\n Fri, 24 Jun 2022 13:20:06 +0000", "from rnnvmail204.nvidia.com (10.129.68.6) by rnnvmail201.nvidia.com\n (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.26; Fri, 24 Jun\n 2022 06:20:05 -0700", "from nvidia.com (10.127.8.11) by mail.nvidia.com (10.129.68.6) with\n Microsoft SMTP Server id 15.2.986.26 via Frontend Transport;\n Fri, 24 Jun 2022 06:20:05 -0700" ], "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=Rwusw5A9LcNHszVXdwBoOpIBsIg/6WOT0f137QTGxx+OA728cL4SFa8fsyDRhA6lVtEU5flQ2A4iU6RMnslG6I4KBJTOfCZlCHYyut4xmF6mZskImDYfyE9kX97gqxCPHMt13okQ6bc1MPcsnJR7+SNRTqX1qYZQz2xWh/wCgdFDqYvSAdcFa/OdiPLcOCuaDrHmNifupXuekUWQf0fy/Tcc4DM6XAzueHy75tpAdaktWK6xktIPNTRMGKJqclSOVbE+IIbgh2SaDuv5T5r25oibQrAI9U5t76g7Wa3v3lpGPpLsZNVKazZpyp+rb4oFgXEKaOLSBdAIFn2j55+hrA==", "ARC-Message-Signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector9901;\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=3PZsvV8UxwsCCg8Cj9IG54/SfJSnJ2wFglvspkVHfQs=;\n b=XiQNb2HG5jPYTxN1KjRMDsoU52MRC7p3TANM0TVXJ2oZhC/2FEYiFJ4gopdWP25yOOHA70/HqgxZ6lf7DPKtdgfc88Dbu8x/F5f3LmbMi2oFm8wz2RHv9n+W9vZdTGQdoYLpOOZ7lnt4tOy6dJaBUZbogZHdPi8q7O0q/ocnLCgZUNi85I/e/Wsr+9/5voSje9YZNpfewncWSuOqtbsTHfs+jsA9xs7RGBlWRhdAXuZ/f9oJcL6NSey5ZedpdRJl3sRpmoGgCOaTgiiHlMNG7LZ38+S7zeuo/JpXP7wjERa03pxhneGEfUJgQ0ln/65DXbkQKOzdwOEswty2CsjYiQ==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 12.22.5.238) smtp.rcpttodomain=dpdk.org smtp.mailfrom=nvidia.com; dmarc=pass\n (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none\n (message not signed); arc=none", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com;\n s=selector2;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=3PZsvV8UxwsCCg8Cj9IG54/SfJSnJ2wFglvspkVHfQs=;\n b=GVdG3qgF6ciSWFkEH51pDjcqsh99o+UFP6HjjujlY4rV+Qo/qGlKA7JCcCkhkO61VPxXpLMA4juvC1AUdJPaRDDO56Id++MXS2ZKpU48H7ctuCyG95qAwW0pZHCdTTMMdSu8Yz5Mwn29byWHCwd3mJlSUCLUrEbO2nJaFtMQbI5AZm0f/8tNumfBOaLLciunQeg4KSI4rwur4jpLolficVnHlpjy9yvH3H2T3f8qI+ZBDo23/bKGvY1j4xbfOZ6r4qr2HLTE8qtia9LvJPi1nLodUBfhL1hVV4Rc2U9PjbwcSXN+XO4TwPonxjywtFa8zTt5PSGU4VxW0HQzkoG++w==", "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 12.22.5.238)\n smtp.mailfrom=nvidia.com; dkim=none (message not signed)\n header.d=none;dmarc=pass action=none header.from=nvidia.com;", "Received-SPF": "Pass (protection.outlook.com: domain of nvidia.com designates\n 12.22.5.238 as permitted sender) receiver=protection.outlook.com;\n client-ip=12.22.5.238; helo=mail.nvidia.com; pr=C", "From": "Dmitry Kozlyuk <dkozlyuk@nvidia.com>", "To": "<dev@dpdk.org>", "CC": "<stable@dpdk.org>", "Subject": "[PATCH v4 4/5] doc: update instructions for running as non-root for\n MLX5", "Date": "Fri, 24 Jun 2022 16:19:55 +0300", "Message-ID": "<20220624131956.75160-5-dkozlyuk@nvidia.com>", "X-Mailer": "git-send-email 2.25.1", "In-Reply-To": "<20220624131956.75160-1-dkozlyuk@nvidia.com>", "References": "<20220624084817.63145-1-dkozlyuk@nvidia.com>\n <20220624131956.75160-1-dkozlyuk@nvidia.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Content-Type": "text/plain", "X-EOPAttributedMessage": "0", "X-MS-PublicTrafficType": "Email", "X-MS-Office365-Filtering-Correlation-Id": "c1634801-5665-4896-c8a7-08da55e441ef", "X-MS-TrafficTypeDiagnostic": "MN2PR12MB3247:EE_", "X-MS-Exchange-SenderADCheck": "1", "X-MS-Exchange-AntiSpam-Relay": "0", "X-Microsoft-Antispam": "BCL:0;", "X-Microsoft-Antispam-Message-Info": "\n nPcyHXJ1REhq6l5caX72DiRNBmupMkMuMKUDu/HF5jCvK41GO+m6Q47mhT0GJzqidGcA3qt6M5A3dlPgAbLpZf8lylw2STdGjJ4E/3o71pZ6WZfRxgk3eDAHENwHFIzF0Kg8LXyBOEYTS8NYsTB0xcEqMlgumvoewjRA742e6/iNcOd0P7zKhF+yrwzhVKKd2z6AGwBo0VUhIhW5a6WcZdYT8M7xzckdWzHjGWD2wBrZfm7NGIT6UF03fjGNKTuhMj0Frtyy9T3FQWEbVoGi//RvBu6Oho2OqjkKKwgjlnPbLivouR2Z6yLHBt1SOsg8BfttPyvyxC63ZSHwVp1ObLABsAWb6Np4JqY2GMSi9IeOPnXHOm5Bazo2siAyKEl6w/f3tv6cZlAU2pR/goqNlzCNVeGbp3nBIpo1EgLkVK5Ask+f539gsNbyMH6/285R/zi9gr/rDkqov0lxzOtXviQhucUHNC+kNpzxWvbCv/KIAK7PZWnGhvI5tMpRZo+zxwELskDi0E+jz62TQpJ+CaAV/Z8If5l4kv1MWxgvbjTK5egyLTUpu1RqxrHbNX3MgkwWVMUUCguH9U3mpj8sRCaNdjnTybfgEUHU/8u7AT3XK53ZGu2iFz81WnqGNTMoHp+vg2fvRtjPgeUkL47/kkJ0leMgY1QILuAxoeD9OKDVdeInNWSLbU7wGQF071zck2xUQtKd+ugaU7CJmqTd6zS0FgXTRrKbZNaUkoednsKVDov1sKiqSaTBl6rrbyuHQGweWc93/Uoeqx2XpCkBvSPhlFE+L+Ia/cVqJZ6/lx0z9PzTWwbdJaDXOjcO8dX1VhIDLg9JdMH7opw45QmjYg==", "X-Forefront-Antispam-Report": "CIP:12.22.5.238; CTRY:US; LANG:en; SCL:1; SRV:;\n IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE;\n SFS:(13230016)(4636009)(346002)(136003)(39860400002)(376002)(396003)(40470700004)(36840700001)(46966006)(6666004)(2616005)(186003)(2906002)(26005)(7696005)(426003)(47076005)(82310400005)(316002)(6916009)(36756003)(86362001)(55016003)(41300700001)(1076003)(8676002)(8936002)(336012)(83380400001)(70206006)(81166007)(6286002)(40480700001)(478600001)(36860700001)(450100002)(356005)(4326008)(5660300002)(70586007)(82740400003)(40460700003)(36900700001);\n DIR:OUT; SFP:1101;", "X-OriginatorOrg": "Nvidia.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "24 Jun 2022 13:20:07.2390 (UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n c1634801-5665-4896-c8a7-08da55e441ef", "X-MS-Exchange-CrossTenant-Id": "43083d15-7273-40c1-b7db-39efd9ccc17a", "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.238];\n Helo=[mail.nvidia.com]", "X-MS-Exchange-CrossTenant-AuthSource": "\n DM6NAM11FT053.eop-nam11.prod.protection.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous", "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "MN2PR12MB3247", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org" }, "content": "Reference the common guide for generic setup.\nRemove excessive capabilities from the recommended list.\n\nCc: stable@dpdk.org\n\nSigned-off-by: Dmitry Kozlyuk <dkozlyuk@nvidia.com>\n---\n doc/guides/platform/mlx5.rst | 31 ++++++++++++++++++-------------\n 1 file changed, 18 insertions(+), 13 deletions(-)", "diff": "diff --git a/doc/guides/platform/mlx5.rst b/doc/guides/platform/mlx5.rst\nindex 64a4c5e76e..18d38f3488 100644\n--- a/doc/guides/platform/mlx5.rst\n+++ b/doc/guides/platform/mlx5.rst\n@@ -404,25 +404,30 @@ The device can be bound again at this point.\n Run as Non-Root\n ^^^^^^^^^^^^^^^\n \n-In order to run as a non-root user,\n-some capabilities must be granted to the application::\n+Hugepage and resource limit setup are documented\n+in the :ref:`common Linux guide <Running_Without_Root_Privileges>`.\n+This PMD can operate without access to physical addresses,\n+therefore it does not require ``SYS_ADMIN`` to access ``/proc/self/pagemaps``.\n+Note that this requirement may still come from other drivers.\n \n- setcap cap_sys_admin,cap_net_admin,cap_net_raw,cap_ipc_lock+ep <dpdk-app>\n+Below are additional capabilities that must be granted to the application\n+with the reasons for the need of each capability:\n \n-Below are the reasons for the need of each capability:\n+``NET_RAW``\n+ For raw Ethernet queue allocation through the kernel driver.\n \n-``cap_sys_admin``\n- When using physical addresses (PA mode), with Linux >= 4.0,\n- for access to ``/proc/self/pagemap``.\n+``NET_ADMIN``\n+ For device configuration, like setting link status or MTU.\n \n-``cap_net_admin``\n- For device configuration.\n+``SYS_RAWIO``\n+ For using group 1 and above (software steering) in Flow API.\n \n-``cap_net_raw``\n- For raw ethernet queue allocation through kernel driver.\n+They can be manually granted for a specific executable file::\n \n-``cap_ipc_lock``\n- For DMA memory pinning.\n+ setcap cap_net_raw,cap_net_admin,cap_sys_rawio+ep <executable>\n+\n+Alternatively, a service manager or a container runtime\n+may configure the capabilities for a process.\n \n \n Windows Environment\n", "prefixes": [ "v4", "4/5" ] }