rio_destid_alloc(9)

💅 rio_destid_alloc — a Kernel API Manual moment 🎀

okay so bestie, welcome to the Kernel API Manual page for rio_destid_alloc — yes it's a section 9 function, yes it's living deep in the RapidIO guts, and yes we're gonna make it make sense 💖

---

✨ NAME ✨

rio_destid_alloc — allocate the next available destID for a given network 🦋

---

✨ SYNOPSIS ✨

u16 rio_destid_alloc (struct rio_net *net );

like that's literally it, one argument, one u16 coming back at you 🌸

---

✨ ARGUMENTS ✨

• net — the RIO network, obviously 💅 this is the network you're grabbing a destID from

---

✨ DESCRIPTION ✨

so what it does: it returns the next available device destination ID for the RIO network you specified. iconic behavior, no notes ✨

and like, it doesn't just look at it — it marks the allocated ID as one in use, so nobody else can snatch it up. main character energy fr fr 👑

but if there's no new destID available? it returns RIO_INVALID_DESTID 💀 that's your "sorry bestie, nothing left" signal, no cap.

---

✨ SEE ALSO ✨

the whole friend group 🫶 — go say hi:

• kernel file ./drivers/rapidio/rio-scan.c (that's where the lore lives)
• rio_destid_reserve(9)
• rio_destid_free(9)
• rio_destid_first(9)
• rio_destid_next(9)
• rio_get_device_id(9)
• rio_set_device_id(9)
• rio_clear_locks(9)
• rio_enum_host(9)
• rio_device_has_destid(9)
• rio_release_dev(9)
• rio_is_switch(9)
• rio_setup_device(9)
• rio_sport_is_active(9)
• rio_get_host_deviceid_lock(9)
• rio_enum_peer(9)
• rio_enum_complete(9)
• rio_disc_peer(9)
• rio_mport_is_active(9)
• rio_update_route_tables(9)
• rio_init_em(9)
• rio_enum_mport(9)
• rio_build_route_tables(9)
• rio_disc_mport(9)
• rio_basic_attach(9)

---

and that's the whole page, bestie 🌈 this one came from ./drivers/rapidio, dated October 2026 — so like, fresh off the kernel press 🍓 mwah, go allocate something iconic 💜🧚