zpci_bus_get_next(9)

💅 zpci_bus_get_next(9) 💅

okay bestie, welcome to the Kernel API Manual — yes that's the manual name, we're fancy here — and today's main character is zpci_bus_get_next, which is literally the glow-up function that walks you to the next zbus object from wherever you're currently at in the list. 🦋

---

✨ NAME ✨

zpci_bus_get_next — get the next zbus object from given position in the list. that's it, that's the vibe. 🎀

---

🌸 SYNOPSIS 🌸

void zpci_bus_get_next (struct zpci_bus **pos );

---

🎯 ARGUMENTS 🎯

• pos — your current position/cursor in the global zbus list. think of it as your little finger on the page, except the page is a global list and your finger is a pointer-to-pointer. iykyk. 💅

---

🔥 DESCRIPTION 🔥

so here's the tea: it acquires and releases references as the cursor iterates — and yes, it might also free/release the cursor itself, so don't get attached. 😭 it is tolerant of concurrent operations on the list, which is honestly such a slay, very unbothered, very secure. ✨

to begin the iteration, set *pos to NULL before calling the function. that's the starting pose. the opening number. the first step of the choreo. 🧚

and *pos is set to NULL in cases where either the list is empty, or *pos is the last element in the list. so when you hit NULL, that's not a bug, that's the end credits rolling. 👑

---

💜 CONTEXT 💜

Process context. May sleep. 😴 so pls don't call it from somewhere where sleeping is a whole crime, okay? it's a napper. let it nap. 🙈

---

🌈 SEE ALSO 🌈

• Kernel file ./arch/s390/pci/pci_bus.c
• zpci_bus_release(9)

---

ngl, the whole thing lives under ./arch/s390/pci and the page is stamped October 2026 — so like, shoutout to the s390 PCI girlies, this one's for you. periodt. 💖🎀🫶