summaryrefslogtreecommitdiffstats
path: root/chromium/third_party/pyelftools/README
blob: 836c1f289267ef88798ce5868ea01e961353f0a4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
Introduction: what is pyelftools?
---------------------------------

**pyelftools** is a pure-Python library for parsing and analyzing ELF files
and DWARF debugging information. See the
`User's guide <https://bitbucket.org/eliben/pyelftools/wiki/Userguide>`_ for more details.

Pre-requisites
--------------

As a user of **pyelftools**, one only needs Python to run. It works with
Python versions 2.6, 2.7 and 3.2. For hacking on **pyelftools** the
requirements are a bit more strict, please see the
`hacking guide <https://bitbucket.org/eliben/pyelftools/wiki/Hacking>`_.

Installing
----------

When you unzip the source distribution, run::

    > python setup.py install

Alternatively, **pyelftools** can be installed from PyPI (Python package
index)::

    > pip install pyelftools

How to use it?
--------------

**pyelftools** is a regular Python library: you import and invoke it from your
own code. For a detailed usage guide and links to examples, please consult the
`user's guide <https://bitbucket.org/eliben/pyelftools/wiki/Userguide>`_.

License
-------

**pyelftools** is open source software. Its code is in the public domain. See
the ``LICENSE`` file for more details.