| '\" t |
| .\" Manual page created with latex2man on Thu Aug 16 09:44:44 MDT 2007 |
| .\" NOTE: This file is generated, DO NOT EDIT. |
| .de Vb |
| .ft CW |
| .nf |
| .. |
| .de Ve |
| .ft R |
| |
| .fi |
| .. |
| .TH "UNW\\_FLUSH\\_CACHE" "3" "16 August 2007" "Programming Library " "Programming Library " |
| .SH NAME |
| unw_flush_cache |
| \-\- flush cached info |
| .PP |
| .SH SYNOPSIS |
| |
| .PP |
| #include <libunwind.h> |
| .br |
| .PP |
| void |
| unw_flush_cache(unw_addr_space_t |
| as, |
| unw_word_t |
| lo, |
| unw_word_t |
| hi); |
| .br |
| .PP |
| .SH DESCRIPTION |
| |
| .PP |
| 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 \fInever\fP |
| less. In other words, unw_flush_cache() |
| may |
| overflush, but not underflush. |
| .PP |
| As a special case, if arguments lo |
| and hi |
| are both 0, all |
| information cached on behalf of address space as |
| is flushed. |
| .PP |
| .SH RETURN VALUE |
| |
| .PP |
| The unw_flush_cache() |
| routine cannot fail and does not |
| return a value. |
| .PP |
| .SH THREAD AND SIGNAL SAFETY |
| |
| .PP |
| The unw_flush_cache() |
| routine is thread\-safe as well as safe to |
| use from a signal handler. |
| .PP |
| .SH SEE ALSO |
| |
| .PP |
| libunwind(3), |
| unw_set_caching_policy(3) |
| .PP |
| .SH AUTHOR |
| |
| .PP |
| David Mosberger\-Tang |
| .br |
| Email: \fBdmosberger@gmail.com\fP |
| .br |
| WWW: \fBhttp://www.nongnu.org/libunwind/\fP\&. |
| .\" NOTE: This file is generated, DO NOT EDIT. |