mlx5dv_dci_stream_id_reset(3)

mlx5dv_dci_stream_id_reset3

Reset stream_id of a given dci qp

Usage

#include <infiniband/mlx5dv.h>
int mlx5dv_dci_stream_id_reset(struct ibv_qp *qp, uint16_t stream_id);

Overview

Used by SW to reset an errored stream_id in the HW DCI context.

On work completion with error, the application should call ibv_query_qp() to check if the QP was moved to an error state, or it’s still operational (in RTS state), which means that the specific stream_id that caused the completion with error is in error state.

Errors which are stream related will cause only that stream_id’s work request to be flushed as they are handled in order in the send queue. Once all stream_id WR’s are flushed, application should reset the errored stream_id by calling mlx5dv_dci_stream_id_reset(). Work requested for other stream_id’s will continue to be processed by the QP. The DCI QP will move to an error state and stop operating once the number of unique stream_id in error reaches the DCI QP’s `log_num_errored' streams defined by SW.

Application should use the `wr_id' in the ibv_wc to find the stream_id from it’s private context.

Arguments

qp

The ibv_qp object to issue the action on.

stream_id

The DCI stream channel id that need to be reset.

Return value

Returns 0 on success, or the value of errno on failure (which indicates the failure reason).

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

Author

Lior Nahmanson ⟨[email protected]⟩\c

From rdma-core 65.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.