regmap_update_bits_base(9)

💅 regmap_update_bits_base(9) — the glow-up your register deserves

okay bestie, so we're in the Kernel API Manual today and this page is about regmap_update_bits_base — the read/modify/write icon herself. no cap, she's a little more extra than plain regmap_update_bits because she's got options. 🎀

---

✨ NAME ✨

regmap_update_bits_base — do a whole read/modify/write cycle on a register, but make it fashion 💅

---

🌸 SYNOPSIS 🌸

int regmap_update_bits_base (struct regmap *map , unsigned int reg ,
       unsigned int mask , unsigned int val , bool *change , bool async , bool
       force );

---

🦋 ARGUMENTS 🦋

• map — the register map you're updating, bestie. the main character struct.
• reg — which register we're touching. literally the address of the drama.
• mask — the bitmask to change. only these bits get the glow-up. ✨
• val — the new value for that bitmask. this is what the bits are gonna be serving after.
• change — a boolean that tells you if a write actually happened. like, did we do something? 🫶
• async — boolean, are we doing this asynchronously?
• force — boolean, are we using the force update? (yes, force update. feel the force 🧚)

---

🔥 DESCRIPTION 🔥

So the whole vibe: perform a read/modify/write cycle on a register map — but with change, async, and force options in the mix. it's giving "I can do the basic thing but with flair". 👑

If async is true:

with most buses the read has to be done synchronously — yes, even though you asked for async, the read is still doing its little synchronous walk 😭 — so this option is most useful for devices with a cache, the ones that don't need to go talk to the actual hardware just to figure out what the current register value is. iykyk.

Returns zero for success, and a negative number on error. that's it, that's the vibe check. ⭐

---

💜 SEE ALSO 💜

Kernel file ./drivers/base/regmap/regmap.c, plus this absolutely iconic squad right here — not me listing all of them, but the manpage said so and I respect the assignment:

• devm_regmap_field_alloc(9)
• regmap_field_bulk_alloc(9)
• devm_regmap_field_bulk_alloc(9)
• regmap_field_bulk_free(9)
• devm_regmap_field_bulk_free(9)
• devm_regmap_field_free(9)
• regmap_field_alloc(9)
• regmap_field_free(9)
• regmap_reinit_cache(9)
• regmap_exit(9)
• dev_get_regmap(9)
• regmap_get_device(9)
• regmap_can_raw_write(9)
• regmap_get_raw_read_max(9)
• regmap_get_raw_write_max(9)
• regmap_write(9)
• regmap_write_async(9)
• regmap_raw_write(9)
• regmap_noinc_write(9)
• regmap_field_update_bits_base(9)
• regmap_field_test_bits(9)
• regmap_fields_update_bits_base(9)
• regmap_bulk_write(9)
• regmap_multi_reg_write(9)
• regmap_multi_reg_write_bypassed(9)
• regmap_raw_write_async(9)
• regmap_read(9)
• regmap_read_bypassed(9)
• regmap_raw_read(9)
• regmap_noinc_read(9)
• regmap_field_read(9)
• regmap_fields_read(9)
• regmap_bulk_read(9)
• regmap_multi_reg_read(9)
• regmap_test_bits(9)
• regmap_async_complete(9)
• regmap_register_patch(9)
• regmap_get_val_bytes(9)
• regmap_get_max_register(9)
• regmap_get_reg_stride(9)
• regmap_might_sleep(9)

---

and that's the page, bestie 🫶 this one lives in ./drivers/base/regmap, it's from the October 2026 era, and it's brought to you by the Kernel API Manual. go forth and modify those bits responsibly. 🍓💖