---
name: "unw_flush_cache"
section: "3"
platform: "linux"
package: "libunwind"
version: "1.8.3-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/unw_flush_cache"
---

# unw\_flush\_cache(3)

## 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

The unw\_flush\_cache() routine flushes all cached info as it  relates to address range lo to hi (non-inclusive) in the  target address space as. In addition, all info cached for  address space as that is not tied to a particular code range is  also flushed. For example, the address of the dynamic registration  list is not tied to a code range and its cached value (if any) is  flushed by a call to this routine. The address range specified by  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 not underflush.

As a special case, if arguments lo and hi are both 0, all  information cached on behalf of address space as is flushed.

## RETURN VALUE

The unw\_flush\_cache() routine cannot fail and does not  return a value.

## THREAD AND SIGNAL SAFETY

The unw\_flush\_cache() routine is thread safe as well as safe to  use from a signal handler.

## SEE ALSO

libunwind(3libunwind), unw\_set\_caching\_policy(3libunwind) unw\_set\_cache\_size(3libunwind)

## AUTHOR

David Mosberger-Tang\
 Email: **dmosberger@gmail.com**\
 WWW: **http://www.nongnu.org/libunwind/**.