Ddpi_Sourcefile APIs

Ddpi_Sourcefile APIs provide information about source files in the .debug_srcfiles section.

Ddpi_Sourcefile object
A Ddpi_Sourcefile object contains information about a source file. If this source file is in more than one compilation unit, there will be a separate Ddpi_Sourcefile object for each unit.
ddpi_sourcefile_get_full_name operation
The ddpi_sourcefile_get_full_name operation returns the full path name of the source file for the compilation unit. The actual version of the name is returned, not a copy. The user must never deallocate the returned pointer.
ddpi_sourcefile_get_short_name operation
The ddpi_sourcefile_get_short_name operation returns the name of the source file for the compilation unit, without the full path. The actual version of the name is returned, not a copy. The user must never deallocate the returned pointer.
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.
ddpi_sourcefile_get_die_offset operation
The ddpi_sourcefile_get_die_offset operation returns the DIE offset of the source file.
ddpi_sourcefile_get_source_lines operation
The ddpi_sourcefile_get_source_lines operation returns the contents of the source file at the given line numbers. The returned string will be NULL terminated. To return all remaining lines, pass 0 for num_lines. If num_lines exceeds the remaining number of lines, all remaining lines will be returned.
ddpi_sourcefile_query_capsrc operation
The ddpi_sourcefile_query_capsrc operation returns whether the debug information contains a copy of the source file text.