uwx_find_source_info.3x (2010 09)

u
uwx_find_source_info(3X) uwx_find_source_info(3X)
(Integrity Systems Only)
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 will be returned (the
difference between the IP and the actual value of the function symbol located). If NULL,
the offset will not be returned. If the function name is not available, an offset of 0 will be
returned.
srcfilep Pointer to a variable of type char * where the source file name will be returned. If
NULL, the source file name will not be returned. If symbolic debug information is not
available, a NULL pointer will be returned.
linenump Pointer to a variable of type int where the source line number will be returned. If NULL,
the source line number will not be returned. If symbolic debug information is not avail-
able, 0 will be returned.
inline_contextp Pointer to a variable of type int where the inline context identifier will be returned. If
NULL, the inline context identifier will not be returned. If the IP of the current context
is not in an inlined call or if symbolic debug information is not available, 0 will be
returned.
In all cases where a pointer to a string is returned, the string is allocated within the unwind environ-
ment, and the pointer is valid only until the next call to either
uwx_step() or uwx_free()
.
Stepping through inlined calls
If
uwx_find_source_info()
returns a non-zero inline context identifier, it indicates that the IP is
located within an inline call. If the application wishes to step through the chain of inlined calls, it can
find the name of the inlined function through the ifuncp pointer, then call
uwx_find_source_info()
again, this time passing the previously-returned value of the inline context identifier as the inline_context
parameter. This process should be repeated until the returned identifier is 0.
RETURN VALUE
uwx_find_source_info()
returns [UWX_OK] on success. See uwx(3X) for error codes.
AUTHOR
The Unwind Express Library was developed by Hewlett-Packard.
SEE ALSO
dlgetname(3C), dlmodinfo(3C), uwx(3X), uwx_add_to_bsp(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).
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010