From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 845D3A0548 for ; Wed, 8 Jun 2022 01:50:10 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 76DE84281C; Wed, 8 Jun 2022 01:50:10 +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 Content-Transfer-Encoding: 8bit Content-Type: text/plain 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: stable@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-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 -- 2.25.1