starting skeleton implementation of call frame parsing

Implement register name decoding in descriptions. This also allows to remove
the hack in run_readelf_tests for ignoring differences in reg names
(previously missing)

Pass configuration from ELFFile to DWARFInfo via a DwarfConfig object.
Also change the way ELFFile exposes the machine architecture gathered from the header

some documentation improvements

some documentation for the dwarf_expr module

renamed 'location expression' to the more general 'dwarf expression'

renamed 'location expression' to the more general 'dwarf expression'

using RepeatUntilExcluding for the Dwarf_abbrev_declaration struct - so now no accounting for the empty element is needed when iterating over it

added debug-dump=decodedline to readelf test suite

changed line program entries to contain commands and arguments, AND state. this allows more faithful decoding in readelf

starting running decodedline vs. readelf, most things work... but some don't [AHA]

small fixes to lineprogram + unit tests + new unittest runner

after cleanup and fixing, it actually shows signs of life

changed the method to obtain line programs - now per CU

moving on with line program stuffz

laziness FTW

some API cleanups + added lineprogram

added Dwarf_lineprog_header struct, with some rudimentary tests

merge

further optimization of reading a cstring from a stream + added some tests for utils

added some more exceptions to the test runner, to account for differences in readelf versions

some performance improvements

run normally by default, not in profiling mode

add caching to LocationExpressionDumper in _location_list_extra. this makes some benchmarks considerably faster

cleanup + add profiling top-level function to readelf

fixes in readelf. added --debug-dump=info to the tests

it's alive, ALIVEhg sthg st! DWARF relocations seem to be working fine

still not working, but getting there. need to revise DWARF processing for per-section streams

nothing works because we're in the middle of a relocation revamp - BUT IT WILL!!

added extra description for DW_AT_import to conform with readelf

the relocation manager for dwarf works!  sdf

some code restructuring + initial version of dwarfrelocationmanager

add __contains__ to construct's Container. this actually fixes Relocation.is_RELA which wouldn't work otherwise. also add __repr__ and __str__ to Relocation

merge & resolve conflicts from remote

fix the 'key to flags' text printed after section enumeration. probably to match a newer readelf version

small fixes to have formatting consistent with readelf

added description for location_expr
kinda works vs. readelf!

Added string dumping for location expressions, with tests

added basic visiting of all OPs in location_expr.GenericLocationExprVisitor

more work on location_expr

started location_expr, added unit tests. moved readelf unittest to a more appropriate file name

added name field to AttributeValue

added name field to AttributeValue

mostly implemented extra information output for dwarf info section dump

more descriptions added for DWARF info

added some basic description capabilities for DWARF attributes in debug_info

* start adding debug_dump=info to readelf.py
* adding support to dwarf code for the above

docstring clarification for DWARFStructs

unflattening the DIE tree by CU done - now DIEs have functional iter_children, get_parent and iter_siblings methods!

CU will now parse all its DIEs (lazily, when any specific DIE is requested)

moved utils/ dir to tests/

added a utils folder with elf_creator.c

* added new test file - an object compiled from C++, on x64
* adjusted readelf to limit width of symbol names in relocation dump

fix detection of flag_after_symtable in compare_output: has to be lower-cased after the change made to lower() the lines before comparing

* added another test file (real-life object file borrowed from libelf)
* print out notification about sections having relocations against them in the file
* munge run_tests to ignore case when comparing lines

* renamed test files to be consistent
* added a real-life test file - the libelf SO on 32-bit
* fixed a formatting difference in readelf.py
* enabled selecting which test files to run on in run_tests.py

merge

relocation output working in readelf comparison

fixed parsing of r_info field

cleanup and cosmetics - for a healthy future!! er... what?

adding some useful attributes & method to DIE

some refactoring. parsing a single DIE now appears to be working

more preparations for full DIE parsing:
- DWARFStructs got a new target_addr field that reflects the size of address fields in a CU
- DWARFInfo now gives access to the symbol table
- fixed stream parsing bugs that happened because the stream was not being preserved during parsing while issuing calls to other APIs that also move the stream

some fixes in relocation printing. INFO STILL PRINTED ENDIAN-REVERSED -- WTF???

* completed implementation of abbrevtable
* started implementing DIE
* added code to CompileUnit to tie them all together

DIEs start showing signs of life

abbrev table almost functioning

Started adding abbrev table stuff

* DWARFInfo now doesn't receive a "dwarf class" argument, since it must infer it on its own from the info section
* Parsing of CU headers was fixed and now appears to be working

some more work towards relocations

adding _default_=Pass to elf enums

* take DWARF stuff from ELFFile
* Currently DWARF format (32 or 64-bit) isn't handled correctly. see TODO

Implemented ELFFile.get_section_by_name and changed readelf.py to use it

Added dwarf/compileunit.py and dwarf/dwarfinfo.py and started filling in details

partial support for parsing relocation sections

created elftools/dwarf and started writing down some basic structs for data primitives and various encodings the format uses

implemented string dumping, with tests

added hex dump of sections

fixing comparison in run_tests. moving all binary files to testfiles/

test suite implemented. fixing some problems in elftools and readelf

the beginnings of a test harness

finalizing cmdling options for current functionality

some more command-line option handling

started adding command-line options to readelf

minor tweak in output formatting for symbols

displaying symtables kinda works

section header output kinda working

Section to segment mapping seems to be working - yay!

added segment attribute formatting for 64-bit, and fixed some words to xwords in the segment struct definition

Implementing reading the INTERP path in segments

implemented some of program header display

some cleanup

prints ELF header correctly

some more header descriptions added

* Started writing readelf.py
* Added file with textual descriptions of enums, for readelf.py

added Symbol decoding from a symbol table section

removed CRs

moving stuff around

Added a SymbolTableSection class and split functionality from ELFFile to create it

Some code reorg:
* created common/ dir and moved exceptions there (along with utils)
* moved struct_parse from elffile to utils
* moved string table functionality to its own section class

* Added handling of segments
* Added iteration API for sections