contrib/ofed/libibverbs/man/ibv_alloc_pd.3

   1 .\" -*- nroff -*-
   2 .\"
   3 .TH IBV_ALLOC_PD 3 2006-10-31 libibverbs "Libibverbs Programmer's Manual"
   4 .SH "NAME"
   5 ibv_alloc_pd, ibv_dealloc_pd \- allocate or deallocate a protection domain (PDs)
   6 .SH "SYNOPSIS"
   7 .nf
   8 .B #include <infiniband/verbs.h>
   9 .sp
  10 .BI "struct ibv_pd *ibv_alloc_pd(struct ibv_context " "*context" );
  11 .sp
  12 .BI "int ibv_dealloc_pd(struct ibv_pd " "*pd" );
  13 .fi
  14 .SH "DESCRIPTION"
  15 .B ibv_alloc_pd()
  16 allocates a PD for the RDMA device context
  17 .I context\fR.
  18 .PP
  19 .B ibv_dealloc_pd()
  20 deallocates the PD
  21 .I pd\fR.
  22 .SH "RETURN VALUE"
  23 .B ibv_alloc_pd()
  24 returns a pointer to the allocated PD, or NULL if the request fails.
  25 .PP
  26 .B ibv_dealloc_pd()
  27 returns 0 on success, or the value of errno on failure (which indicates the failure reason).
  28 .SH "NOTES"
  29 .B ibv_dealloc_pd()
  30 may fail if any other resource is still associated with the PD being
  31 freed.
  32 .SH "SEE ALSO"
  33 .BR ibv_reg_mr (3),
  34 .BR ibv_create_srq (3),
  35 .BR ibv_create_qp (3),
  36 .BR ibv_create_ah (3),
  37 .BR ibv_create_ah_from_wc (3)
  38 .SH "AUTHORS"
  39 .TP
  40 Dotan Barak <dotanb@mellanox.co.il>