Ddpi_Elf APIs

This information describes the operations that get and set information in the Ddpi_Elf object.

Description

The Ddpi_Elf object stores the information needed to access, load, or relocate an ELF object file. For example, it contains a file handle and the address range of the compilation unit (CU) loaded in memory. A Ddpi_Elf object is created for each ELF object file. For information on loading and relocating the Ddpi_Elf object, see Ddpi_Elf loading API.

The program analysis application uses the Ddpi_Elf object in order to specify a particular CU or section. Accordingly, the Ddpi_Elf object can be set either during creation or by individual routines. For more information on using a Ddpi_Elf object , see Common Debug Architecture User's Guide, SC09-7653.

For C and C++ modules, you can use the ddpi_module_extract_C_CPP_information operation to automatically create Ddpi_Elf objects. For more information, see 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 object

A Ddpi_Elf object is created for each ELF object file. This structure is used to coordinate access to an ELF object file that has been loaded and pointed to by an ELF descriptor. The data type is opaque.
Ddpi_Elf_Source object

An ELF object is loaded from an ELF source. The ELF source must remain open as long as the information from it is potentially in use. The Ddpi_Elf_Source object tracks this ELF source.
Ddpi_Elf_Source_Type object

The Ddpi_Elf_Source_Type object determines which member of the Ddpi_Elf_Source object is used to track the source of the ELF object.
ddpi_elf_create operation

The ddpi_elf_create operation creates a Ddpi_Elf object to enable access to debugging data in an ELF object file.
ddpi_elf_term operation

The ddpi_elf_term operation terminates a Ddpi_Elf object and removes the given Ddpi_Elf from the list in its parent access object.
ddpi_elf_get_owner operation

The ddpi_elf_get_owner operation returns the owner of the Ddpi_Elf object.
ddpi_elf_get_source operation

The ddpi_elf_get_source operation finds the source data of the Elf object.
ddpi_elf_set_source operation

The ddpi_elf_set_source operation stores the value returned by the elf_begin operation. The value can be a file descriptor, file pointer, or memory block.
ddpi_elf_get_elf operation

The ddpi_elf_get_elf operation finds the ELF object for the given Ddpi_Elf object.
ddpi_elf_set_elf operation

The ddpi_elf_set_elf operation assigns the ELF object to the given Ddpi_Elf object.
ddpi_elf_get_elf_file_name operation

The ddpi_elf_get_elf_file_name operation returns the pointer to the ELF object filename, and not a copy.
ddpi_elf_set_elf_file_name operation

The ddpi_elf_set_elf_file_name operation assigns an ELF file name to the given Ddpi_Elf object and makes a copy of the given name.
ddpi_elf_get_ppa_addrs operation

The ddpi_elf_get_ppa_addrs operation queries the PPA addresses for a given Ddpi_Elf object.
ddpi_elf_set_ppa_addrs operation

The ddpi_elf_set_ppa_addrs operation assigns the PPA addresses to a given ELF object.
ddpi_elf_get_md5_sig operation

The ddpi_elf_get_md5_sig operation copies the MD5 signature into the given unsigned char[16] buffer.
ddpi_elf_set_md5_sig operation

The ddpi_elf_set_md5_sig operation assigns the MD5 signature to a given ELF object. It copies the given unsigned char[16] buffer into the MD5 signature.
ddpi_elf_get_csect_addrs operation

The ddpi_elf_get_csect_addrs operation queries the CSECT addresses for the ELF object and extracts the high and low addresses.
ddpi_elf_set_csect_addrs operation

The ddpi_elf_set_csect_addrs operation assigns the high and low addresses to the CSECT of the ELF object.
ddpi_elf_get_user_area operation

The ddpi_elf_get_user_area operation returns a pointer to the user area for the Ddpi_Elf object.
ddpi_elf_list_function operation

The ddpi_elf_list_function operation lists all of the Ddpi_Function objects associated with the given Ddpi_Elf object. Although the calling module must deallocate the list, the individual Ddpi_Function objects in the list should never be deallocated, as these are the actual Ddpi_Function objects from the Ddpi_Elf object.
ddpi_elf_list_variable operation

The ddpi_elf_list_variable operation lists all of the Ddpi_Variable objects associated with the given Ddpi_Elf object. Although the calling module must deallocate the list, the individual Ddpi_Variable objects in the list should never be deallocated, as these are the actual Ddpi_Variable objects associated with the Ddpi_Elf object.
ddpi_elf_list_type operation

The ddpi_elf_list_type operation creates an array that contains all of the Ddpi_Type objects associated with the given Ddpi_Elf object. Although the calling module must deallocate the list, the individual Ddpi_Variable objects in the list should never be deallocated; these are the actual Ddpi_Type objects associated with the Ddpi_Elf object.
ddpi_elf_list_sourcefile operation

The ddpi_elf_list_sourcefile operation creates an array that contains all of the Ddpi_Sourcefile objects associated with the given Ddpi_Elf object. Although the calling module must deallocate the list, the individual Ddpi_Sourcefile objects in the list should never be deallocated; these are the actual Ddpi_Sourcefile objects associated with the Ddpi_Elf object.
ddpi_elf_get_primary_sourcefile operation

The ddpi_elf_get_primary_sourcefile operation returns the primary Ddpi_Sourcefile object associated with the given Ddpi_Elf object. The Ddpi_Sourcefile object should never be deallocated; this is the actual primary Ddpi_Sourcefile object associated with the Ddpi_Elf object.
ddpi_elf_get_reloc_info operation

The ddpi_elf_get_reloc_info operation retrieves the relocation information that relocates a symbol found in .symtab of the elf image. If the ddpi_elf_get_reloc_info operation is called more than once for a relocation entries found in .symtab of the Ddpi_Elf object, the ddpi_elf_get_reloc_info operation always returns the first one.
ddpi_elf_set_reloc_info operation

The ddpi_elf_set_reloc_info operation adds a relocation information that relocates a symbol found in .symtab of the elf image. This API should be called once for each relocation entries found in .symtab of the Ddpi_Elf object.