STRUCT PERF_DATA_FILE(9)

💖 struct perf_data_file(9) 💖

okay bestie, we’re in the Kernel API Manual and this one is lowkey iconic: struct perf_data_file is literally a wrapper around a file that’s used for perf.data reading or writing, and it’s generally part of struct perf_data. no cap, it’s the file-handling sidekick 💅

✨ NAME ✨

struct perf_data_file — a wrapper around a file used for perf.data reading or writing. Generally part of struct perf_data. 🫶

🌸 SYNOPSIS 🌸

       struct perf_data_file {
           char *path;
           union {
             int fd;
             FILE *fptr;
           };
           unsigned long    size;
           bool use_stdio;
        };

🎀 Members 🎀

• path — path of the file, fr fr. It’s generally a copy of perf_data.path, but if it’s a directory, it’s the file within that directory. 🗂️
• {unnamed_union} — anonymous. yep, that’s the whole vibe. 🫥
• fd — the file descriptor for reads/writes. valid if use_stdio is false. 🔥
• fptr — the stdio FILE. valid if use_stdio is true, and currently it’s just pipes in perf inject. 🧚
• size — size of the file when it was opened. 📏
• use_stdio — use buffered stdio operations. 💾

🌈 SEE ALSO 🌈

• Kernel file ./tools/perf/util/data.h
• struct perf_data(9)

mwah 💋 signing off from the ./tools/perf/util source/version, dated October 2026 — this was literally struct perf_data_file(9), and yes bestie, she ate 👑✨