UNW_FLUSH_CACHE(3libunwind)

📦
version 1.8.3 · 2 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, epel 10, epel 9, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0

💖 UNW_FLUSH_CACHE 💖

okay bestie, welcome to unw_flush_cache(3libunwind) — this one lives in the Programming Library section, so you already know it's giving serious toolchain energy. let's get into it 🫶

✨ NAME ✨

unw_flush_cache — flush cached info

🌸 SYNOPSIS 🌸

#include <libunwind.h>

void unw_flush_cache(unw_addr_space_t as, unw_word_t lo, unw_word_t hi);

🦋 DESCRIPTION 🦋

so the unw_flush_cache() routine flushes all cached info as it relates to the address range lo to hi (non-inclusive, so like, hi is NOT invited to the party) in the target address space as. 💅

and that's not even all of it — in addition, every bit of info cached for address space as that is not tied to a particular code range also gets flushed. like, for example? the address of the dynamic registration list is not tied to a code range, and its cached value (if there is one) gets flushed by a call to this routine. periodt. 👑

the address range you specify with lo and hi should be understood as a hint: unw_flush_cache() may flush more information than requested, but never less. in other words, unw_flush_cache() may overflush, but it will not underflush. no cap. 🧚

special case alert!! if arguments lo and hi are both 0, then all information cached on behalf of address space as is flushed. that's the whole thing, gone, iconic behaviour honestly 🌈

⭐ RETURN VALUE ⭐

the unw_flush_cache() routine cannot fail and does not return a value. she simply does not miss. 💀✨

🔥 THREAD AND SIGNAL SAFETY 🔥

the unw_flush_cache() routine is thread safe as well as safe to use from a signal handler. main character energy in both contexts, we love to see it 💜

👑 SEE ALSO 👑

🎀 AUTHOR 🎀

David Mosberger-Tang

and that's the whole page bestie!! this gem is from the Programming Library manual, dated 29 August 2023 — so when you're out here calling unw_flush_cache, just know you're standing on the shoulders of legends. slay responsibly 💖🌸🦋💅

📦 where this page comes from