msc_configure(9)

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

okay so this is a page from the Kernel API Manual, and honestly? it's a little one but it's important. it's giving "small function, big consequences" energy ngl.

---

✨ NAME ✨

msc_configure — set up MSC hardware 🫶

---

✨ SYNOPSIS ✨

int msc_configure (struct msc *msc );

---

✨ ARGUMENTS ✨

• msc — the MSC device we're configuring, she's the main character here 👑

---

✨ DESCRIPTION ✨

okay so what this does is it programs four things into a given MSC, all in one go:

• storage mode
• wrapping
• burst length
• trace buffer address

then it enables tracing and sets msc::enabled. slay. ✨

🚨 real talk though: setting msc::enabled is serialized on msc::buf_mutex, so make sure you hold it before you call this. no cap, this is not a drill. 💀

---

✨ RETURN ✨

0 for success, or a negative error code otherwise. literally that simple. 🙈

---

✨ SEE ALSO ✨

she's got a whole friend group, and you will be meeting all of them:

• Kernel file ./drivers/hwtracing/intel_th/msu.c
• 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_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_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)

---

💖 that's the whole page bestie, go configure some hardware and hold that mutex 💖

so yeah — this little gem lives under ./drivers/hwtracing/intel_th 🦋, it's dated October 2026 🌸, and it's page msc_configure(9) of the Kernel API Manual. periodt. 💅✨