ti_sci_cmd_free_event_map(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ti_sci_cmd_free_event_map — like, the un-mapping one

Okay bestie, so this is a page out of the Kernel API Manual (that's the manual name, now you know ✨), and it's all about ti_sci_cmd_free_event_map — the function you call when you wanna free an event map between the requested source and Interrupt Aggregator. Yeah. We're cleaning up. We're releasing the mapping. We're letting it go, main character style 🦋

✨ SYNOPSIS ✨

int ti_sci_cmd_free_event_map(const struct ti_sci_handle *handle, u16 src_id,
                              u16 src_index, u16 ia_id, u16 vint,
                              u16 global_event, u8 vint_status_bit);

It returns an int, and it takes a whole little friend group of arguments — six of them plus the handle. Let's meet everybody 🫶

🎀 ARGUMENTS 🎀

  • handle — Pointer to the TISCI handle. Your golden ticket, your VIP pass, the thing that says "hi yes I'm allowed to talk to the firmware" 💅
  • src_id — Device ID of the IRQ source. Like, which device is this interrupt even coming from?
  • src_index — IRQ source index within the source device. Because one device can have a whole situationship with multiple interrupt lines, y'know?
  • ia_id — Device ID of the IA (if the IRQ flows through this IA). Conditional queen 👑 — it only matters when the interrupt actually routes through the Interrupt Aggregator.
  • vint — Virtual interrupt to be used within the IA. The virtual one. The vibe-translated version of the interrupt, if you will 🌈
  • global_event — Global event number to be used for the requesting event. Big number energy, globally scoped 🔥
  • vint_status_bit — Virtual interrupt status bit to be used for the event. It's a u8, it's a bit, it's doing its job, we love that for it ⭐

💖 RETURN 💖

  • 0 if all went fine 😌✨
  • else it returns the appropriate error — which is code for "something went sideways, check the error, don't @ me" 💀
no cap, if you get something other than 0, that event map did not free, and you should probably go look at what went wrong. fr fr.

🦋 SEE ALSO 🦋

The kernel file lives at ./drivers/firmware/ti_sci.c — that's the source of truth, go read it if you want the full lore 📖

And here's the entire extended universe of related pages, all (9) sections, all iconic, all listed in order because we do not skip entries in this house 💜

ngl, ti_sci_cmd_set_event_map(9) is literally the sibling of this page — that one sets it, this one frees it. iconic symmetry 💫

🌸 okay that's the whole page, mwah 💋 — this one came out of ./drivers/firmware, October 2026, and it's filed under ti_sci_cmd_free_event_map(9). go free those event maps, bestie, you got this 🫶✨

📦 where this page comes from