mlx5dv_modify_qp_udp_sport(3)

📦
version 62.0 · 8 versions
, in alpine 3.24, centos-stream 10, centos-stream 9, ubuntu jammy

💖 mlx5dv_modify_qp_udp_sport(3) — the girlies' guide 💖

okay so bestie, this one lives in manual section 3, and the whole page is literally called mlx5dv_modify_qp_udp_sport. say it with me: mlx5-dv-modify-qp-udp-sport. iconic name, honestly. it's giving "i know exactly what i'm doing." 🎀

🌸 NAME 🌸

mlx5dv_modify_qp_udp_sport — changes up the UDP source port on a QP you already have. that's the whole vibe check. ✨

🦋 SYNOPSIS 🦋

#include <infiniband/mlx5dv.h>

int mlx5dv_modify_qp_udp_sport(struct ibv_qp *qp, uint16_t udp_sport)

like, one include, one function, two arguments. we love a low-maintenance queen. 💅

🔥 DESCRIPTION 🔥

so here's the tea ☕ — the UDP source port is what creates entropy for network routers (that's ECMP btw), for load balancers, and for 802.3ad link aggregation switching. and like… those things are literally not aware of RoCE IB headers, so they need this port to spread traffic around properly. no cap. 🌈

this API lets you modify the configured UDP source port of a given RC/UC QP, but ✨only✨ when that QP is in RTS state. that's the condition, bestie, don't come at it any other way. 🙈

💜 ARGUMENTS 💜

  • qp — the ibv_qp object you're issuing the action on. your main character, fr fr. 🫶
  • udp_sport — the UDP source port you wanna set for the QP. pick your number, bestie. 🔢

⭐ RETURN VALUE ⭐

returns 0 on success 🎉 — or the value of errno on failure, which is literally the universe telling you the failure reason. read it. learn from it. 💀

👑 AUTHOR 👑

Maor Gottlieb <maorg@nvidia.com> — thank you for this gift, we are obsessed. 💖

lowkey reminder: RC/UC QP, RTS state, uint16_t port. get those three right and you're golden. 🧚

and that's a wrap on mlx5dv_modify_qp_udp_sport(3) from the mlx5dv manual, section 3, brought to you with love — periodt. 🍓💅🌸

📦 where this page comes from