mlx5_fpga_sbu_conn_create(9)

💅 mlx5_fpga_sbu_conn_create(9) — Kernel API Manual, bestie 💖

okay so this is a section 9 kernel API page, and it's literally about spinning up a brand-new FPGA SBU connection ✨ it's giving "let me introduce you to your new connection" energy, and honestly? iconic.

---

🌸 NAME 🌸

mlx5_fpga_sbu_conn_create — the function that initializes a new FPGA SBU connection 🎀

---

✨ SYNOPSIS ✨

struct mlx5_fpga_conn * mlx5_fpga_sbu_conn_create (struct
       mlx5_fpga_device *fdev , struct mlx5_fpga_conn_attr *attr );

like, that's the whole signature, no cap 💅

---

🫶 ARGUMENTS 🫶

• fdev — the FPGA device itself, bestie. the actual hardware vibe. you're passing the whole device in 🦋
• attr — the attributes of the new connection. yes, plural attributes, and yes, they matter 🔥

---

💜 DESCRIPTION 💜

So what it does: it sets up a new FPGA SBU connection using the attributes you specified. that's the whole assignment, and it ate 👑

Now here's the part that makes me go "not me forgetting this": the receive callback function may be called for incoming messages even before this function returns 😭😭 like it can start talking to you before the handshake is even finished. the receive callback is main character energy fr fr and you are not in control of the timing.

⚠️ and the big one, bestie: the caller must eventually destroy the connection by calling mlx5_fpga_sbu_conn_destroy. must. not "should", not "if you feel like it". you made it, you clean it up. periodt. 🧹✨

---

🌈 RETURN 🌈

Returns a new connection 💖 ... OR an ERR_PTR error value otherwise 💀 so like, vibe check your return value before you dereference it, iykyk.

---

🦋 SEE ALSO 🦋

go look at the kernel file ./drivers/net/ethernet/mellanox/mlx5/core/fpga/sdk.h — that's where the lore lives 📖

and also these icons, all of them, in this order:

• Innova SDK(9)
• enum mlx5_fpga_access_type(9)
• struct mlx5_fpga_dma_entry(9)
• struct mlx5_fpga_dma_buf(9)
• struct mlx5_fpga_conn_attr(9)
• mlx5_fpga_sbu_conn_destroy(9)
• mlx5_fpga_sbu_conn_sendmsg(9)
• mlx5_fpga_mem_read(9)
• mlx5_fpga_mem_write(9)
• mlx5_fpga_get_sbu_caps(9)

---

alright that's the page 🎀 source path is ./drivers/net/ethernet/mellano... and the date on this one is October 2026, so like, future-era documentation bestie 🌸 mwah, go create some connections (and please, for the love of everything, destroy them after) 💖💅✨