1ibv_import_pd, ibv_unimpoLritb_ipbdv(e3r)bs Programmer’isbvM_ainmupaolrt_pd, ibv_unimport_pd(3)
2
3
4

NAME

6       ibv_import_pd - import a PD from a given ibv_context
7
8       ibv_unimport_pd - unimport a PD
9

SYNOPSIS

11              #include <infiniband/verbs.h>
12
13              struct ibv_pd *ibv_import_pd(struct ibv_context *context, uint32_t pd_handle);
14              void ibv_unimport_pd(struct ibv_pd *pd)
15

DESCRIPTION

17       ibv_import_pd()  returns  a  protection  domain (PD) that is associated
18       with the given pd_handle in the given context.
19
20       The input pd_handle value must be a valid kernel handle for a PD object
21       in  the given context.  It can be achieved from the original PD by get‐
22       ting its ibv_pd->handle member value.
23
24       The returned ibv_pd can be used in all verbs that get a protection  do‐
25       main.
26
27       ibv_unimport_pd()  unimport  the  PD.  Once the PD usage has been ended
28       ibv_dealloc_pd() or ibv_unimport_pd() should be called.  The first  one
29       will  go  to  the  kernel to destroy the object once the second one way
30       cleanup what ever is needed/opposite of the import without calling  the
31       kernel.
32
33       This is the responsibility of the application to coordinate between all
34       ibv_context(s) that use this PD.  Once destroy is done no other process
35       can  touch  the  object  except for unimport.  All users of the context
36       must collaborate to ensure this.
37

RETURN VALUE

39       ibv_import_pd() returns a pointer to the allocated PD, or NULL  if  the
40       request fails.
41

SEE ALSO

43       ibv_alloc_pd(3), ibv_dealloc_pd(3),
44

AUTHOR

46       Yishai Hadas <yishaih@mellanox.com>
47
48
49
50libibverbs                         2020-5-3  ibv_import_pd, ibv_unimport_pd(3)