1mlx5dv_devx_alloc_uar / mlx5dv_dmelvxx5_dfvr_edee_vuxa_ra(l3l)oc_uar / mlx5dv_devx_free_uar(3)
2
3
4

NAME

6       mlx5dv_devx_alloc_uar - Allocates a DEVX UAR
7
8       mlx5dv_devx_free_uar - Frees a DEVX UAR
9

SYNOPSIS

11              #include <infiniband/mlx5dv.h>
12
13              struct mlx5dv_devx_uar *mlx5dv_devx_alloc_uar(struct ibv_context *context,
14                                                            uint32_t flags);
15
16              void mlx5dv_devx_free_uar(struct mlx5dv_devx_uar *devx_uar);
17

DESCRIPTION

19       Create / free a DEVX UAR which is needed for other device commands over
20       the DEVX interface.
21
22       The DEVX API enables direct access from the user space area to the mlx5
23       device  driver, the UAR information is needed for few commands as of QP
24       creation.
25

ARGUMENTS

27       context
28              RDMA device context to work on.
29
30       flags  Allocation flags for the UAR.   MLX5DV_UAR_ALLOC_TYPE_BF:  Allo‐
31              cate  UAR  with Blueflame properties.  MLX5DV_UAR_ALLOC_TYPE_NC:
32              Allocate  UAR   with   non-cache   properties.    MLX5DV_UAR_AL‐
33              LOC_TYPE_NC_DEDICATED:  Allocate  a dedicated UAR with non-cache
34              properties.
35
36   devx_uar
37              struct mlx5dv_devx_uar {
38                  void *reg_addr;
39                  void *base_addr;
40                  uint32_t page_id;
41                  off_t mmap_off;
42                  uint64_t comp_mask;
43              };
44
45       reg_addr
46              The write address of DB/BF.
47
48       base_addr
49              The base address of the UAR.
50
51       page_id
52              The device page id to be used.
53
54       mmap_off
55              The mmap offset parameter to be used for re-mapping, to be  used
56              by a secondary process.
57

RETURN VALUE

59       Upon  success mlx5dv_devx_alloc_uar will return a new struct mlx5dv_de‐
60       vx_uar, on error NULL will be returned and errno will be set.
61

SEE ALSO

63       mlx5dv_open_device, mlx5dv_devx_obj_create
64
65       #AUTHOR
66
67       Yishai Hadas <yishaih@mellanox.com>
68
69
70
71                               mlx5dv_devx_alloc_uar / mlx5dv_devx_free_uar(3)
Impressum