1ibv_import_mr ibv_unimporLti_bmirb(v3e)rbs Programmer’sibMva_niumaplort_mr ibv_unimport_mr(3)
2
3
4

NAME

6       ibv_import_mr - import an MR from a given ibv_pd
7
8       ibv_unimport_mr - unimport an MR
9

SYNOPSIS

11              #include <infiniband/verbs.h>
12
13              struct ibv_mr *ibv_import_mr(struct ibv_pd *pd, uint32_t mr_handle);
14              void ibv_unimport_mr(struct ibv_mr *mr)
15

DESCRIPTION

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

RETURN VALUE

37       ibv_import_mr() returns a pointer to the allocated MR, or NULL  if  the
38       request fails.
39

NOTES

41       The  addr field in the imported MR is not applicable, NULL value is ex‐
42       pected.
43

SEE ALSO

45       ibv_reg_mr(3),  ibv_reg_dm_mr(3),  ibv_reg_mr_iova(3),   ibv_reg_mr_io‐
46       va2(3), ibv_dereg_mr(3),
47

AUTHOR

49       Yishai Hadas <yishaih@mellanox.com>
50
51
52
53libibverbs                         2020-5-3   ibv_import_mr ibv_unimport_mr(3)