sas_port_alloc_num(9)

📦 version 7.3.1, in nixpkgs unstable

💅 sas_port_alloc_num — from the Kernel API Manual, bestie

Okay so picture this: it's the Kernel API Manual, and we're talking about sas_port_alloc_num(9). It's the little function that sets up a SAS port for you, number and all. Let's get into it 🫶

✨ NAME ✨

sas_port_alloc_num — allocate and initialize a SAS port structure. That's the whole vibe. It builds the port, it gives it a number, it's a whole matchmaker situation 💖

🎀 SYNOPSIS 🎀

struct sas_port * sas_port_alloc_num (struct device *parent );

Like, that's literally it. One arg. We love a low-effort queen 👑

🌸 ARGUMENTS 🌸

  • parent — the parent device, aka the device that's gonna be this port's parent in the tree. The one who takes care of it. A real main character energy move 🌈

🦋 DESCRIPTION 🦋

So what it does: it allocates a SAS port structure and a number to go with it. Two for one, slay ✨

This interface is really meant for adapters where the port number genuinely has no meaning — like, the number is not the point, bestie — so in those cases the sas class should be the one managing them. Let the class handle it, it's got this 💅

Then it gets added to the device tree, right below the device you passed in as parent. And real talk: that parent must be either a Scsi_Host or a sas_expander_device. Those are the only two acceptable parentals. No exceptions, no cap 😭

🔥 RETURN 🔥

NULL on error. Yep, just NULL. If it doesn't work out, that's what you get back, so check for it before you start building your whole life on top of it bestie 💀

👑 SEE ALSO 👑

Kernel file ./drivers/scsi/scsi_transport_sas.c — that's the home base, iykyk. And the whole extended friend group:

That's the whole group chat, go say hi 🧚

Fr fr, one last thing: parent has to be a Scsi_Host or a sas_expander_device. Not a soft suggestion, it's the rule. Don't come crying to me 😤

Alright bestie, that's the page 🎀 it lives over in <cyan>./drivers/scsi</cyan>, dated October 2026, and it's sas_port_alloc_num(9) out of the Kernel API Manual. Mwah, go allocate something iconic 💜

📦 where this page comes from