mlx4dv_init_obj(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO | AUTHORS | COLOPHON

MLX4DV_INIT_OBJ(3)      Library Functions Manual      MLX4DV_INIT_OBJ(3)

NAME         top

       mlx4dv_init_obj - Initialize mlx4 direct verbs object from
       ibv_xxx structures

SYNOPSIS         top

       #include <infiniband/mlx4dv.h>

       int mlx4dv_init_obj(struct mlx4dv_obj *obj, uint64_t obj_type);

DESCRIPTION         top

       mlx4dv_init_obj() This function will initialize mlx4dv_xxx
       structs based on supplied type. The information for
       initialization is taken from ibv_xx structs supplied as part of
       input.

       Request information of CQ marks its owned by direct verbs for all
       consumer index related actions. The initialization type can be
       combination of several types together.

       struct mlx4dv_qp {
               uint32_t         *rdb;
               uint32_t         *sdb;
               struct {
                       uint32_t        wqe_cnt;
                       int             wqe_shift;
                       int             offset;
               } sq;
               struct {
                       uint32_t        wqe_cnt;
                       int             wqe_shift;
                       int             offset;
               } rq;
               struct {
                       void            *buf;
                       size_t          length;
               } buf;
               uint64_t        comp_mask; /* Use enum mlx4dv_qp_comp_mask */
               off_t           uar_mmap_offset; /* If MLX4DV_QP_MASK_UAR_MMAP_OFFSET is set in comp_mask, this will contain the mmap offset of *sdb* */
       };

       struct mlx4dv_cq {
               struct {
                       void            *buf;
                       size_t          length;
               } buf;
               uint32_t        cqe_cnt;
               uint32_t        cqn;
               uint32_t        *set_ci_db;
               uint32_t        *arm_db;
               int             arm_sn;
               int             cqe_size;
               uint64_t        comp_mask; /* Use enum mlx4dv_cq_comp_mask */
               void            *cq_uar;
       };

       struct mlx4dv_srq {
               struct {
                       void            *buf;
                       size_t          length;
               } buf;
               int             wqe_shift;
               int             head;
               int             tail;
               uint32_t        *db;
               uint64_t        comp_mask;
       };

       struct mlx4dv_rwq {
               __be32          *rdb;
               struct {
                       uint32_t        wqe_cnt;
                       int             wqe_shift;
                       int             offset;
               } rq;
               struct {
                       void            *buf;
                       size_t          length;
               } buf;
               uint64_t        comp_mask;
       };

       struct mlx4dv_obj {
               struct {
                       struct ibv_qp      *in;
                       struct mlx4dv_qp   *out;
               } qp;
               struct {
                       struct ibv_cq      *in;
                       struct mlx4dv_cq   *out;
               } cq;
       };

       enum mlx4dv_obj_type {
               MLX4DV_OBJ_QP   = 1 << 0,
               MLX4DV_OBJ_CQ   = 1 << 1,
               MLX4DV_OBJ_SRQ  = 1 << 2,
       };

RETURN VALUE         top

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

NOTES         top

        * Compatibility masks (comp_mask) are in/out fields.

SEE ALSO         top

       mlx4dv(7)

AUTHORS         top

       Maor Gottlieb <maorg@mellanox.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 2024-06-14.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2024-06-10.)  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

1.0.0                          2017-02-02             MLX4DV_INIT_OBJ(3)