MLX5IB(4)

💅 MLX5IB — the kernel interfaces manual page, but make it make sense 💅

okay so bestie, pull up a chair 🫶 this is mlx5ib(4), a page from the Kernel Interfaces Manual, and it's all about the Mellanox ConnectX-4 and ConnectX-4 LX based 100Gb, 50Gb, 40Gb, 25Gb and 10Gb network adapter driver. yes that's a lot of Gb. we're gonna get through it together 💖

---

✨ NAME ✨

mlx5ib — the driver for Mellanox ConnectX-4 and ConnectX-4 LX based 100Gb, 50Gb, 40Gb, 25Gb and 10Gb network adapters. that's the whole vibe. one driver, so many speeds, she contains multitudes 💫

---

🌸 SYNOPSIS 🌸

so there's two ways to get this driver living in your system, and they're honestly both giving.

Way one: bake it into the kernel. drop these lines into your kernel configuration file:

options COMPAT_LINUXKPI
device mlx5
device mlx5ib

Way two: load it as a module at run-time. run this as root:

kldload mlx5ib

Way three (yes there's a third, don't @ me): module at boot time. put this line in loader.conf(5):

mlx5ib_load="YES"

---

🦋 DESCRIPTION 🦋

the mlx5ib driver provides support for infiniband and Remote DMA over Converged Ethernet, aka RoCE, for PCI Express network adapters based on ConnectX-4 and ConnectX-4 LX. no cap, that's the whole job description.

if you want the further hardware information, or you've got questions related to hardware requirements, go peek at http://www.mellanox.com/ — they've got you.

and for more information on configuring this device, the move is ifconfig(8). iconic, we love her.

---

👑 HARDWARE 👑

the mlx5ib driver supports 100Gb, 50Gb, 40Gb, 25Gb and 10Gb network adapters. let's break down who does what:

• ConnectX-4 supports: 10/20/25/40/50/56/100Gb/s speeds. she's fast fr fr 🔥
• ConnectX-4 LX supports: 10/25/40/50Gb/s speeds (and reduced power consumption — lowkey the environmentally-conscious queen 💚)

and here's the full list of supported adapters, every single one, no skipping:

• Mellanox MCX455A-ECAT
• Mellanox MCX456A-ECAT
• Mellanox MCX415A-CCAT
• Mellanox MCX416A-CCAT
• Mellanox MCX455A-FCAT
• Mellanox MCX456A-FCAT
• Mellanox MCX415A-BCAT
• Mellanox MCX416A-BCAT
• Mellanox MCX4131A-GCAT
• Mellanox MCX4131A-BCAT
• Mellanox MCX4121A-ACAT
• Mellanox MCX4111A-ACAT
• Mellanox MCX4121A-XCAT
• Mellanox MCX4111A-XCAT

fourteen cards. fourteen. the way she supports all of them 💅

---

🎀 SUPPORT 🎀

for general information and support, bestie, go straight to the Mellanox support website at: http://www.mellanox.com/

and if an issue is identified with this driver with a supported adapter, email all the specific information related to the issue to ⟨freebsd-drivers@mellanox.com⟩. like, all of it. the details are the point 🙈

---

🌈 SEE ALSO 🌈

• mlx5en(4)
• ifconfig(8)

---

⭐ HISTORY ⭐

the mlx5ib device driver first appeared in FreeBSD 12.x. a whole era 💜

---

🧚 AUTHORS 🧚

the mlx5ib driver was written by Mellanox Technologies <freebsd-drivers@mellanox.com>. thank you for your service 🫡✨

---

and that's the page, bestie!! this lil beauty came from Debian, dated August 23, 2017, and it lives at MLX5IB(4) in the manual. go forth and configure responsibly 💖🎀🦋