mlx5dv_map_ah_to_qp(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | ARGUMENTS | RETURN VALUE | SEE ALSO | AUTHOR | COLOPHON

mlx5dv_map_ah_to_qp(3)                             mlx5dv_map_ah_to_qp(3)

NAME         top

       mlx5dv_map_ah_to_qp - Map the destination path information in
       address handle (AH) to the information extracted from the qp.

SYNOPSIS         top

              #include <infiniband/mlx5dv.h>

              int mlx5dv_map_ah_to_qp(struct ibv_ah *ah, uint32_t qp_num);

DESCRIPTION         top

       This API maps the destination path information in address handle
       (ah) to the information extracted from the qp (e.g. congestion
       control from ECE).

       This API serves as an enhancement to DC and UD QPs to achieve
       better performance by using per-address congestion control (CC)
       algorithms, enabling DC/UD QPs to use multiple CC algorithms in
       the same datacenter.

       The mapping created by this API is implicitly destroyed when the
       address handle is destroyed.  It is not affected by the
       destruction of QP qp_num.

       A duplicate mapping to the same address handle is ignored.  As
       this API is just a hint for the hardware in this case it would do
       nothing and return success regardless of the new qp_num ECE.

       The function must be called after ECE negotiation/preconfiguration
       was done by some external means.

ARGUMENTS         top

       ah     The target’s address handle.

       qp_num The initiator QP from which congestion control information
              is extracted from its ECE.

RETURN VALUE         top

       Upon success, returns 0; Upon failure, the value of errno is
       returned.

SEE ALSO         top

       rdma_cm(7), rdma_get_remote_ece(3), ibv_query_ece(3),
       ibv_set_ece(3)

AUTHOR         top

       Yochai Cohen ⟨yochai@nvidia.com⟩

       Patrisious Haddad ⟨phaddad@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_map_ah_to_qp(3)