uwx_get_module_info.3x (2010 09)

uwx_get_module_info(3X) uwx_get_module_info(3X)

(Integrity Systems Only)

NAME

uwx_get_module_info() - return load module information for current context

SYNOPSIS

#include <uwx.h>

int uwx_get_module_info(

struct uwx_env *env,

char **modp,

uint64_t *text_base

);

DESCRIPTION

uwx_get_module_info()

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

uwx_get_module_info()

returns the name and text segment base address of the load module that

contains the IP (instruction pointer) of the current unwind context.

Parameters

env A pointer to an unwind environment object.

modp Pointer to a variable of type char * where the module name will be returned. The

returned module name is allocated within the unwind environment, and the pointer is

valid only until the next call to either

uwx_step() or uwx_free(). If NULL, the

module name will not be returned.

text_base Pointer to a variable of type uint64_t where the text segment base address for the load

module will be returned. If NULL, the base address will not be returned.

RETURN VALUE

uwx_get_module_info()

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

AUTHOR

The Unwind Express Library was developed by Hewlett-Packard.