contrib/ofed/libibverbs/man/ibv_resize_cq.3

   1 .\" -*- nroff -*-
   2 .\"
   3 .TH IBV_RESIZE_CQ 3 2006-10-31 libibverbs "Libibverbs Programmer's Manual"
   4 .SH "NAME"
   5 ibv_resize_cq \- resize a completion queue (CQ)
   6 .SH "SYNOPSIS"
   7 .nf
   8 .B #include <infiniband/verbs.h>
   9 .sp
  10 .BI "int ibv_resize_cq(struct ibv_cq " "*cq" ", int " "cqe" ");
  11 .fi
  12 .SH "DESCRIPTION"
  13 .B ibv_resize_cq()
  14 resizes the completion queue (CQ)
  15 .I cq
  16 to have at least
  17 .I cqe
  18 entries.
  19 .I cqe
  20 must be at least the number of unpolled entries in the CQ
  21 .I cq\fR.
  22 If
  23 .I cqe
  24 is a valid value less than the current CQ size,
  25 .B ibv_resize_cq()
  26 may not do anything, since this function is only guaranteed to resize
  27 the CQ to a size at least as big as the requested size.
  28 .SH "RETURN VALUE"
  29 .B ibv_resize_cq()
  30 returns 0 on success, or the value of errno on failure (which indicates the failure reason).
  31 .SH "NOTES"
  32 .B ibv_resize_cq()
  33 may assign a CQ size greater than or equal to the requested size.
  34 The cqe member of
  35 .I cq
  36 will be updated to the actual size.
  37 .SH "SEE ALSO"
  38 .BR ibv_create_cq (3)
  39 .BR ibv_destroy_cq (3)
  40 .SH "AUTHORS"
  41 .TP
  42 Dotan Barak <dotanb@mellanox.co.il>