darling-gdb/gold
Ian Lance Taylor 15f8229bbf * readsyms.cc (Read_symbols::incompatible_warning): New function.
(Read_symbols::requeue): New function.
	(Read_symbols::do_read_symbols): If make_elf_object fails because
	the target type is not configured, and the file was searched for,
	issue a warning and retry with the next directory.
	(Add_symbols::run): If the file has an incompatible format, and
	it was searched for, requeue the Read_symbols task.  On error,
	release the object.
	* readsyms.h (class Read_symbols): Add dirindex_ field.  Add
	dirindex parameter to constructor.  Change all callers.  Declare
	incompatible_warning and requeue.
	(class Add_symbols): Add dirpath_, dirindex_, mapfile_,
	input_argument_ and input_group_ fields.  Add them to
	constructor.  Change all callers.
	(class Read_script): Add dirindex_ field.  Add it to constructor.
	Change all callers.
	* archive.cc (Archive::setup): Remove input_objects parameter.
	Change all callers.
	(Archive::get_file_and_offset): Likewise.
	(Archive::read_all_symbols): Likewise.
	(Archive::read_symbols): Likewise.
	(Archive::get_elf_object_for_member): Remove input_objects
	parameter.  Add punconfigured parameter.  Change all callers.
	(Archive::add_symbols): Change return type to bool.  Check return
	value of include_member.
	(Archive::include_all_members): Likewise.
	(Archive::include_member): Change return type to bool.  Return
	false if first included object has incompatible target.  Set
	included_member_ field.
	(Add_archive_symbols::run): If add_symbols returns false, requeue
	Read_symbols task.
	* archive.h (class Archive): Add included_member_ field.
	Initialize it in constructor.  Add input_file and searched_for
	methods.  Update declarations.
	(class Add_archive_symbols): Add dirpath_, dirindex_, and
	input_argument_ fields.  Add them to constructor.  Change all
	callers.
	* script.cc: Include "target-select.h".
	(class Parser_closure): Add skip_on_incompatible_target_ and
	found_incompatible_target_ fields.  Add
	skip_on_incompatible_target parameter to constructor.  Change all
	callers.  Add methods skip_on_incompatible_target,
	clear_skip_on_incompatible_target, found_incompatible_target, and
	set_found_incompatible_target.
	(read_input_script): Add dirindex parameter.  Change all callers.
	If parser finds an incompatible target, requeue Read_symbols
	task.
	(script_set_symbol): Clear skip_on_incompatible_target in
	closure.
	(script_add_assertion, script_parse_option): Likewise.
	(script_start_sections, script_add_phdr): Likewise.
	(script_check_output_format): New function.
	* script.h (read_input_script): Update declaration.
	* script-c.h (script_check_output_format): Declare.
	* yyscript.y (file_cmd): Handle OUTPUT_FORMAT.
	(ignore_cmd): Remove OUTPUT_FORMAT.
	* fileread.cc (Input_file::Input_file): Add explicit this.
	(Input_file::will_search_for): New function.
	(Input_file::open): Add pindex parameter.  Change all callers.
	* fileread.h (class Input_file): Add input_file_argument method.
	Declare will_search_for.  Update declarations.
	* object.cc (make_elf_object): Add punconfigured parameter.
	Change all callers.
	* object.h (class Object): Make input_file public.  Add
	searched_for method.
	(make_elf_object): Update declaration.
	* dirsearch.cc (Dirsearch::find): Add pindex parameter.  Use it to
	restart search.
	* dirsearch.h (class Dirsearch): Update declaration.
	* options.h (class General_options): Add --warn-search-mismatch.
	* parameters.cc (Parameters::is_compatible_target): New function.
	* parameters.h (class Parameters): Declare is_compatible_target.
	* workqueue.cc (Workqueue::add_blocker): New function.
	* workqueue.h (class Workqueue): Declare add_blocker.
2009-03-14 05:56:46 +00:00
..
po Add Spanish translation to gold. 2009-03-10 09:21:01 +00:00
testsuite * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
aclocal.m4
archive.cc * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
archive.h * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
binary.cc * binary.cc: Fix file comment. 2009-02-07 01:03:32 +00:00
binary.h
ChangeLog * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
common.cc
common.h
compressed_output.cc
compressed_output.h
config.in elfcpp:/ 2009-03-02 02:45:29 +00:00
configure elfcpp:/ 2009-03-02 02:45:29 +00:00
configure.ac elfcpp:/ 2009-03-02 02:45:29 +00:00
configure.tgt
copy-relocs.cc
copy-relocs.h
cref.cc
cref.h
debug.h
defstd.cc
defstd.h
descriptors.cc PR 5990 2009-02-28 03:05:08 +00:00
descriptors.h PR 5990 2009-02-28 03:05:08 +00:00
dirsearch.cc * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
dirsearch.h * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
dwarf_reader.cc
dwarf_reader.h
dynobj.cc (From Rafael Espindola) 2009-02-13 19:04:45 +00:00
dynobj.h (From Rafael Espindola) 2009-02-13 19:04:45 +00:00
ehframe.cc
ehframe.h
errors.cc 2009-02-06 Chris Demetriou <cgd@google.com> 2009-02-06 19:20:10 +00:00
errors.h 2009-02-06 Chris Demetriou <cgd@google.com> 2009-02-06 19:20:10 +00:00
expression.cc
fileread.cc * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
fileread.h * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
gc.cc
gc.h
gold-threads.cc
gold-threads.h
gold.cc * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
gold.h 2009-02-06 Chris Demetriou <cgd@google.com> 2009-02-06 19:20:10 +00:00
i386.cc PR 9918 2009-03-04 06:46:27 +00:00
layout.cc * layout.cc (Layout::find_or_add_kept_section): New function. 2009-03-01 22:22:02 +00:00
layout.h * layout.cc (Layout::find_or_add_kept_section): New function. 2009-03-01 22:22:02 +00:00
main.cc
Makefile.am
Makefile.in * layout.cc (Layout::choose_output_section): Don't rename sections 2009-02-25 19:05:21 +00:00
mapfile.cc
mapfile.h
merge.cc
merge.h
NEWS
object.cc * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
object.h * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
options.cc * options.cc (parse_short_option): Keep dash_z from registering itself. 2009-03-06 23:12:37 +00:00
options.h * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
output.cc PR 7091 2009-02-28 00:12:26 +00:00
output.h PR 7091 2009-02-28 00:12:26 +00:00
parameters.cc * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
parameters.h * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
plugin.cc * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
plugin.h (From Rafael Espindola) 2009-02-13 19:04:45 +00:00
powerpc.cc PR 9918 2009-03-04 06:46:27 +00:00
pread.c
README * README: --gc-sections and map files are now supported. Document 2009-02-28 18:08:30 +00:00
readsyms.cc * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
readsyms.h * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
reduced_debug_output.cc
reduced_debug_output.h PR 9812 2009-02-04 15:18:51 +00:00
reloc-types.h
reloc.cc PR 9918 2009-03-04 06:46:27 +00:00
reloc.h
resolve.cc PR 9836 2009-02-27 19:57:46 +00:00
script-c.h * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
script-sections.cc
script-sections.h
script.cc * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
script.h * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
sparc.cc PR 9918 2009-03-04 06:46:27 +00:00
stringpool.cc
stringpool.h
symtab.cc PR 6992 2009-02-28 17:53:16 +00:00
symtab.h PR 6811 2009-02-28 04:39:57 +00:00
target-reloc.h PR 9918 2009-03-04 06:46:27 +00:00
target-select.cc
target-select.h
target.h
tls.h
TODO
token.h
version.cc
workqueue-internal.h
workqueue-threads.cc
workqueue.cc * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
workqueue.h * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +00:00
x86_64.cc PR 9918 2009-03-04 06:46:27 +00:00
yyscript.y * readsyms.cc (Read_symbols::incompatible_warning): New function. 2009-03-14 05:56:46 +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:
  * MEMORY regions in linker scripts
  * MRI compatible linker scripts
  * cross-reference reports (--cref)
  * position independent executables (-pie)
  * 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 is known to work.  g++ 3.2 and g++
3.4.3 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.