2007-09-21 15:20:01 +08:00
|
|
|
// parameters.h -- general parameters for a link using gold -*- C++ -*-
|
|
|
|
|
2021-01-01 06:58:58 +08:00
|
|
|
// Copyright (C) 2006-2021 Free Software Foundation, Inc.
|
2007-09-23 05:02:10 +08:00
|
|
|
// Written by Ian Lance Taylor <iant@google.com>.
|
|
|
|
|
|
|
|
// This file is part of gold.
|
|
|
|
|
|
|
|
// This program is free software; you can redistribute it and/or modify
|
|
|
|
// it under the terms of the GNU General Public License as published by
|
|
|
|
// the Free Software Foundation; either version 3 of the License, or
|
|
|
|
// (at your option) any later version.
|
|
|
|
|
|
|
|
// This program is distributed in the hope that it will be useful,
|
|
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
// GNU General Public License for more details.
|
|
|
|
|
|
|
|
// You should have received a copy of the GNU General Public License
|
|
|
|
// along with this program; if not, write to the Free Software
|
|
|
|
// Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
|
|
|
|
// MA 02110-1301, USA.
|
|
|
|
|
2007-09-21 15:20:01 +08:00
|
|
|
#ifndef GOLD_PARAMETERS_H
|
|
|
|
#define GOLD_PARAMETERS_H
|
|
|
|
|
|
|
|
namespace gold
|
|
|
|
{
|
|
|
|
|
|
|
|
class General_options;
|
2007-10-14 14:49:14 +08:00
|
|
|
class Errors;
|
2011-10-18 08:06:10 +08:00
|
|
|
class Timer;
|
2007-12-01 14:34:12 +08:00
|
|
|
class Target;
|
2009-10-01 06:21:13 +08:00
|
|
|
template<int size, bool big_endian>
|
|
|
|
class Sized_target;
|
2010-02-12 11:23:26 +08:00
|
|
|
class Set_parameters_target_once;
|
2007-09-21 15:20:01 +08:00
|
|
|
|
|
|
|
// Here we define the Parameters class which simply holds simple
|
|
|
|
// general parameters which apply to the entire link. We use a global
|
2008-02-28 08:18:24 +08:00
|
|
|
// variable for this. The parameters class holds three types of data:
|
|
|
|
// 1) An Errors struct. Any part of the code that wants to log an
|
|
|
|
// error can use parameters->errors().
|
|
|
|
// 2) A const General_options. These are the options as read on
|
|
|
|
// the commandline.
|
|
|
|
// 3) Target information, such as size and endian-ness. This is
|
|
|
|
// available as soon as we've decided on the Target (after
|
|
|
|
// parsing the first .o file).
|
|
|
|
// 4) Whether we're doing a static link or not. This is set
|
|
|
|
// after all inputs have been read and we know if any is a
|
|
|
|
// dynamic library.
|
2007-09-21 15:20:01 +08:00
|
|
|
|
|
|
|
class Parameters
|
|
|
|
{
|
|
|
|
public:
|
2010-02-12 11:23:26 +08:00
|
|
|
Parameters();
|
2008-02-28 08:18:24 +08:00
|
|
|
|
|
|
|
// These should be called as soon as they are known.
|
|
|
|
void
|
|
|
|
set_errors(Errors* errors);
|
|
|
|
|
2011-10-18 08:06:10 +08:00
|
|
|
void
|
|
|
|
set_timer(Timer* timer);
|
|
|
|
|
2008-02-28 08:18:24 +08:00
|
|
|
void
|
|
|
|
set_options(const General_options* options);
|
|
|
|
|
|
|
|
void
|
2009-10-01 06:21:13 +08:00
|
|
|
set_target(Target* target);
|
2008-02-28 08:18:24 +08:00
|
|
|
|
|
|
|
void
|
|
|
|
set_doing_static_link(bool doing_static_link);
|
2007-10-14 14:49:14 +08:00
|
|
|
|
|
|
|
// Return the error object.
|
|
|
|
Errors*
|
|
|
|
errors() const
|
|
|
|
{ return this->errors_; }
|
|
|
|
|
2011-10-18 08:06:10 +08:00
|
|
|
// Return the timer object.
|
|
|
|
Timer*
|
|
|
|
timer() const
|
|
|
|
{ return this->timer_; }
|
|
|
|
|
2007-11-29 03:39:40 +08:00
|
|
|
// Whether the options are valid. This should not normally be
|
|
|
|
// called, but it is needed by gold_exit.
|
|
|
|
bool
|
|
|
|
options_valid() const
|
2008-02-28 08:18:24 +08:00
|
|
|
{ return this->options_ != NULL; }
|
2007-10-19 07:20:53 +08:00
|
|
|
|
2008-02-28 08:18:24 +08:00
|
|
|
// Return the options object.
|
|
|
|
const General_options&
|
|
|
|
options() const
|
2007-09-28 14:36:25 +08:00
|
|
|
{
|
2008-02-28 08:18:24 +08:00
|
|
|
gold_assert(this->options_valid());
|
|
|
|
return *this->options_;
|
2007-09-28 14:36:25 +08:00
|
|
|
}
|
|
|
|
|
2008-02-07 04:32:10 +08:00
|
|
|
// Return whether the target field has been set.
|
|
|
|
bool
|
2008-02-28 08:18:24 +08:00
|
|
|
target_valid() const
|
|
|
|
{ return this->target_ != NULL; }
|
2008-02-07 04:32:10 +08:00
|
|
|
|
2007-12-01 14:34:12 +08:00
|
|
|
// The target of the output file we are generating.
|
2008-02-28 08:18:24 +08:00
|
|
|
const Target&
|
2007-12-01 14:34:12 +08:00
|
|
|
target() const
|
|
|
|
{
|
2008-02-28 08:18:24 +08:00
|
|
|
gold_assert(this->target_valid());
|
|
|
|
return *this->target_;
|
2007-12-01 14:34:12 +08:00
|
|
|
}
|
|
|
|
|
2009-10-01 06:21:13 +08:00
|
|
|
// The Sized_target of the output file. The caller must request the
|
|
|
|
// right size and endianness.
|
|
|
|
template<int size, bool big_endian>
|
|
|
|
Sized_target<size, big_endian>*
|
|
|
|
sized_target() const
|
|
|
|
{
|
|
|
|
gold_assert(this->target_valid());
|
|
|
|
return static_cast<Sized_target<size, big_endian>*>(this->target_);
|
|
|
|
}
|
|
|
|
|
|
|
|
// Clear the target, for testing.
|
|
|
|
void
|
2010-02-12 11:23:26 +08:00
|
|
|
clear_target();
|
2007-09-26 15:01:35 +08:00
|
|
|
|
* 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 13:56:46 +08:00
|
|
|
// Return true if TARGET is compatible with the current target.
|
|
|
|
bool
|
|
|
|
is_compatible_target(const Target*) const;
|
|
|
|
|
2007-09-26 15:01:35 +08:00
|
|
|
bool
|
2008-02-28 08:18:24 +08:00
|
|
|
doing_static_link() const
|
2008-02-27 06:10:32 +08:00
|
|
|
{
|
2008-02-28 08:18:24 +08:00
|
|
|
gold_assert(this->doing_static_link_valid_);
|
|
|
|
return this->doing_static_link_;
|
2008-02-27 06:10:32 +08:00
|
|
|
}
|
|
|
|
|
2008-02-28 08:18:24 +08:00
|
|
|
// This is just a copy of options().debug(). We make a copy so we
|
|
|
|
// don't have to #include options.h in order to inline
|
|
|
|
// is_debugging_enabled, below.
|
|
|
|
int
|
|
|
|
debug() const
|
2008-02-27 06:10:32 +08:00
|
|
|
{
|
2008-03-13 09:46:17 +08:00
|
|
|
// This can be called before the options are set up.
|
|
|
|
if (!this->options_valid())
|
|
|
|
return 0;
|
2008-02-28 08:18:24 +08:00
|
|
|
return debug_;
|
2008-02-27 06:10:32 +08:00
|
|
|
}
|
|
|
|
|
2011-05-25 08:17:47 +08:00
|
|
|
// Return the name of the entry symbol.
|
|
|
|
const char*
|
|
|
|
entry() const;
|
|
|
|
|
2008-02-28 08:18:24 +08:00
|
|
|
// A convenience routine for combining size and endianness. It also
|
|
|
|
// checks the HAVE_TARGET_FOO configure options and dies if the
|
|
|
|
// current target's size/endianness is not supported according to
|
|
|
|
// HAVE_TARGET_FOO. Otherwise it returns this enum
|
|
|
|
enum Target_size_endianness
|
|
|
|
{ TARGET_32_LITTLE, TARGET_32_BIG, TARGET_64_LITTLE, TARGET_64_BIG };
|
2007-10-17 07:23:08 +08:00
|
|
|
|
2008-02-28 08:18:24 +08:00
|
|
|
Target_size_endianness
|
|
|
|
size_and_endianness() const;
|
2007-09-28 14:36:25 +08:00
|
|
|
|
2010-10-15 06:10:22 +08:00
|
|
|
// Set the incremental linking mode to INCREMENTAL_FULL. Used when
|
|
|
|
// the linker determines that an incremental update is not possible.
|
|
|
|
// Returns false if the incremental mode was INCREMENTAL_UPDATE,
|
|
|
|
// indicating that the linker should exit if an update is not possible.
|
|
|
|
bool
|
|
|
|
set_incremental_full();
|
|
|
|
|
|
|
|
// Return true if we need to prepare incremental linking information.
|
|
|
|
bool
|
|
|
|
incremental() const;
|
|
|
|
|
2011-07-07 05:19:32 +08:00
|
|
|
// Return true if we are doing a full incremental link.
|
|
|
|
bool
|
|
|
|
incremental_full() const;
|
|
|
|
|
2010-10-15 06:10:22 +08:00
|
|
|
// Return true if we are doing an incremental update.
|
|
|
|
bool
|
|
|
|
incremental_update() const;
|
2007-09-26 15:01:35 +08:00
|
|
|
|
2007-09-21 15:20:01 +08:00
|
|
|
private:
|
2010-02-12 11:23:26 +08:00
|
|
|
void
|
|
|
|
set_target_once(Target*);
|
|
|
|
|
2010-04-08 05:42:22 +08:00
|
|
|
void
|
|
|
|
check_target_endianness();
|
|
|
|
|
2013-07-20 07:07:08 +08:00
|
|
|
void
|
|
|
|
check_rodata_segment();
|
|
|
|
|
2010-02-12 11:23:26 +08:00
|
|
|
friend class Set_parameters_target_once;
|
|
|
|
|
2007-10-14 14:49:14 +08:00
|
|
|
Errors* errors_;
|
2011-10-18 08:06:10 +08:00
|
|
|
Timer* timer_;
|
2008-02-28 08:18:24 +08:00
|
|
|
const General_options* options_;
|
2009-10-01 06:21:13 +08:00
|
|
|
Target* target_;
|
2008-02-28 08:18:24 +08:00
|
|
|
bool doing_static_link_valid_;
|
2007-09-28 14:36:25 +08:00
|
|
|
bool doing_static_link_;
|
2008-02-28 08:18:24 +08:00
|
|
|
int debug_;
|
2010-10-15 06:10:22 +08:00
|
|
|
int incremental_mode_;
|
2010-02-12 11:23:26 +08:00
|
|
|
Set_parameters_target_once* set_parameters_target_once_;
|
2007-09-21 15:20:01 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
// This is a global variable.
|
|
|
|
extern const Parameters* parameters;
|
|
|
|
|
2008-02-28 08:18:24 +08:00
|
|
|
// We use free functions for these since they affect a global variable
|
|
|
|
// that is internal to parameters.cc.
|
2007-10-27 08:29:34 +08:00
|
|
|
|
2008-02-28 08:18:24 +08:00
|
|
|
extern void
|
|
|
|
set_parameters_errors(Errors* errors);
|
2007-09-21 15:20:01 +08:00
|
|
|
|
2011-10-18 08:06:10 +08:00
|
|
|
extern void
|
|
|
|
set_parameters_timer(Timer* timer);
|
|
|
|
|
2008-02-28 08:18:24 +08:00
|
|
|
extern void
|
|
|
|
set_parameters_options(const General_options* options);
|
2007-09-26 15:01:35 +08:00
|
|
|
|
2008-02-28 08:18:24 +08:00
|
|
|
extern void
|
2009-10-01 06:21:13 +08:00
|
|
|
set_parameters_target(Target* target);
|
2007-09-28 14:36:25 +08:00
|
|
|
|
2008-02-28 08:18:24 +08:00
|
|
|
extern void
|
|
|
|
set_parameters_doing_static_link(bool doing_static_link);
|
2009-10-01 06:21:13 +08:00
|
|
|
|
2010-10-15 06:10:22 +08:00
|
|
|
extern bool
|
|
|
|
set_parameters_incremental_full();
|
|
|
|
|
2009-10-01 06:21:13 +08:00
|
|
|
// Ensure that the target to be valid by using the default target if
|
|
|
|
// necessary.
|
|
|
|
|
|
|
|
extern void
|
|
|
|
parameters_force_valid_target();
|
|
|
|
|
|
|
|
// Clear the current target, for testing.
|
|
|
|
|
|
|
|
extern void
|
|
|
|
parameters_clear_target();
|
|
|
|
|
2007-11-22 08:05:51 +08:00
|
|
|
// Return whether we are doing a particular debugging type. The
|
|
|
|
// argument is one of the flags from debug.h.
|
|
|
|
|
|
|
|
inline bool
|
|
|
|
is_debugging_enabled(unsigned int type)
|
|
|
|
{ return (parameters->debug() & type) != 0; }
|
|
|
|
|
2007-09-21 15:20:01 +08:00
|
|
|
} // End namespace gold.
|
|
|
|
|
2007-10-14 12:10:25 +08:00
|
|
|
#endif // !defined(GOLD_PARAMETERS_H)
|