dvb_ringbuffer_pkt_next(9)

📦 version 7.3.1, in nixpkgs unstable

💖 dvb_ringbuffer_pkt_next(9) — the kernel API manual, bestie edition 💖

okay so like, this is the manual page for dvb_ringbuffer_pkt_next(9), and honestly? it's giving "tiny function, big main character energy." let's get into it 🫶

✨ NAME ✨

dvb_ringbuffer_pkt_next — literally just "get the index of the next packet in a ringbuffer." that's it, that's the whole vibe. no cap. 💅

🦋 SYNOPSIS 🦋

ssize_t dvb_ringbuffer_pkt_next (struct dvb_ringbuffer *rbuf , size_t
idx , size_t *pktlen );

like, that's the whole signature. yes the line break is weird, no we're not fixing it, it's iconic in its own way. periodt. 🎀

🌸 ARGUMENTS 🌸

  • rbuf — the ringbuffer we're concerned about. this is the one we're snooping through, bestie. 👀
  • idx — the previous packet index. but here's the slay: if you pass -1, it returns the first packet index instead. so -1 is basically your "start me from the top" button. 🎬
  • pktlen — on success, this gets updated to contain the length of the packet in bytes. she's the output param, she's doing her job, we love to see it. 💖
and oh — right there in the original arguments it says: returns Packet index (if >=0), or -1 if no packets available. so like, that's the return behavior, sneaking in under the pktlen bullet. iykyk. 🌈

✨ THE VIBE (a.k.a. what you get back) ✨

so like:

  • if it works, you get a packet index (if >=0) — she's valid, she's real, she ate 🔥
  • if there are no packets available, you get -1 — the classic "there's nothing here" 😭

fr fr, that's the whole return contract. no extra lore.

heads up bestie: -1 is doing double duty here — as an input to idx it means "give me the first packet," and as a return value it means "no packets available." she contains multitudes. 💀

👑 SEE ALSO 👑

the kernel file lives at ./include/media/dvb_ringbuffer.h and here's the whole friend group, no one gets left out:

like, that's the whole squad. go read them too, they're all lowkey obsessed with the same ringbuffer. 🧚💜

aaaand that's the page!! this lil icon came to you from ./include/media, dated October 2026, and it ships as part of the Kernel API Manual. mwah, go forth and iterate your packets bestie 💋⭐💖

📦 where this page comes from