H.J. Lu 0fd153457c Feed right input object to x86_64_mov_to_lea1[12] vor 9 Jahren
..
po 1e1b2efc46 Update French Translations for LD and GOLD. vor 9 Jahren
testsuite 0fd153457c Feed right input object to x86_64_mov_to_lea1[12] vor 9 Jahren
ChangeLog 0fd153457c Feed right input object to x86_64_mov_to_lea1[12] vor 9 Jahren
Makefile.am bdd2d2b7e6 Add diststuff target to Makefile. vor 9 Jahren
Makefile.in bdd2d2b7e6 Add diststuff target to Makefile. vor 9 Jahren
NEWS b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
README b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
TODO 70752818b0 * TODO: New file. vor 16 Jahren
aarch64-reloc-property.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
aarch64-reloc-property.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
aarch64-reloc.def 6b0ad2ebf6 Support AARCH64_TLSLD_ADD_DTPREL_* relocations. vor 9 Jahren
aarch64.cc 3b0357dada gold: fix ABI pagesize for aarch64 vor 9 Jahren
aclocal.m4 ae2eea65c6 * configure.ac (HAVE_ZLIB): Use AM_ZLIB instead of AC_SEARCH_LIBS. vor 12 Jahren
archive.cc cb5cf5e26e Fix internal error when linking an archive library with no preceding objects. vor 9 Jahren
archive.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
arm-reloc-property.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
arm-reloc-property.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
arm-reloc.def b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
arm.cc cdb061674c 2015-07-23 Ian Coolidge <icoolidge@google.com> vor 9 Jahren
attributes.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
attributes.h 5b07cd848d Fix an internal error in do_print_to_mapfile on Arm. vor 9 Jahren
binary.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
binary.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
common.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
common.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
compressed_output.cc 19a7fe52ae Make default compression gABI compliant vor 9 Jahren
compressed_output.h 480586639d Add SHF_COMPRESSED section decompression to gold vor 9 Jahren
config.in 918357b955 Regenerate configure in gold vor 9 Jahren
configure 37a42ee9ad Regenerate configure files vor 9 Jahren
configure.ac 918357b955 Regenerate configure in gold vor 9 Jahren
configure.tgt b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
copy-relocs.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
copy-relocs.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
cref.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
cref.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
debug.h 437ddf0c4c Improve ODR checking in gold. vor 9 Jahren
defstd.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
defstd.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
descriptors.cc 8265ef9502 Add extra debugging output for files and descriptors. vor 9 Jahren
descriptors.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
dirsearch.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
dirsearch.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
dwarf_reader.cc 437ddf0c4c Improve ODR checking in gold. vor 9 Jahren
dwarf_reader.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
dwp.cc 0d5bbdb0e1 Support compressed debug sections in dynamic object files. vor 9 Jahren
dwp.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
dynobj.cc b45e00b3ed Fix symbol versioning problems in PR 18703. vor 9 Jahren
dynobj.h 480586639d Add SHF_COMPRESSED section decompression to gold vor 9 Jahren
ehframe.cc e16631979e Fix failure in exception_static_test. vor 9 Jahren
ehframe.h e16631979e Fix failure in exception_static_test. vor 9 Jahren
errors.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
errors.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
expression.cc 1757d35c8a Fix internal error in gold when script uses section address in assignment. vor 9 Jahren
ffsll.c b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
fileread.cc 8265ef9502 Add extra debugging output for files and descriptors. vor 9 Jahren
fileread.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
freebsd.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
ftruncate.c b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
gc.cc 4277535cdc Use LIFO instead of FIFO to implement gc's transitive closure. vor 9 Jahren
gc.h efc6fa128f Change Section_id type to use Relobj* instead of Object*. vor 9 Jahren
gdb-index.cc 2d9afefe22 [gold] Recognize DWARF5/GCC5 DW_LANG_Fortran03 and DW_LANG_Fortran08. vor 9 Jahren
gdb-index.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
gold-threads.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
gold-threads.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
gold.cc 9c7fe3c5c2 PR 17819: Fix --build-id=tree when using --compress-debug-sections. vor 9 Jahren
gold.h 970cdef261 [GOLD] Fix handling of __start/__stop symbols vor 9 Jahren
i386.cc 01f573ad8a Add EM_IAMCU support to gold vor 9 Jahren
icf.cc efc6fa128f Change Section_id type to use Relobj* instead of Object*. vor 9 Jahren
icf.h efc6fa128f Change Section_id type to use Relobj* instead of Object*. vor 9 Jahren
incremental-dump.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
incremental.cc 0ed4b0bf3d Remove redundant include of "output.h". vor 9 Jahren
incremental.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
int_encoding.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
int_encoding.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
layout.cc f54f5e31ce Clear SHF_COMPRESSED flag bit from input to output vor 9 Jahren
layout.h dd68f8fa8e Fix bug where SECTIONS clause does not handle compressed debug sections. vor 9 Jahren
main.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
mapfile.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
mapfile.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
merge.cc 400f89447b Use a std::vector instead of a std::map to hold Input_merge_map. vor 9 Jahren
merge.h 400f89447b Use a std::vector instead of a std::map to hold Input_merge_map. vor 9 Jahren
mips.cc 40fc1451c6 [MIPS] Map 'move' to 'or'. vor 9 Jahren
mremap.c b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
nacl.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
nacl.h 775ed62ec5 Fix Sniff_file to get an aligned view. vor 9 Jahren
object.cc 4bfacfd359 Fix --no-as-needed when shared library is listed twice on the command line. vor 9 Jahren
object.h 4bfacfd359 Fix --no-as-needed when shared library is listed twice on the command line. vor 9 Jahren
options.cc cd3c333f43 Change default to discard temporary local symbols in merge sections. vor 9 Jahren
options.h 6457197210 Don't ignore "-m emulation" command line option vor 9 Jahren
output.cc efc6fa128f Change Section_id type to use Relobj* instead of Object*. vor 9 Jahren
output.h fb8b9dbc14 Extend --compress-debug-sections in gold vor 9 Jahren
parameters.cc 6457197210 Don't ignore "-m emulation" command line option vor 9 Jahren
parameters.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
plugin.cc efc6fa128f Change Section_id type to use Relobj* instead of Object*. vor 9 Jahren
plugin.h 480586639d Add SHF_COMPRESSED section decompression to gold vor 9 Jahren
powerpc.cc d49044c753 [GOLD] ppc64 out-of-line register save/restore functions vor 9 Jahren
pread.c b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
readsyms.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
readsyms.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
reduced_debug_output.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
reduced_debug_output.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
reloc-types.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
reloc.cc 480586639d Add SHF_COMPRESSED section decompression to gold vor 9 Jahren
reloc.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
resolve.cc 3d4fde6974 Fix internal error caused by IFUNC patch. vor 9 Jahren
script-c.h 410da591ba PR gold/18048: Fix INCLUDE directive support for gold vor 9 Jahren
script-sections.cc 7c61d651fd Fix problem where script specified both address and region for a section. vor 9 Jahren
script-sections.h 7c61d651fd Fix problem where script specified both address and region for a section. vor 9 Jahren
script.cc 1757d35c8a Fix internal error in gold when script uses section address in assignment. vor 9 Jahren
script.h 1757d35c8a Fix internal error in gold when script uses section address in assignment. vor 9 Jahren
sparc.cc 9eacb935ac Fix bug when applying R_SPARC_GOTDATA_OP* relocations to local symbols. vor 9 Jahren
stringpool.cc 1c582fe718 Fix bug when optimizing string pools of aligned strings. vor 9 Jahren
stringpool.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
symtab.cc 3d4fde6974 Fix internal error caused by IFUNC patch. vor 9 Jahren
symtab.h b45e00b3ed Fix symbol versioning problems in PR 18703. vor 9 Jahren
system.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
target-reloc.h 9215b98bb2 gold --emit-relocs vor 9 Jahren
target-select.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
target-select.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
target.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
target.h efc6fa128f Change Section_id type to use Relobj* instead of Object*. vor 9 Jahren
tilegx.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
timer.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
timer.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
tls.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
token.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
version.cc af759df025 Correct printed year in copyright notices for gold. vor 10 Jahren
workqueue-internal.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
workqueue-threads.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
workqueue.cc b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
workqueue.h b90efa5b79 ChangeLog rotatation and copyright year update vor 10 Jahren
x86_64.cc 1fa29f1060 [Gold,x86_64] Convert mov foo@GOTPCREL(%rip), %reg to lea foo(%rip), %reg vor 9 Jahren
yyscript.y 410da591ba PR gold/18048: Fix INCLUDE directive support for gold vor 9 Jahren

README

gold is an ELF linker. It is intended to have complete support for
ELF and to run as fast as possible on modern systems. For normal use
it is a drop-in replacement for the older GNU linker.

gold is part of the GNU binutils. See ../binutils/README for more
general notes, including where to send bug reports.

gold was originally developed at Google, and was contributed to the
Free Software Foundation in March 2008. At Google it was designed by
Ian Lance Taylor, with major contributions by Cary Coutant, Craig
Silverstein, and Andrew Chatham.

The existing GNU linker manual is intended to be accurate
documentation for features which gold supports. gold supports most of
the features of the GNU linker for ELF targets. Notable
omissions--features of the GNU linker not currently supported in
gold--are:
* MRI compatible linker scripts
* cross-reference reports (--cref)
* various other minor options


Notes on the code
=================

These are some notes which may be helpful to people working on the
source code of gold itself.

gold is written in C++. It is a GNU program, and therefore follows
the GNU formatting standards as modified for C++. Source documents in
order of decreasing precedence:
http://www.gnu.org/prep/standards/
http://gcc.gnu.org/onlinedocs/libstdc++/manual/source_code_style.html
http://www.zembu.com/eng/procs/c++style.html

The linker is intended to have complete support for cross-compilation,
while still supporting the normal case of native linking as fast as
possible. In order to do this, many classes are actually templates
whose parameter is the ELF file class (e.g., 32 bits or 64 bits). The
C++ code is the same, but we don't pay the execution time cost of
always using 64-bit integers if the target is 32 bits. Many of these
class templates also have an endianness parameter: true for
big-endian, false for little-endian.

The linker is multi-threaded. The Task class represents a single unit
of work. Task objects are stored on a single Workqueue object. Tasks
communicate via Task_token objects. Task_token objects are only
manipulated while holding the master Workqueue lock. Relatively few
mutexes are used.


Build requirements
==================

The gold source code uses templates heavily. Building it requires a
recent version of g++. g++ 4.0.3 and 4.1.3 are known to work. g++
3.2, 3.4.3, and 4.1.2 are known to fail.

The linker script parser uses features which are only in newer
versions of bison. bison 2.3 is known to work. bison 1.26 is known
to fail. If you are building gold from an official binutils release,
the bison output should already be included.


Copyright (C) 2012-2015 Free Software Foundation, Inc.

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.