Ddpi_Access APIs

The Ddpi_Access object contains and controls the items necessary to load and use ELF and DWARF objects.

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.

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 operation
• ddpi_module_get_dwarf_error operation

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 operation
• ddpi_elf_create operation