trace_get_event_file(9)

✨ trace_get_event_file ✨

okay bestie, welcome to the trace_get_event_file(9) page 💖 this one lives in the Kernel API Manual and honestly? it's a little lookup gremlin with big main character energy. let's get into it 🎀

---

🌸 NAME 🌸

trace_get_event_file — find a trace event file and hand it to you, no cap 🔍

---

🦋 SYNOPSIS 🦋

struct trace_event_file * trace_get_event_file (const char *instance ,
       const char *system , const char *event );

---

💜 ARGUMENTS 💜

• instance — the name of the trace instance that's holding the event 🫶
• system — the name of the system that's holding the event 🌈
• event — the name of the event itself, the star of the show 👑

---

⭐ DESCRIPTION ⭐

so here's the vibe 💅 this function returns a trace event file when you give it the trace instance name, the trace system, and the trace event name. that's the trio, iykyk.

and listen — if the instance name is NULL, it refers to the top-level trace array. good to know fr fr 🧚

the way this works is it looks the thing up and returns it if found, but not before it calls trace_array_get to stop the instance from just.. going away 😭, and it also increments the event's module refcount so nobody can remove it out from under you. protective king behavior honestly 🛡️✨

to release the file, call trace_put_event_file, which will call trace_array_put and decrement the event's module refcount. don't skip this bestie, the refcounts are watching 👀

---

🔥 RETURN 🔥

the trace event on success 💖 — otherwise ERR_PTR 💀

---

🌟 SEE ALSO 🌟

kernel file ./kernel/trace/trace_events.c plus the whole friend group:

• trace_event_buffer_reserve(9)
• trace_set_clr_event(9)
• trace_array_set_clr_event(9)
• t_show_filters(9)
• t_show_triggers(9)
• ftrace_event_show_filters_open(9)
• ftrace_event_show_triggers_open(9)
• trace_put_event_file(9)
• event_trace_add_tracer(9)
• early_enable_events(9)

---

and that's the whole page, periodt ✨💅 this little icon came from ./kernel/trace and it's dated October 2026, filed under trace_get_event_file(9) 🎀💜 go forth and get those event files bestie 🦋🌸