From patchwork Tue Jun 7 23:49:46 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dmitry Kozlyuk X-Patchwork-Id: 112508 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 03453A0548; Wed, 8 Jun 2022 01:50:09 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 7CAE341132; Wed, 8 Jun 2022 01:50:04 +0200 (CEST) Received: from NAM11-BN8-obe.outbound.protection.outlook.com (mail-bn8nam11on2059.outbound.protection.outlook.com [40.107.236.59]) by mails.dpdk.org (Postfix) with ESMTP id 9D4534021F for ; Wed, 8 Jun 2022 01:50:02 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=OY8u2G/2kWR2TTfM+moNfWY9EcUgfWPIUDu3pmGfWD0aNqhBEjImdmb8qbms463DWXzEdqU4RUfXX8exd2JGkG5SD7SwcsoGKUZM4D7j7gfyCVqnTD6AbhOgSwRNjRmbTK5ekBm6xw34I0XLckTMlKa6jU2k7UdMUc9mVdUkPi1KvwssijHzOQaaNrWDke7L9eWxq3J3JVrX3s2U/SpfiN/1tJGjMIITPEnCx7xoSaUzHGNVIbiLmxcxne61dp9DxRoKX671s+RZLveWWCLGwW+gB1Z0g9bOxZAKEAoGs/iICoPJX+a3WqXOWCDHlpqKIGIVsN15OtiF5gO5d52u2A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=4IxijkFbpYwZI+RXV+VFoqmnoirHivSYuA4FBc641Z4=; b=F1SCsruZrO42en5y+heFg4KAn80j1rYY1BRWjM0C25fo49S7c5q2LFibLYgPTYPJxQlxZA9UsJW6IQK3wVS7uYWY3VbHYAga59jwA4nf1K2KViA2K/BmZdZv5fQqUgxkFJcy3c5aH4bzPpqTNcvnlGqsZ7+yPLcKV+EK1tvFXKzI3FcjSiBiWKR+n7C+kQs0Ti8QsixKp/YSgB936KCmFjoWQLSfDanf49CBg4yXA2SAMgHulhBewsGBtjPwsIJQK38eqoNH7eUtszZhUc4Ih9Z3925Rlvy4E2dcZE6FXJ+eTSizrLmBlhcwAKldmPmxw+L4ZXnwLsBM9kRnMogmyA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 12.22.5.234) smtp.rcpttodomain=monjalon.net smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); 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=4IxijkFbpYwZI+RXV+VFoqmnoirHivSYuA4FBc641Z4=; b=o0j/qOIbz1MYjDgqYzgWFvBrSNCtyNazOd5PfwHrv5bgmd1ChPEsb5FpE4Ag+bDzbfT9Ou9LfqJzXY4Vsqw9/ieF3/FNT1iWXYOHyrg8IMwezHuIb3kqTeUVKpZ5jWbksbp0nQX4YCzEb3zUxRHHK5SWzE+FhJRgbKV2xTSIHPi/aJPad5l4X9d2CwjKRXe2IAmH8g/6TmPuaxMJc/ZMoFThS537x4FSuvwIRZVN5MbHsZvr8pcWod88nUTvHBoBo1ssGWMmAdaKYTNVMGISwYdf6L1fvcW3+IHcRamQMd4cFxyAB0Kg/Fxd0yYXEthEam+5jOApVvKLmccMiaVExw== Received: from MWHPR19CA0065.namprd19.prod.outlook.com (2603:10b6:300:94::27) by MWHPR12MB1312.namprd12.prod.outlook.com (2603:10b6:300:11::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5314.17; Tue, 7 Jun 2022 23:50:00 +0000 Received: from CO1NAM11FT035.eop-nam11.prod.protection.outlook.com (2603:10b6:300:94:cafe::21) by MWHPR19CA0065.outlook.office365.com (2603:10b6:300:94::27) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5293.18 via Frontend Transport; Tue, 7 Jun 2022 23:50:00 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 12.22.5.234) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 12.22.5.234 as permitted sender) receiver=protection.outlook.com; client-ip=12.22.5.234; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (12.22.5.234) by CO1NAM11FT035.mail.protection.outlook.com (10.13.175.36) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.5314.12 via Frontend Transport; Tue, 7 Jun 2022 23:50:00 +0000 Received: from drhqmail201.nvidia.com (10.126.190.180) by DRHQMAIL101.nvidia.com (10.27.9.10) with Microsoft SMTP Server (TLS) id 15.0.1497.32; Tue, 7 Jun 2022 23:49:59 +0000 Received: from drhqmail203.nvidia.com (10.126.190.182) by drhqmail201.nvidia.com (10.126.190.180) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.22; Tue, 7 Jun 2022 16:49:59 -0700 Received: from nvidia.com (10.127.8.11) by mail.nvidia.com (10.126.190.182) with Microsoft SMTP Server id 15.2.986.22 via Frontend Transport; Tue, 7 Jun 2022 16:49:58 -0700 From: Dmitry Kozlyuk To: CC: Thomas Monjalon Subject: [PATCH 1/4] usertools: add option to select hugetlbfs directory Date: Wed, 8 Jun 2022 02:49:46 +0300 Message-ID: <20220607234949.2311884-2-dkozlyuk@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220607234949.2311884-1-dkozlyuk@nvidia.com> References: <20220607234949.2311884-1-dkozlyuk@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 80d5bee3-79df-4adc-b41d-08da48e06f46 X-MS-TrafficTypeDiagnostic: MWHPR12MB1312:EE_ X-LD-Processed: 43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: X418XLzxdilhns1m89zNAgO0jGW8XJgsZ+W9M7ECnI8dwZmy07bfhEcbMAS1oLiBW7HGnVWxbX+Cp10zIzCqDArm7NVK4D1Vd6b986esIR4pLZRW0ezpPzXBkLhClaoQPxbT3uCpgjzH8e4ILJSENZWATklhJEt3WN8czyBi6njVcl24YAZtF/7Xe056C9otozmy7HHmeQe5T50y3JIzVykPoxWrzKmPsKtMIM6wu5S0SBq/BnZ2+1+9PJnA1Hk+/w/Ht0+Tpm6jf3OJO+scCKcEno4DAGgEiMym5jZxnuO5zDx30oU6xDsL1rlOFVKL8lHxTfCUOhJyY42ZrmMjSdrm2H8hUl/x12d9j/jXZTgeZ3vYu3dy5S3gydTw5KavMNbVBlIDi77MERbqLtJapDHheHN6ULGbPGWzfIBJm0xxNZDKtJ8rsltfbVxNZ6C/C00UKPFXimiIUDUJjnYlQeg3mZNJLb7zMkuit5ULgEGMz53BjE0Kl0QDN3/W13h2+Syszc519WCbFZsNLPkBSxtSKW+d0fXwuXkITr6uglndVlEvAhD+BtRY6xXmcACXIF/IjZnqVvkh/vLncjekfTFzpAWT6WqxjW/2Hf7PlqmAYExbPAGa1lIj3mzIO3yFqs+HZJT33N1abbbgOwdkBa+Z21MThp5GLzjYdYTxj9JHzO1tPQNVUYUIQJ17eB9CTsf3Qkw7Y+9UZwAjWi36oA== X-Forefront-Antispam-Report: CIP:12.22.5.234; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE; SFS:(13230001)(4636009)(40470700004)(36840700001)(46966006)(40460700003)(83380400001)(36860700001)(82310400005)(356005)(81166007)(8936002)(8676002)(86362001)(6666004)(4326008)(5660300002)(70586007)(70206006)(6916009)(2906002)(26005)(55016003)(47076005)(36756003)(316002)(426003)(336012)(6286002)(186003)(1076003)(2616005)(7696005)(508600001)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Jun 2022 23:50:00.2031 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 80d5bee3-79df-4adc-b41d-08da48e06f46 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.234]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1NAM11FT035.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: MWHPR12MB1312 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org dpdk-hugepages.py had /dev/hugepages hardcoded as the mount point. It may be desirable to setup hugepage directory at another path, for example, when using hugepages of multiple sizes in different directories or when granting different permissions to mount points. Add --directory/-d option to the script. Signed-off-by: Dmitry Kozlyuk --- usertools/dpdk-hugepages.py | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/usertools/dpdk-hugepages.py b/usertools/dpdk-hugepages.py index 4fdb199744..8bab086a2f 100755 --- a/usertools/dpdk-hugepages.py +++ b/usertools/dpdk-hugepages.py @@ -228,6 +228,12 @@ def main(): '-u', action='store_true', help='unmount the system huge page directory') + parser.add_argument( + '--directory', + '-d', + metavar='DIR', + default=HUGE_MOUNT, + help='mount point') parser.add_argument( '--node', '-n', help='select numa node to reserve pages on') parser.add_argument( @@ -262,7 +268,7 @@ def main(): if args.clear: clear_pages() if args.unmount: - umount_huge(HUGE_MOUNT) + umount_huge(args.directory) if args.reserve: reserve_kb = get_memsize(args.reserve) @@ -273,7 +279,7 @@ def main(): reserve_pages( int(reserve_kb / pagesize_kb), pagesize_kb, node=args.node) if args.mount: - mount_huge(pagesize_kb, HUGE_MOUNT) + mount_huge(pagesize_kb, args.directory) if args.show: show_pages() print() From patchwork Tue Jun 7 23:49:47 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dmitry Kozlyuk X-Patchwork-Id: 112509 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 8AC86A0548; Wed, 8 Jun 2022 01:50:13 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 776CB427EE; Wed, 8 Jun 2022 01:50:06 +0200 (CEST) Received: from NAM10-MW2-obe.outbound.protection.outlook.com (mail-mw2nam10on2075.outbound.protection.outlook.com [40.107.94.75]) by mails.dpdk.org (Postfix) with ESMTP id B5A6241614 for ; Wed, 8 Jun 2022 01:50:04 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=A+jj2lvpDVXUusg0wjHpRv1jtwg+BsfQezkTQwzR8iOEicvbTGzt/BKtQGo8z1HN6wJzg5ImlQNRkG/WNRgzo6vfHS9kNBCVSszy5NBY4D8JRLdfVc/Vo4KTGrycyXu1zpWSBMSdP5bQ+ErJWoFdbdcUsSMNCKXH7656EDDPYJ3aiTEzWpK3YKcZdgIB/2lfeOsSz6DXdXdI8IVN2wWy1Ua5YJSqImcuSyP0EWNdp4PkDBEhMbN3MazlSAY7SeJvUaf09VHfVzITnjRNuiElJxnwsKqE1srKSs5XFEc5lISQuOscsW0uA5DOCPIeKtoLLHhuzuzX8i096osWpED8ZA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=uj96b/6BV1/h//uVAJcGhoGDQSgxcBGsDypqqzQRx80=; b=VdC20gSViQzNk9DHHwJomR7PJbxDTtw+/Kwxtg1CJNGIx9PClPZwuoSonWrg/Bx3/0jx8a0eLqO++TODpDyNHX/+7oWvbIfjp2XVd3gDWNNRkZUgIVuCz6vU8fxt6RW6mcciJUIUk/fSXHhsY2M9w4eLJ7DOgWhkgT40CItXaxS1YyEd7Rrm4gZv6cCSne1i7wKS74F0+qhxgkrhzDdlqbleRS3h2PnTZ0skE9Aqo3zNUQGVDq8I2U96wirmDr8eWWym7D1ufEefQxw9DqFUrrgL0REZs2EBGFuA57iaURScepAUxsGjBQsfeatUYpzhOLCSvIH23SeYLooXJxmMow== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 12.22.5.236) smtp.rcpttodomain=monjalon.net smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); 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=uj96b/6BV1/h//uVAJcGhoGDQSgxcBGsDypqqzQRx80=; b=JEwhBSYZryHGV0zLsA1+PLMSAt8z/fsHcT2rUtNWviA4r3rB4FilALglH7RCArJSSueGu3h3ZtmczzoeISnoTNMgX//eVccYbdYWMsqJw70gEUtDKQQAQRP737eHGHbMOAEbEAhPfZWrjrUATlYzp1ydkzR/rQaI/OzFgKQ5hyAPq5qFdGXiLtM8deBlYbpYXAmnMAXFbG98JW7viM1+51Z/K2Q7ZVBsno1TyZAj/3B8JuYRdveUdJ0P0MsR1ya8bLXmerh/ONfFyEXZiJ/aVbVPePJ+wzgK9VBXbj/ywkxDkVMlXQbsAzVH+YtK0gu3/3Qr4ZyUI724AQUD15uAgg== Received: from DM6PR06CA0051.namprd06.prod.outlook.com (2603:10b6:5:54::28) by CH2PR12MB4808.namprd12.prod.outlook.com (2603:10b6:610:e::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5314.13; Tue, 7 Jun 2022 23:50:02 +0000 Received: from DM6NAM11FT051.eop-nam11.prod.protection.outlook.com (2603:10b6:5:54:cafe::d4) by DM6PR06CA0051.outlook.office365.com (2603:10b6:5:54::28) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5314.15 via Frontend Transport; Tue, 7 Jun 2022 23:50:01 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 12.22.5.236) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 12.22.5.236 as permitted sender) receiver=protection.outlook.com; client-ip=12.22.5.236; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (12.22.5.236) by DM6NAM11FT051.mail.protection.outlook.com (10.13.172.243) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.5332.12 via Frontend Transport; Tue, 7 Jun 2022 23:50:01 +0000 Received: from drhqmail201.nvidia.com (10.126.190.180) by DRHQMAIL109.nvidia.com (10.27.9.19) with Microsoft SMTP Server (TLS) id 15.0.1497.32; Tue, 7 Jun 2022 23:50:01 +0000 Received: from drhqmail203.nvidia.com (10.126.190.182) by drhqmail201.nvidia.com (10.126.190.180) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.22; Tue, 7 Jun 2022 16:50:00 -0700 Received: from nvidia.com (10.127.8.11) by mail.nvidia.com (10.126.190.182) with Microsoft SMTP Server id 15.2.986.22 via Frontend Transport; Tue, 7 Jun 2022 16:49:59 -0700 From: Dmitry Kozlyuk To: CC: Thomas Monjalon Subject: [PATCH 2/4] usertools: add option to change mount point owner Date: Wed, 8 Jun 2022 02:49:47 +0300 Message-ID: <20220607234949.2311884-3-dkozlyuk@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220607234949.2311884-1-dkozlyuk@nvidia.com> References: <20220607234949.2311884-1-dkozlyuk@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 73ec76f2-78f2-4603-8c6f-08da48e0701a X-MS-TrafficTypeDiagnostic: CH2PR12MB4808:EE_ X-LD-Processed: 43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: iYP8Nuwxa2dN6ZqOfxS+6x3i6MKC0FYs87tldRAtZvGDwxMyYlyS+udZNht4mb3+QUDJVqoDXDjxxkXKfv8k0IK4d0/MnZ5s085FdX+9YYRDzwzbxpAAKifzyj9XSKtOejLIOD9qr32HY0n3pOjynCDe0ZI+QmjAN4BsuMajRfrks9C9qFRt07q4rcO4n5J/0aAi7l9PwY0m28Z7zL5WcKeMcxTi8yUtDa6lekF+L8IK1CsMxMfKtoO5cGfqbtrb+CMtNDYTUORq20KjfnT1ui2zAwkhKC7l7qvTDB/k3HYatzPvomdCQmO2sDwlzoB+q92rDfBHQE5U/blRyVzOm6ODfsspctHE+6zgXsCpTCaGfNaPA6YB80X2jBGJck1S/OXlhFipTn0/lkVu9/FwQ5W44T7TISJdqclzzbvv1hoQdKDn1sAHIxbQ502h3xO3lwv7lV2lJUX7krpP6YpwNFT67iJimvl39IpZpuIQCPpFi9zfvrruv6diVApxIXeB6pxoMNDWLdB9oC4ao01zb7VZqMSiN7HPXMYTwQgcavCnk/fRONyOn6XDHHNQC3Wkb05z+rXA6ZShCF7jPO5k13qo4lKDRtwKTC/7/bzVpPWnVjrp2xHbbE/T4TUzrCI1Cv903hyRKYFYXXwoBvnuRT1AmmZF+vSiqB6m1pvYI3Z8VgZgDTUK0bO5YDXmlCnr7gT9LuH72rwK+fIBYVbeeQ== X-Forefront-Antispam-Report: CIP:12.22.5.236; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE; SFS:(13230001)(4636009)(40470700004)(36840700001)(46966006)(86362001)(40460700003)(4326008)(5660300002)(8676002)(70586007)(70206006)(36860700001)(7696005)(356005)(1076003)(82310400005)(6286002)(316002)(6916009)(26005)(6666004)(8936002)(186003)(83380400001)(2906002)(81166007)(508600001)(36756003)(55016003)(2616005)(47076005)(336012)(426003)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Jun 2022 23:50:01.5758 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 73ec76f2-78f2-4603-8c6f-08da48e0701a X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.236]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: DM6NAM11FT051.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR12MB4808 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Per mount(8), the previous owner and mode of the mount point become invisible as long as this filesystem remains mounted. Because dpdk-hugepages.py must be run as root, the new owner would be root. This is undesirable if the hugepage directory is being set up by the administrator for an unprivileged user. Add --owner/-o option to set the owner after mounting. The benefit over calling chown directly after the script is that the user does not need to care about this detail of mount command operation. Signed-off-by: Dmitry Kozlyuk --- usertools/dpdk-hugepages.py | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/usertools/dpdk-hugepages.py b/usertools/dpdk-hugepages.py index 8bab086a2f..1e01ac3d9f 100755 --- a/usertools/dpdk-hugepages.py +++ b/usertools/dpdk-hugepages.py @@ -170,7 +170,7 @@ def get_mountpoints(): return mounted -def mount_huge(pagesize, mountpoint): +def mount_huge(pagesize, mountpoint, owner): '''Mount the huge TLB file system''' if mountpoint in get_mountpoints(): print(mountpoint, "already mounted") @@ -180,6 +180,8 @@ def mount_huge(pagesize, mountpoint): cmd += ' -o pagesize={}'.format(pagesize * 1024) cmd += ' nodev ' + mountpoint os.system(cmd) + if owner: + os.system('chown {} {}'.format(owner, mountpoint)) def umount_huge(mountpoint): @@ -234,6 +236,11 @@ def main(): metavar='DIR', default=HUGE_MOUNT, help='mount point') + parser.add_argument( + '--owner', + '-o', + metavar='USER:GROUP', + help='change the mounted directory owner') parser.add_argument( '--node', '-n', help='select numa node to reserve pages on') parser.add_argument( @@ -279,7 +286,7 @@ def main(): reserve_pages( int(reserve_kb / pagesize_kb), pagesize_kb, node=args.node) if args.mount: - mount_huge(pagesize_kb, args.directory) + mount_huge(pagesize_kb, args.directory, args.owner) if args.show: show_pages() print() From patchwork Tue Jun 7 23:49:48 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dmitry Kozlyuk X-Patchwork-Id: 112511 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 76605A0548; Wed, 8 Jun 2022 01:50:26 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id F3F5C4281C; Wed, 8 Jun 2022 01:50:13 +0200 (CEST) Received: from NAM12-DM6-obe.outbound.protection.outlook.com (mail-dm6nam12on2064.outbound.protection.outlook.com [40.107.243.64]) by mails.dpdk.org (Postfix) with ESMTP id EA9D24282C; Wed, 8 Jun 2022 01:50:11 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=GIhoXC9n+DYo8yhd9BgeMujzLe3spZpu6WsqN55TkVTEBLQ8ckidWbttDyAMSykLgwN4Mv1i99lua2tjktkO16OgAlNe3r1cpp/xoD74FGT9rQT0T2fwcV0rHCp5NKaJfC3YyrRakuAw/l+t2Av/5tsmonfGWhNiLUJoF2JW6vewz5oyXbusjGEy6r1nv8VaXiz3xbddfDGwSVmYpCjkAFwejNMOEC/iUNk+lt3h/XSSIHqawvCUFSfhFe+7wMaawivvQJuUEXL2/+el1OkujwkFkdMlHhpgi3x7iei9jmVYzEz58KeQr+9KN/vWQR1gIR4sh18C4IIWpVvcSn3bIw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=wHCqUhzeCVapD2LVSejVk6W2BRC+YjLSZmu7rAZEwdU=; b=Pg7T+tfGUKk9VtYQn9rp8PcOliolt2B2Sj3TSW1rxmyB8hiK9Ib+U4GhIhGSGekG+87LzlxD2zvYy7qKr/dngSnAgzy7ivcl+B37zIExvSbL1PSXSnB9a68zEKrzMwSzUA1O+6Q8xcYQWnDtbwJDwOEJ2jitVtc9M9Z9Mik9TP97BYMRvm1h8jKE0P8Es5neKoSmJn/ZKkxKAa0UDVWdA8RlbM2Td+okLJsesrmlhC2h2m7sUMEP4yg2NCB4yKPH7Yr/nkXOeZ8r8qx4t530D2rJ5crlt7oqgbiyGsRAwLou0LlN4s9FaE5hg6nLXPsvfAeZXAQ2iy7hf1M9z7Ev+A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 12.22.5.235) smtp.rcpttodomain=dpdk.org smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); 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=wHCqUhzeCVapD2LVSejVk6W2BRC+YjLSZmu7rAZEwdU=; b=R5jMfUb2C2WryYpLysaxh6eYTcFcr3oJixYNLxCNk1tNs9uQU8HXff5TmROJEICBgcMazmHTNa/oCdUaRgQrO2+4RCsyCSELvxgs//wqmbpT8BnIB4csXca06HWT+LOCDKUBM/6l2mDcNpW594yY5nw+XBN43swbu3oUJLkfkXeIWiJq/w7pwgL1pj8VJ/dYRx2WJVFCdJkXOaNBzPoA++hK1cxBe6uYBHInaJCMEqQcWgf8n0cda7YsfKuHln3AxruuoFs3smvZHywIonCuKuPz0c/H2k81yvndsqR5vqlOPCxTcZpI6yGk6EJirQysssru8IH0NqOKnanr7JRNjg== Received: from BN8PR04CA0061.namprd04.prod.outlook.com (2603:10b6:408:d4::35) by BL1PR12MB5239.namprd12.prod.outlook.com (2603:10b6:208:315::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5332.12; Tue, 7 Jun 2022 23:50:06 +0000 Received: from BN8NAM11FT031.eop-nam11.prod.protection.outlook.com (2603:10b6:408:d4:cafe::3b) by BN8PR04CA0061.outlook.office365.com (2603:10b6:408:d4::35) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5314.16 via Frontend Transport; Tue, 7 Jun 2022 23:50:05 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 12.22.5.235) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 12.22.5.235 as permitted sender) receiver=protection.outlook.com; client-ip=12.22.5.235; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (12.22.5.235) by BN8NAM11FT031.mail.protection.outlook.com (10.13.177.25) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.5314.12 via Frontend Transport; Tue, 7 Jun 2022 23:50:05 +0000 Received: from drhqmail202.nvidia.com (10.126.190.181) by DRHQMAIL107.nvidia.com (10.27.9.16) with Microsoft SMTP Server (TLS) id 15.0.1497.32; Tue, 7 Jun 2022 23:50:02 +0000 Received: from drhqmail203.nvidia.com (10.126.190.182) by drhqmail202.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.22; Tue, 7 Jun 2022 16:50:02 -0700 Received: from nvidia.com (10.127.8.11) by mail.nvidia.com (10.126.190.182) with Microsoft SMTP Server id 15.2.986.22 via Frontend Transport; Tue, 7 Jun 2022 16:50:01 -0700 From: Dmitry Kozlyuk To: CC: Thomas Monjalon , , Anatoly Burakov Subject: [PATCH 3/4] doc: give specific instructions for running as non-root Date: Wed, 8 Jun 2022 02:49:48 +0300 Message-ID: <20220607234949.2311884-4-dkozlyuk@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220607234949.2311884-1-dkozlyuk@nvidia.com> References: <20220607234949.2311884-1-dkozlyuk@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 287b4185-2611-4d0f-de6b-08da48e0729d X-MS-TrafficTypeDiagnostic: BL1PR12MB5239:EE_ X-LD-Processed: 43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: cKH2UZp0V3DoUhOaTbJ3qnvtz6JpXoxHN3bfyNWzKqLV+/d/+sCph48xg37t1ZpfykVfyfk8G+qKWlpmcm3gh5JNsuFrsXrTaTNVsy+009+M74MriC2+SCVFudpgfAdVCKLNqFKiup2GT/NhWUEltShD/ndctG0OCvzdL8y1/ypwH2FYONdnMdLYiXSg9F67fSFZrFCHPnZ7+sIQ0WMSsy41rvmLzqM0/Wbj5icouHcU/4Q05gfTEFbRkaXpcDFIomRvquURsNHDhU70qBq3jpkj/dQ3+J/XUbCU2aMsFg3GdUUJyPuArtxTNedFeppS7OlYtCkWdhy9kwkq4IVb21KOtKnyz9XXVv0Qvif+AJXUteoHe31DJyS+h9xtaL8bp2sq5NuRBT4kn4il6LBvQ72daqgPc/2SSEuyYodtR+OXF74Zo1JZr8VxoRvezoZ5pHQgyOTWL6rCjWwCBn+rGtmMtpwDM8wVd0f7EUXcIw53bHIvs/3viRmKuG1GMIuyjzq9pfPAWT7/al3FD5VnXgM7CSyH8zaBRbR0j5rwPoidYklciwOfsR949xi0ZT9hp6Zmm66UsIwnXW/imk9xL67PBRWSxqByBgpNKzT3EfeKUbR40R7S9k4nwHlrihfpNl8wLrj2nVfphCrGxZIAzq21hkJFiTOHFZk5XeACGZZQQmP0eSzqS2WuHTnyQXm1AXYAnx+cE8QwyCF/NuMq0g== X-Forefront-Antispam-Report: CIP:12.22.5.235; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE; SFS:(13230001)(4636009)(36840700001)(46966006)(40470700004)(83380400001)(47076005)(426003)(336012)(8676002)(86362001)(186003)(36860700001)(70586007)(70206006)(1076003)(2616005)(26005)(6286002)(2906002)(7696005)(316002)(356005)(5660300002)(54906003)(6916009)(55016003)(6666004)(36756003)(4326008)(81166007)(82310400005)(508600001)(40460700003)(8936002)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Jun 2022 23:50:05.7294 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 287b4185-2611-4d0f-de6b-08da48e0729d X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.235]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: BN8NAM11FT031.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL1PR12MB5239 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org The guide to run DPDK applications as non-root in Linux did not provide specific instructions to configure the required access and did not explain why each bit is needed. The latter is important because running as non-root is one of the ways to tighten security and grant minimal permissions. Cc: stable@dpdk.org Signed-off-by: Dmitry Kozlyuk --- doc/guides/linux_gsg/enable_func.rst | 53 ++++++++++++++++--- .../prog_guide/env_abstraction_layer.rst | 2 + 2 files changed, 49 insertions(+), 6 deletions(-) diff --git a/doc/guides/linux_gsg/enable_func.rst b/doc/guides/linux_gsg/enable_func.rst index 1df3ab0255..c6975ce8bf 100644 --- a/doc/guides/linux_gsg/enable_func.rst +++ b/doc/guides/linux_gsg/enable_func.rst @@ -13,13 +13,46 @@ Enabling Additional Functionality Running DPDK Applications Without Root Privileges ------------------------------------------------- -In order to run DPDK as non-root, the following Linux filesystem objects' -permissions should be adjusted to ensure that the Linux account being used to -run the DPDK application has access to them: +The following sections describe generic requirements and configuration +for running DPDK applications as non-root. +There may be additional requirements documented for some drivers. -* All directories which serve as hugepage mount points, for example, ``/dev/hugepages`` +Hugepages +~~~~~~~~~ -* If the HPET is to be used, ``/dev/hpet`` +Hugepages must be reserved as root before runing the application as non-root, +for example:: + + sudo dpdk-hugepages.py --reserve 1G + +If multi-process is not required, running with ``--in-memory`` +bypasses the need to access hugepage mount point and files within it. +Otherwise, hugepage directory must be made accessible +for writing to the unprivileged user, for example:: + + export HUGEDIR=$HOME/huge-1G + mkdir -p $HUGEDIR + sudo dpdk-hugepages.py --mount --directory $HUGEDIR --owner `id -u`:`id -g` + +If the driver requires using physical addresses (PA), +the executable file must be granted additional capabilities: + +* ``SYS_ADMIN`` to read ``/proc/self/pagemaps`` +* ``IPC_LOCK`` to lock hugepages in memory + +.. code-block:: console + + setcap cap_ipc_lock,cap_sys_admin+ep + +If physical addresses are not accessible, +the following message will appear during EAL initialization:: + + EAL: rte_mem_virt2phy(): cannot open /proc/self/pagemap: Permission denied + +It is harmless in case PA are not needed. + +Resource Limits +~~~~~~~~~~~~~~~ When running as non-root user, there may be some additional resource limits that are imposed by the system. Specifically, the following resource limits may @@ -34,7 +67,15 @@ need to be adjusted in order to ensure normal DPDK operation: The above limits can usually be adjusted by editing ``/etc/security/limits.conf`` file, and rebooting. -Additionally, depending on which kernel driver is in use, the relevant +See `Hugepage Mapping `_ +secton to learn how these limits affect EAL. + +Device Control +~~~~~~~~~~~~~~ + +If the HPET is to be used, ``/dev/hpet`` permissions must be adjusted. + +Depending on which kernel driver is in use, the relevant resources also should be accessible by the user running the DPDK application. For ``vfio-pci`` kernel driver, the following Linux file system objects' diff --git a/doc/guides/prog_guide/env_abstraction_layer.rst b/doc/guides/prog_guide/env_abstraction_layer.rst index 5f0748fba1..70fa099d30 100644 --- a/doc/guides/prog_guide/env_abstraction_layer.rst +++ b/doc/guides/prog_guide/env_abstraction_layer.rst @@ -228,6 +228,8 @@ Normally, these options do not need to be changed. can later be mapped into that preallocated VA space (if dynamic memory mode is enabled), and can optionally be mapped into it at startup. +.. _hugepage_mapping: + Hugepage Mapping ^^^^^^^^^^^^^^^^ From patchwork Tue Jun 7 23:49:49 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dmitry Kozlyuk X-Patchwork-Id: 112510 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 193C6A0548; Wed, 8 Jun 2022 01:50:19 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 839B442802; Wed, 8 Jun 2022 01:50:09 +0200 (CEST) Received: from NAM11-CO1-obe.outbound.protection.outlook.com (mail-co1nam11on2061.outbound.protection.outlook.com [40.107.220.61]) by mails.dpdk.org (Postfix) with ESMTP id 17B6C427F6; Wed, 8 Jun 2022 01:50:08 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=I1H/0bqshFaf0/IPunwV3sZwrtahKKQq04mau3NdeWMLIW4zCz3XkSFmmkO0j57l514k46ZNYE03L/oDahLxc68ZahXrTuPUItvI6a3Ts+oUrv95eG1pfcFwUHkPsBkSDcX4vJYLA/c3gYLTVlj1mHxsyshvvrJqU+gmYxhgSHSjRRxOvfPGTdVQ9EM8jvBSUDO5VPplY/BJD2OP+/38oAOA+2Uq8fVYYKDqvqPj8psp4/ZzFMebCItCGnTeQKE40GPY7w3izuwCLpERpB6BKtWO2saBIzldRa8OtETdEhcT+H9bwy+mW6p6dDDAl0vra916DPuIyVCUmkalUM0Wuw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=AV5oBSvMPTf3MbiDEGXvz2akaIQyZzDbjTcFp6RIZOA=; b=SuZohrTOdjgcnrB4WEgaKsZ6y4wrOcNSeDkZzILVhtVLRPXHELU+w34KvNYPJmsXcgDGm1W4n7DHpaDqzD6zTKGKu03O2SOxyxb6Xen2eZNOr63GrvfY3akLtlTLOmyRzaq89flfFw5tBOJS0YFMo+1gvOmBLxF22WD8E1hy9pUnIBx3x38Bk30BUOlu7uuf+yfkFUWMTawlXunF1oT64wzOLmduc2agW5KJmuAERq6iZayo6l4PavowLJcJJmvcDHfYak/JvlxjpVAgvweuA/wQioNEYgcAjahzp+elntkV4uuUEI3gtX/VirC539l9PQD5/T44ld/BAH3CvK+UFQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 12.22.5.238) smtp.rcpttodomain=dpdk.org smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); 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=AV5oBSvMPTf3MbiDEGXvz2akaIQyZzDbjTcFp6RIZOA=; b=YfRFBDTquNckpulCzP9gPauHWuc0TXOnHUvRbXV2aHUiiOmg1YGWU7Udd+mKCgozHhGbfzBoB7q91R7RO5dZ88+DDoK0QkgLxE7xyjqr7/23GhZIynF2671x3zluWfz9TFAl6qwWEguCyvZnmuhgbFf5pKHnYOqRIK9B/q4i46b6bUFxR4ZOCgWeSkJVBO8KKA2zYYMlVwvytay7Zq+oZc+5mg2vOmG6XsT6KX3iCRpAYDd1iLLBWjg04ny6ddaLuSzaDNJC9jUbufirISjj8yIDYSPCSokM5M6GjViuOkodwMK1mZMnvKQ2usSlFRFMiyvKf7OqxhgwelfBNQRX9Q== Received: from BN1PR12CA0002.namprd12.prod.outlook.com (2603:10b6:408:e1::7) by DS7PR12MB6192.namprd12.prod.outlook.com (2603:10b6:8:97::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5314.19; Tue, 7 Jun 2022 23:50:06 +0000 Received: from BN8NAM11FT023.eop-nam11.prod.protection.outlook.com (2603:10b6:408:e1:cafe::44) by BN1PR12CA0002.outlook.office365.com (2603:10b6:408:e1::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5314.17 via Frontend Transport; Tue, 7 Jun 2022 23:50:06 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 12.22.5.238) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 12.22.5.238 as permitted sender) receiver=protection.outlook.com; client-ip=12.22.5.238; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (12.22.5.238) by BN8NAM11FT023.mail.protection.outlook.com (10.13.177.103) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.5314.12 via Frontend Transport; Tue, 7 Jun 2022 23:50:05 +0000 Received: from drhqmail203.nvidia.com (10.126.190.182) by DRHQMAIL105.nvidia.com (10.27.9.14) with Microsoft SMTP Server (TLS) id 15.0.1497.32; Tue, 7 Jun 2022 23:50:04 +0000 Received: from drhqmail203.nvidia.com (10.126.190.182) by drhqmail203.nvidia.com (10.126.190.182) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.22; Tue, 7 Jun 2022 16:50:03 -0700 Received: from nvidia.com (10.127.8.11) by mail.nvidia.com (10.126.190.182) with Microsoft SMTP Server id 15.2.986.22 via Frontend Transport; Tue, 7 Jun 2022 16:50:02 -0700 From: Dmitry Kozlyuk To: CC: Thomas Monjalon , Subject: [PATCH 4/4] doc: update instructions for running as non-root for MLX5 Date: Wed, 8 Jun 2022 02:49:49 +0300 Message-ID: <20220607234949.2311884-5-dkozlyuk@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220607234949.2311884-1-dkozlyuk@nvidia.com> References: <20220607234949.2311884-1-dkozlyuk@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 35f74f9b-f6e9-4bc4-161b-08da48e07294 X-MS-TrafficTypeDiagnostic: DS7PR12MB6192:EE_ X-LD-Processed: 43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: +OB3MRcFw2873iQD5edIG//tgfNItv0blX7SFJi4ORcJbN8zw/Hvd1DgkOM5fUZMFjzdeSH75XDY/7uNRDl44y4IlhlJpbXsul+uhGHz52Dd367wqGSimPwHturFojy9NktIi6tucOPjNxF8/Fvmx/RvXvByclV7er/cO3jLFvyI6nH6+fLDghvivscBcvSoH8TVdkv98i1H0Rtb+3827H8k+CTqQH8wGjeD4cSoS2LZduQQHEZlweufOgI0ssPn0KYNDsHkFor5hPCHRrw2KGOg/0apH3vpU9G1232S/6vztYivK3QQTFlyxmRtBFa4WYCBUpCMWOwhF8/LQiNQo3FyHoFcfZsiFROjmqakRv9aXSs9BbTvDB7bVsiFwfTDxEQmSZDRRKeaaB2yPjZHpMRlLY6IJGvzk6ZbixTkWuNOpqI6Sq8ZVOdpdaakxQUVPTDeI68BkrL9CV6VRl/zQWYGruQwFesz/SmQYjMm5cNSDY7XtAVfgr/H59n11mZjBhvQ1mGkm4dngCxJZfLcqabJ420YXT6WBbNHRVG97/OcCbS6lfdlRdpcdQZfo8jIhaofaJ5ZLCBNR4BaGBWwAyyxdRwu5CO6qevJjfQBE7EzU9HRAfNl15VCdy+vHY5RPeLOvQc5tXvCXI7SBUTOjBFoKa+eegQ6/s2eTZ7OYGdDbYn4Whi8nu/iFBpU8hWR4qliEFGPg6aK9CNo+DdYAQ== X-Forefront-Antispam-Report: CIP:12.22.5.238; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE; SFS:(13230001)(4636009)(46966006)(40470700004)(36840700001)(86362001)(336012)(7696005)(26005)(70586007)(1076003)(70206006)(6666004)(6286002)(36756003)(40460700003)(426003)(47076005)(83380400001)(356005)(54906003)(8676002)(6916009)(4326008)(316002)(8936002)(36860700001)(2616005)(5660300002)(186003)(55016003)(81166007)(82310400005)(508600001)(2906002)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Jun 2022 23:50:05.6653 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 35f74f9b-f6e9-4bc4-161b-08da48e07294 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.238]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: BN8NAM11FT023.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS7PR12MB6192 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Reference the common guide for generic setup. Remove excessive capabilities from the recommended list. Cc: stable@dpdk.org Signed-off-by: Dmitry Kozlyuk --- doc/guides/platform/mlx5.rst | 22 ++++++++++------------ 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/doc/guides/platform/mlx5.rst b/doc/guides/platform/mlx5.rst index 64a4c5e76e..956a72fadf 100644 --- a/doc/guides/platform/mlx5.rst +++ b/doc/guides/platform/mlx5.rst @@ -404,25 +404,23 @@ The device can be bound again at this point. Run as Non-Root ^^^^^^^^^^^^^^^ -In order to run as a non-root user, -some capabilities must be granted to the application:: +Hugepage and resource limit setup is documented +in the :ref:`common Linux guide `. +This PMD does not require physical addresses, +so capability configuration is not needed to access hugepages. +Note that physical addresses may be required by other drivers. - setcap cap_sys_admin,cap_net_admin,cap_net_raw,cap_ipc_lock+ep +Additional capabilities must be granted to the application:: -Below are the reasons for the need of each capability: - -``cap_sys_admin`` - When using physical addresses (PA mode), with Linux >= 4.0, - for access to ``/proc/self/pagemap``. + setcap cap_net_raw,cap_net_admin,cap_sys_rawio+ep -``cap_net_admin`` - For device configuration. +Below are the reasons for the need of each capability: ``cap_net_raw`` For raw ethernet queue allocation through kernel driver. -``cap_ipc_lock`` - For DMA memory pinning. +``cap_net_admin`` + For device configuration, like setting link status or MTU. Windows Environment