ti_sci_cmd_put_device(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… ti_sci_cmd_put_device(9) β€” the Kernel API Manual moment

okay so bestie, welcome to the glow-up era of the TISCI device lifecycle ✨ this one is a Kernel API Manual page (yes, the actual manual, we're fancy now), and it's all about giving a device back when you're done with it. no cap, it's short but it MATTERS. πŸŽ€


🌸 NAME 🌸

ti_sci_cmd_put_device β€” the command that releases a device managed by TISCI 🫢


✨ SYNOPSIS ✨

int ti_sci_cmd_put_device (const struct ti_sci_handle *handle , u32 id
);

like, that's the whole signature. short king. πŸ‘‘


πŸŽ€ ARGUMENTS πŸŽ€

  • handle β€” pointer to the TISCI handle, the one you got back from *ti_sci_get_handle πŸ’–
  • id β€” the Device Identifier. which device, bestie. you gotta say which one. πŸ”

πŸ¦‹ DESCRIPTION πŸ¦‹

so this is the request for the device β€” i.e. the release side of the whole thing. and here's the part where you gotta pay attention because it's literally in all caps in the original for a reason:

NOTE: the client MUST maintain integrity of usage count by balancing get_device with put_device. No refcounting is managed by driver for that purpose. πŸ’€

translation, bestie: you are the refcount. the driver is not keeping score for you. every get_device needs its matching put_device or the count drifts and it's giving chaos. balance your books. periodt. 🧾✨


πŸ”₯ RETURN πŸ”₯

0 if all went fine β€” iconic, we love a zero πŸŽ‰ β€” else it returns the appropriate error. so like, check it. don't just vibe past it. 😭


πŸ‘‘ SEE ALSO πŸ‘‘

the whole friend group, in order, no one left out 🫢:

Kernel file ./drivers/firmware/ti_sci.c


that's the whole page, bestie, you ate that πŸ’… this little gem lives in ./drivers/firmware, dated October 2026, and yeah β€” the page itself is ti_sci_cmd_put_device(9). now go balance your refcounts, ily, bye πŸ«ΆπŸ’–πŸŒΈ

πŸ“¦ where this page comes from