Add README.chromium.

So that we can add pyelftools (along with chromite) to the Chromium
checkout.

BUG=None
TEST=None

Change-Id: Icf7f161ec674bfb3a4fe964f3483794e7430797c
Reviewed-on: https://gerrit.chromium.org/gerrit/45945
Reviewed-by: Mike Frysinger <vapier@chromium.org>
Commit-Queue: Ryan Cui <rcui@chromium.org>
Tested-by: Ryan Cui <rcui@chromium.org>

Prevent .pyc files from showing in git output

BUG=None
TEST=manual
   . running

    git status

   does not show  a bunch of .pyc files anymore

Change-Id: I153da9059adb0b7ba4c4de28d52c8024123bec2d
Signed-off-by: Vadim Bendebury <vbendeb@chromium.org>
Reviewed-on: https://gerrit.chromium.org/gerrit/41960
Reviewed-by: Eli Bendersky <eliben@chromium.org>
Reviewed-by: Mike Frysinger <vapier@chromium.org>

add Elf_Dyn support

This adds support for Elf_Dyn tags.  Pull request sent to upstream:
https://bitbucket.org/eliben/pyelftools/pull-request/5/add-support-for-parsing-of-the-dynamic/diff

BUG=chromium-os:36453
TEST=lddtree.py works

Change-Id: Iaf383eacc45adccb4dfc33e275028a8e7f58ff1e
Reviewed-on: https://gerrit.chromium.org/gerrit/38667
Reviewed-by: David James <davidjames@chromium.org>
Commit-Ready: Mike Frysinger <vapier@chromium.org>
Tested-by: Mike Frysinger <vapier@chromium.org>

Added dwarf_decode_address.py example

Added tag v0.20 for changeset 706dbb8620bd

python 3 version and README update

Added tag v0.20 for changeset 68b18168051a

More changes to port to Python 3
All tox tests pass now!!

initial efforts porting pyelftools to python 3. some basic ELF functionality working

adding more construct's files

imported new version of construct with Python 3 compatibility

Issue #3: make examples/elf_low_high_api.py more generic. Patch by Jessica McKellar

change order of tox tests to run examples before readelf (since they're much shorter)

Issue #2: made all examples run (and test/run_examples_test.py pass) on Windows.

CHANGES update

Fix Container's __pretty_str__ to use str instead of repr. This provides more consistent output across platforms for integers. Patch by Jessica McKellar

add ref output for dwarf_range_lists

minor tweaks + new tag for release

Added tag v0.10 for changeset b1c15add0da8

added parsing of .debug_ranges

updated MANIFEST and tox to include and run example tests

initial version of example tests

a bit of refactoring in the test/ dir  + completed dwarf_location_lists example

location lists kinda working. need more docs & readelf support

 a bit progress on locationlists

basic preparations for parsing location lists

lazy parsing of CUs

simple refactoring of DWARF expr descriptions to enable use from other callers

another example

made all tests run with Python 2.6 that has unittest2 installed. Added basic tox.ini file for running tox tests

fix setup.py; add verbose mode (off by default) and exit code to run_readelf_test

fixed setup script to include internal packages as well, and removed ^M from README

MANIFEST tweaks + arranging examples to find elftools even if it's not installed

added basic TODO with distribution checklist

initial addition of files needed for setup

documentation fixes + new examples

updated README

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