find_var_ref(9)

💖 find_var_ref(9) 💖

okay bestie, welcome to the Kernel API Manual page for find_var_ref(9) — this one is lowkey iconic because it's all about checking whether a trigger has a reference to a trigger variable. 🦋 no cap, we're getting into var_refs[] business.

🌸 NAME 🌸

find_var_ref — Check if a trigger has a reference to a trigger variable. 💅

✨ SYNOPSIS ✨

struct hist_field * find_var_ref (struct hist_trigger_data *hist_data ,
struct hist_trigger_data *var_data , unsigned int var_idx );

🎀 ARGUMENTS 🎀

• hist_data — The hist trigger that might have a reference to the variable.
• var_data — The hist trigger that owns the variable.
• var_idx — The trigger variable identifier.

🔥 DESCRIPTION 🔥

okay so what this does is check the list of var_refs[] on the first hist trigger to see whether any of them are references to the variable on the second trigger. That's the whole vibe check, bestie — first trigger's ref list, second trigger's variable, are they linked? 👀

👑 RETURN 👑

The VAR_REF field referencing the variable if so, NULL if not. That's it — either you get the reference or you get NULL, no in-between. 💖

🌈 SEE ALSO 🌈

• Kernel file ./kernel/trace/trace_events_hist.c
• check_field_for_var_ref(9)
• find_any_var_ref(9)
• check_var_refs(9)
• create_var_ref(9)
• create_field_var_hist(9)
• create_target_field_var(9)

mwah 💋 — source/version: ./kernel/trace; date: October 2026; page: find_var_ref(9). byeee bestie 🫶✨