ddpi_sourcefile_get_access operation

The ddpi_sourcefile_get_access operation returns the Ddpi_Access object whose Dwarf_Debug instance contains information from the source file for the compilation unit. The actual Ddpi_Access version is returned, not a copy. The user must never deallocate the returned pointer.

Prototype

int ddpi_sourcefile_get_access(
   Ddpi_Sourcefile       sourcefile,
   Ddpi_Access*          ret_access,
   Ddpi_Error*           error);

Parameters

sourcefile: Input. This accepts the Ddpi_Sourcefile object for instance.
ret_access: Output. This returns the Ddpi_Access object whose Dwarf_Debug object contains the instance information.
error: See The libddpi error parameter.

Return values

DW_DLV_OK

This value is returned upon successful completion of the operation.

DW_DLV_NO_ENTRY

This value is never returned.

DW_DLV_ERROR

This value is returned if:

sourcefile is NULL or invalid.
The Ddpi_Elf, Ddpi_Access, or Ddpi_Info object associated with the source file is either NULL or invalid.
ret_access is NULL.