From patchwork Tue Nov 30 11:56:13 2010 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Or Gerlitz X-Patchwork-Id: 366731 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by demeter1.kernel.org (8.14.4/8.14.3) with ESMTP id oAUBuK8Y026415 for ; Tue, 30 Nov 2010 11:56:20 GMT Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751429Ab0K3L4T (ORCPT ); Tue, 30 Nov 2010 06:56:19 -0500 Received: from fwil.voltaire.com ([193.47.165.2]:53864 "EHLO exil.voltaire.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1750924Ab0K3L4S (ORCPT ); Tue, 30 Nov 2010 06:56:18 -0500 Received: from zuben.voltaire.com ([172.25.5.141]) by exil.voltaire.com with Microsoft SMTPSVC(6.0.3790.4675); Tue, 30 Nov 2010 13:56:13 +0200 Message-ID: <4CF4E65D.4070205@Voltaire.com> Date: Tue, 30 Nov 2010 13:56:13 +0200 From: Or Gerlitz User-Agent: Thunderbird 2.0.0.19 (X11/20081209) MIME-Version: 1.0 To: Roland Dreier CC: Steve Wise , "Robert D. Russell" , linux-rdma Subject: [PATCH] libibverbs/doc: clarify selective signaling (Re: using IBV_SEND_SIGNALED) References: <4CF3DDF0.2070907@opengridcomputing.com> <4CF3E5FA.6010308@opengridcomputing.com> In-Reply-To: <4CF3E5FA.6010308@opengridcomputing.com> X-OriginalArrivalTime: 30 Nov 2010 11:56:13.0298 (UTC) FILETIME=[9611A520:01CB9085] Sender: linux-rdma-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-rdma@vger.kernel.org X-Greylist: IP, sender and recipient auto-whitelisted, not delayed by milter-greylist-4.2.3 (demeter1.kernel.org [140.211.167.41]); Tue, 30 Nov 2010 11:56:20 +0000 (UTC) Index: libibverbs/man/ibv_post_send.3 =================================================================== --- libibverbs.orig/man/ibv_post_send.3 +++ libibverbs/man/ibv_post_send.3 @@ -112,6 +112,12 @@ request is fully executed and a work com from the corresponding completion queue (CQ). However, if the IBV_SEND_INLINE flag was set, the buffer can be reused immediately after the call returns. +.PP +Applications which use selective signaling should make sure to post +a signaled WR (i.e one for which the IBV_SEND_SIGNALED flag is set) from +time to time - depending on the requirements of the underlying rdma device. +Typically the number of consecutive unsignaled WRs should not exceed the +size of the send queue specified when the QP was created. .SH "SEE ALSO" .BR ibv_create_qp (3), .BR ibv_create_ah (3),