dwarf_lineaddr,
dwarf_linebeginstatement,
dwarf_lineblock,
dwarf_lineendsequence,
dwarf_lineno,
dwarf_lineoff,
dwarf_linesrc,
dwarf_line_srcfileno —
retrieve information associated with a DWARF line
descriptor
DWARF Access Library (libdwarf, -ldwarf)
#include
<libdwarf.h>
int
dwarf_lineaddr(
Dwarf_Line
ln,
Dwarf_Addr *ret,
Dwarf_Error *err);
int
dwarf_linebeginstatement(
Dwarf_Line
ln,
Dwarf_Bool *ret,
Dwarf_Error *err);
int
dwarf_lineblock(
Dwarf_Line
ln,
Dwarf_Bool *ret,
Dwarf_Error *err);
int
dwarf_lineendsequence(
Dwarf_Line
ln,
Dwarf_Bool *ret,
Dwarf_Error *err);
int
dwarf_lineno(
Dwarf_Line
ln,
Dwarf_Unsigned *ret,
Dwarf_Error *err);
int
dwarf_lineoff(
Dwarf_Line
ln,
Dwarf_Signed *ret,
Dwarf_Error *err);
int
dwarf_linesrc(
Dwarf_Line
ln,
char **ret,
Dwarf_Error *err);
int
dwarf_line_srcfileno(
Dwarf_Line
ln,
Dwarf_Unsigned *ret,
Dwarf_Error *err);
These functions retrieve specific line information associated with the line
descriptor specified by argument
ln, and
stores it in the location pointed to by argument
ret. If argument
err is not NULL, it will be used to store
error information in case of an error.
Function
dwarf_lineaddr() stores the program
address corresponding to the source line specified in argument
ln into the location pointed to by argument
ret.
Function
dwarf_linebeginstatement() sets the
location pointed to by argument
ret to 1 if
the source line specified by the line descriptor
ln is the beginning of a statement, or to 0
otherwise.
Function
dwarf_lineblock() sets the location
pointed to by argument
ret to 1 if the source
line specified by the line descriptor
ln is
the beginning of a basic block, or to 0 otherwise.
Function
dwarf_lineendsequence() sets the location
pointed to by argument
ret to 1 if the
program address associated with the line descriptor
ln is the address immediately following the
end of a sequence of target machine instructions, or to 0 otherwise.
Function
dwarf_lineno() stores the line number of
the source line associated with the line descriptor
ln into the location pointed to by argument
ret.
Function
dwarf_lineoff() stores the column number
within a line associated with descriptor
ln
into the location pointed to by argument
ret.
The retrieved column numbers are 1-based, with the value -1 indicating that
column number information was not available.
Function
dwarf_linesrc() stores a pointer to a
NUL-terminated string containing the source file name associated with line
descriptor
ln into the location pointed to by
argument
ret. The full path of the source
file is returned if possible. The memory used for the source file name string
is managed by the DWARF(3) library and should not be directly freed by
application code. Instead, portable code should use
dwarf_dealloc(3) to
indicate that the string should be freed.
Function
dwarf_line_srcfileno() stores the index of
the source file associated with the line descriptor
ln in the location pointed to by argument
ret. The returned value is 1-based index into
the array of source file names returned by
dwarf_srcfiles(3).
On success, these functions returns
DW_DLV_OK
. In case of an error, they return
DW_DLV_ERROR
and set the argument
err.
These functions may fail with the following errors:
-
-
- [
DW_DLE_ARGUMENT
]
- Either of the arguments ln
or ret was NULL.
-
-
- [
DW_DLE_LINE_FILE_NUM_BAD
]
- The source file name associated with the line descriptor
ln could not be retrieved by function
dwarf_linesrc().
dwarf(3),
dwarf_dealloc(3),
dwarf_srcfiles(3),
dwarf_srclines(3)