1UNW_FLUSH_CACHE(3)           Programming Library            UNW_FLUSH_CACHE(3)
2
3
4

NAME

6       unw_flush_cache -- flush cached info
7

SYNOPSIS

9       #include <libunwind.h>
10
11       void  unw_flush_cache(unw_addr_space_t  as,  unw_word_t  lo, unw_word_t
12       hi);
13

DESCRIPTION

15       The unw_flush_cache() routine flushes all cached info as it relates  to
16       address-range  lo to hi (non-inclusive) in the target address-space as.
17       In addition, all info cached for address-space as that is not tied to a
18       particular  code-range is also flushed. For example, the address of the
19       dynamic registration list is not tied to a code-range  and  its  cached
20       value  (if any) is flushed by a call to this routine. The address range
21       specified  by  lo  and   hi   should   be   understood   as   a   hint:
22       unw_flush_cache()  may flush more information than requested, but never
23       less. In other words, unw_flush_cache() may overflush, but  not  under‐
24       flush.
25
26       As  a  special case, if arguments lo and hi are both 0, all information
27       cached on behalf of address space as is flushed.
28

RETURN VALUE

30       The unw_flush_cache() routine cannot fail and does not return a value.
31

THREAD AND SIGNAL SAFETY

33       The unw_flush_cache() routine is thread-safe as well  as  safe  to  use
34       from a signal handler.
35

SEE ALSO

37       libunwind(3), unw_set_caching_policy(3)
38

AUTHOR

40       David Mosberger-Tang
41       Hewlett-Packard Labs
42       Palo-Alto, CA 94304
43       Email: davidm@hpl.hp.com
44       WWW: http://www.hpl.hp.com/research/linux/libunwind/.
45
46
47
48Programming Library             05 August 2004              UNW_FLUSH_CACHE(3)
Impressum