The Ddpi_Access object contains and controls the items necessary
to load and use ELF and DWARF objects.
Description
When an error condition is triggered, and the resulting Ddpi_Error object
indicates the error occurred during a call to a libdwarf operation,
a program analysis application can extract further information by querying
the Dwarf_Error object, which is stored in the Ddpi_Access object.
Description
That
Ddpi_Access object contains:
- The libdwarf consumer object (Dwarf_Debug).
Each libddpi instance has a single Dwarf_Debug object,
which can work with one or more Ddpi_Elf objects.
- A Dwarf_Error object, which is used for all calls to libdwarf operations.
For example, if DDPI_DLE_DWARF_ERROR (error code 138) is returned, the Dwarf_Error
object can be queried to determine the cause and type of the error.
- A list of Ddpi_Elf objects. It is recommended that a Ddpi_Elf object
exist for each compilation unit (CU), debug-information file (debugging unit),
or section of a unit. Each Ddpi_Elf object contains the handle
to the ELF object file.
To access the Dwarf_Error object, you can use either
of the following operations:ddpi_access_get_dwarf_error operationThe ddpi_access_get_dwarf_error operation returns the Dwarf_Debug object that is stored in the given Ddpi_Access object. If the extraction function ddpi_module_extract_debug_info() was used, this operation will open the .dbg file and create a Dwarf_Debug object for the instance, if one does not already exist.ddpi_module_get_dwarf_error operationThe ddpi_module_get_dwarf_error operation returns a pointer to the Dwarf_Error object for the given Ddpi_Module.Both of these operations return the same Dwarf_Error object.
To create the Ddpi_Elf objects, you can use either of the following
operations:ddpi_module_extract_C_CPP_information operationThe ddpi_module_extract_C_CPP_information operation uses the given Ddpi_Module object to locate the module or program object, and extract all of the information needed to load a DWARF object for C/C++.ddpi_elf_create operationThe ddpi_elf_create operation creates a Ddpi_Elf object to enable access to debugging data in an ELF object file.