ring_buffer_discard_commit(9)

📦 version 7.3.1, in nixpkgs unstable

💫 ring_buffer_discard_commit — the "nvm, forget that event" era 💫

okay so this is a page from the Kernel API Manual, bestie — section 9, kernel dev vibes only. sit down, hydrate, and let's get into it 🫶

✨ NAME ✨

ring_buffer_discard_commit — discard an event that has not been committed. literally the "undo button but make it kernel" situation 😭💅

🌸 SYNOPSIS 🌸

void ring_buffer_discard_commit (struct trace_buffer *buffer , struct ring_buffer_event *event );

that's the whole signature, no cap. returns nothing (void), takes two things, does the thing 💖

🎀 ARGUMENTS 🎀

  • buffer — the ring buffer. the venue, the stage, the whole main character location of this operation ✨
  • event — non committed event to discard. emphasis on non committed, bestie, this is not a drill 🔥

🦋 DESCRIPTION 🦋

Sometimes an event that is in the ring buffer needs to be ignored 👀 like, it's there, it exists, but we're choosing to pretend we don't see it (respectfully). This function lets the user discard an event in the ring buffer, and then that event will not be read later. gone. ghosted. blocked. periodt 💀

This function only works if it is called before the item has been committed. read that again. before. committed. no take-backs after 😤 It will try to free the event from the ring buffer if another event has not been added behind it.

If another event has been added behind it, it will set the event up as discarded, and perform the commit. so it's still handled, just flagged as "yeah no" 🙈✨

⚠️ okay this is the important one, don't skip it: if this function is called, do not call ring_buffer_unlock_commit on the event. like actually do not. that's the whole rule. ring_buffer_discard_commit already handled the commit business, so calling ring_buffer_unlock_commit on top of it is not the vibe 💀 not me warning you twice.

💜 SEE ALSO 💜

the whole friend group, fr fr — starting with the kernel file itself: ./kernel/trace/ring_buffer.c 🌈

okay that's the whole page, mwah 💋 one last cute sign-off: this little icon lives in ./kernel/trace, dated October 2026, and it's filed under ring_buffer_discard_commit(9). go forth and discard responsibly, bestie 🧚‍♀️⭐💖

📦 where this page comes from