X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gold%2Fparameters.h;h=e39c387bebd81f5ce9fe59dc0924fd3a133b0082;hb=945e0f82dad31db89a107b496532886fe215c011;hp=2467295c857f634dcc4f0f2bf0f067095f7eda6a;hpb=96803768f1845a2c5af362ea2dc6b39a147d3930;p=deliverable%2Fbinutils-gdb.git diff --git a/gold/parameters.h b/gold/parameters.h index 2467295c85..e39c387beb 100644 --- a/gold/parameters.h +++ b/gold/parameters.h @@ -1,6 +1,6 @@ // parameters.h -- general parameters for a link using gold -*- C++ -*- -// Copyright 2006, 2007 Free Software Foundation, Inc. +// Copyright (C) 2006-2016 Free Software Foundation, Inc. // Written by Ian Lance Taylor . // This file is part of gold. @@ -28,302 +28,211 @@ namespace gold class General_options; class Errors; +class Timer; class Target; +template +class Sized_target; +class Set_parameters_target_once; // Here we define the Parameters class which simply holds simple // general parameters which apply to the entire link. We use a global -// variable for this. This is in contrast to the General_options -// class, which holds the complete state of position independent -// command line options. The hope is that Parameters will stay fairly -// simple, so that if this turns into a library it will be clear how -// these parameters should be set. +// 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. class Parameters { public: - Parameters(Errors*); + Parameters(); + + // These should be called as soon as they are known. + void + set_errors(Errors* errors); + + void + set_timer(Timer* timer); + + void + set_options(const General_options* options); + + void + set_target(Target* target); + + void + set_doing_static_link(bool doing_static_link); // Return the error object. Errors* errors() const { return this->errors_; } + // Return the timer object. + Timer* + timer() const + { return this->timer_; } + // Whether the options are valid. This should not normally be // called, but it is needed by gold_exit. bool options_valid() const - { return this->options_valid_; } + { return this->options_ != NULL; } - // Whether to use threads. - bool - threads() const + // Return the options object. + const General_options& + options() const { - gold_assert(this->options_valid_); - return this->threads_; + gold_assert(this->options_valid()); + return *this->options_; } - // Return the output file name. - const char* - output_file_name() const - { - gold_assert(this->options_valid_); - return this->output_file_name_; - } - - // Whether we are generating a regular executable. + // Return whether the target field has been set. bool - output_is_executable() const - { - gold_assert(this->output_file_type_ != OUTPUT_INVALID); - return this->output_file_type_ == OUTPUT_EXECUTABLE; - } + target_valid() const + { return this->target_ != NULL; } - // Whether we are generating a shared library. - bool - output_is_shared() const + // The target of the output file we are generating. + const Target& + target() const { - gold_assert(this->output_file_type_ != OUTPUT_INVALID); - return this->output_file_type_ == OUTPUT_SHARED; + gold_assert(this->target_valid()); + return *this->target_; } - // Whether we are generating an object file. - bool - output_is_object() const + // The Sized_target of the output file. The caller must request the + // right size and endianness. + template + Sized_target* + sized_target() const { - gold_assert(this->output_file_type_ != OUTPUT_INVALID); - return this->output_file_type_ == OUTPUT_OBJECT; + gold_assert(this->target_valid()); + return static_cast*>(this->target_); } - // Whether we are generating position-independent output. - // This is the case when generating either a shared library - // or a regular executable with the --pic-executable option. - // FIXME: support --pic-executable - bool - output_is_position_independent() const - { return output_is_shared(); } - - // The target system root directory. This is NULL if there isn't - // one. - const std::string& - sysroot() const - { - gold_assert(this->options_valid_); - return this->sysroot_; - } + // Clear the target, for testing. + void + clear_target(); - // Whether to strip all symbols. + // Return true if TARGET is compatible with the current target. bool - strip_all() const - { - gold_assert(this->strip_ != STRIP_INVALID); - return this->strip_ == STRIP_ALL; - } + is_compatible_target(const Target*) const; - // Whether to strip debugging information. bool - strip_debug() const + doing_static_link() const { - gold_assert(this->strip_ != STRIP_INVALID); - return this->strip_ == STRIP_ALL || this->strip_ == STRIP_DEBUG; + gold_assert(this->doing_static_link_valid_); + return this->doing_static_link_; } - // Whether to strip debugging information that's not used by gdb. - bool - strip_debug_gdb() const + // 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 { - gold_assert(this->strip_ != STRIP_INVALID); - return this->strip_debug() || this->strip_ == STRIP_DEBUG_UNUSED_BY_GDB; + // This can be called before the options are set up. + if (!this->options_valid()) + return 0; + return debug_; } - // Whether to permit unresolved references from shared libraries. - bool - allow_shlib_undefined() const - { - gold_assert(this->options_valid_); - return this->allow_shlib_undefined_; - } + // Return the name of the entry symbol. + const char* + entry() const; - // Whether we are doing a symbolic link, in which all defined - // symbols are bound locally. - bool - symbolic() const - { - gold_assert(this->options_valid_); - return this->symbolic_; - } + // 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 }; - // Whether we should demangle C++ symbols in our log messages. - bool - demangle() const - { return this->demangle_; } + Target_size_endianness + size_and_endianness() const; - // Whether we should try to detect violations of the One Definition Rule. + // 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 - detect_odr_violations() const - { - gold_assert(this->options_valid_); - return this->detect_odr_violations_; - } - - // The general linker optimization level. - int - optimization_level() const - { - gold_assert(this->options_valid_); - return this->optimization_level_; - } + set_incremental_full(); - // Whether the -E/--export-dynamic flag is set. + // Return true if we need to prepare incremental linking information. bool - export_dynamic() const - { - gold_assert(this->options_valid_); - return this->export_dynamic_; - } - - // Return the debug flags. These are the flags for which we should - // report internal debugging information. - unsigned int - debug() const - { - gold_assert(this->options_valid_); - return this->debug_; - } + incremental() const; - // Whether we are doing a static link--a link in which none of the - // input files are shared libraries. This is only known after we - // have seen all the input files. + // Return true if we are doing a full incremental link. bool - doing_static_link() const - { - gold_assert(this->is_doing_static_link_valid_); - return this->doing_static_link_; - } + incremental_full() const; - // The target of the output file we are generating. - Target* - target() const - { - gold_assert(this->is_target_valid_); - return this->target_; - } - - // The size of the output file we are generating. This should - // return 32 or 64. - int - get_size() const - { - gold_assert(this->is_target_valid_); - return this->size_; - } - - // Whether the output is big endian. + // Return true if we are doing an incremental update. bool - is_big_endian() const - { - gold_assert(this->is_target_valid_); - return this->is_big_endian_; - } + incremental_update() const; - // Set values recorded from options. + private: void - set_from_options(const General_options*); + set_target_once(Target*); - // Set whether we are doing a static link. void - set_doing_static_link(bool doing_static_link); + check_target_endianness(); - // Set the target. void - set_target(Target* target); + check_rodata_segment(); - private: - // The types of output files. - enum Output_file_type - { - // Uninitialized. - OUTPUT_INVALID, - // Generating executable. - OUTPUT_EXECUTABLE, - // Generating shared library. - OUTPUT_SHARED, - // Generating object file. - OUTPUT_OBJECT - }; - - // Which symbols to strip. - enum Strip - { - // Uninitialize. - STRIP_INVALID, - // Don't strip any symbols. - STRIP_NONE, - // Strip all symbols. - STRIP_ALL, - // Strip debugging information. - STRIP_DEBUG, - // Strip debugging information that's not used by gdb (at least <= 6.7) - STRIP_DEBUG_UNUSED_BY_GDB - }; - - // A pointer to the error handling object. - Errors* errors_; + friend class Set_parameters_target_once; - // Whether the fields set from the options are valid. - bool options_valid_; - // Whether to use threads. - bool threads_; - // The output file name. - const char* output_file_name_; - // The type of the output file. - Output_file_type output_file_type_; - // The target system root directory. - std::string sysroot_; - // Which symbols to strip. - Strip strip_; - // Whether to allow undefined references from shared libraries. - bool allow_shlib_undefined_; - // Whether we are doing a symbolic link. - bool symbolic_; - // Whether we should demangle C++ symbols in our log messages. - bool demangle_; - // Whether we try to detect One Definition Rule violations. - bool detect_odr_violations_; - // The optimization level. - int optimization_level_; - // Whether the -E/--export-dynamic flag is set. - bool export_dynamic_; - // The debug flags. - unsigned int debug_; - - // Whether the doing_static_link_ field is valid. - bool is_doing_static_link_valid_; - // Whether we are doing a static link. - bool doing_static_link_; - // Whether the target_ field is valid. - bool is_target_valid_; - // The target. + Errors* errors_; + Timer* timer_; + const General_options* options_; Target* target_; - // The size of the output file--32 or 64. - int size_; - // Whether the output file is big endian. - bool is_big_endian_; + bool doing_static_link_valid_; + bool doing_static_link_; + int debug_; + int incremental_mode_; + Set_parameters_target_once* set_parameters_target_once_; }; // This is a global variable. extern const Parameters* parameters; -// Initialize the global variable. -extern void initialize_parameters(Errors*); +// We use free functions for these since they affect a global variable +// that is internal to parameters.cc. + +extern void +set_parameters_errors(Errors* errors); + +extern void +set_parameters_timer(Timer* timer); + +extern void +set_parameters_options(const General_options* options); + +extern void +set_parameters_target(Target* target); + +extern void +set_parameters_doing_static_link(bool doing_static_link); + +extern bool +set_parameters_incremental_full(); + +// Ensure that the target to be valid by using the default target if +// necessary. -// Set the options. -extern void set_parameters_from_options(const General_options*); +extern void +parameters_force_valid_target(); -// Set the target recorded in the global parameters variable. -extern void set_parameters_target(Target* target); +// Clear the current target, for testing. -// Set whether we are doing a static link. -extern void set_parameters_doing_static_link(bool doing_static_link); +extern void +parameters_clear_target(); // Return whether we are doing a particular debugging type. The // argument is one of the flags from debug.h.