From: Chuck Lever <chuck.lever@oracle.com>
Date: Tue, 4 Sep 2018 15:45:20 +0000 (-0400)
Subject: RDMA/core: Document QP @event_handler function
X-Git-Tag: v4.20-rc1~110^2~193
X-Git-Url: https://git.kernel.dk/?a=commitdiff_plain;h=eb93c82ed8c77f00955f2891483170194c3be92c;p=linux-block.git

RDMA/core: Document QP @event_handler function

Add helpful warning for RDMA consumer implementers.

Signed-off-by: Chuck Lever <chuck.lever@oracle.com>
Signed-off-by: Jason Gunthorpe <jgg@mellanox.com>
---

diff --git a/include/rdma/ib_verbs.h b/include/rdma/ib_verbs.h
index 995f176d4782..f687faadf33b 100644
--- a/include/rdma/ib_verbs.h
+++ b/include/rdma/ib_verbs.h
@@ -1138,7 +1138,9 @@ enum ib_qp_create_flags {
  */
 
 struct ib_qp_init_attr {
+	/* Consumer's event_handler callback must not block */
 	void                  (*event_handler)(struct ib_event *, void *);
+
 	void		       *qp_context;
 	struct ib_cq	       *send_cq;
 	struct ib_cq	       *recv_cq;