HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)
u
uwx(3X) uwx(3X)
(Integrity Systems Only)
[UWX_ERR_LOOKUPERR] The "Lookup IP" callback encountered an error.
[UWX_ERR_NOCALLBACKS] No callback routines have been registered.
[UWX_ERR_NOCONTEXT] No initial context has been supplied.
[UWX_ERR_NOENV] The env parameter is NULL.
[UWX_ERR_NOMEM] An attempt to allocate additional memory failed.
[UWX_ERR_NOSYM] No symbolic information was found.
[UWX_ERR_NOUDESC] An unwind information block was found, but it does not describe the
current frame’s IP.
[UWX_ERR_NOUENTRY] No unwind information block was found for the current frame’s IP.
[UWX_ERR_PROLOG_UF] The unwind information block is invalid -- the nesting of prologue
regions is not balanced.
[UWX_ERR_UCACCESS] An unidentified error was received from the uc_access(3) library.
[UWX_ERR_UNDEFLABEL] The unwind information block is invalid -- an undefined label is refer-
enced.
EXAMPLES
The following code fragment performs a stack unwind in the current thread:
int status;
struct uwx_env *env;
struct uwx_self_info *info;
uint64_t ip;
env = uwx_init();
info = uwx_self_init_info(env);
status = uwx_register_callbacks(env, (intptr_t)info,
uwx_self_copyin, uwx_self_lookupip);
status = uwx_self_init_context(env);
for (;;) {
status = uwx_step(env);
if (status != UWX_OK)
break;
status = uwx_get_reg(env, UWX_REG_IP, &ip);
printf("IP: %016llx\n", ip);
}
uwx_self_free_info(info);
uwx_free(env);
LIMITATIONS
The Unwind Express Library currently does not recognize X-format unwind descriptors. These are not
currently used by HP compilers.
AUTHOR
The Unwind Express Library was developed by Hewlett-Packard.
SEE ALSO
uc_access(3), 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_funcstart(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).
HP-UX 11i Version 3: February 2007 − 3 − Hewlett-Packard Company 601