cp_get_orb(9)

📦 version 7.3.1, in nixpkgs unstable

💅 cp_get_orb(9) — Kernel API Manual, bestie edition 🎀

okay so real talk, this one is short and sweet and honestly kind of iconic for it. it's from the Kernel API Manual, it's called cp_get_orb(9), and it does exactly one (1) thing. main character energy, no filler. 💖

✨ NAME ✨

cp_get_orb — get the orb of the channel program 🦋

like, literally, that's the whole job. get the orb. get it. 👑

🌸 SYNOPSIS 🌸

union orb * cp_get_orb (struct channel_program *cp , struct subchannel *sch );

yup, that's the signature, and yes you pass it two whole things. both of them matter. 💀

🧚 ARGUMENTS 🧚

  • cp — the channel_program we're doing the operation on. this is the one holding the orb, so like, be nice to it 🫶
  • sch — the subchannel the operation gets performed against. yeah, it gets a subchannel too. both. always both ✨
ngl, both args are required and neither is optional, so don't come for me in the replies asking if you can skip one. you can't. 🙈

🔥 DESCRIPTION 🔥

so here's the tea: this function returns the address of the updated orb of the channel program. that's it. that's the vibe check and it PASSED. ⭐

and why do we care?? because channel I/O device drivers could use this orb to issue a ssch. that's the whole point bestie, that's the assignment and it ATE. 💅

lowkey important: it gives you back the address of the updated orb, not some musty stale copy. updated. keep that word in your notes. 📝

🎀 SEE ALSO 🎀

iykyk, here's the whole friend group 💜 — these all live over in the kernel file ./drivers/s390/cio/vfio_ccw_cp.c:

fr fr, go read cp_init(9) and cp_free(9) first, they're the responsible ones. 🧚

kisses, this page was served fresh from ./drivers/s390/cio, dated October 2026, and it'll always answer to cp_get_orb(9). slay, stay hydrated, and remember to free your channel programs 💖✨🌈

📦 where this page comes from