msc_buffer_free_unless_used(9)

✨ msc_buffer_free_unless_used(9) — like, the Kernel API Manual moment 💅

okay bestie, welcome to the glow-up of msc_buffer_free_unless_used(9), straight out of the Kernel API Manual. she's short, she's locked, she's lowkey iconic 🎀

---

🌸 NAME 🌸

msc_buffer_free_unless_used — frees a buffer unless it's currently in use, no cap 💀

---

🦋 SYNOPSIS 🦋

int msc_buffer_free_unless_used (struct msc *msc );

---

💖 ARGUMENTS 💖

• msc — the MSC device. that's the whole vibe check, she's just one param 🫶

---

✨ DESCRIPTION ✨

so here's the tea ☕ — this one is the locked version of msc_buffer_unlocked_free_unless_used. that's literally it, that's the whole description. she locks, she frees, she leaves 💅

---

🔥 RETURN 🔥

• 0 — on successful deallocation, or if there was no buffer to deallocate in the first place (no buffer, no problem 🧚)
• -EBUSY — when there are active users. somebody's still using it, so hands off 🙈

---

👑 SEE ALSO 👑

the whole friend group, in the order the page gives them — kernel file ./drivers/hwtracing/intel_th/msu.c, then:

• struct msc_window(9)
• struct msc_iter(9)
• struct msc(9)
• struct msu_buffer_entry(9)
• msc_is_last_win(9)
• msc_next_window(9)
• msc_find_window(9)
• msc_oldest_window(9)
• msc_win_oldest_sg(9)
• msc_buffer_iterate(9)
• msc_buffer_clear_hw_header(9)
• msc_configure(9)
• msc_disable(9)
• msc_buffer_contig_alloc(9)
• msc_buffer_contig_free(9)
• msc_buffer_contig_get_page(9)
• msc_buffer_win_alloc(9)
• msc_buffer_win_free(9)
• msc_buffer_relink(9)
• msc_buffer_free(9)
• msc_buffer_alloc(9)
• msc_buffer_unlocked_free_unless_used(9)
• msc_buffer_get_page(9)
• struct msc_win_to_user_struct(9)
• msc_win_to_user(9)
• intel_th_msc_window_unlock(9)

---

ngl bestie, memorise the -EBUSY case — it's giving "someone else is in the group chat, don't free the buffer" 😭

---

mwah 💜 that's a wrap! this lil page lives at ./drivers/hwtracing/intel_th, dated October 2026, and it's titled msc_buffer_free_unless_used(9) — periodt. 🍓