i2c_put_dma_safe_msg_buf(9)

💅 i2c_put_dma_safe_msg_buf(9) 💅

okay so bestie, welcome to the Kernel API Manual — this one's about i2c_put_dma_safe_msg_buf, and it's literally the cleanup arc of the DMA safe message buffer saga 🎀

---

✨ NAME ✨

i2c_put_dma_safe_msg_buf — release the DMA safe buffer and sync it back up with the i2c_msg 🫶

---

🌸 SYNOPSIS 🌸

void i2c_put_dma_safe_msg_buf (u8 *buf , struct i2c_msg *msg , bool xferred );

no cap, that's the whole signature. returns void because it's a release function, she doesn't owe you a status code 💅

---

🦋 ARGUMENTS 🦋

• buf — the buffer you got from i2c_get_dma_safe_msg_buf. and yes, it may be NULL — that's allowed, she's flexible like that 🙈
• msg — the message that this buffer corresponds to. they're a matched set, iykyk 👑
• xferred — a bool telling you if the message was actually transferred. true = it went through, false = it did not. simple as that fr fr ⭐

---

💀 SEE ALSO 💀

this is the part where the friend group shows up. the whole squad, in the kernel file ./drivers/i2c/i2c-core-base.c:

• i2c_verify_client(9)
• i2c_adapter_lock_bus(9)
• i2c_adapter_trylock_bus(9)
• i2c_adapter_unlock_bus(9)
• i2c_new_client_device(9)
• i2c_unregister_device(9)
• i2c_find_device_by_fwnode(9)
• i2c_new_dummy_device(9)
• devm_i2c_new_dummy_device(9)
• i2c_new_ancillary_device(9)
• i2c_verify_adapter(9)
• i2c_handle_smbus_host_notify(9)
• i2c_add_adapter(9)
• i2c_add_numbered_adapter(9)
• i2c_del_adapter(9)
• devm_i2c_add_adapter(9)
• i2c_find_adapter_by_fwnode(9)
• i2c_get_adapter_by_fwnode(9)
• i2c_parse_fw_timings(9)
• i2c_del_driver(9)
• __i2c_transfer(9)
• i2c_transfer(9)
• i2c_transfer_buffer_flags(9)
• i2c_get_device_id(9)
• i2c_client_get_device_id(9)
• i2c_get_dma_safe_msg_buf(9)

like, every single one. no skipping, we don't do that here 💖 and obviously i2c_get_dma_safe_msg_buf(9) is the one that gave you the buffer in the first place — this is her put-it-back counterpart, the duo of all time 🧚

---

and that's the whole page, bestie!! go forth and release those buffers responsibly 🌈

source: ./drivers/i2c · date: October 2026 · this was the i2c_put_dma_safe_msg_buf(9) page from the Kernel API Manual — mwah, catch you on the next manpage 😭💜