Hallo, dies ist ein Test.
PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html
Running in File Mode
Relative path: ./../../../../../../usr/man/man3/ibv_create_xsrq.3
Real path: /usr/share/man/man3/ibv_create_xsrq.3
Zurück
'\" te .\" -*- nroff -*- .\" .TH IBV_CREATE_XSRQ 3 2011-06-17 libibverbs "Libibverbs Programmer's Manual" .SH "NAME" ibv_create_xsrq, ibv_destroy_srq \- create or destroy a shared receive queue (SRQ) .SH "SYNOPSIS" .nf .B #include .sp .BI "struct ibv_srq *ibv_create_xsrq(struct ibv_pd " "*pd" ", struct " .BI " ibv_srq_init_attr " "*srq_init_attr" ); .sp .BI "int ibv_destroy_srq(struct ibv_srq " "*srq" ); .fi .SH "DESCRIPTION" .B ibv_create_xsrq() creates a shared receive queue (SRQ) associated with the protection domain .I pd\fR. The argument .I srq_init_attr is an ibv_srq_init_attr struct, as defined in . .PP .nf struct ibv_srq_init_attr { .in +8 void *srq_context; /* Associated context of the SRQ */ struct ibv_srq_attr attr; /* SRQ attributes */ enum ibv_srq_type srq_type; /* Specifies type of SRQ to create */ union { .in +8 struct { .in +8 struct ibv_xrcd *xrcd; /* XRC domain associated with an XRC SRQ */ struct ibv_cq *cq; /* completion queue for an XRC SRQ*/ .in -8 } xrc; /* Extended attributes for IBV_SRQT_XRC type SRQs */ .in -8 } ext; .in -8 }; .sp .nf struct ibv_srq_attr { .in +8 uint32_t max_wr; /* Requested max number of outstanding work requests (WRs) in the SRQ */ uint32_t max_sge; /* Requested max number of scatter elements per WR */ uint32_t srq_limit; /* The limit value of the SRQ (ignored for ibv_create_srq) */ .in -8 }; .fi .PP The function .B ibv_create_xsrq() will update the .I srq_init_attr struct with the original values of the SRQ that was created; the values of max_wr and max_sge will be greater than or equal to the values requested. .PP .B ibv_destroy_srq() destroys the SRQ .I srq\fR. .SH "RETURN VALUE" .B ibv_create_xsrq() returns a pointer to the created SRQ, or NULL if the request fails. .PP .B ibv_destroy_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 (7) for descriptions of the following attributes: .sp .TS box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE VALUE = Availability network/open-fabrics = Stability Pass-through volatile .TE .PP .SH "NOTES" .B ibv_destroy_srq() fails if any queue pair is still associated with this SRQ. .\" Oracle has added source availability information to this manual page Source code for open source software components in Oracle Solaris can be found at https://www.oracle.com/downloads/opensource/solaris-source-code-downloads.html. This software was built from source available at https://github.com/oracle/solaris-userland. The original community source was downloaded from ['https://www.openfabrics.org/downloads/ibutils/ibutils-1.5.7-0.2.gbd7e502.tar.gz', 'https://www.openfabrics.org/downloads/libibverbs/libibverbs-1.1.8.tar.gz', 'https://www.openfabrics.org/downloads/libmlx4/libmlx4-1.0.6.tar.gz', 'https://www.openfabrics.org/downloads/libsdp/libsdp-1.1.108-0.15.gd7fdb72.tar.gz', 'https://www.openfabrics.org/downloads/management/infiniband-diags-1.6.5.tar.gz', 'https://www.openfabrics.org/downloads/management/libibmad-1.3.12.tar.gz', 'https://www.openfabrics.org/downloads/management/libibumad-1.3.10.2.tar.gz', 'https://www.openfabrics.org/downloads/management/opensm-3.3.19.tar.gz', 'https://www.openfabrics.org/downloads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz', 'https://www.openfabrics.org/downloads/qperf/qperf-0.4.9.tar.gz', 'https://www.openfabrics.org/downloads/rdmacm/librdmacm-1.0.21.tar.gz', 'https://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/. .SH "SEE ALSO" .BR ibv_alloc_pd (3), .BR ibv_create_cq (3), .BR ibv_open_xrcd (3), .BR ibv_modify_srq (3), .BR ibv_query_srq (3) .SH "AUTHORS" .TP Sean Hefty