Name
Date
Size
#Lines
LOC

..--

common/H--3,1832,585

libelf/H--10,5316,535

READMEH A D02-Nov-20153.6 KiB12886

README.DELETEDH A D02-Nov-20151.3 KiB7978

README.DRAGONFLYH A D02-Nov-2015406 1510

RELEASE-NOTESH A D02-Nov-20156.2 KiB207152

REVISIONH A D02-Nov-201569 32

README

1The Elftoolchain Project
2========================
3
4.. contents::
5..
6
7Description
8-----------
9
10This software implements essential compilation tools and libraries for:
11
12- managing program objects conforming to the ELF_ object format, and
13- for managing DWARF_ debugging information in ELF objects.
14
15The project currently implements the following utilities and
16libraries:
17
18    =========== ============================================
19    Name        Description
20    =========== ============================================
21    ar          Archive manager.
22    addr2line   Debug tool.
23    brandelf    Manage the ELF brand on executables.
24    c++filt     Translate encoded symbols.
25    elfcopy     Copy and translate between object formats.
26    elfdump     Diagnostic tool.
27    findtextrel Find undesired text relocations.
28    libdwarf    DWARF access library.
29    libelf      ELF access library.
30    mcs         Manage comment sections.
31    nm          List symbols in an ELF object.
32    ranlib      Add archive symbol tables to an archive.
33    readelf     Display ELF information.
34    size        List object sizes.
35    strings     Extract printable strings.
36    strip       Discard information from ELF objects.
37    =========== ============================================
38
39.. _ELF: http://en.wikipedia.org/wiki/Executable_and_Linkable_Format
40.. _DWARF: http://www.dwarfstd.org/
41
42
43Project Documentation
44---------------------
45
46- Release notes for released versions of this software are present in
47  the file ``RELEASE-NOTES`` in the current directory.
48- The file ``INSTALL`` in the current directory contains instructions
49  on building and installing this software.
50- Reference documentation in the form of manual pages is provided for
51  the utilities and libraries developed by the project.
52- Additional tutorial documentation is present in the
53  ``documentation`` directory.
54
55
56Tracking Ongoing Development
57----------------------------
58
59The project uses subversion_ for its version control system.
60
61The subversion branch for the current set of sources may be accessed
62at the following URL:
63
64  https://elftoolchain.svn.sourceforge.net/svnroot/elftoolchain/trunk
65
66The project's source tree may be checked out from its repository by
67using the ``svn checkout`` command::
68
69    % svn checkout https://elftoolchain.svn.sourceforge.net/svnroot/elftoolchain/trunk
70
71Checked-out sources may be kept upto-date by running ``svn update``
72inside the source directory::
73
74   % svn update
75
76
77Instructions on building and installing the software are given in the
78file ``INSTALL`` in the current directory.
79
80.. _Subversion:
81
82Downloading Released Software
83-----------------------------
84
85Released versions of the project's software may also be downloaded
86from SourceForge's `file release system`_.
87
88.. _file release system: http://sourceforge.net/projects/elftoolchain/files/
89
90Copyright and License
91---------------------
92
93This code is copyright its authors, and is distributed under the `BSD
94License`_.
95
96.. _BSD License: http://www.opensource.org/licenses/bsd-license.php
97
98
99Developer Community
100-------------------
101
102The project's developers may be contacted using the mailing list:
103``<elftoolchain-developers@lists.sourceforge.net>``.
104
105
106Reporting Bugs
107--------------
108
109Please use our `Trac instance`_ for viewing existing bug reports and
110for submitting new bug reports.
111
112.. _`Trac instance`: http://sourceforge.net/apps/trac/elftoolchain/report
113
114
115Additional Information
116----------------------
117
118Additional information about the project may be found on the `project
119website`_.
120
121.. _project website:  http://elftoolchain.sourceforge.net/
122
123.. $Id: README 2146 2011-11-11 09:39:00Z jkoshy $
124
125.. Local Variables:
126.. mode: rst
127.. End:
128

README.DELETED

1GNUmakefile
2INSTALL
3Makefile
4addr2line/
5ar/
6as/
7brandelf/
8common/Makefile
9common/native-elf-format
10common/os.Linux.mk
11common/utarray.h
12common/uthash.h
13cxxfilt/
14documentation/
15elfcopy/
16elfdump/
17findtextrel/
18isa/
19ld/
20libdwarf/
21libelf/elf.3
22libelf/elf_begin.3
23libelf/elf_cntl.3
24libelf/elf_end.3
25libelf/elf_errmsg.3
26libelf/elf_fill.3
27libelf/elf_flagdata.3
28libelf/elf_getarhdr.3
29libelf/elf_getarsym.3
30libelf/elf_getbase.3
31libelf/elf_getdata.3
32libelf/elf_getident.3
33libelf/elf_getphdrnum.3
34libelf/elf_getphnum.3
35libelf/elf_getscn.3
36libelf/elf_getshdrnum.3
37libelf/elf_getshdrstrndx.3
38libelf/elf_getshnum.3
39libelf/elf_getshstrndx.3
40libelf/elf_hash.3
41libelf/elf_kind.3
42libelf/elf_memory.3
43libelf/elf_next.3
44libelf/elf_open.3
45libelf/elf_rand.3
46libelf/elf_rawfile.3
47libelf/elf_strptr.3
48libelf/elf_update.3
49libelf/elf_version.3
50libelf/gelf.3
51libelf/gelf_checksum.3
52libelf/gelf_fsize.3
53libelf/gelf_getcap.3
54libelf/gelf_getclass.3
55libelf/gelf_getdyn.3
56libelf/gelf_getehdr.3
57libelf/gelf_getmove.3
58libelf/gelf_getphdr.3
59libelf/gelf_getrel.3
60libelf/gelf_getrela.3
61libelf/gelf_getshdr.3
62libelf/gelf_getsym.3
63libelf/gelf_getsyminfo.3
64libelf/gelf_getsymshndx.3
65libelf/gelf_newehdr.3
66libelf/gelf_newphdr.3
67libelf/gelf_update_ehdr.3
68libelf/gelf_xlatetof.3
69libelf/os.FreeBSD.mk
70libelf/os.NetBSD.mk
71libelftc/
72mk/
73nm/
74readelf/
75size/
76strings/
77test/
78tools/
79

README.DRAGONFLY

1ELF Tool Chain
2==============
3
4Original source can be checked out with subversion:
5svn co svn://svn.code.sf.net/p/elftoolchain/code/trunk elftoolchain
6
7rev  = 3255
8date = 28 Oct 2015
9
10A list of files and directories removed is in README.DELETED
11
12Currently only libelf is built and it is only used internally.
13In the future, the entire toolchain could be added, perhaps to
14replace one of the binutils sets.
15