[PATCH net-next V3 10/10] devlink: Document port-level resources
From: Tariq Toukan <tariqt@nvidia.com>
Date: 2026-02-26 22:20:54
Also in:
linux-doc, linux-kselftest, linux-rdma, lkml
Subsystem:
documentation, networking [general], the rest · Maintainers:
Jonathan Corbet, "David S. Miller", Eric Dumazet, Jakub Kicinski, Paolo Abeni, Linus Torvalds
From: Or Har-Toov <redacted> Add documentation for the port-level resource feature to devlink-resource.rst. Port-level resources allow viewing resources associated with specific devlink ports. Currently, port-level resources only support the get command for viewing resource information. Signed-off-by: Or Har-Toov <redacted> Reviewed-by: Shay Drori <redacted> Reviewed-by: Moshe Shemesh <redacted> Reviewed-by: Jiri Pirko <redacted> Signed-off-by: Tariq Toukan <tariqt@nvidia.com> --- .../networking/devlink/devlink-resource.rst | 36 +++++++++++++++++++ 1 file changed, 36 insertions(+)
diff --git a/Documentation/networking/devlink/devlink-resource.rst b/Documentation/networking/devlink/devlink-resource.rst
index b4203c498bf2..1d6d8bfa1692 100644
--- a/Documentation/networking/devlink/devlink-resource.rst
+++ b/Documentation/networking/devlink/devlink-resource.rst@@ -94,3 +94,39 @@ attribute, which represents the pending change in size. For example: Note that changes in resource size may require a device reload to properly take effect. + +Port-level Resources +==================== + +In addition to device-level resources, ``devlink`` also supports port-level +resources. These resources are associated with a specific devlink port rather +than the device as a whole. + +Currently, port-level resources only support the ``GET`` command for viewing +resource information. + +Port-level resources can be viewed for a specific port: + +.. code:: shell + + $devlink port resource show pci/0000:03:00.0/196608 + pci/0000:03:00.0/196608: + name max_SFs size 20 unit entry + +Or for ports of a specific device: + +.. code:: shell + + $devlink port resource show pci/0000:03:00.0 + pci/0000:03:00.0/196608: + name max_SFs size 20 unit entry + +Or for all ports across all devices: + +.. code:: shell + + $devlink port resource show + pci/0000:03:00.0/196608: + name max_SFs size 20 unit entry + pci/0000:03:00.1/262144: + name max_SFs size 20 unit entry
--
2.44.0