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_qp.3
Real path: /usr/share/man/man3/ibv_create_qp.3
Zurück

'\" te .\" -*- nroff -*- .\" .TH IBV_CREATE_QP 3 2006-10-31 libibverbs "Libibverbs Programmer's Manual" .SH "NAME" ibv_create_qp, ibv_destroy_qp \- create or destroy a queue pair (QP) .SH "SYNOPSIS" .nf .B #include <infiniband/verbs.h> .sp .BI "struct ibv_qp *ibv_create_qp(struct ibv_pd " "*pd" , .BI " struct ibv_qp_init_attr " "*qp_init_attr" ); .sp .BI "int ibv_destroy_qp(struct ibv_qp " "*qp" ); .fi .SH "DESCRIPTION" .B ibv_create_qp() creates a queue pair (QP) associated with the protection domain .I pd\fR. The argument .I qp_init_attr is an ibv_qp_init_attr struct, as defined in <infiniband/verbs.h>. .PP .nf struct ibv_qp_init_attr { .in +8 void *qp_context; /* Associated context of the QP */ struct ibv_cq *send_cq; /* CQ to be associated with the Send Queue (SQ) */ struct ibv_cq *recv_cq; /* CQ to be associated with the Receive Queue (RQ) */ struct ibv_srq *srq; /* SRQ handle if QP is to be associated with an SRQ, otherwise NULL */ struct ibv_qp_cap cap; /* QP capabilities */ enum ibv_qp_type qp_type; /* QP Transport Service Type: IBV_QPT_RC, IBV_QPT_UC, IBV_QPT_UD or IBV_QPT_RAW_PACKET */ int sq_sig_all; /* If set, each Work Request (WR) submitted to the SQ generates a completion entry */ .in -8 }; .sp .nf struct ibv_qp_cap { .in +8 uint32_t max_send_wr; /* Requested max number of outstanding WRs in the SQ */ uint32_t max_recv_wr; /* Requested max number of outstanding WRs in the RQ */ uint32_t max_send_sge; /* Requested max number of scatter/gather (s/g) elements in a WR in the SQ */ uint32_t max_recv_sge; /* Requested max number of s/g elements in a WR in the SQ */ uint32_t max_inline_data;/* Requested max number of data (bytes) that can be posted inline to the SQ, otherwise 0 */ .in -8 }; .fi .PP The function .B ibv_create_qp() will update the .I qp_init_attr\fB\fR->cap struct with the actual \s-1QP\s0 values of the QP that was created; the values will be greater than or equal to the values requested. .PP .B ibv_destroy_qp() destroys the QP .I qp\fR. .SH "RETURN VALUE" .B ibv_create_qp() returns a pointer to the created QP, or NULL if the request fails. Check the QP number (\fBqp_num\fR) in the returned QP. .PP .B ibv_destroy_qp() 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_create_qp() will fail if a it is asked to create QP of a type other than .B IBV_QPT_RC or .B IBV_QPT_UD associated with an SRQ. .PP The attributes max_recv_wr and max_recv_sge are ignored by .B ibv_create_qp() if the QP is to be associated with an SRQ. .PP .B ibv_destroy_qp() fails if the QP is attached to a multicast group. .\" 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_modify_qp (3), .BR ibv_query_qp (3) .SH "AUTHORS" .TP Dotan Barak <dotanba@gmail.com>