mbox

[v3,0/3] ethdev: document special cases of port start and stop

Message ID 20221114181956.1052159-1-dsosnowski@nvidia.com (mailing list archive)
Headers

Message

Dariusz Sosnowski Nov. 14, 2022, 6:19 p.m. UTC 
  This patch series attempts to address the special failure
cases of rte_eth_dev_stop() and rte_eth_dev_start().

In case of starting a port, If the port cannot be started and
start operation must be retried, PMDs might return (-EAGAIN)
to notify about such situation.

In case of stopping a port, If the port cannot be stopped
in the current state, PMDs might return (-EBUSY)
to notify about such situation.

These cases are addressed in ethdev API docs.
Testpmd is updated to allow users to manually retry start/stop operations.

v3:
- Allow to retry port stop in testpmd for all errors.
- Made error descriptions in the API more generic and
  moved specific error causes descriptions to PMD.

v2:
- Fixed documentation build.

Dariusz Sosnowski (3):
  net/mlx5: fix log level on failed transfer proxy stop
  net/mlx5: document E-Switch limitations with HWS in mlx5 PMD
  ethdev: document special cases of port start and stop

 app/test-pmd/testpmd.c          |  8 +++++++-
 doc/guides/nics/mlx5.rst        | 13 +++++++++++++
 drivers/net/mlx5/mlx5_trigger.c | 17 ++++++++++++++---
 lib/ethdev/rte_ethdev.h         |  2 ++
 4 files changed, 36 insertions(+), 4 deletions(-)