mlx5dv_destroy_mkey (3) Linux Manual Page

mlx5dv_create_mkey – Creates an indirect mkey

mlx5dv_create_mkey – Destroys an indirect mkey

Synopsis

#include <infiniband/mlx5dv.h>

struct mlx5dv_mkey_init_attr {

 struct ibv_pd *pd;

 uint32_t create_flags;

 uint16_t max_entries;

};

struct mlx5dv_mkey {

 uint32_t lkey;

 uint32_t rkey;

};

struct mlx5dv_mkey *

mlx5dv_create_mkey(struct mlx5dv_mkey_init_attr *mkey_init_attr);

int mlx5dv_destroy_mkey(struct mlx5dv_mkey *mkey);

Description

Create / destroy an indirect mkey.

Create an indirect mkey to enable application uses its specific device functionality.

Arguments

##mkey_init_attr##

pd

ibv protection domain.

create_flags

MLX5DV_MKEY_INIT_ATTR_FLAGS_INDIRECT: Indirect mkey is being created.

max_entries

Requested max number of pointed entries by this indirect mkey. The function will update the mkey_init_attr->max_entries with the actual mkey value that was created; it will be greater than or equal to the value requested.

Return Value

Upon success mlx5dv_create_mkey will return a new struct mlx5dv_mkey on error NULL will be returned and errno will be set.

Upon success destroy 0 is returned or the value of errno on a failure.

Notes

To let this functionality works a DEVX context should be opened by using mlx5dv_open_device.

See Also

mlx5dv_open_device

#AUTHOR

Yishai Hadas <yishaih [at] mellanox.com>