int ibv_dealloc_pd(struct ibv_pd *pd);

Description

ibv_dealloc_pd() deallocates a Protection Domain.

The destruction of a PD will fail if any other resource is still associated with that PD. In that case the PD, or those resource's state won't be changed.
The following resources can be associated with that PD:

• AH
• SRQ
• QP
• MR
• MW

As soon as all of those resources will be destroyed that PD can be destroyed.

Parameters

Return Values

Examples

Allocate a PD and then deallocate it:

struct ibv_context *context;
struct ibv_pd *pd;
 
pd = ibv_alloc_pd(context);
if (!pd) {
	fprintf(stderr, "Error, ibv_alloc_pd() failed\n");
	return -1;
}
 
if (ibv_dealloc_pd(pd)) {
	fprintf(stderr, "Error, ibv_dealloc_pd() failed\n");
	return -1;
}

FAQs

Can I destroy the PD and all of the RDMA resources which are associated with it with one verb call?

No, libibverbs doesn't support it. If a user wishes to deallocate a PD, he needs to destroy all of the RDMA resources which are associated with it before calling ibv_dealloc_pd().

ibv_dealloc_pd() failed, can I know which RDMA resources are allocated and causes this failure?

No, currently the RDMA stack doesn't have this capability.

Written by: Dotan Barak on August 31, 2012.on February 17, 2015.