table of contents
- buster 22.1-1
- buster-backports 24.0-2~bpo10+1
- testing 33.1+git20210317-1
- unstable 33.2-1
IBV_ALLOC_PARENT_DOMAIN(3) | Libibverbs Programmer's Manual | IBV_ALLOC_PARENT_DOMAIN(3) |
NAME¶
ibv_alloc_parent_domain(), ibv_dealloc_pd() - allocate and deallocate the parent domain objectSYNOPSIS¶
#include <infiniband/verbs.h> struct ibv_pd *ibv_alloc_parent_domain(struct ibv_context *context", struct ibv_parent_domain_init_attr *attr);
DESCRIPTION¶
ibv_alloc_parent_domain() allocates a parent domain object for the RDMA device context context.The parent domain object extends the normal protection domain with additional objects, such as a thread domain.
A parent domain is completely interchangeable with the struct ibv_pd used to create it, and can be used as an input argument to any function accepting a struct ibv_pd.
The behavior of each verb may be different if the verb is passed a parent domain struct ibv_pd that contains a struct ibv_td pointer. For instance the verb my choose to share resources between objects using the same thread domain. The exact behavior is provider dependent.
The attr argument specifies the following:
struct ibv_parent_domain_init_attr {
struct ibv_pd *pd; /* referance to a protection domain, can't be NULL */ struct ibv_td *td; /* referance to a thread domain, or NULL */ uint32_t comp_mask;
};
ibv_dealloc_pd() will deallocate the parent domain as its exposed as an ibv_pd pd. All resources created with the parent domain should be destroyed prior to deallocating the parent domain.
RETURN VALUE¶
ibv_alloc_parent_domain() returns a pointer to the allocated struct ibv_pd object, or NULL if the request fails (and sets errno to indicate the failure reason).SEE ALSO¶
ibv_alloc_parent_domain(3), ibv_dealloc_pd(3), ibv_alloc_pd(3), ibv_alloc_td(3)AUTHORS¶
- Alex Rosenbaum <alexr@mellanox.com>
- Yishai Hadas <yishaih@mellanox.com>
2017-11-06 | libibverbs |