Table of Contents
Note
If you are reading this README on a mirror site such as GitHub, please note that the primary development site for this project is at elftoolchain.sourceforge.net.
Please use the SourceForge project's bug tracker
for reporting bugs and for sending in patches. If you
have other project-related questions, please ask them on the
<[email protected]> mailing list.
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. |
- Release notes for released versions of this software are present in
the file
RELEASE-NOTESin the current directory. - The file
INSTALLin 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
documentationdirectory.
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://sourceforge.net/p/elftoolchain/code/HEAD/tree/trunk/
The project's source tree may be checked out from its repository by
using the svn checkout command:
% svn checkout https://svn.code.sf.net/p/elftoolchain/code/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.
Released versions of the project's software may also be downloaded from SourceForge's file release system.
This code is copyright its authors, and is distributed under the BSD License.
The project's developers may be contacted using the mailing list:
<[email protected]>.
Please use our bug tracker for viewing existing bug reports and for submitting new bug reports.
Additional information about the project may be found on the project website.