Skip to content

ethdev: document special cases of port start and stop

Dariusz Sosnowski dpdk-dev 3 versions – In review

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v3 Latest3 patches 3 repliesIn review
  2. v23 patches 6 repliesSuperseded
  3. v13 patches 0 repliesSuperseded

Changes in v3 from the cover letter

- 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.

Patches in v3 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/3net/mlx5: fix log level on failed transfer proxy stopdrivers/net/mlx5/mlx5_trigger.c+3 -30 replies
2/3net/mlx5: document E-Switch limitations with HWS in mlx5 PMDdoc/guides/nics/mlx5.rst drivers/net/mlx5/mlx5_trigger.c+24 -01 reply
3/3ethdev: document special cases of port start and stopapp/test-pmd/testpmd.c lib/ethdev/rte_ethdev.h+9 -11 reply

Reviews trailers per patch

All 3 patches have a Reviewed-by or Acked-by.

PatchViacheslav OvsiienkoFerruh Yigit
1/3A-b
2/3A-b
3/3A-b

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v3 thread

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

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(-)
Signature · 1 line
2.25.1