relay_switch_subbuf(9)

📦 version 7.3.1, in nixpkgs unstable

💅 relay_switch_subbuf — like, the kernel API manual, but make it make sense

okay so bestie, welcome to relay_switch_subbuf(9) — yes it's a section 9 kernel API page, yes it's from the Kernel API Manual, and yes we're gonna get through it together 🫶

✨ NAME ✨

relay_switch_subbuf — switch to a new sub-buffer. that's literally the whole thing, no cap 🎀

🌸 SYNOPSIS 🌸

size_t relay_switch_subbuf (struct rchan_buf *buf , size_t length );

like, that's the signature, character for character, don't @ me 💖

🦋 ARGUMENTS 🦋

  • buf — channel buffer. the buffer for the channel. she's the main character of this function ngl 👑
  • length — size of current event. as in, how big the event you're currently dealing with is 🌸

⭐ DESCRIPTION ⭐

So what does she do? She returns either the length you passed in, or 0 if full. that's it, that's the return contract, iykyk 💀

And the way she does it?? She performs sub-buffer-switch tasks — the little chores of switching over to a fresh sub-buffer — such as invoking callbacks, updating padding counts, waking up readers, etc. like she's doing the group project all by herself and honestly? slay 🧚✨

fr fr remember: 0 means full. 0 is not a length, bestie, it's the "we're cooked" signal 🙈

💜 SEE ALSO 💜

Kernel file ./kernel/relay.c — go read it, it's giving source of truth 📖

like, that's the whole relay friend group, and they all ate 🔥

sign-off time 🌈

this little icon came from ./kernel, dated October 2026, and she's filed under relay_switch_subbuf(9). mwah, go switch some sub-buffers bestie 💅💖

📦 where this page comes from