binutils-gdb/gold
Cary Coutant c1027032c2 2012-03-21 Cary Coutant <ccoutant@google.com>
* Makefile.am: Add gdb-index.cc, gdb-index.h.
	* Makefile.in: Regenerate.
	* dwarf_reader.cc (Sized_elf_reloc_mapper::do_initialize): New function.
	(Sized_elf_reloc_mapper::symbol_section): New function.
	(Sized_elf_reloc_mapper::do_get_reloc_target): New function.
	(make_elf_reloc_mapper): New function.
	(Dwarf_abbrev_table::clear_abbrev_codes): New function.
	(Dwarf_abbrev_table::do_read_abbrevs): New function.
	(Dwarf_abbrev_table::do_get_abbrev): New function.
	(Dwarf_ranges_table::read_ranges_table): New function.
	(Dwarf_ranges_table::read_range_list): New function.
	(Dwarf_pubnames_table::read_section): New function.
	(Dwarf_pubnames_table::read_header): New function.
	(Dwarf_pubnames_table::next_name): New function.
	(Dwarf_die::Dwarf_die): New function.
	(Dwarf_die::read_attributes): New function.
	(Dwarf_die::skip_attributes): New function.
	(Dwarf_die::set_name): New function.
	(Dwarf_die::set_linkage_name): New function.
	(Dwarf_die::attribute): New function.
	(Dwarf_die::string_attribute): New function.
	(Dwarf_die::int_attribute): New function.
	(Dwarf_die::uint_attribute): New function.
	(Dwarf_die::ref_attribute): New function.
	(Dwarf_die::child_offset): New function.
	(Dwarf_die::sibling_offset): New function.
	(Dwarf_info_reader::check_buffer): New function.
	(Dwarf_info_reader::parse): New function.
	(Dwarf_info_reader::do_parse): New function.
	(Dwarf_info_reader::do_read_string_table): New function.
	(Dwarf_info_reader::lookup_reloc): New function.
	(Dwarf_info_reader::get_string): New function.
	(Dwarf_info_reader::visit_compilation_unit): New function.
	(Dwarf_info_reader::visit_type_unit): New function.
	(Sized_dwarf_line_info::Sized_dwarf_line_info): Use
	Sized_elf_reloc_mapper.
	(Sized_dwarf_line_info::symbol_section): Remove function.
	(Sized_dwarf_line_info::read_relocs): Use Sized_elf_reloc_mapper.
	(Sized_dwarf_line_info::read_line_mappings): Remove object
	parameter, adjust callers.
	(Sized_dwarf_line_info::format_file_lineno): Fix type of cast.
	* dwarf_reader.h: Include <sys/types.h>.
	(class Track_relocs): Remove forward declaration.
	(class Elf_reloc_mapper): New class.
	(class Sized_elf_reloc_mapper): New class.
	(class Dwarf_abbrev_table): New class.
	(class Dwarf_range_list): New class.
	(class Dwarf_ranges_table): New class.
	(class Dwarf_pubnames_table): New class.
	(class Dwarf_die): New class.
	(class Dwarf_info_reader): New class.
	(Sized_dwarf_line_info::read_line_mappings): Remove object parameter.
	(Sized_dwarf_line_info::symbol_section): Remove member function.
	* dynobj.h (Sized_dynobj::do_section_contents): Refactor code from
	base class.
	* gdb-index.cc: New source file.
	* gdb-index.h: New source file.
	* incremental.cc (Sized_relobj_incr::do_layout): Track .debug_info
	and .debug_types sections, call Layout::add_to_gdb_index.
	(Sized_relobj_incr::do_section_name): Implement.
	(Sized_relobj_incr::do_section_contents): Adjust parameter list and
	return type; Implement.
	(Sized_incr_dynobj::do_section_contents): Adjust parameter list and
	return type.
	* incremental.h (Sized_relobj_incr::do_section_contents): Adjust
	parameter list and return type.
	(Sized_incr_dynobj::do_section_contents): Likewise.
	* layout.cc: Include gdb-index.h.
	(Layout::Layout): Initialize gdb_index_data_.
	(Layout::init_fixed_output_section): Check for .gdb_index section.
	(Layout::add_to_gdb_index): New function. Instantiate.
	* layout.h: Add forward declaration for class Gdb_index.
	(Layout::add_to_gdb_index): New member function.
	(Layout::gdb_index_data_): New data member.
	* main.cc: Include gdb-index.h.
	(main): Print statistics for gdb index.
	* object.cc (Object::section_contents): Move code into
	do_section_contents.
	(need_decompressed_section): Check for sections needed when building
	gdb index.
	(build_compressed_section_map): Likewise.
	(Sized_relobj_file::do_read_symbols): Need local symbols when building
	gdb index.
	(Sized_relobj_file::do_layout): Track .debug_info and .debug_types
	sections; call Layout::add_to_gdb_index.
	(Sized_relobj_file::do_decompressed_section_contents): Call
	do_section_contents directly.
	* object.h (Object::do_section_contents): Adjust parameter list and
	return type.
	(Object::do_decompressed_section_contents): Call do_section_contents
	directly.
	(Sized_relobj_file::do_section_contents): Adjust parameter list and
	return type.
	* options.h (class General_options): Add --gdb-index option.
	* plugin.cc (Sized_pluginobj::do_section_contents): Adjust parameter
	list and return type.
	* plugin.h (Sized_pluginobj::do_section_contents): Likewise.
	* reloc.h (Track_relocs::checkpoint): New function.
	(Track_relocs::reset): New function.

	* testsuite/Makefile.am (gdb_index_test_1.sh, gdb_index_test_2.sh):
	New test cases.
	* testsuite/Makefile.in: Regenerate.
	* testsuite/gdb_index_test.cc: New test source file.
	* testsuite/gdb_index_test_1.sh: New test source file.
	* testsuite/gdb_index_test_2.sh: New test source file.
2012-03-21 19:02:22 +00:00
..
po * po/it.po: New Italian translation. 2011-11-25 09:15:26 +00:00
testsuite 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
aclocal.m4
archive.cc 2011-07-13 Sriraman Tallam <tmsriram@google.com> 2011-07-14 00:55:18 +00:00
archive.h
arm-reloc-property.cc
arm-reloc-property.h
arm-reloc.def
arm.cc 2012-03-19 Doug Kwan <dougkwan@google.com> 2012-03-19 23:54:07 +00:00
attributes.cc
attributes.h
binary.cc
binary.h
ChangeLog 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
common.cc
common.h
compressed_output.cc
compressed_output.h
config.in * configure.ac: Add --with-lib-path option. Define LIB_PATH and 2011-11-03 04:32:01 +00:00
configure Check if -fpic -mtls-dialect=gnu2 works 2012-01-30 21:13:30 +00:00
configure.ac Check if -fpic -mtls-dialect=gnu2 works 2012-01-30 21:13:30 +00:00
configure.tgt
copy-relocs.cc * object.h (Relobj::local_symbol_value): New function. 2011-12-19 21:07:16 +00:00
copy-relocs.h
cref.cc
cref.h
debug.h
defstd.cc
defstd.h
descriptors.cc
descriptors.h
dirsearch.cc 2011-11-17 Sterling Augustine <saugustine@google.com> 2011-11-17 17:46:54 +00:00
dirsearch.h 2011-11-17 Sterling Augustine <saugustine@google.com> 2011-11-17 17:46:54 +00:00
dwarf_reader.cc 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
dwarf_reader.h 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
dynobj.cc
dynobj.h 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
ehframe.cc
ehframe.h
errors.cc
errors.h
expression.cc * object.h (Relobj::local_symbol_value): New function. 2011-12-19 21:07:16 +00:00
ffsll.c
fileread.cc PR gold/13288 2011-10-17 23:36:43 +00:00
fileread.h
freebsd.h * options.h (class General_options): Add --print-output-format. 2011-07-15 21:43:08 +00:00
ftruncate.c
gc.cc
gc.h
gdb-index.cc 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
gdb-index.h 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
gold-threads.cc
gold-threads.h
gold.cc 2012-03-19 Doug Kwan <dougkwan@google.com> 2012-03-19 23:54:07 +00:00
gold.h
i386.cc PR gold/13617 2012-01-24 06:21:11 +00:00
icf.cc
icf.h
incremental-dump.cc
incremental.cc 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
incremental.h 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
int_encoding.cc * int_encoding.cc (read_unsigned_LEB_128): Replaced with inline 2012-01-25 07:34:55 +00:00
int_encoding.h * int_encoding.cc (read_unsigned_LEB_128): Replaced with inline 2012-01-25 07:34:55 +00:00
layout.cc 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
layout.h 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
main.cc 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
Makefile.am 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
Makefile.in 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
mapfile.cc
mapfile.h
merge.cc * dwarf_reader.cc (Sized_dwarf_line_info::Sized_dwarf_line_info): 2012-02-29 21:22:29 +00:00
merge.h
mremap.c
NEWS
object.cc 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
object.h 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
options.cc * options.cc (General_options::finalize): Disallow -pie and -static. 2012-02-15 00:56:16 +00:00
options.h 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
output.cc * gold/incremental.cc (Sized_incremental_binary::do_process_got_plt): 2012-01-04 00:18:23 +00:00
output.h * gold/incremental.cc (Sized_incremental_binary::do_process_got_plt): 2012-01-04 00:18:23 +00:00
parameters.cc * gold.cc: Include timer.h. 2011-10-18 00:06:10 +00:00
parameters.h * gold.cc: Include timer.h. 2011-10-18 00:06:10 +00:00
plugin.cc 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
plugin.h 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
powerpc.cc * object.h (Relobj::local_symbol_value): New function. 2011-12-19 21:07:16 +00:00
pread.c
README
readsyms.cc * dwarf_reader.cc (Sized_dwarf_line_info::Sized_dwarf_line_info): 2012-02-29 21:22:29 +00:00
readsyms.h
reduced_debug_output.cc elfcpp/ 2012-03-13 00:13:08 +00:00
reduced_debug_output.h
reloc-types.h
reloc.cc
reloc.h 2012-03-21 Cary Coutant <ccoutant@google.com> 2012-03-21 19:02:22 +00:00
resolve.cc * resolve.cc (Symbol_table::resolve): When merging common symbols, 2012-03-13 16:08:53 +00:00
script-c.h
script-sections.cc PR gold/13023 2011-10-31 22:51:03 +00:00
script-sections.h
script.cc 2011-11-17 Sterling Augustine <saugustine@google.com> 2011-11-17 17:46:54 +00:00
script.h PR gold/13023 2011-10-31 22:51:03 +00:00
sparc.cc * object.h (Relobj::local_symbol_value): New function. 2011-12-19 21:07:16 +00:00
stringpool.cc
stringpool.h
symtab.cc * options.h (class General_options): Add --[no-]gnu-unique options. 2011-10-31 22:43:49 +00:00
symtab.h 2011-10-31 Sriraman Tallam <tmsriram@google.com> 2011-10-31 21:36:54 +00:00
target-reloc.h Replace <64, false> with <size, big_endian> 2011-12-15 23:29:24 +00:00
target-select.cc * options.h (class General_options): Add --print-output-format. 2011-07-15 21:43:08 +00:00
target-select.h * options.h (class General_options): Add --print-output-format. 2011-07-15 21:43:08 +00:00
target.cc * layout.cc (Layout::set_segment_offsets): Don't realign text 2011-08-01 18:25:22 +00:00
target.h 2012-03-19 Doug Kwan <dougkwan@google.com> 2012-03-19 23:54:07 +00:00
timer.cc * gold.cc: Include timer.h. 2011-10-18 00:06:10 +00:00
timer.h * gold.cc: Include timer.h. 2011-10-18 00:06:10 +00:00
tls.h
TODO
token.h
version.cc
workqueue-internal.h * workqueue-internal.h (Workqueue_threader::should_cancel_thread): 2011-07-28 23:25:06 +00:00
workqueue-threads.cc * workqueue-internal.h (Workqueue_threader::should_cancel_thread): 2011-07-28 23:25:06 +00:00
workqueue.cc * workqueue-internal.h (Workqueue_threader::should_cancel_thread): 2011-07-28 23:25:06 +00:00
workqueue.h * workqueue-internal.h (Workqueue_threader::should_cancel_thread): 2011-07-28 23:25:06 +00:00
x86_64.cc Support x32 GD->IE and GD->LE optimizations 2012-01-27 23:29:54 +00:00
yyscript.y 2011-11-11 Sterling Augustine <saugustine@google.com> 2011-11-11 22:29:43 +00:00

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++/17_intro/C++STYLE
    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.