1\documentclass{article}
2\usepackage[fancyhdr,pdf]{latex2man}
3
4\input{common.tex}
5
6\begin{document}
7
8\begin{Name}{3}{unw\_flush\_cache}{David Mosberger-Tang}{Programming Library}{unw\_flush\_cache}unw\_flush\_cache -- flush cached info
9\end{Name}
10
11\section{Synopsis}
12
13\File{\#include $<$libunwind.h$>$}\\
14
15\Type{void} \Func{unw\_flush\_cache}(\Type{unw\_addr\_space\_t} \Var{as}, \Type{unw\_word\_t} \Var{lo}, \Type{unw\_word\_t} \Var{hi});\\
16
17\section{Description}
18
19The \Func{unw\_flush\_cache}() routine flushes all cached info as it
20relates to address-range \Var{lo} to \Var{hi} (non-inclusive) in the
21target address-space \Var{as}.  In addition, all info cached for
22address-space \Var{as} that is not tied to a particular code-range is
23also flushed.  For example, the address of the dynamic registration
24list is not tied to a code-range and its cached value (if any) is
25flushed by a call to this routine.  The address range specified by
26\Var{lo} and \Var{hi} should be understood as a hint:
27\Func{unw\_flush\_cache}() may flush more information than requested,
28but \emph{never} less.  In other words, \Func{unw\_flush\_cache}() may
29overflush, but not underflush.
30
31As a special case, if arguments \Var{lo} and \Var{hi} are both 0, all
32information cached on behalf of address space \Var{as} is flushed.
33
34\section{Return Value}
35
36The \Func{unw\_flush\_cache}() routine cannot fail and does not
37return a value.
38
39\section{Thread and Signal Safety}
40
41The \Func{unw\_flush\_cache}() routine is thread-safe as well as safe to
42use from a signal handler.
43
44\section{See Also}
45
46\SeeAlso{libunwind(3)},
47\SeeAlso{unw\_set\_caching\_policy(3)}
48
49\section{Author}
50
51\noindent
52David Mosberger-Tang\\
53Email: \Email{dmosberger@gmail.com}\\
54WWW: \URL{http://www.nongnu.org/libunwind/}.
55\LatexManEnd
56
57\end{document}
58