mlx5dv_dci_stream_id_reset(3) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| ARGUMENTS \| RETURN VALUE \| AUTHOR \| COLOPHON

mlx5dv_dci_stream_id_reset(3)               mlx5dv_dci_stream_id_reset(3)

NAME top

       mlx5dv_dci_stream_id_reset - Reset stream_id of a given DCI QP

SYNOPSIS top

              #include <infiniband/mlx5dv.h>

              int mlx5dv_dci_stream_id_reset(struct ibv_qp *qp, uint16_t stream_id);

DESCRIPTION top

       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 top

       qp     The ibv_qp object to issue the action on.

       stream_id
              The DCI stream channel id that need to be reset.

RETURN VALUE top

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

AUTHOR top

       Lior Nahmanson ⟨liorna@nvidia.com⟩

COLOPHON top

       This page is part of the rdma-core (RDMA Core Userspace Libraries
       and Daemons) project.  Information about the project can be found
       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug
       report for this manual page, send it to
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2025-08-11.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-08-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

                                            mlx5dv_dci_stream_id_reset(3)