Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

Tree [r3223] / trunk /
History



File Date Author Commit
addr2line 2015-05-12 emaste [r3197] addr2line: handle DWARF 4's DW_AT_high_pc.
ar 2015-05-12 emaste [r3195] Use .Mt to mark up email addresses consistently
as 2012-12-22 jkoshy [r2799] Tweak the usage message printed by '''as'''.
brandelf 2015-05-12 emaste [r3195] Use .Mt to mark up email addresses consistently
common 2015-05-17 kaiwang27 [r3209] Do not redeclare program_invocation_short_name(...
cxxfilt 2015-05-12 emaste [r3195] Use .Mt to mark up email addresses consistently
documentation 2012-03-09 jkoshy [r2457] Update (c) years.
elfcopy 23 hours ago kaiwang27 [r3222] Remove an unused variable.
elfdump 2015-05-14 emaste [r3198] Add EM_IAMCU, 32-bit Intel MCU
findtextrel 2015-05-12 emaste [r3195] Use .Mt to mark up email addresses consistently
isa 2015-05-12 emaste [r3195] Use .Mt to mark up email addresses consistently
ld 2015-03-27 emaste [r3174] Remove <sys/cdefs.h> includes
libdwarf 2015-05-14 emaste [r3198] Add EM_IAMCU, 32-bit Intel MCU
libelf 2015-05-12 emaste [r3195] Use .Mt to mark up email addresses consistently
libelftc 2015-05-17 kaiwang27 [r3212] Binutils compatibiliy fixes for special names d...
mk 2014-11-02 jkoshy [r3103] For GNU/Linux based operating systems, determin...
nm 2015-05-12 emaste [r3195] Use .Mt to mark up email addresses consistently
readelf 2 hours ago emaste [r3223] readelf: Cast size_t to uintmax_t to fix 32-bit...
size 2015-05-12 emaste [r3195] Use .Mt to mark up email addresses consistently
strings 2015-05-12 emaste [r3195] Use .Mt to mark up email addresses consistently
test 2015-05-04 jkoshy [r3192] Fix the invocation of `make run-tests` at the t...
tools 2012-09-14 jkoshy [r2581] Include a change missed out in changeset [2580].
GNUmakefile 2012-09-04 jkoshy [r2568] Turn on the SVN 'Id' keyword on a newly added f...
INSTALL 2015-05-04 jkoshy [r3193] Add installation instructions for FreeBSD v10.1.
Makefile 2014-04-10 jkoshy [r3016] Turn off builds of the 'isa' utility for now, t...
README 2011-11-11 jkoshy [r2146] Changes to the top-level `README`:
RELEASE-NOTES 2012-09-25 jkoshy [r2599] Correct a typo in the release notes.

Read Me

The Elftoolchain Project
========================

.. contents::
..

Description
-----------

This software implements essential compilation tools and libraries for:

- managing program objects conforming to the ELF_ object format, and
- for managing DWARF_ debugging information in ELF objects.

The project currently implements the following utilities and
libraries:

    =========== ============================================
    Name        Description
    =========== ============================================
    ar          Archive manager.
    addr2line   Debug tool.
    brandelf    Manage the ELF brand on executables.
    c++filt     Translate encoded symbols.
    elfcopy     Copy and translate between object formats.
    elfdump     Diagnostic tool.
    findtextrel Find undesired text relocations.
    libdwarf    DWARF access library.
    libelf      ELF access library.
    mcs         Manage comment sections.
    nm          List symbols in an ELF object.
    ranlib      Add archive symbol tables to an archive.
    readelf     Display ELF information.
    size        List object sizes.
    strings     Extract printable strings.
    strip       Discard information from ELF objects.
    =========== ============================================

.. _ELF: http://en.wikipedia.org/wiki/Executable_and_Linkable_Format
.. _DWARF: http://www.dwarfstd.org/


Project Documentation
---------------------

- Release notes for released versions of this software are present in
  the file ``RELEASE-NOTES`` in the current directory.
- The file ``INSTALL`` in the current directory contains instructions
  on building and installing this software.
- Reference documentation in the form of manual pages is provided for
  the utilities and libraries developed by the project.
- Additional tutorial documentation is present in the
  ``documentation`` directory.


Tracking Ongoing Development
----------------------------

The project uses subversion_ for its version control system.

The subversion branch for the current set of sources may be accessed
at the following URL:

  https://elftoolchain.svn.sourceforge.net/svnroot/elftoolchain/trunk

The project's source tree may be checked out from its repository by
using the ``svn checkout`` command::

    % svn checkout https://elftoolchain.svn.sourceforge.net/svnroot/elftoolchain/trunk

Checked-out sources may be kept upto-date by running ``svn update``
inside the source directory::

   % svn update


Instructions on building and installing the software are given in the
file ``INSTALL`` in the current directory.

.. _Subversion: 

Downloading Released Software
-----------------------------

Released versions of the project's software may also be downloaded
from SourceForge's `file release system`_.

.. _file release system: http://sourceforge.net/projects/elftoolchain/files/

Copyright and License
---------------------

This code is copyright its authors, and is distributed under the `BSD
License`_.

.. _BSD License: http://www.opensource.org/licenses/bsd-license.php


Developer Community
-------------------

The project's developers may be contacted using the mailing list:
``<elftoolchain-developers@lists.sourceforge.net>``.


Reporting Bugs
--------------

Please use our `Trac instance`_ for viewing existing bug reports and
for submitting new bug reports.

.. _`Trac instance`: http://sourceforge.net/apps/trac/elftoolchain/report


Additional Information
----------------------

Additional information about the project may be found on the `project
website`_.

.. _project website:  http://elftoolchain.sourceforge.net/

.. $Id: README 2146 2011-11-11 09:39:00Z jkoshy $

.. Local Variables:
.. mode: rst
.. End: