msc_buffer_contig_get_page(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… msc_buffer_contig_get_page(9)

okay so bestie, welcome to the Kernel API Manual β€” this one's msc_buffer_contig_get_page(9), a tiny little function that's giving "short but essential" energy. no cap, she's small, but she works. ✨


πŸŽ€ NAME πŸŽ€

msc_buffer_contig_get_page β€” literally just find a page at a given offset. that's it. that's the whole job. 🫢


🌸 SYNOPSIS 🌸

struct page * msc_buffer_contig_get_page (struct msc *msc , unsigned
long pgoff );

she returns a struct page *, takes an struct msc * and an unsigned long, and yes the line break up there in the middle of unsigned long is exactly how the original rolls. iconic formatting, no notes. πŸ’€


✨ ARGUMENTS ✨

  • msc β€” the MSC, and heads up, it's gotta be configured in SINGLE mode. like, that's the vibe check this function is doing. 🧚
  • pgoff β€” the page offset. the "where we lookin" of it all. 🎯

πŸ‘‘ RETURN πŸ‘‘

you get the page back if pgoff is within the range β€” and NULL otherwise. so like, if it's out of range? nothing. empty. void. NULL. don't come for her about it. πŸ’…


πŸ¦‹ SEE ALSO πŸ¦‹

okay this is the part where she tags all her mutuals, and it is a long list, so buckle up:

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_configure(9), msc_disable(9), msc_buffer_contig_alloc(9), msc_buffer_contig_free(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)

fr fr, that's the whole squad. 🌈


πŸ’– tiny reminder bestie: msc must be SINGLE mode, and out-of-range pgoff gets you NULL. that's the entire personality of this function.

and that's the page!! footer says ./drivers/hwtracing/intel_th, dated October 2026 β€” like, love that for her. mwah, bye bestie πŸ’œπŸŽ€β­

πŸ“¦ where this page comes from