Manual Pages  — DWARF_SRCLINES

dwarf_srclines – retrieve line number information for a debugging information entry

LIBRARY SYNOPSIS DESCRIPTION Memory Management RETURN VALUES EXAMPLES ERRORS SEE ALSO

DWARF Access Library (libdwarf, -ldwarf)

#include <libdwarf.h>

int
dwarf_srclines(Dwarf_Die die, Dwarf_Line **lines, Dwarf_Signed *nlines, Dwarf_Error *err);

The memory area used for the array of Dwarf_Line descriptors returned in argument lines is owned by the DWARF Access Library (libdwarf, -ldwarf)The application should not attempt to free this pointer. Portable code should instead use dwarf_srclines_dealloc() to indicate that the memory may be freed.

Function dwarf_srclines() returns DW_DLV_OK when it succeeds. In case of an error, it returns DW_DLV_ERROR and sets the argument err.

To obtain an array of Dwarf_Line descriptors and to retrieve the source file, line number, and virtual address associated with each descriptor:

int n;
Dwarf_Die die;
Dwarf_Error de;
char *filename;
Dwarf_Line *lines;
Dwarf_Signed nlines;
Dwarf_Addr lineaddr;
Dwarf_Unsigned lineno;

/* variable "die" should reference a DIE for a compilation unit */

if (dwarf_srclines(die, &lines, &nlines, &de) != DW_DLV_OK)
        errx(EXIT_FAILURE, "dwarf_srclines: %s", dwarf_errmsg(de));

for (n = 0; n < nlines; n++) {
        /* Retrieve the file name for this descriptor. */
        if (dwarf_linesrc(lines[n], &filename, &de))
                errx(EXIT_FAILURE, "dwarf_linesrc: %s",
                    dwarf_errmsg(de));

        /* Retrieve the line number in the source file. */
        if (dwarf_lineno(lines[n], &lineno, &de))
                errx(EXIT_FAILURE, "dwarf_lineno: %s",
                    dwarf_errmsg(de));
        /* Retrieve the virtual address for this line. */
        if (dwarf_lineaddr(lines[n], &lineaddr, &de))
                errx(EXIT_FAILURE, "dwarf_lineaddr: %s",
                    dwarf_errmsg(de));
        }

Function dwarf_srclines() can fail with:

[DW_DLE_ARGUMENT]	One of the arguments die, lines or nlines was NULL.
[DW_DLE_NO_ENTRY]	The compilation unit referenced by argument die does not have associated line number information.
[DW_DLE_MEMORY]	An out of memory condition was encountered during the execution of this function.