uwx_get_sym_info(3x) [hpux man page]

uwx_get_sym_info(3X)													      uwx_get_sym_info(3X)

NAME

       uwx_get_sym_info() - return symbolic information for current frame

SYNOPSIS


DESCRIPTION

       is part of the Unwind Express Library for Integrity systems; see uwx(3X).  obtains symbolic information for the current frame from the sym-
       bol tables in the ELF object file, if available.

       This entry point is provided for use immediately following a call to For other situations, see

   Parameters
       env	      A pointer to an unwind environment object.

       modp	      Pointer to a variable of type char * where the load module name will be returned.  If NULL, the  module  name  will  not	be
		      returned.  If the module name is not available, a NULL pointer will be returned.

       funcp	      Pointer  to  a  variable	of  type  char * where the function name will be returned.  If NULL, the function name will not be
		      returned.  If the function name is not available, a NULL pointer will be returned.

       offsetp	      Pointer to a variable of type uint64_t where the function offset (the difference between the IP  (instruction  pointer)  and
		      the  actual value of the function symbol located) will be returned.  If NULL, the offset will not be returned.  If the func-
		      tion name is not available, an offset of 0 will be returned.

RETURN VALUE

       returns on success.  If the current frame is a signal handler frame, it returns and no symbolic information is returned.  See  uwx(3X)  for
       error codes.

AUTHOR

       The Unwind Express Library was developed by Hewlett-Packard.

SEE ALSO

       uwx(3X),  uwx_add_to_bsp(3X),  uwx_find_source_info(3X),  uwx_find_symbol(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_init(3X), uwx_init_context(3X), uwx_reg-
       ister_alloc_cb(3X),   uwx_register_callbacks(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 Only					      uwx_get_sym_info(3X)

uwx_self_init_state_cache(3X)											     uwx_self_init_state_cache(3X)

NAME

       uwx_self_init_state_cache() - create a cache to improve self-unwind performance

SYNOPSIS


DESCRIPTION

       is  part of the Unwind Express Library for Integrity systems; see uwx(3X).  creates a cache for quick retrieval of unwind state information
       when self-unwinding.  This routine can be used to improve the performance of programs that perform frequent self-unwind operations.

       The ideal cache size and associativity will vary for different applications.  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 ALSO

       uwx(3X),  uwx_add_to_bsp(3X),  uwx_find_source_info(3X),  uwx_find_symbol(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_callbacks(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 Only				     uwx_self_init_state_cache(3X)