X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gold%2Fparameters.h;h=909594d68e50455aa7ddd908ed4c39e8ed2867cc;hb=fe33e22e7b2ef36f564df92c7259728eaf2e5028;hp=3186b6d454d3e848beb28a2fa4536456110c1941;hpb=02d2ba740273e3f539501337eebf0c6007af0b4b;p=deliverable%2Fbinutils-gdb.git diff --git a/gold/parameters.h b/gold/parameters.h index 3186b6d454..909594d68e 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-2019 Free Software Foundation, Inc. // Written by Ian Lance Taylor . // This file is part of gold. @@ -28,264 +28,218 @@ 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(); - // Return the error object. - Errors* - errors() const - { return this->errors_; } + // These should be called as soon as they are known. + void + set_errors(Errors* errors); - // Return the output file name. - const char* - output_file_name() const - { - gold_assert(this->options_valid_); - return this->output_file_name_; - } + void + set_timer(Timer* timer); - // Whether we are generating a regular executable. - bool - output_is_executable() const - { - gold_assert(this->output_file_type_ != OUTPUT_INVALID); - return this->output_file_type_ == OUTPUT_EXECUTABLE; - } + void + set_options(const General_options* options); - // Whether we are generating a shared library. - bool - output_is_shared() const - { - gold_assert(this->output_file_type_ != OUTPUT_INVALID); - return this->output_file_type_ == OUTPUT_SHARED; - } + void + set_target(Target* target); - // Whether we are generating an object file. - bool - output_is_object() const - { - gold_assert(this->output_file_type_ != OUTPUT_INVALID); - return this->output_file_type_ == OUTPUT_OBJECT; - } + void + set_doing_static_link(bool doing_static_link); - // 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(); } + // Return the error object. + Errors* + errors() const + { return this->errors_; } - // 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_; - } + // Return the timer object. + Timer* + timer() const + { return this->timer_; } - // Whether to strip all symbols. + // Whether the options are valid. This should not normally be + // called, but it is needed by gold_exit. bool - strip_all() const - { - gold_assert(this->strip_ != STRIP_INVALID); - return this->strip_ == STRIP_ALL; - } + options_valid() const + { return this->options_ != NULL; } - // Whether to strip debugging information. - bool - strip_debug() const + // Return the options object. + const General_options& + options() const { - gold_assert(this->strip_ != STRIP_INVALID); - return this->strip_ == STRIP_ALL || this->strip_ == STRIP_DEBUG; + gold_assert(this->options_valid()); + return *this->options_; } - // Whether to strip debugging information that's not used by gdb. + // Return whether the target field has been set. bool - strip_debug_gdb() const - { - gold_assert(this->strip_ != STRIP_INVALID); - return this->strip_debug() || this->strip_ == STRIP_DEBUG_UNUSED_BY_GDB; - } + target_valid() const + { return this->target_ != NULL; } - // Whether to permit unresolved references from shared libraries. - bool - allow_shlib_undefined() const + // The target of the output file we are generating. + const Target& + target() const { - gold_assert(this->options_valid_); - return this->allow_shlib_undefined_; + gold_assert(this->target_valid()); + return *this->target_; } - // Whether we are doing a symbolic link, in which all defined - // symbols are bound locally. - bool - symbolic() 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->options_valid_); - return this->symbolic_; + gold_assert(this->target_valid()); + return static_cast*>(this->target_); } - // Whether we should demangle C++ symbols in our log messages. + // Clear the target, for testing. + void + clear_target(); + + // Return true if TARGET is compatible with the current target. bool - demangle() const - { return this->demangle_; } + is_compatible_target(const Target*) const; - // Whether we should try to detect violations of the One Definition Rule. bool - detect_odr_violations() const + doing_static_link() const { - gold_assert(this->options_valid_); - return this->detect_odr_violations_; + gold_assert(this->doing_static_link_valid_); + return this->doing_static_link_; } - // The general linker optimization level. + // 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 - optimization_level() const + debug() const { - gold_assert(this->options_valid_); - return this->optimization_level_; + // This can be called before the options are set up. + if (!this->options_valid()) + return 0; + return debug_; } - // Whether the -E/--export-dynamic flag is set. + // Return the name of the entry symbol. + const char* + entry() const; + + // 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 }; + + Target_size_endianness + size_and_endianness() const; + + // 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 - export_dynamic() const - { - gold_assert(this->options_valid_); - return this->export_dynamic_; - } + set_incremental_full(); - // 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 need to prepare incremental linking information. bool - doing_static_link() const - { - gold_assert(this->is_doing_static_link_valid_); - return this->doing_static_link_; - } + incremental() const; - // The size of the output file we are generating. This should - // return 32 or 64. - int - get_size() const - { - gold_assert(this->is_size_and_endian_valid_); - return this->size_; - } + // Return true if we are doing a full incremental link. + bool + incremental_full() const; - // Whether the output is big endian. + // Return true if we are doing an incremental update. bool - is_big_endian() const - { - gold_assert(this->is_size_and_endian_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 size and endianness. void - set_size_and_endianness(int size, bool is_big_endian); + 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_; - // 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_; - - // Whether the doing_static_link_ field is valid. - bool is_doing_static_link_valid_; - // Whether we are doing a static link. + Errors* errors_; + Timer* timer_; + const General_options* options_; + Target* target_; + bool doing_static_link_valid_; bool doing_static_link_; - // Whether the size_ and is_big_endian_ fields are valid. - bool is_size_and_endian_valid_; - // The size of the output file--32 or 64. - int size_; - // Whether the output file is big endian. - bool is_big_endian_; + 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. + +extern void +parameters_force_valid_target(); + +// Clear the current target, for testing. -// Set the options. -extern void set_parameters_from_options(const General_options*); +extern void +parameters_clear_target(); -// Set the size and endianness of the global parameters variable. -extern void set_parameters_size_and_endianness(int size, bool is_big_endian); +// Return whether we are doing a particular debugging type. The +// argument is one of the flags from debug.h. -// Set whether we are doing a static link. -extern void set_parameters_doing_static_link(bool doing_static_link); +inline bool +is_debugging_enabled(unsigned int type) +{ return (parameters->debug() & type) != 0; } } // End namespace gold.