i3c_bus_maintenance_lock(9)

💖 i3c_bus_maintenance_lock(9) 💖

okay bestie, welcome to the Kernel API Manual side of the group chat 🫶 this page is all about i3c_bus_maintenance_lock, and we're gonna keep it cute and factual, no cap.

✨ NAME ✨

i3c_bus_maintenance_lock — lock the bus for a maintenance operation. periodt 💅

🦋 SYNOPSIS 🦋

void i3c_bus_maintenance_lock (struct i3c_bus *bus );

🎀 ARGUMENTS 🎀

• bus — I3C bus to take the lock on. that's the assignment, bestie 🎀

🔥 DESCRIPTION 🔥

okay so this function takes the bus lock so that no other operations can occur on the bus. it's needed for all kind of bus maintenance operation, like:

• enabling/disabling slave events
• re-triggering DAA
• changing the dynamic address of a device
• relinquishing mastership
• (empty bullet — yes, the original list literally has one more bullet with nothing in it 🫥)

the reason for this kind of locking is that we don't want drivers and core logic to rely on I3C device information that could be changed behind their back. that's the whole vibe check 😭✨

🌈 SEE ALSO 🌈

Kernel file ./drivers/i3c/master.c is home base 🏠 and the whole crew is:

• i3c_bus_maintenance_unlock(9)
• i3c_bus_normaluse_lock(9)
• i3c_bus_normaluse_unlock(9)
• i3c_master_queue_hotjoin(9)
• i3c_master_send_ccc_cmd_locked(9)
• i3c_master_get_free_addr(9)
• i3c_master_setaasa_locked(9)
• i3c_master_entdaa_locked(9)
• i3c_master_enec_disec_locked(9)
• i3c_master_disec_locked(9)
• i3c_master_enec_locked(9)
• i3c_master_defslvs_locked(9)
• i3c_master_reattach_i3c_dev_locked(9)
• i3c_master_has_wakeup_enabled_devs(9)
• i3c_master_dma_map_single(9)
• i3c_master_dma_unmap_single(9)
• i3c_master_set_info(9)
• i3c_master_bus_init(9)
• __i3c_master_add_i3c_dev_locked(9)
• i3c_master_add_i3c_dev_locked(9)
• i3c_master_do_daa_ext(9)
• i3c_master_do_daa(9)
• i3c_master_queue_ibi(9)
• i3c_generic_ibi_free_pool(9)
• i3c_generic_ibi_alloc_pool(9)
• i3c_generic_ibi_get_free_slot(9)
• i3c_generic_ibi_recycle_slot(9)
• i3c_master_register(9)
• i3c_master_unregister(9)
• i3c_dev_disable_ibi_locked(9)
• i3c_dev_enable_ibi_locked(9)
• i3c_dev_request_ibi_locked(9)
• i3c_dev_free_ibi_locked(9)

that's the whole page, bestie. source/version: ./drivers/i3c; date: October 2026; title: i3c_bus_maintenance_lock(9) — catch u later, mwah 💋✨