HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

611

612

613

614

615

616

617

618

619

620

uwx_get_sym_info(3X) uwx_get_sym_info(3X)

(Integrity Systems Only)

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 ﬁle, 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.