devm_acpm_get_by_phandle(9)

🎀 devm_acpm_get_by_phandle(9) 🎀

okay so bestie, welcome to the Kernel API Manual 💖 this one's a little lookup function from the Samsung ACPM firmware corner of the kernel, and honestly? it's giving "resource managed, so you literally can't mess it up" energy ✨

---

✨ NAME ✨

devm_acpm_get_by_phandle — resource managed lookup of the standardized "samsung,acpm-ipc" handle 🫶

like, you give it a device, it goes and finds the handle for you, and the devm part means the cleanup is handled so you don't have to think about it 💅 periodt

---

🌸 SYNOPSIS 🌸

struct acpm_handle * devm_acpm_get_by_phandle (struct device *dev );

no cap, that's the whole signature 🦋

---

💜 ARGUMENTS 💜

• dev — the consumer device 🙈 that's it, that's the whole argument list, she's lowkey simple and we love her for it

---

⭐ RETURN ⭐

okay so what comes back:

• a pointer to the handle on success 🎉 slay
• ERR_PTR(-errno) otherwise 😭 so like, always check it with IS_ERR() before you go dereferencing things, iykyk

fr fr, "otherwise" means failure — treat that return value with respect or your kernel is gonna have a bad time 💀

---

🌈 SEE ALSO 🌈

bestie this list is long, but every single one of these is iconic in her own right, so here we go:

the kernel file itself lives at ./drivers/firmware/samsung/exynos-acpm.c 🍓 and these are all part of the fam:

• struct acpm_shmem(9)
• struct acpm_chan_shmem(9)
• struct acpm_queue(9)
• struct acpm_rx_data(9)
• struct acpm_chan(9)
• struct acpm_info(9)
• struct acpm_match_data(9)
• acpm_get_saved_rx(9)
• acpm_get_rx(9)
• acpm_dequeue_by_polling(9)
• acpm_wait_for_queue_slots(9)
• acpm_prepare_xfer(9)
• acpm_wait_for_message_response(9)
• acpm_do_xfer(9)
• acpm_set_xfer(9)
• acpm_chan_shmem_get_params(9)
• acpm_achan_alloc_cmds(9)
• acpm_free_mbox_chans(9)
• acpm_channels_init(9)
• acpm_handle_put(9)
• devm_acpm_release(9)
• acpm_get_by_node(9)
• devm_acpm_get_by_node(9)

like, the whole acpm cinematic universe 🔥 go read them all, you're welcome 🧚

---

and that's the whole page bestie!! 💖 brought to you by ./drivers/firmware/samsung, dated October 2026 — mwah, go forth and look up handles responsibly 👑✨