libdw: Add new functions dwarf_getlocation_attr and dwarf_getlocation_die.
authorMark Wielaard <mjw@redhat.com>
Fri, 30 Aug 2013 21:55:12 +0000 (23:55 +0200)
committerMark Wielaard <mjw@redhat.com>
Fri, 6 Sep 2013 10:09:45 +0000 (12:09 +0200)
commitb2535b6a6be7717cdd41834d76e5cb48cb446b83
tree6f90ce8b4e754103beaf72cef9778fe744ddc65d
parent66eaae9bcc1608efad65e3aa0204afbb3cb1a83d
libdw: Add new functions dwarf_getlocation_attr and dwarf_getlocation_die.

Some location expression operations have a DIE associated with them.
Examples are some of the new GNU typed DWARF extensions, DW_OP_GNU_convert,
DW_OP_GNU_reinterpret, DW_OP_GNU_const_type, DW_OP_GNU_regval_type and
DW_OP_GNU_deref_type. Others have (block) values associated with them,
like DW_OP_GNU_entry_value and DW_OP_GNU_const_type.

It is not always easy to access these values. The DIE offset is given in
various formats either as global offset or CU relative offset. The (block)
value might be constant or a location description. And the block might be
encoded with a uleb128 or ubyte length. The new functions help to easily
get at the DIE or attribute value.

In theory dwarf_getlocation_attr could be used for all cases, since
besides returning DW_AT_const_value or DW_AT_location, it could also
return an attribute referencing a DIE. But at least one operation,
DW_OP_GNU_const_type, has both a (type) DIE and a constant (block)
value associated with it. And directly getting the DIE when needed
is easier than first having to retrieve a (synthesized) attribute
and then getting the actual (type) DIE.

Expression operations that reference an actual DIE for the
DW_AT_location or DW_AT_const_value, like DW_OP_call2, DW_OP_call4,
DW_OP_callref and DW_OP_GNU_implicit_pointer can be used with both
dwarf_getlocation_attr and dwarf_getlocation_die.

DW_OP_implicit_value and DW_OP_GNU_implicit_pointer already had
their own special accessors (dwarf_getlocation_implicit_value
and dwarf_getlocation_implicit_pointer), but it seemed consistent
to include them in the new more generic accessors too.

Signed-off-by: Mark Wielaard <mjw@redhat.com>
libdw/ChangeLog
libdw/Makefile.am
libdw/dwarf_getlocation.c
libdw/dwarf_getlocation_attr.c [new file with mode: 0644]
libdw/dwarf_getlocation_die.c [new file with mode: 0644]
libdw/libdw.h
libdw/libdw.map
libdw/libdwP.h