NAME
uwx_get_sym_info() — return symbolic information for current frame
SYNOPSIS
#include <uwx.h>
int uwx_get_sym_info(
struct uwx_env *env,
char **modp,
char **funcp,
uint64_t *offsetp
);
DESCRIPTION
uwx_get_sym_info()
is part of the Unwind Express Library for Integrity systems; see
uwx(3X).
uwx_get_sym_info()
obtains symbolic information for the current frame from
the symbol tables in the ELF object file,
if available.
This entry point is provided for use immediately following a call to
uwx_step().
For other situations, see
uwx_find_symbol().
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 function name is not available, an offset of 0 will be returned.
RETURN VALUE
uwx_get_sym_info()
returns
UWX_OK
on success.
If the current frame is a signal handler frame, it returns
UWX_ABI_FRAME
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_funcstart(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_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).