diff mbox

[rdma-core,1/2] verbs: Expose IBV_PORT_GRH_REQUIRED port capability

Message ID 1526225877-2050-2-git-send-email-yishaih@mellanox.com (mailing list archive)
State Not Applicable
Delegated to: Leon Romanovsky
Headers show

Commit Message

Yishai Hadas May 13, 2018, 3:37 p.m. UTC 
From: Alex Rosenbaum <alexr@mellanox.com>

RDMA applications require an indication they are operating in an
environment which is based on GID addressing, such as SR-IOV IB
Virtualization. In this mode, all sent traffic must include a GRH.

This patch exposes a new port capability flag: IBV_PORT_GRH_REQUIRED.
When this port capability flag is set, the applications must
create all AH with GRH configured. Meaning calling ibv_create_ah() and
ibv_modify_qp() with 'struct ibv_ah_attr { is_global = 1 }'

Signed-off-by: Alex Rosenbaum <alexr@mellanox.com>
Signed-off-by: Artemy Kovalyov <artemyko@mellanox.com>
Signed-off-by: Yishai Hadas <yishaih@mellanox.com>
---
 libibverbs/man/ibv_create_ah.3 | 4 ++++
 libibverbs/man/ibv_modify_qp.3 | 5 +++++
 libibverbs/verbs.h             | 3 ++-
 3 files changed, 11 insertions(+), 1 deletion(-)
diff mbox

Patch

diff --git a/libibverbs/man/ibv_create_ah.3 b/libibverbs/man/ibv_create_ah.3
index 0ca2198..b645ea3 100644
--- a/libibverbs/man/ibv_create_ah.3
+++ b/libibverbs/man/ibv_create_ah.3
@@ -53,6 +53,10 @@  destroys the AH
 .SH "RETURN VALUE"
 .B ibv_create_ah()
 returns a pointer to the created AH, or NULL if the request fails.
+.SH "NOTES"
+If port cap flag IBV_PORT_GRH_REQUIRED is set then
+.B ibv_create_ah()
+must be created with definition of 'struct ibv_ah_attr { .is_global = 1; .grh = {...}; }'.
 .PP
 .B ibv_destroy_ah()
 returns 0 on success, or the value of errno on failure (which indicates the failure reason).
diff --git a/libibverbs/man/ibv_modify_qp.3 b/libibverbs/man/ibv_modify_qp.3
index 487aa94..33b4a48 100644
--- a/libibverbs/man/ibv_modify_qp.3
+++ b/libibverbs/man/ibv_modify_qp.3
@@ -172,6 +172,11 @@  Init \fB          IBV_QP_STATE, IBV_QP_PORT\fR
 RTR  \fB          IBV_QP_STATE\fR
 RTS  \fB          IBV_QP_STATE\fR
 .fi
+.PP
+If port cap flag IBV_PORT_GRH_REQUIRED is set then
+ah_attr and alt_ah_attr
+must be passed with definition of 'struct ibv_ah_attr { .is_global = 1; .grh = {...}; }'.
+.PP
 .SH "SEE ALSO"
 .BR ibv_create_qp (3),
 .BR ibv_destroy_qp (3),
diff --git a/libibverbs/verbs.h b/libibverbs/verbs.h
index eb57824..ddeeace 100644
--- a/libibverbs/verbs.h
+++ b/libibverbs/verbs.h
@@ -356,7 +356,8 @@  enum ibv_port_cap_flags {
 	IBV_PORT_BOOT_MGMT_SUP			= 1 << 23,
 	IBV_PORT_LINK_LATENCY_SUP		= 1 << 24,
 	IBV_PORT_CLIENT_REG_SUP			= 1 << 25,
-	IBV_PORT_IP_BASED_GIDS			= 1 << 26
+	IBV_PORT_IP_BASED_GIDS			= 1 << 26,
+	IBV_PORT_GRH_REQUIRED			= 1 << 27,
 };
 
 struct ibv_port_attr {