Currently, there is no way in the testpmd shell class to set the mbuf
fast free offload configuration for queues or ports. This prohibits any
test suites to be written utilizing this offload configuration.
Introduce methods that support calls to testpmd in order to allow
the configuration of mbuf fast free.
Signed-off-by: Andrew Bailey <abai...@iol.unh.edu>
---
dts/framework/remote_session/testpmd_shell.py | 60 +++++++++++++++++++
1 file changed, 60 insertions(+)
diff --git a/dts/framework/remote_session/testpmd_shell.py
b/dts/framework/remote_session/testpmd_shell.py
index 1df3d5f792..ecbdd66edd 100644
--- a/dts/framework/remote_session/testpmd_shell.py
+++ b/dts/framework/remote_session/testpmd_shell.py
@@ -2672,6 +2672,66 @@ def get_capabilities_physical_function(
else:
unsupported_capabilities.add(NicCapability.PHYSICAL_FUNCTION)
+ @requires_stopped_ports
+ def set_port_mbuf_fast_free(
+ self,
+ on: bool,
+ port_id: int,
+ /,
+ verify: bool = True,
+ ) -> None:
+ """Sets the mbuf_fast_free configuration for the Tx offload of a given
port.
+
+ Args:
+ on: If :data:`True` mbuf_fast_free will be enabled, disable it
otherwise.
+ port_id: The ID of the port to configure mbuf_fast_free on.
+ verify: If :data:`True` the output of the command will be scanned
in an attempt to
+ verify that the mbuf_fast_free was set successfully.
+
+ Raises:
+ InteractiveCommandExecutionError: If mbuf_fast_free could not be
set successfully.
+ """
+ mbuf_output = self.send_command(
+ f"port config {port_id} tx_offload mbuf_fast_free {"on" if on else
"off"}"
+ )
+
+ if verify and "Error" in mbuf_output:
+ raise InteractiveCommandExecutionError(
+ f"Unable to set mbuf_fast_free config on port
{port_id}:\n{mbuf_output}"
+ )
+
+ @requires_stopped_ports
+ def set_queue_mbuf_fast_free(
+ self,
+ on: bool,
+ port_id: int,
+ /,
+ queue_id: int = 0,
+ verify: bool = True,
+ ) -> None:
+ """Sets the Tx mbuf_fast_free configuration of the specified queue on
a given port.
+
+ Args:
+ on: If :data:`True` the mbuf_fast_free configuration will be
enabled, otherwise
+ disabled.
+ port_id: The ID of the port containing the queues.
+ queue_id: The ID of the queue to configure mbuf_fast_free on.
+ verify: If :data:`True` the output of the command will be scanned
in an attempt to
+ verify that mbuf_fast_free was set successfully on all ports.
+
+ Raises:
+ InteractiveCommandExecutionError: If all queues could not be set
successfully.
+ """
+ toggle = "on" if on else "off"
+ output = self.send_command(
+ f"port {port_id} txq {queue_id} tx_offload mbuf_fast_free {toggle}"
+ )
+ if verify and "Error" in output:
+ self._logger.debug(f"Set queue offload config error\n{output}")
+ raise InteractiveCommandExecutionError(
+ f"Failed to get offload config on port {port_id}, queue
{queue_id}:\n{output}"
+ )
+
class NicCapability(NoAliasEnum):
"""A mapping between capability names and the associated
:class:`TestPmdShell` methods.
--
2.50.1
