This wiki page documents release 0.5.1 of the software released by the Elftoolchain project.
There are two ways to download the sources:
The source code for the release may be downloaded from SourceForge.Net: http://sourceforge.net/projects/elftoolchain/files/Sources/elftoolchain-0.5.1/.
To check out the sources from the project's SVN repository, use:
% svn export http://sourceforge.net/p/elftoolchain/code/HEAD/tree/tags/elftoolchain-0.5.1/
The Elftoolchain project develops BSD-licensed implementations of essential compilation tools and libraries for handling ELF based program objects.
This release is the first public release of the software developed by the Elftoolchain project.
This release comprises the following libraries and utilities.
|brandelf||Manage the ELF brand on executables.|
|c++filt||Translate encoded symbols.|
|elfcopy||Copy and translate between object formats.|
|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.|
Each public API and invocable utility has its own manual page (327 manual entries, documented in 186 files).
Additionally, this release contains the following documentation:
|libelf-by-example||A tutorial introduction to
The release contains the following test suites:
This software is designed to run on Unix(TM)-like operating systems such as the BSD-family of operating systems and GNU/Linux.
This release has been built and tested on the following operating systems:
|Operating System||Version||Supported Architectures|
|FreeBSD||v8.2||amd64 & i386|
|Ubuntu GNU/Linux||10.04LTS||i386 & x86_64|
Instructions for building and installing this software from source are described in the file "INSTALL".
This is the first public release of the Elftoolchain sources.
Some of the libraries and utilities in this release were originally developed at the FreeBSD_ project. These components differ from their prior versions in FreeBSD source tree in the following ways:
arsupports BSD-style archives.
brandelfsupports additional ELF brands.
libdwarflibrary implements the complete DWARF(3) producer and consumer API set. Each public API has been documented in the form of a manual page.
libelfsupports operations on special devices in addition to regular files.
libelfsupports opening of ELF objects in read/write mode.
libelfcan process BSD-style archives.
Additionally, the manual pages associated with these components have been improved.
There were no outstanding issues at the time of the release.
This release has the following limitations:
We hope to address these limitations in future releases.
The test summary for this release is presented below:
|Suite||Tests (32 & 64 bit)||FreeBSD 8.2 (i386 & amd64)||NetBSD 5.0.2 (i386)||Ubuntu 10.04LTS (i386 & x86_64)|
|ar||51 & 50||P: 51 & 50||P: 51||P: 51 & 50|
|elfcopy||39||P: 39||P: 39||P: 39|
|elfdump||155||P: 155||P: 155||P: 155|
|libdwarf||133||P: 133||P: 133||P: 133|
|libelf||1024||P: 1020, U: 4||P: 1020, U: 4||P: 1020, U: 4|
* F: Test failures.
* P: Test successes.
* U: Unresolved tests.
arcontains one test that is applicable only on 32-bit systems.
The project's website is at http://elftoolchain.sourceforge.net/.
The source code for this software and for its associated documentation is open-source under the BSD license.
The project's developers may be contacted using the mailing list:
Please use our tracker instance for viewing existing bug reports and for submitting new bug reports.
This software is copyright its authors, and is distributed under the BSD License.
Archived test logs for the release are available: elftoolchain-test-logs-0.5.1.tgz.