verbs: Introduce ibv_query_port_speed() verb

Add a new API, ibv_query_port_speed(), which enables applications to
query the effective bandwidth of a port. This is useful for VF LAG and
multiport LAG configurations, since ibv_query_port does not report the
combined bandwidth of all aggregated ports. In any case, the API can be
used on non-aggregated devices as well.

Signed-off-by: Or Har-Toov <ohartoov@nvidia.com>
Reviewed-by: Patrisious Haddad <phaddad@nvidia.com>
Signed-off-by: Yishai Hadas <yishaih@nvidia.com>

Author: yishaih

debian/libibverbs1.symbols

@@ -13,6 +13,7 @@ libibverbs.so.1 libibverbs1 #MINVER#
  IBVERBS_1.13@IBVERBS_1.13 35
  IBVERBS_1.14@IBVERBS_1.14 36
  IBVERBS_1.15@IBVERBS_1.15 59
+ IBVERBS_1.16@IBVERBS_1.16 62
  (symver)IBVERBS_PRIVATE_59 59
  _ibv_query_gid_ex@IBVERBS_1.11 32
  _ibv_query_gid_table@IBVERBS_1.11 32
@@ -100,6 +101,7 @@ libibverbs.so.1 libibverbs1 #MINVER#
  ibv_query_pkey@IBVERBS_1.1 1.1.6
  ibv_query_port@IBVERBS_1.0 1.1.6
  ibv_query_port@IBVERBS_1.1 1.1.6
+ ibv_query_port_speed@IBVERBS_1.16 62
  ibv_query_qp@IBVERBS_1.0 1.1.6
  ibv_query_qp@IBVERBS_1.1 1.1.6
  ibv_query_qp_data_in_order@IBVERBS_1.14 36

libibverbs/CMakeLists.txt

@@ -21,7 +21,7 @@ configure_file("libibverbs.map.in"
 
 rdma_library(ibverbs "${CMAKE_CURRENT_BINARY_DIR}/libibverbs.map"
   # See Documentation/versioning.md
-  1 1.15.${PACKAGE_VERSION}
+  1 1.16.${PACKAGE_VERSION}
   all_providers.c
   cmd.c
   cmd_ah.c

libibverbs/driver.h

@@ -447,6 +447,8 @@ struct verbs_context_ops {
 	int (*query_ece)(struct ibv_qp *qp, struct ibv_ece *ece);
 	int (*query_port)(struct ibv_context *context, uint8_t port_num,
 			  struct ibv_port_attr *port_attr);
+	int (*query_port_speed)(struct ibv_context *context, uint32_t port_num,
+				uint64_t *speed);
 	int (*query_qp)(struct ibv_qp *qp, struct ibv_qp_attr *attr,
 			int attr_mask, struct ibv_qp_init_attr *init_attr);
 	int (*query_qp_data_in_order)(struct ibv_qp *qp, enum ibv_wr_opcode op,

libibverbs/dummy_ops.c

@@ -421,6 +421,12 @@ static int query_port(struct ibv_context *context, uint8_t port_num,
 	return EOPNOTSUPP;
 }
 
+static int query_port_speed(struct ibv_context *context, uint32_t port_num,
+			    uint64_t *speed)
+{
+	return EOPNOTSUPP;
+}
+
 static int query_qp(struct ibv_qp *qp, struct ibv_qp_attr *attr, int attr_mask,
 		    struct ibv_qp_init_attr *init_attr)
 {
@@ -585,6 +591,7 @@ const struct verbs_context_ops verbs_dummy_ops = {
 	query_device_ex,
 	query_ece,
 	query_port,
+	query_port_speed,
 	query_qp,
 	query_qp_data_in_order,
 	query_rt_values,
@@ -713,6 +720,7 @@ void verbs_set_ops(struct verbs_context *vctx,
 	SET_OP(vctx, query_device_ex);
 	SET_PRIV_OP_IC(vctx, query_ece);
 	SET_PRIV_OP_IC(ctx, query_port);
+	SET_PRIV_OP_IC(ctx, query_port_speed);
 	SET_PRIV_OP(ctx, query_qp);
 	SET_PRIV_OP_IC(ctx, query_qp_data_in_order);
 	SET_OP(vctx, query_rt_values);

libibverbs/libibverbs.map.in

@@ -171,6 +171,11 @@ IBVERBS_1.15 {
 		ibv_reg_mr_ex;
 } IBVERBS_1.14;
 
+IBVERBS_1.16 {
+	global:
+		ibv_query_port_speed;
+} IBVERBS_1.15;
+
 /* If any symbols in this stanza change ABI then the entire staza gets a new symbol
    version. See the top level CMakeLists.txt for this setting. */
 

libibverbs/man/CMakeLists.txt

@@ -64,6 +64,7 @@ rdma_man_pages(
   ibv_query_gid_table.3.md
   ibv_query_pkey.3.md
   ibv_query_port.3
+  ibv_query_port_speed.3.md
   ibv_query_qp.3
   ibv_query_qp_data_in_order.3.md
   ibv_query_rt_values_ex.3

libibverbs/man/ibv_query_port_speed.3.md

@@ -0,0 +1,55 @@
+---
+date: 2025-10-19
+footer: libibverbs
+header: "Libibverbs Programmer's Manual"
+layout: page
+license: 'Licensed under the OpenIB.org BSD license (FreeBSD Variant) - See COPYING.md'
+section: 3
+title: ibv_query_port_speed
+---
+
+# NAME
+
+ibv_query_port_speed - query an RDMA port's effective bandwidth in 100Mb/s granularity
+
+# SYNOPSIS
+
+```c
+#include <infiniband/verbs.h>
+
+int ibv_query_port_speed(struct ibv_context *context, uint32_t port_num, uint64_t *port_speed);
+
+```
+
+
+# DESCRIPTION
+
+**ibv_query_port_speed()** Queries the device of the context at the given port number
+for the effective bandwidth of the port in 100Mb/s granularity.
+
+# ARGUMENTS
+*context*
+:       The device context.
+
+*port_num*
+:       The device port number which needs to be queried.
+
+*port_speed*
+:   The effective bandwidth of port for device context in a granularity of 100 Mb/s
+
+# RETURN VALUE
+
+**ibv_query_port_speed()** Returns 0 on success, or the value of errno on failure (which indicates the failure reason)
+
+# NOTES
+
+port_speed pointer value is valid only when the function returns 0.
+
+# SEE ALSO
+
+**ibv_query_port**(3)
+
+# AUTHOR
+
+Patrisious Haddad <phaddad@nvidia.com>
+Or Har-Toov <ohartoov@nvidia.com>

libibverbs/verbs.c

@@ -1186,3 +1186,10 @@ int ibv_query_ece(struct ibv_qp *qp, struct ibv_ece *ece)
 {
 	return get_ops(qp->context)->query_ece(qp, ece);
 }
+
+int ibv_query_port_speed(struct ibv_context *context, uint32_t port_num,
+			 uint64_t *port_speed)
+{
+	return get_ops(context)->query_port_speed(context, port_num,
+						  port_speed);
+}

libibverbs/verbs.h

@@ -2455,6 +2455,12 @@ int ibv_query_device(struct ibv_context *context,
 int ibv_query_port(struct ibv_context *context, uint8_t port_num,
 		   struct _compat_ibv_port_attr *port_attr);
 
+/**
+ * ibv_query_port_speed - Get port effective speed in 100 Mb/s granularity.
+ */
+int ibv_query_port_speed(struct ibv_context *context, uint32_t port_num,
+			 uint64_t *port_speed);
+
 static inline int ___ibv_query_port(struct ibv_context *context,
 				    uint8_t port_num,
 				    struct ibv_port_attr *port_attr)