annotated_d...date_samples(9)

💅 annotated_d...date_samples(9) 💅

okay so real talk — this is a page from the Kernel API Manual, and it's about one (1) little function that keeps a histogram looking fresh. bestie, it's giving bookkeeping main character energy and honestly? we stan. ✨

---

🌸 NAME 🌸

annotated_data_type__update_samples — update the histogram, that's literally it, that's the whole job 🫶

---

⭐ SYNOPSIS ⭐

int annotated_data_type__update_samples (struct annotated_data_type *adt
, struct evsel *evsel , int offset , int nr_samples , u64 period );

like, yes, she's a int-returning icon and she takes five args. don't come for her formatting, she's been through a lot 😭

---

🎀 ARGUMENTS 🎀

• adt — the data type you're updating. the actual struct annotated_data_type in question 👑
• evsel — the event to update. she's the one getting the glow-up ✨
• offset — offset in the type. yes, in the type, keep up 💅
• nr_samples — how many samples are chilling at this offset 🔥
• period — the event count at this offset. numbers. we love numbers 📊

---

🦋 DESCRIPTION 🦋

so what she does is update the type histogram at ofs for evsel. periodt. 💖

and here's the part that lowkey matters: samples get aggregated before calling this function, which means it's totally fine to call her with more than one sample at a certain offset. she can handle it. she's built different. no cap 🧚

---

🌈 SEE ALSO 🌈

• update_var_state(9)
• update_insn_state(9)
• find_data_type(9)

also the kernel file ./tools/perf/util/annotate-data.c — that's where the magic lives, iykyk 🔍

---

and that's the page, bestie!! 🍓 this lil gem ships out of ./tools/perf/util and it's dated October 2026, so mark your calendars and go update some histograms 💜👑💀