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 99B424262C; Mon, 25 Sep 2023 13:33:57 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 85053402DE; Mon, 25 Sep 2023 13:33:57 +0200 (CEST) Received: from NAM12-BN8-obe.outbound.protection.outlook.com (mail-bn8nam12on2058.outbound.protection.outlook.com [40.107.237.58]) by mails.dpdk.org (Postfix) with ESMTP id 7A2B24029F for ; Mon, 25 Sep 2023 13:33:55 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=NYACh1zpRULlUIbPMvB0Mah6EvQZyRj6cYM0wJNT0lq+4mlVdKURdDdhkJgf6Z09+Un/bjQKM5VXuoFdCvnCl0W2M332U3Nr5hoPUZAtitC8mqCSTa0rHSEbH24Zteo/k795HENdiArhGGR/5ppJvlVWggJQjIaIRvcqYnw//oLJejx87iRZ74b4BIOtImQEaLtz18hxE3TjdFBP3K20ullDkrMSk2jr6HzX/QLjgezwpgS/Zc4Mjl3og73nPb7lQmogEWCMApil1hi7gNvraoC0qZ0t5vjw/upiApYWprBYF7MSAdctE3YC1+SzQOMBCSF8nGuORb0evTMMKsTSag== 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=CWp+vcfmS8V/ZbNhLYuAI5yyzCpqWx13a+OKhWwyTdY=; b=H/OH5wPd0Dpltr7vjZMXaZ4UWGxyw44/CStrv7aCBAALZi52SxI8+crFMb9eO4t7BFRgwV0lhQivA0peNjGch0dmbpAovcU2koT2ixBpfs+Y0cXCfz6Er+PX4M1mtPF8ifgLFWjFkvjvYsBzzFi9xOFf2tVV+TNhcYL7jOOcDMRbypUX5EMTHv+3xcz+XR0QankagG7z2HUZw42IquqTaKljzLKDlRpX9jz9P9X1TjcgbRQ3ffLENYbgblNz2VcsTV9hEzOUf8U903qymfg/57mOkdHqSCqv7w1URDmOue03jrXhsGQrTxnKpBlBsytZVVumC4kBMwvOrvjQK3mGVQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=amd.com; dmarc=pass action=none header.from=amd.com; dkim=pass header.d=amd.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=CWp+vcfmS8V/ZbNhLYuAI5yyzCpqWx13a+OKhWwyTdY=; b=VaL7WU2IVBK/9awKXs9oqlAfWlj6P/uxZnY1UvwEoTWIETemg0RreKjslKXMIT+vfZ3YRbPbFwtsgkMmygzaX+KKfdmV9PRXj/w3MW4ZMvAPjuh/nZ1y/I7hbPmK87zF1d9LTZ2/UlO2kHNeC/GaprTrhg7UQlbU6z3wEcnsnFk= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=amd.com; Received: from CH2PR12MB4294.namprd12.prod.outlook.com (2603:10b6:610:a9::11) by SA1PR12MB8947.namprd12.prod.outlook.com (2603:10b6:806:386::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6813.28; Mon, 25 Sep 2023 11:33:53 +0000 Received: from CH2PR12MB4294.namprd12.prod.outlook.com ([fe80::102f:c69b:d3e5:7fe8]) by CH2PR12MB4294.namprd12.prod.outlook.com ([fe80::102f:c69b:d3e5:7fe8%4]) with mapi id 15.20.6813.027; Mon, 25 Sep 2023 11:33:53 +0000 Message-ID: <2d67e056-8020-4153-9494-08c264496254@amd.com> Date: Mon, 25 Sep 2023 12:33:52 +0100 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH 5/6] Section 5: Appendix Content-Language: en-US To: David Young , dev@dpdk.org Cc: Bruce Richardson References: <20230920154817.617-1-dave@youngcopy.com> <20230920154817.617-6-dave@youngcopy.com> From: Ferruh Yigit Autocrypt: addr=ferruh.yigit@amd.com; keydata= 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 3FQ= In-Reply-To: <20230920154817.617-6-dave@youngcopy.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-ClientProxiedBy: AS4P250CA0027.EURP250.PROD.OUTLOOK.COM (2603:10a6:20b:5e3::18) To CH2PR12MB4294.namprd12.prod.outlook.com (2603:10b6:610:a9::11) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CH2PR12MB4294:EE_|SA1PR12MB8947:EE_ X-MS-Office365-Filtering-Correlation-Id: 261427b9-37c4-4d0e-36a6-08dbbdbb4bd8 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: UYjIoJDa7ttY69PnJ+GCYVLbyFBopNXm9FN86QfRq6BPvxNveTwACY89Vs3bzLCPq8rOhV6cm9TbZjN65PXXJVCPQByih+Yc11VjL1L/ruBszRUc5ik0Nwb6C59yI9IPP4fUbaqd9d3JztHVLd89X0Swu+qZKFGIo7QBubCNiQXN4ku1ACCYtxWoxv3uyjWCBCWrErJnnc9gsH1ZaQNjXoiy1LrfjZvmDSuHNYJbhaPaUJGWNQgko7XB6zSPIOXTU3pykNrZK3TiIgMukTzw1NpI9mq+9kXMeQI4LiKDsTPEPAfect/pO2LY3fPFtMXtbSGyCECX0XdsbiDdTL/4w2jWy+hgbVm8FwXiC7izrVeV1IQc1tvhVg8mV6VFoqLghrhj7tMXSoRHcP5XOwBfDesR3xFlOZY2zexjfsrLJpOpCD2OjJ6zz+qyZHYi+jO1TfT8nY72ZlB6hHeELghGE/kDH0qzhfJUI88XC+GXQXwsys6Qr2fhtOTm+GPod1uKNb9+NYv9Ry//n0D+h+P//VYzKgN5xTbtnXQIoxcCwB1yBM0gbMbS/BxKJD10emnYdop+eG25cERAuaith6CYRBY/0CyW+5k4m4uWEmUfebsKIktXaOsd5S2dQkV0SnuiBYJbNaIwSkCixAUBCysYbg== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:CH2PR12MB4294.namprd12.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031)(396003)(366004)(39860400002)(346002)(376002)(136003)(230922051799003)(1800799009)(186009)(451199024)(6512007)(53546011)(6486002)(6506007)(83380400001)(86362001)(31696002)(38100700002)(36756003)(2616005)(26005)(44832011)(2906002)(31686004)(8936002)(8676002)(4326008)(41300700001)(66556008)(66946007)(316002)(66476007)(5660300002)(478600001)(45980500001)(43740500002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?T2NseE5jTGhFWEd0VCs2cVhVaVJMUTZCUDRnaEJtOFRLcGFEU205c1pQSWpz?= =?utf-8?B?UTZqZzViOU93alQweVFIQkF3ZndyODlJSXNJREtmY2FJQjRCM0NwMGpjK3E1?= =?utf-8?B?eDd5ZmN6SnVsNndCY2FSRnJYaUUrLzNMYXNSdmNzYjdvSHlZK2tqNGRkZ3ZB?= =?utf-8?B?TFMveERFdnN3VTB5SDg4dmxVRWJvR084QUxQdVNmbG9yNHRDVWdCeXhNaGwr?= =?utf-8?B?L2tXUE4yb0lFYXJlQlljUUtRaDRBNGVubExNMTQ5Rk1pQklITHViZTlMMjVB?= =?utf-8?B?ekh5Z296OFRKWStYQjIzdFpseTBoSGFXRXExZmhscUZqbE1zM1VyUGM0S1FH?= =?utf-8?B?VTZBS1J3US9tTmVuSXpLbE04bkR2ZWluYTg4MkdzS1pqZVorbEdQOVlHVThs?= =?utf-8?B?RDNjSmgreVNoVDdNenpQcVNCNzdIMndKR0FWK2srZEY5SGE2L0pYbjc2OG96?= =?utf-8?B?TU9RS3NrVUxkUmlLTE8zYm55TVZjcFpoanFWaXlpcTVEUUFrRkhjS1hsaGlO?= =?utf-8?B?ZktPVm0yZ2s0RUVQaGY2cCtick42a3IveTlTeTlFT0hqYXBsUWJ6UjFMS2cv?= =?utf-8?B?YVFEQWJ0cUxKa2JWWU5TT0JiWEg2bFdDUUxJZzV1eGRqQUJqVWowZUZUaDVK?= =?utf-8?B?aEMxUGF5Yk11UVpqZVlEWHRUdGhkTG9lSnFlcTR5OTNYQm9YZkcwSEplaXFQ?= =?utf-8?B?UnExTnVjMzlBTUIzd0FsSW9wTWxMRmF5OFFvdEFrc3o3V281azAvU3hBcTky?= =?utf-8?B?K3YwUE1HWXE3RnM4ZlRlTmE5eWlyUGs2T1NNMTMrbldjUit1Q0RreW1lcXFa?= =?utf-8?B?TldMdmY0TlYxcXZGNC9YTElCUkt2Z2M0K1pZSlJFdnNZai9MQ0Y5SDQwS1RL?= =?utf-8?B?OXBobVZKTVgrUWQ3Z3U2a1hzQ28ydkdINTdhVDBSOXpjcEVGYXd6TVkxSzAy?= =?utf-8?B?WHdrdFZ2MWhmY1hOQmxTUXJiZWdIM0VXaEdQOWJuUUdmdW1BdlhMR0FFdTRw?= =?utf-8?B?eTlOY3NkMUU1ZVJoOGhBdTRnR0FZdkVtb1JzL04yejJiT01JNG90aldOd01K?= =?utf-8?B?NHUxZ1hDeGpwMUxHaEpXZWNLQmJIcVlhaXFkL0xoQzVNYW42azRzV0hzcUxP?= =?utf-8?B?Rm02UGh2NUxIZmJwaGpCa1dEdE5tR3BFYmZ1a1YwdktLV0psYjRNVWVNeXpu?= =?utf-8?B?UW5LQk8wYlR5ZVdaOFNnNEVsYlRXeENnRS9uSzRrejJreUZ6U3crd2hFZFQy?= =?utf-8?B?YlFEdFdUalYzRTJaY2xITXI5K2xoMDZwR0VjT1hxVEh6R3RGU3M5cjlUNWlZ?= =?utf-8?B?djhOUHQxVzI4QWhlU2dOandzZ2tWVUdpeXJLYS8rR2pqWG43ZG1NN1c5Ym1q?= =?utf-8?B?VThDT2xVcVdNY013cUh0dk52MnBjN0Q1dld4Y1RqdnpkTWlGREFoM3QxcmFh?= =?utf-8?B?RWJpZzMxU1cxUFExOTVwRXI3STRENTd2ckxSUWVqZnRwaXNVaHhzbkhNZ2g3?= =?utf-8?B?MHk1SlMxTW93dkd1cWt5ekYyczFhSVhXdE5DQkw1U0lvRTh3dklpcFBBc2w0?= =?utf-8?B?SURmcXNBK2phZjVaK3RqNGZqWGpjN0pOczYyOHpnaEs3eGhncHBsbmt0UDkv?= =?utf-8?B?ck9SMGM1a2NsQU9seTFyQWpSbE9sOXFabjk0L2xJTFQ5eXE4VEdDTEZQQTY4?= =?utf-8?B?OEFSTXQxa0ZTU3RUTUhCdHhHdmltR2dsRk50MS9LRktEM0x1Z3BZa21NbWpu?= =?utf-8?B?dGdheUhpT2N4Q2d3Yi9lcitpZWpiRjN2MllLTzhLOVhzVjNRQlFoM3VFZUw3?= =?utf-8?B?QmFxcFZnQzNCa3lXa1orcy9Yd0kwcHptMHZ6OXVZK05kWVd6cmk1NjAyV3hv?= =?utf-8?B?SnlucGxHSjlsellta0ZqYWdtRWRNVFdrWWIrYnR1bllFa0prN1JnMVRUUjcz?= =?utf-8?B?UFFRSUhwK0xkaHAyell1dUJSQ1NLOXl6TFJxdGJYMXJaSXd5V1NiMmpoa2Jh?= =?utf-8?B?U0lVaytrdE9WdUV5Q3Z5bGs5eUxWaGYvVEJlVnloVWs1cUJMRzYzZlFXZHQ0?= =?utf-8?B?cnJtdlk2U1ZldkNJSTYvQjBmVndaeGtQUFM0VHZucU5sTjQzaGtaR1NOeVNY?= =?utf-8?Q?JbuEPhKtjIPGWNbv5hJY6q0CD?= X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-Network-Message-Id: 261427b9-37c4-4d0e-36a6-08dbbdbb4bd8 X-MS-Exchange-CrossTenant-AuthSource: CH2PR12MB4294.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 25 Sep 2023 11:33:53.3518 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: vqV0+S+9ca53bU19MXsPbxLgR+2lG/GeTpchlw8VknTPKXiIAfyug7d0ROv/enfI X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA1PR12MB8947 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 On 9/20/2023 4:48 PM, David Young wrote: > --- > .../appendix/cross_compile_dpdk.rst | 37 +++ > .../appendix/dpdk_meson_build_options.rst | 57 ++++ > .../getting_started_guide/appendix/index.rst | 17 + > .../running_dpdk_apps_without_root.rst | 36 +++ > .../appendix/vfio_advanced.rst | 295 ++++++++++++++++++ > 5 files changed, 442 insertions(+) > create mode 100644 doc/guides/getting_started_guide/appendix/cross_compile_dpdk.rst > create mode 100644 doc/guides/getting_started_guide/appendix/dpdk_meson_build_options.rst > create mode 100644 doc/guides/getting_started_guide/appendix/index.rst > create mode 100644 doc/guides/getting_started_guide/appendix/running_dpdk_apps_without_root.rst > create mode 100644 doc/guides/getting_started_guide/appendix/vfio_advanced.rst > These files are put under 'appendix' folder, and I can see these documents are linked from other 'getting started guide' documentations, which I assume the reason to put these under 'appendix' folder. But these are not limited to getting started, perhaps we can do a better organization of them out of getting started appendix. > diff --git a/doc/guides/getting_started_guide/appendix/cross_compile_dpdk.rst b/doc/guides/getting_started_guide/appendix/cross_compile_dpdk.rst > new file mode 100644 > index 0000000000..3e4efe23a4 > --- /dev/null > +++ b/doc/guides/getting_started_guide/appendix/cross_compile_dpdk.rst > @@ -0,0 +1,37 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) 2010-2025 Intel Corporation. > + > +.. _cross_compile_dpdk: > + > +Cross-compiling DPDK for Different Architectures on Linux > +========================================================= > + > +Cross-compiling DPDK for different architectures follows a similar process. Here are the general steps: > + > +1. **Get Compiler and Libraries**: Obtain the cross-compiler toolchain and any required libraries specific to the target architecture. > + > +2. **Build Using Cross-File**: Use Meson to set up the build with a cross-file specific to the target architecture, and then build with Ninja. > + > +Prerequisites > +------------- > + > +- NUMA Library (if required) > +- Meson and Ninja > +- pkg-config for the target architecture > +- Specific GNU or LLVM/Clang toolchain for the target architecture > + > +Cross-Compiling DPDK > +-------------------- > + > +1. **Set Up the Cross Toolchain**: Download and extract the toolchain for the target architecture. Add it to the PATH. > + > +2. **Compile Any Required Libraries**: Compile libraries like NUMA if required. > + > +3. **Cross-Compile DPDK with Meson**: > + > + .. code-block:: bash > + > + meson setup cross-build --cross-file > + ninja -C cross-build > + > +Refer to the specific sections for ARM64, LoongArch, and RISC-V for detailed instructions and architecture-specific considerations. > \ No newline at end of file > diff --git a/doc/guides/getting_started_guide/appendix/dpdk_meson_build_options.rst b/doc/guides/getting_started_guide/appendix/dpdk_meson_build_options.rst > new file mode 100644 > index 0000000000..6669f98371 > --- /dev/null > +++ b/doc/guides/getting_started_guide/appendix/dpdk_meson_build_options.rst > @@ -0,0 +1,57 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) 2010-2025 Intel Corporation. > + > +.. _dpdk_meson_build_options: > + > +DPDK Meson Build Configuration Options > +====================================== > + > +DPDK provides a number of build configuration options that can be adjusted using the Meson build system. These options can be listed by running ``meson configure`` inside a configured build > +folder. > + > +Changing the Build Type > +----------------------- > + > +To change the build type from the default "release" to a regular "debug" build, > +you can either: > + > +- Pass ``-Dbuildtype=debug`` or ``--buildtype=debug`` to meson when configuring the build folder initially. > +- Run ``meson configure -Dbuildtype=debug`` inside the build folder after the initial meson run. > + > +Platform Options > +---------------- > + > +The "platform" option specifies a set of configuration parameters that will be used. > +The valid values are: > + > +- ``-Dplatform=native`` will tailor the configuration to the build machine. > +- ``-Dplatform=generic`` will use configuration that works on all machines of the same architecture as the build machine. > +- ``-Dplatform=`` will use configuration optimized for a particular SoC. > + > +Consult the "socs" dictionary in ``config/arm/meson.build`` to see which SoCs are supported. > + > +Overriding Platform Parameters > +------------------------------ > + > +The values determined by the platform parameter may be overwritten. For example, > +to set the ``max_lcores`` value to 256, you can either: > + > +- Pass ``-Dmax_lcores=256`` to meson when configuring the build folder initially. > +- Run ``meson configure -Dmax_lcores=256`` inside the build folder after the initial meson run. > + > +Building Sample Applications > +---------------------------- > + > +Some of the DPDK sample applications in the examples directory can be automatically built as > +part of a meson build. To do so, pass a comma-separated list of the examples to build to the > +``-Dexamples`` meson option as below:: > + > + meson setup -Dexamples=l2fwd,l3fwd build > + > +There is also a special value "all" to request that all example applications whose dependencies > +are met on the current system are built. When ``-Dexamples=all`` is set as a meson option, > +meson will check each example application to see if it can be built, and add all which can be > +built to the list of tasks in the ninja build configuration file. > + > +For a complete list of options, run ``meson configure`` inside your configured build > +folder. > \ No newline at end of file > diff --git a/doc/guides/getting_started_guide/appendix/index.rst b/doc/guides/getting_started_guide/appendix/index.rst > new file mode 100644 > index 0000000000..23bb1fcf78 > --- /dev/null > +++ b/doc/guides/getting_started_guide/appendix/index.rst > @@ -0,0 +1,17 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) 2010-2025 Intel Corporation. > + > +.. _appendix: > + > +Appendix > +======== > + > +This section covers specific guides related to DPDK. > + > +.. toctree:: > + :maxdepth: 2 > + > + dpdk_meson_build_options > + running_dpdk_apps_without_root > + vfio_advanced > + cross_compile_dpdk > \ No newline at end of file > diff --git a/doc/guides/getting_started_guide/appendix/running_dpdk_apps_without_root.rst b/doc/guides/getting_started_guide/appendix/running_dpdk_apps_without_root.rst > new file mode 100644 > index 0000000000..9f214bbdc8 > --- /dev/null > +++ b/doc/guides/getting_started_guide/appendix/running_dpdk_apps_without_root.rst > @@ -0,0 +1,36 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) 2010-2025 Intel Corporation. > + > +.. _running_dpdk_apps_without_root: > + > +Running DPDK Applications Without Root Privileges > +================================================= > + > +Although applications using the DPDK use network ports and other hardware resources > +directly, with a number of small permission adjustments, > +it is possible to run these applications as a user other than “root”. > +To do so, the ownership, or permissions, on the following file system objects should be > +adjusted so the user account being used to run the DPDK application has > +access to them: > + > +Linux > +----- > + > +1. **Create a DPDK User Group**: Create a new user group for DPDK and add the desired user to this group. > + > +2. **Set Up Hugepages**: Configure hugepages for the user. > + > +3. **Bind the NIC to a User-Space Driver**: Use the DPDK tool ``dpdk-devbind.py`` to bind the NIC to a user-space driver like ``vfio-pci`` or ``igb_uio``. > + > +4. **Set Permissions for UIO/VFIO Devices**: Change the ownership and permissions of the UIO or VFIO devices to allow access by the DPDK user group. > + > +5. **Run the DPDK Application**: Run the desired DPDK application as the user who has been added to the DPDK group. > + > I think we need a sample commands, additional to description, on how to run an application as a non-priviledged user. > +FreeBSD > +------- > + > +- The userspace-io device files in ``/dev``, for example, ``/dev/uio0``, ``/dev/uio1``, and so on > +- The userspace contiguous memory device: ``/dev/contigmem`` > + > + > +Refer to the `DPDK Release Notes `_ for supported applications. > Applications that run without root privileges? Do we have that kind of list in release notes? > \ No newline at end of file > diff --git a/doc/guides/getting_started_guide/appendix/vfio_advanced.rst b/doc/guides/getting_started_guide/appendix/vfio_advanced.rst > new file mode 100644 > index 0000000000..1cdb138eb7 > --- /dev/null > +++ b/doc/guides/getting_started_guide/appendix/vfio_advanced.rst > @@ -0,0 +1,295 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) 2010-2025 Intel Corporation. > + > +.. _vfio_advanced: > + > +.. |reg| unicode:: U+000AE > + > +VFIO Advanced > +============= > + > + > +.. contents:: Table of Contents > + :local: > + > +.. _vfio_no_iommu_mode: > + > +VFIO no-IOMMU mode > +------------------ > + I guess this is the only documentation specific to "VFIO", (and title is VFIO advanced), I think it can be better to start with describing VFIO, instead of starting with no-iommu mode.