X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gold%2Fparameters.h;h=909594d68e50455aa7ddd908ed4c39e8ed2867cc;hb=d0509ba44323dc5550852f0dbdcb2ccc2818d5b3;hp=fafd3450e50d01f260107b46b8f9e1298894199e;hpb=9025d29d14ae287d2bc338ef1b0bfa043799e15c;p=deliverable%2Fbinutils-gdb.git diff --git a/gold/parameters.h b/gold/parameters.h index fafd3450e5..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. @@ -27,94 +27,220 @@ 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(const General_options*); + Parameters(); - // Whether we are generating a regular executable. - bool - output_is_executable() const - { return this->output_file_type_ == OUTPUT_EXECUTABLE; } + // These should be called as soon as they are known. + void + set_errors(Errors* errors); + + void + set_timer(Timer* timer); - // Whether we are generating a shared library. + 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 - output_is_shared() const - { return this->output_file_type_ == OUTPUT_SHARED; } + options_valid() const + { return this->options_ != NULL; } + + // Return the options object. + const General_options& + options() const + { + gold_assert(this->options_valid()); + return *this->options_; + } - // Whether we are generating an object file. + // Return whether the target field has been set. bool - output_is_object() const - { return this->output_file_type_ == OUTPUT_OBJECT; } + target_valid() const + { return this->target_ != NULL; } - // The size of the output file we are generating. This should - // return 32 or 64. - int - get_size() const + // The target of the output file we are generating. + const Target& + target() const { - gold_assert(this->is_size_and_endian_valid_); - return this->size_; + gold_assert(this->target_valid()); + return *this->target_; } - // Whether the output is big endian. + // 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->target_valid()); + return static_cast*>(this->target_); + } + + // Clear the target, for testing. + void + clear_target(); + + // Return true if TARGET is compatible with the current target. + bool + is_compatible_target(const Target*) const; + bool - is_big_endian() const + doing_static_link() const { - gold_assert(this->is_size_and_endian_valid_); - return this->is_big_endian_; + 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 - { return this->optimization_level_; } + debug() const + { + // This can be called before the options are set up. + if (!this->options_valid()) + return 0; + return debug_; + } - // Set the size and endianness. - void - set_size_and_endianness(int size, bool is_big_endian); + // 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 + set_incremental_full(); + + // Return true if we need to prepare incremental linking information. + bool + incremental() const; + + // Return true if we are doing a full incremental link. + bool + incremental_full() const; + + // Return true if we are doing an incremental update. + bool + incremental_update() const; private: - // The types of output files. - enum Output_file_type - { - // Generating executable. - OUTPUT_EXECUTABLE, - // Generating shared library. - OUTPUT_SHARED, - // Generating object file. - OUTPUT_OBJECT - }; - - // The type of the output file. - Output_file_type output_file_type_; - // 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_; - // The optimization level. - int optimization_level_; + void + set_target_once(Target*); + + void + check_target_endianness(); + + void + check_rodata_segment(); + + friend class Set_parameters_target_once; + + Errors* errors_; + Timer* timer_; + const General_options* options_; + Target* target_; + 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(const General_options*); +// 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. + +extern void +parameters_clear_target(); + +// Return whether we are doing a particular debugging type. The +// argument is one of the flags from debug.h. -// Set the size and endianness of the global parameters variable. -extern void set_parameters_size_and_endianness(int size, bool is_big_endian); +inline bool +is_debugging_enabled(unsigned int type) +{ return (parameters->debug() & type) != 0; } } // End namespace gold. -#endif // !defined(GOLD_PARAMATERS_H) +#endif // !defined(GOLD_PARAMETERS_H)