[PATCH v3 4/4] dts: add sr-iov section to docs
Dean Marx
dmarx at iol.unh.edu
Wed Jul 2 18:23:31 CEST 2025
Add a section to the dts.rst file explaining how to
enable SR-IOV mode on an environment, as well
as any additional steps needed for virtual
function configuration.
Signed-off-by: Dean Marx <dmarx at iol.unh.edu>
---
doc/guides/tools/dts.rst | 46 ++++++++++++++++++++++++++++++++++++++++
dts/README.md | 2 +-
2 files changed, 47 insertions(+), 1 deletion(-)
diff --git a/doc/guides/tools/dts.rst b/doc/guides/tools/dts.rst
index 7e68159571..5dd858a7c8 100644
--- a/doc/guides/tools/dts.rst
+++ b/doc/guides/tools/dts.rst
@@ -217,6 +217,52 @@ There are two areas that need to be set up on a System Under Test:
sudo usermod -aG sudo <sut_user>
+#. **SR-IOV**
+
+ Before configuring virtual functions, SR-IOV support must be enabled in the system BIOS/UEFI:
+
+ #. Reboot the system and enter BIOS/UEFI settings.
+ #. Locate the SR-IOV option (often under PCIe or Advanced settings).
+ #. Set SR-IOV to **Enabled** and save changes.
+
+ For Mellanox environments, the following additional setup steps are required:
+
+ #. **Install mstflint tools** (if not already installed):
+
+ .. code-block:: bash
+
+ sudo apt install mstflint # On Debian/Ubuntu
+ sudo yum install mstflint # On RHEL/CentOS
+
+ #. **Start the MST service**:
+
+ .. code-block:: bash
+
+ sudo mst start
+
+ #. **List Mellanox devices**:
+
+ .. code-block:: bash
+
+ sudo mst status
+
+ This will output paths such as ``/dev/mst/mt4121_pciconf0`` and possibly additional functions (e.g., ``pciconf0.1``).
+
+ #. **Enable SR-IOV and configure number of VFs**:
+
+ .. code-block:: bash
+
+ sudo mlxconfig -d /dev/mst/mt4121_pciconf0 set SRIOV_EN=1 NUM_OF_VFS=8
+ sudo mlxconfig -d /dev/mst/mt4121_pciconf0.1 set SRIOV_EN=1 NUM_OF_VFS=8
+
+ Replace the device names with those matching your setup (from ``mst status``). The number of VFs can be adjusted as needed.
+
+ #. **Reboot the system**:
+
+ .. code-block:: bash
+
+ sudo reboot now
+
Setting up Traffic Generator Node
---------------------------------
diff --git a/dts/README.md b/dts/README.md
index 224a7aa20b..73c56ec504 100644
--- a/dts/README.md
+++ b/dts/README.md
@@ -33,7 +33,7 @@ its own ports.
3. DTS uses ssh key auth to control the nodes. Copy your ssh keys to the TG and SUT:
ssh-copy-id dts@{your host}.
-For additional detail, please refer to [dts.rst](doc/guides/tools/dts.rst)
+For additional detail on how to set up a valid DPDK environment, please refer to [dts.rst](doc/guides/tools/dts.rst)
# DTS Configuration
--
2.49.0
More information about the dev
mailing list