1ibv_import_dm ibv_unimporLti_bdimb(v3e)rbs Programmer’sibMva_niumaplort_dm ibv_unimport_dm(3)
2
3
4

NAME

6       ibv_import_dm - import an DM from a given ibv_context
7
8       ibv_unimport_dm - unimport an DM
9

SYNOPSIS

11              #include <infiniband/verbs.h>
12
13              struct ibv_dm *ibv_import_dm(struct ibv_context *context, uint32_t dm_handle);
14              void ibv_unimport_dm(struct ibv_dm *dm)
15

DESCRIPTION

17       ibv_import_dm()  returns  a  Device memory (DM) that is associated with
18       the given dm_handle in the RDMA context.
19
20       The input dm_handle value must be a valid kernel handle for an  DM  ob‐
21       ject  in  the  assosicated  RDMA  context.  It can be achieved from the
22       original DM by getting its ibv_dm->handle member value.
23
24       ibv_unimport_dm() un import the DM.  Once the DM usage has  been  ended
25       ibv_free_dm()  or  ibv_unimport_dm()  should  be called.  The first one
26       will go to the kernel to destroy the object once  the  second  one  way
27       cleanup  what ever is needed/opposite of the import without calling the
28       kernel.
29
30       This is the responsibility of the application to coordinate between all
31       ibv_context(s) that use this DM.  Once destroy is done no other process
32       can touch the object except for unimport.  All  users  of  the  context
33       must collaborate to ensure this.
34

RETURN VALUE

36       ibv_import_dm()  returns  a pointer to the allocated DM, or NULL if the
37       request fails and errno is set.
38

NOTES

SEE ALSO

41       ibv_alloc_dm(3), ibv_free_dm(3),
42

AUTHOR

44       Maor Gottlieb <maorg@nvidia.com>
45
46
47
48libibverbs                         2021-1-17  ibv_import_dm ibv_unimport_dm(3)
Impressum