mlx5dv_devx_create_eq - Man Page

Name

mlx5dv_devx_create_eq — Create an EQ object

mlx5dv_devx_destroy_eq — Destroy an EQ object

Synopsis

#include <infiniband/mlx5dv.h>

struct mlx5dv_devx_eq *
mlx5dv_devx_create_eq(struct ibv_context *ibctx, const void *in, size_t inlen,
              void *out, size_t outlen);

int mlx5dv_devx_destroy_eq(struct mlx5dv_devx_eq *eq);

Description

Create / Destroy an EQ object. Upon creation, the caller prepares the in/out mail boxes based on the device specification format; For the input mailbox, caller needs to prepare all fields except “eqc.log_page_size” and the pas list, which will be set by the driver. The “eqc.intr” field should be used from the output of mlx5dv_devx_alloc_msi_vector().

Arguments

ibctx

RDMA device context to create the action on.

in

A buffer which contains the command’s input data provided in a device specification format.

inlen

The size of in buffer in bytes.

out

A buffer which contains the command’s output data according to the device specification format.

outlen

The size of out buffer in bytes.

eq

The EQ object to work on.

struct mlx5dv_devx_eq {
    void *vaddr;
};
vaddr

EQ VA that was allocated in the driver for.

Notes

mlx5dv_devx_query_eqn() will not support vectors which are used by mlx5dv_devx_create_eq().

Return Value

Upon success mlx5dv_devx_create_eq will return a new struct mlx5dv_devx_eq; On error NULL will be returned and errno will be set.

Upon success mlx5dv_devx_destroy_eq will return 0, on error errno will be returned.

If the error value is EREMOTEIO, outbox.status and outbox.syndrome will contain the command failure details.

See Also

mlx5dv_devx_alloc_msi_vector(3), mlx5dv_devx_query_eqn(3)

Author

Mark Zhang <markzhang@nvidia.com>

Referenced By

The man page mlx5dv_devx_destroy_eq(3) is an alias of mlx5dv_devx_create_eq(3).

2022-01-12 mlx5 Programmer’s Manual