| Current File : //usr/man/man3/ibv_query_srq.3 |
'\" te
.\" -*- nroff -*-
.\"
.TH IBV_QUERY_SRQ 3 2006-10-31 libibverbs "Libibverbs Programmer's Manual"
.SH "NAME"
ibv_query_srq \- get the attributes of a shared receive queue (SRQ)
.SH "SYNOPSIS"
.nf
.B #include <infiniband/verbs.h>
.sp
.BI "int ibv_query_srq(struct ibv_srq " "*srq" ", struct ibv_srq_attr " "*srq_attr" );
.fi
.SH "DESCRIPTION"
.B ibv_query_srq()
gets the attributes of the SRQ
.I srq
and returns them through the pointer
.I srq_attr\fR.
The argument
.I srq_attr
is an ibv_srq_attr struct, as defined in <infiniband/verbs.h>.
.PP
.nf
struct ibv_srq_attr {
.in +8
uint32_t max_wr; /* maximum number of outstanding work requests (WRs) in the SRQ */
uint32_t max_sge; /* maximum number of scatter elements per WR */
uint32_t srq_limit; /* the limit value of the SRQ */
.in -8
};
.fi
.SH "RETURN VALUE"
.B ibv_query_srq()
returns 0 on success, or the value of errno on failure (which indicates the failure reason).
.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE ATTRIBUTE VALUE
=
Availability network/open-fabrics
=
Stability Volatile
.TE
.PP
.SH "NOTES"
If the value returned for srq_limit is 0, then the SRQ limit reached
("low watermark") event is not (or no longer) armed, and no
asynchronous events will be generated until the event is rearmed.
.SH "SEE ALSO"
.BR ibv_create_srq (3),
.BR ibv_destroy_srq (3),
.BR ibv_modify_srq (3)
.SH "AUTHORS"
.TP
Dotan Barak <dotanb@mellanox.co.il>
.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland. The original community source was downloaded from ['http://download.oracle.com/otn-pub/oss/networking/libsif-1.0.tar.gz', 'http://www.openfabrics.org/downloads/ibutils/ibutils-1.5.7.tar.gz', 'http://www.openfabrics.org/downloads/libibverbs/libibverbs-1.1.4-1.22.g7257cd3.tar.gz', 'http://www.openfabrics.org/downloads/libmlx4/libmlx4-1.0.1-1.18.gb810a27.tar.gz', 'http://www.openfabrics.org/downloads/libsdp/libsdp-1.1.108-0.15.gd7fdb72.tar.gz', 'http://www.openfabrics.org/downloads/management/infiniband-diags-1.5.8.tar.gz', 'http://www.openfabrics.org/downloads/management/libibmad-1.3.7.tar.gz', 'http://www.openfabrics.org/downloads/management/libibumad-1.3.7.tar.gz', 'http://www.openfabrics.org/downloads/management/opensm-3.3.9.tar.gz', 'http://www.openfabrics.org/downloads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz', 'http://www.openfabrics.org/downloads/qperf/qperf-0.4.6-0.1.gb81434e.tar.gz', 'http://www.openfabrics.org/downloads/rdmacm/librdmacm-1.0.14.1.tar.gz', 'http://www.openfabrics.org/downloads/rds-tools/rds-tools-2.0.4.tar.gz']
Further information about this software can be found on the open source community website at http://www.openfabrics.org/.