Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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 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 ALSO
       uwx(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)

Vote for polarhome