__synth_event_gen_cmd_start(9)

📦 version 7.3.1, in nixpkgs unstable

🌸 __synth_event_gen_cmd_start 🌸

okay so bestie, welcome to the Kernel API Manual — this little cutie is __synth_event_gen_cmd_start, and it's literally the "start a synthetic event command from an arg list" girlie. 💅

✨ NAME ✨

__synth_event_gen_cmd_start — start a synthetic event command from an arg list 🎀

🦋 SYNOPSIS 🦋

int __synth_event_gen_cmd_start (struct dynevent_cmd *cmd , const char *name , struct module *mod , ... );

💖 ARGUMENTS 💖

  • cmd — a pointer to the dynevent_cmd struct representing the new event. like, the whole vibe container for it 🫶
  • name — the name of the synthetic event. name her, bestie ✨
  • mod — the module creating the event, or NULL if it's not created from a module
  • ... — a variable number of args in pairs, one pair for each field 👑

🧚 NOTE 🧚

okay real talk — users normally won't want to call this function directly 🙈 instead use the synth_event_gen_cmd_start wrapper, which automatically adds a NULL to the end of the arg list for you. so convenient, honestly iconic. but if you do use this function directly, make sure the last arg in the variable arg list is NULL. no cap, that part matters. 💀

This generates a synthetic event command to be executed by synth_event_gen_cmd_end. and here's the serve: this function can be used to generate the complete command or only the first part of it. in that latter case, synth_event_add_field, synth_event_add_field_str, or synth_event_add_fields can be used to add more fields following this. expansion pack energy 🍓

There should be an even number of variable args, each pair consisting of a type followed by a field name. type + name, type + name, it's giving matching set 🌸

See synth_field_size for available types. and if field_name contains [n], the field is considered to be an array. noted! ✨

🔥 RETURN 🔥

0 if successful, error otherwise. that's it, that's the whole mood 💜

🌈 SEE ALSO 🌈

Kernel file ./kernel/trace/trace_events_synth.c — plus the whole friend group:

okay that's the whole page, bestie, go forth and synthesize ✨💅

sign-off szn: this one lives in ./kernel/trace, dated October 2026, and the version tag is literally __synth_event_gen_cmd_start(9) — that's the whole footer, mwah 💋🎀

📦 where this page comes from