From: Wei Hu <[email protected]> Add device reset section to mana.rst describing the two-phase reset flow, recovery events, and PCI remove event dependency. Add release note entry for the 26.07 release.
Signed-off-by: Wei Hu <[email protected]> --- doc/guides/nics/mana.rst | 33 ++++++++++++++++++++++++++ doc/guides/rel_notes/release_26_07.rst | 8 +++++++ 2 files changed, 41 insertions(+) diff --git a/doc/guides/nics/mana.rst b/doc/guides/nics/mana.rst index 0fcab6e2f6..a89338291a 100644 --- a/doc/guides/nics/mana.rst +++ b/doc/guides/nics/mana.rst @@ -71,3 +71,36 @@ The user can specify below argument in devargs. The default value is not set, meaning all the NICs will be probed and loaded. User can specify multiple mac=xx:xx:xx:xx:xx:xx arguments for up to 8 NICs. + +Device Reset Support +-------------------- + +The MANA PMD supports automatic recovery from hardware service reset events. +When the MANA kernel driver receives a hardware service event, +it initiates a device reset and notifies userspace +via ``IBV_EVENT_DEVICE_FATAL``. + +The driver handles this transparently through a two-phase reset flow: + +* **Enter phase**: The driver stops the data path, + waits for all threads to reach a quiescent state using RCU, + tears down IB resources and queues, + and unmaps secondary process doorbell pages. + +* **Exit phase**: After a delay for hardware recovery, + a control thread re-probes the PCI device, + reinstalls the interrupt handler, + reinitializes resources, and restarts queues. + +The driver emits the following ethdev recovery events +to notify upper layers (e.g. netvsc) of the reset lifecycle: + +* ``RTE_ETH_EVENT_ERR_RECOVERING`` — reset has started +* ``RTE_ETH_EVENT_RECOVERY_SUCCESS`` — device has recovered successfully +* ``RTE_ETH_EVENT_RECOVERY_FAILED`` — recovery failed + +To distinguish a PCI hot-remove from a service reset, +the driver registers for PCI device removal events. +This requires the application to call ``rte_dev_event_monitor_start()`` +for removal events to be delivered +(e.g. testpmd ``--hot-plug-handling`` option). diff --git a/doc/guides/rel_notes/release_26_07.rst b/doc/guides/rel_notes/release_26_07.rst index 92c90673bc..114bc09c5d 100644 --- a/doc/guides/rel_notes/release_26_07.rst +++ b/doc/guides/rel_notes/release_26_07.rst @@ -77,6 +77,14 @@ New Features Added network driver for the Linkdata Network Adapters. +* **Added device reset support to the MANA PMD.** + + Added automatic recovery from hardware service reset events + in the MANA poll mode driver. The driver uses ethdev recovery events + (``RTE_ETH_EVENT_ERR_RECOVERING``, ``RTE_ETH_EVENT_RECOVERY_SUCCESS``, + ``RTE_ETH_EVENT_RECOVERY_FAILED``) to notify upper layers of the + reset lifecycle. + Removed Items ------------- -- 2.34.1
