efadv_wr_set_processing_hints(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | AUTHORS | COLOPHON

EFADV_WR...ING_HINTS(3)  EFA Direct Verbs Manual  EFADV_WR...ING_HINTS(3)

NAME         top

       efadv_wr_set_processing_hints - Set processing hints on the
       current work request

SYNOPSIS         top

              #include <infiniband/efadv.h>

              static inline void efadv_wr_set_processing_hints(
                  struct efadv_qp *efadv_qp,
                  uint32_t hints);

DESCRIPTION         top

       efadv_wr_set_processing_hints() sets processing hints on the
       current work request being built.  Hints allow the application to
       communicate intended usage patterns to the device, which may use
       them to optimize processing.

       This function is a work request setter and must be called after
       the work request opcode function (e.g. ibv_wr_send()) and before
       ibv_wr_complete() or the next work request opcode call.

       Use efadv_qp_from_ibv_qp_ex() to get the efadv_qp for accessing
       this interface.

       The QP must be created with EFADV_WR_EX_WITH_PROCESSING_HINTS set
       in efadv_qp_init_attr.wr_flags to use this function.

       The hints argument is a bitmask of efadv_wr_processing_hint
       values:

              enum efadv_wr_processing_hint {
                  EFADV_WR_PROCESSING_HINT_BURST_PPS_SENSITIVE = 1 << 0,
              };

       EFADV_WR_PROCESSING_HINT_BURST_PPS_SENSITIVE
              Optimize for throughput in bursty, packet-rate sensitive
              workloads.

SEE ALSO         top

       efadv(7), efadv_create_qp_ex(3), ibv_wr_start(3)

AUTHORS         top

       Michael Margolin ⟨mrgolin@amazon.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 2026-05-24.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2026-05-20.)  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

efa                             2026-05-05        EFADV_WR...ING_HINTS(3)