regcache_sync(9)

💖 NAME 💖

regcache_sync — sync the register cache with the hardware. This is the regcache_sync(9) page from the Kernel API Manual, and bestie, we are getting into it. 🫶

✨ SYNOPSIS ✨

int regcache_sync (struct regmap *map );

🎀 ARGUMENTS 🎀

• map — map to configure. 💅

🌸 DESCRIPTION 🌸

Okay so first thing: any registers that should not be synced should be marked as volatile. That's the move. ✨

In general, drivers can choose not to use the provided syncing functionality if they so require. No pressure — literally optional vibes.

This pushes cached changes made while cache_only (e.g. suspend) down to hardware. Think of it as sending the group-chat drafts to the actual hardware. 💌

The caller must disable cache_only before calling this function. 🚨 Like, do that first, bestie — it's giving prerequisites.

Return a negative value on failure, 0 on success. That's the whole mood. 😭

🦋 SEE ALSO 🦋

• Kernel file ./drivers/base/regmap/regcache.c
• regcache_read(9)
• regcache_write(9)
• regcache_sync_region(9)
• regcache_drop_region(9)
• regcache_cache_only(9)
• regcache_mark_dirty(9)
• regcache_cache_bypass(9)
• regcache_reg_cached(9)

Sign-off time: source/version ./drivers/base/regmap, date October 2026, page regcache_sync(9) — periodt. 💜🧚