From patchwork Fri Jun 24 08:48:12 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dmitry Kozlyuk X-Patchwork-Id: 113418 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 803A8A0032; Fri, 24 Jun 2022 10:48:36 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id DE5BF427EC; Fri, 24 Jun 2022 10:48:34 +0200 (CEST) Received: from NAM10-DM6-obe.outbound.protection.outlook.com (mail-dm6nam10on2061.outbound.protection.outlook.com [40.107.93.61]) by mails.dpdk.org (Postfix) with ESMTP id B7C6040A82 for ; Fri, 24 Jun 2022 10:48:30 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=YDxCFiz4V7gtqDqu33I1dXprSL6/Qu9GWK96SZ7u/ND0/JknRvqD+8PBJkDPdKZaPUtVza7zKbqtLBYCp7qKbEqmilOgiUYvt7lVHdlo5avyMKC2XSAkHYdPlbvAo7FYH5VjCoK8PgQDqvZMddb5VLcSKlKgvuxXGoGCRKRFRmUwOlEWuXrgLFJ+iU9B0WRhl9mw+Bj9C2oLQ2uH45c1vQUZHSfMGbpyQjKqCNw5wrIpK1ZeGLSvJMfzqF8+2J6iT/8TVIJ3bvI0EiMm0WLk/JSQJe/761u70emx1i+Tj/K1GlJJHKS+j6ralCB4azr/p1fc4s4FKhJ/D8IZNZVGGw== 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=CnCywvBJHeX7Zmjnqp9xKWBrGunbZTtRD9ITxsB7Zoo=; b=a6V+I7AP+IiCQvrD/lWQDggSdCc8RrbXdQrY9UE0s7WHo9mo3EmSxBKWsH9Gere3HAlh/k3LQ3ojYEr3gyRV6xguhDN/M4swjJo6LKPSm+yELW7kweCp2xBq5KcJa5AYe09M4+aRnfjkn1y9fKJpOFoN4zRQgLMr2xNIVZMpuaTQjjap8yHC0mOaXsBqrbzIo86AzdSOPaOJNDY7KKT0uDsdZsuSElhQz5NiS5dd3WrSf2vgogtz1XmXNJZ7/i4S32tKv+yARYexP4KQs8TB5SGAISrsOBT6ZA9Z+t2pNinBsY9iMfecgy6RILAmUnJFMC7fCZBU0x3EGEGS74NLIg== 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=CnCywvBJHeX7Zmjnqp9xKWBrGunbZTtRD9ITxsB7Zoo=; b=JAYXqgRZY5+5imxF35J3PZO63RJduZ8ODHS1aQfl/bAN5yARzQMrru/9zKJWmj5fSs4qzuAQPNzzVREXQpN8e2r7853XQ9wq+GY6AxKolGJS5/jn/ICNImvjXi1H+4CwD1kemcVNFLh2jWhOhRLCoWwc04Oi3odoKAZH6KpBEYSL+VzT+SWq3+uM5xc5RhF3MPBWpVoq396dAmjkOuy/jcAk7DpsIQHyh5CddpoYeyn8v04qVyocRbmCWy4V/0ehW6kEOF4c43QIO1t6gQnkSYnhRAOgNKzj5k5KyTMncZmsl+Q/XYLE0uK+G8Ds+P9UYNX5CCNlZNtf//6Y3sYajg== Received: from BN6PR11CA0009.namprd11.prod.outlook.com (2603:10b6:405:2::19) by BL0PR12MB2578.namprd12.prod.outlook.com (2603:10b6:207:49::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5373.15; Fri, 24 Jun 2022 08:48:27 +0000 Received: from BN8NAM11FT021.eop-nam11.prod.protection.outlook.com (2603:10b6:405:2:cafe::bb) by BN6PR11CA0009.outlook.office365.com (2603:10b6:405:2::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5373.15 via Frontend Transport; Fri, 24 Jun 2022 08:48:27 +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 BN8NAM11FT021.mail.protection.outlook.com (10.13.177.114) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.5373.15 via Frontend Transport; Fri, 24 Jun 2022 08:48:27 +0000 Received: from rnnvmail205.nvidia.com (10.129.68.10) by DRHQMAIL107.nvidia.com (10.27.9.16) with Microsoft SMTP Server (TLS) id 15.0.1497.32; Fri, 24 Jun 2022 08:48:26 +0000 Received: from rnnvmail203.nvidia.com (10.129.68.9) by rnnvmail205.nvidia.com (10.129.68.10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.26; Fri, 24 Jun 2022 01:48:25 -0700 Received: from nvidia.com (10.127.8.11) by mail.nvidia.com (10.129.68.9) with Microsoft SMTP Server id 15.2.986.26 via Frontend Transport; Fri, 24 Jun 2022 01:48:24 -0700 From: Dmitry Kozlyuk To: Subject: [PATCH v3 0/5] Improve documentation for running as non-root Date: Fri, 24 Jun 2022 11:48:12 +0300 Message-ID: <20220624084817.63145-1-dkozlyuk@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220617112508.3823291-1-dkozlyuk@nvidia.com> References: <20220617112508.3823291-1-dkozlyuk@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 333f7ef1-0b0d-4131-f4ee-08da55be4e4e X-MS-TrafficTypeDiagnostic: BL0PR12MB2578:EE_ X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: /hRnhtdyVf7ACKaSmxF5bx1NLjcc9MMAyakzhc+3EsLX8zDyPo1R8Xoz7N1CAlXWqo6+FRYfTIr0HciZ+frCu1S1l5tG07OKZfktMd95wu12BVI3SLht1/KJwqci86JAnWwx/gQipCkJVYLJVPs3R1054ga7kWG7xplM71WgSnwhyDWSW5dvgQpqGDKGX9HbR9e5gp7ALu9nW1r9R8AUBQbr6DyUQsh844A95Te4dXQ3rUYnFd9lc1UE5HNKKMmUEqUtCTqNb+UtWThImfPb7u4jlmOuSxYCFO9+FclVHoioAUnqV4QlQmop9YuvVyn5Z/x3DSO5+WVaODsCgNPh024nhkyYFRBmerlBRQt2RngXdG/jGMCeOAJsBguLtsVlVlLH+jKvUfK9WVHPLFgTZj2PaAc2hAh3oNxW1NgPjLQ/qIkBcFP2aO8d32e6aNh3BNiT3J9zdT/qQkC8GyBrBOSOwYkha9FiT99ZtHiBBgm32oSAz4/WduLEbj1HGu+FggbtSnd/8MXiext7OQV6Sp3AiYelTljg8jZynrCcQMbCOKmi2V14/NaMPjDSSsaTHhRJTGQ2bfTOvWSqZfQV0xSdQAkz2PNQitYKHqggPaAI5R0tg6WAfZeAvQi3MWDQ/DE7SEtgUZfvJq1h3j0F97BH5xn0cY+lX2k3oflwVaCvpJ0Wz2nJYcbpFivcN4U4toK5ZQUezNmy9XIOBe63UhDFR+3FLrz92BOyTHgIFzulGmpIg77ZE9x9AWwOo8YGMXc7MB59ke9HQo19vk5tEMslyvZCtQnA1wAG5mJzXX26M99lyGERhCIsNiFfVGET+g5aOynGj17KmU13bOS9jw== 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:(13230016)(4636009)(346002)(136003)(376002)(39860400002)(396003)(36840700001)(46966006)(40470700004)(70586007)(8676002)(6666004)(86362001)(2906002)(5660300002)(478600001)(8936002)(70206006)(41300700001)(40460700003)(6286002)(26005)(7696005)(356005)(82740400003)(81166007)(40480700001)(6916009)(55016003)(36756003)(82310400005)(36860700001)(426003)(83380400001)(336012)(2616005)(316002)(1076003)(47076005)(186003)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Jun 2022 08:48:27.0572 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 333f7ef1-0b0d-4131-f4ee-08da55be4e4e 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: BN8NAM11FT021.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL0PR12MB2578 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 v3: Address comments by Bruce Richardson: - Remove the section for using UIO with older kernels. - Move the note about legacy virtio to virtio doc. - Advertise vfio-pci usage to avoid physical addresses (still unclear whether and when it requires IPC_LOCK). - Fix typo. v2: Address comments by Stephen Hemminger: - Use hugetlbfs options instead of chown. - Suggest using OS or container runtime where possible. - Improve wording. Add SYS_RAWIO requirement for legacy virtio. Explain SYS_RAWIO requirement for MLX5 PMD. Dmitry Kozlyuk (5): usertools: add option to select hugetlbfs directory usertools: add option to change mount point owner doc: give specific instructions for running as non-root doc: update instructions for running as non-root for MLX5 doc: add note about running virtio-legacy as non-root doc/guides/linux_gsg/enable_func.rst | 89 +++++++++++++------ doc/guides/nics/virtio.rst | 3 + doc/guides/platform/mlx5.rst | 31 ++++--- .../prog_guide/env_abstraction_layer.rst | 2 + usertools/dpdk-hugepages.py | 20 ++++- 5 files changed, 102 insertions(+), 43 deletions(-)