2 .\" Manual page created with latex2man on Thu Aug 16 09:44:45 MDT 2007
3 .\" NOTE: This file is generated, DO NOT EDIT.
13 .TH "UNW\\_SET\\_CACHING\\_POLICY" "3" "16 August 2007" "Programming Library " "Programming Library "
15 unw_set_caching_policy
16 \-\- set unwind caching policy
21 #include <libunwind.h>
25 unw_set_caching_policy(unw_addr_space_t
34 The unw_set_caching_policy()
35 routine sets the caching policy
37 to the policy specified by argument
40 argument can take one of three
44 Turns off caching completely. This
45 also implicitly flushes the contents of all caches as if
50 Enables caching using a global cache
51 that is shared by all threads. If global caching is unavailable or
52 unsupported, libunwind
53 may fall back on using a per\-thread
54 cache, as if UNW_CACHE_PER_THREAD
59 thread\-local caches. If a thread\-local caching are unavailable or
60 unsupported, libunwind
61 may fall back on using a global cache,
62 as if UNW_CACHE_GLOBAL
65 If caching is enabled, an application must be prepared to make
66 appropriate calls to unw_flush_cache()
68 changes in a way that could affect the validity of cached information.
69 For example, after unloading (removing) a shared library,
71 would have to be called (at least) for the
72 address\-range that was covered by the shared library.
74 For address spaces created via unw_create_addr_space(3),
75 caching is turned off by default. For the local address space
77 caching is turned on by default.
82 On successful completion, unw_set_caching_policy()
84 Otherwise the negative value of one of the error\-codes below is
87 .SH THREAD AND SIGNAL SAFETY
90 unw_set_caching_policy()
91 is thread\-safe but \fInot\fP
93 to use from a signal handler.
100 The desired caching policy could not be
101 established because the application is out of memory.
107 unw_create_addr_space(3),
113 David Mosberger\-Tang
115 Email: \fBdmosberger@gmail.com\fP
117 WWW: \fBhttp://www.nongnu.org/libunwind/\fP\&.
118 .\" NOTE: This file is generated, DO NOT EDIT.