uwx_self_init_state_cache(3X)uwx_self_init_state_cache(3X)NAMEuwx_self_init_state_cache() - create a cache to improve self-unwind
performance
SYNOPSISDESCRIPTION
is part of the Unwind Express Library for Integrity systems; see
uwx(3X). creates a cache for quick retrieval of unwind state informa‐
tion when self-unwinding. This routine can be used to improve the per‐
formance of programs that perform frequent self-unwind operations.
The ideal cache size and associativity will vary for different applica‐
tions. Experiment with different values and use performance measure‐
ment tools to determine the best values to use.
The memory used by the cache is freed when is called.
Parameters
info A pointer to the callback info structure created by
rows The number of rows in the cache. If this is not a power
of two, it will be adjusted to the largest power of two
less than the value specified. If the value specified
is less than 1, returns without allocating a cache.
assoc The associativity of the cache. This determines how
many entries with conflicting hash values can be stored
in each row of the cache. If the value specified is
less than 1, returns without allocating a cache.
entsz The size of a cache entry in bytes. The size of the
unwind state information stored in a cache entry varies
between 64 and 368 bytes.
If a stack frame's unwind state is larger than the value
specified for entsz, the state will not be saved in the
cache. An entry size of 104 is sufficient for most
stack frames. If the entsz value is not a multiple of 8
bytes it will be rounded up. If value specified is less
than 64 bytes, returns without allocating a cache.
RETURN VALUE
returns on success. See uwx(3X) for error codes.
AUTHOR
The Unwind Express Library was developed by Hewlett-Packard.
SEE ALSOuwx(3X), uwx_add_to_bsp(3X), uwx_find_source_info(3X), uwx_find_sym‐
bol(3X), uwx_free(3X), uwx_get_abi_context_code(3X), uwx_get_func‐
start(3X), uwx_get_module_info(3X), uwx_get_nat(3X), uwx_get_reg(3X),
uwx_get_source_info(3X), uwx_get_sym_info(3X), uwx_init(3X),
uwx_init_context(3X), uwx_register_alloc_cb(3X), uwx_register_call‐
backs(3X), uwx_release_symbol_cache(3X), uwx_self_do_context_frame(3X),
uwx_self_free_info(3X), uwx_self_init_context(3X),
uwx_self_init_info(3X), uwx_set_nofr(3X), uwx_set_remote(3X),
uwx_step(3X), uwx_step_inline(3X).
Integrity Systems Onluwx_self_init_state_cache(3X)