some doc updates

fix ReST links in README

updated README

some cosmetic changes + updating README

adding license + some filename cleanup

update unittest runner

cleanup

renamed 'tests' dir to 'test'

changed file permissions

fixed previous problem

Added new test file and fixing some problems related to it. not completely working yet

more horrible hacks to run_readelf_tests to pass with a newer readelf on 32-bit

added test file (clang-compiled). fixed readelf handling of unknown attributes

added some documentation to callframe.py

fixed a bug in taking the last line from CIE to first line in FDE - need copy.copy! now all current readelf tests run successfully

readelf --debug-dump=frames-interp initial implementation completed. some tests vs. readelf run

started implementing debug-dump=frames-interp

decoding seems to somewhat work. some unit tests pass

decoding seems to somewhat work. some unit tests pass

some unit tests for describe_CFI_instructions

completed descriptions of --debug-info=frames. readelf tests run

started implementing dumping --debug-dump=frames

implemented decoding of the CIE object associated with FDEs

added some more assertions to test_callframe.py

starting tests for callframes

fixed default address size passing from ELFFile to DWARFInfo, which makes it possible to correctly read .debug_frame sections

call frame instructions parsing kinda done. now need to run some tests: ++ write unit tests for this

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