unw_flush_cache.tex 1.8 KB

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