cache_key_append(9)

okay bestie, welcome to the cache_key_append(9) page from the Kernel API Manual — this one is literally about appending a cache key to the related kset, and it's giving very "small function, important job" energy 💅✨

💖 NAME 💖

cache_key_append — append a cache key to the related kset. no cap, that's the whole name vibe 🎀

✨ SYNOPSIS ✨

int cache_key_append (struct pcache_cache *cache , struct
       pcache_cache_key *key , bool force_close );

🎀 ARGUMENTS 🎀

• cache — pointer to the pcache_cache structure. yes, the cache itself 🫶
• key — pointer to the cache key structure to append. this is the little key getting added to the pile 🎀
• force_close — if true, you need to close the current kset. yes, that's the force-close switch 💀

🦋 DESCRIPTION 🦋

so this function appends a cache key to the appropriate kset. periodt. if the kset is full, it closes the kset — that's the move 😭. if it's not full, it queues a flush work to write the kset to media, and that's lowkey iconic ✨.

it returns 0 on success, or a negative error code on failure. that's the return vibe, bestie 💖

🌈 SEE ALSO 🌈

kernel file ./drivers/md/dm-pcache/cache_key.c — and the whole friend group is here:

• cache_key_get(9)
• cache_key_destroy(9)
• cache_subtree_walk(9)
• cache_subtree_search(9)
• fixup_overlap_tail(9)
• fixup_overlap_contain(9)
• fixup_overlap_contained(9)
• fixup_overlap_head(9)
• cache_key_insert(9)
• clean_fn(9)

xoxo bestie, this page is from ./drivers/md/dm-pcache, dated October 2026 — stay slay 💖✨