• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1\documentclass{article}
2\usepackage[fancyhdr,pdf]{latex2man}
3
4\input{common.tex}
5
6\begin{document}
7
8\begin{Name}{3}{unw\_set\_cache\_size}{Dave Watson}{Programming Library}{unw\_set\_cache\_size}unw\_set\_cache\_size -- set unwind cache size
9\end{Name}
10
11\section{Synopsis}
12
13\File{\#include $<$libunwind.h$>$}\\
14
15\Type{int} \Func{unw\_set\_cache\_size}(\Type{unw\_addr\_space\_t} \Var{as}, \Type{size\_t} \Var{size}, \Type{int} \Var{flag});\\
16
17\section{Description}
18
19The \Func{unw\_set\_cache\_size}() routine sets the cache size of
20address space \Var{as} to hold at least as many items as given by
21argument \Var{size}.  It may hold more items as determined by the
22implementation.  To disable caching, call
23\Func{unw\_set\_caching\_policy}) with a policy of
24\Const{UNW\_CACHE\_NONE}.  Flag is currently unused and must be 0.
25
26\section{Return Value}
27
28On successful completion, \Func{unw\_set\_cache\_size}() returns 0.
29Otherwise the negative value of one of the error-codes below is
30returned.
31
32\section{Thread and Signal Safety}
33
34\Func{unw\_set\_cache\_size}() is thread-safe but \emph{not} safe
35to use from a signal handler.
36
37\section{Errors}
38
39\begin{Description}
40\item[\Const{UNW\_ENOMEM}] The desired cache size could not be
41  established because the application is out of memory.
42\end{Description}
43
44\section{See Also}
45
46\SeeAlso{libunwind(3)},
47\SeeAlso{unw\_create\_addr\_space(3)},
48\SeeAlso{unw\_set\_caching\_policy(3)},
49\SeeAlso{unw\_flush\_cache(3)}
50
51\section{Author}
52
53\noindent
54Dave Watson\\
55Email: \Email{dade.watson@gmail.com}\\
56WWW: \URL{http://www.nongnu.org/libunwind/}.
57\LatexManEnd
58
59\end{document}
60