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_source_info(3X) uwx_get_source_info(3X)

(Integrity Systems Only)

NAME

uwx_get_source_info() - return source information for current frame

SYNOPSIS

#include <uwx.h>

int uwx_get_source_info(

struct uwx_env *

env,

char **

ifuncp,

char **

srcﬁlep,

int *

linenump,

int *

inline_contextp

);

DESCRIPTION

uwx_get_source_info()

is part of the Unwind Express Library for Integrity systems; see uwx(3X).

uwx_get_source_info()

obtains source ﬁle and line number information for the current frame from

the symbolic information stored in the ELF object ﬁle, if available.

This entry point is provided for use immediately following a call to

uwx_step() or

uwx_step_inline()

. For other situations, see uwx_ﬁnd_source_info(3X).

Parameters

env A pointer to an unwind environment object.

ifuncp Pointer to a variable of type char * where the inlined function name will be returned. If

NULL, the inlined function name will not be returned. If the IP (instruction pointer) of the

current context is not in an inlined call or if symbolic debug information is not available, a

NULL pointer will be returned.

srcfilep Pointer to a variable of type char * where the source ﬁle name will be returned. If NULL,

the source ﬁle 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 available,

0 will be returned.

inline_contextp Pointer to a variable of type int where the inline context identiﬁer will be returned. If

NULL, the inline context identiﬁer 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 environment,

and the pointer is valid only until the next call to either

uwx_step() or uwx_free() .

Stepping through inlined calls

uwx_get_source_info()

returns a non-zero inline context identiﬁer, 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 ﬁnd

the name of the inlined function through the ifuncp pointer, then call

uwx_step_inline()

to move one

step up the chain of inlined calls. The application may then call

uwx_get_source_info() again to

obtain the updated information. This process should be repeated until the returned identiﬁer is 0.

RETURN VALUE

uwx_get_source_info() returns [UWX_OK] on success. See uwx(3X) for error codes.

AUTHOR

The Unwind Express Library was developed by Hewlett-Packard.