gold/parameters.h

   1 // parameters.h -- general parameters for a link using gold  -*- C++ -*-
   2
   3 // Copyright (C) 2006-2024 Free Software Foundation, Inc.
   4 // Written by Ian Lance Taylor <iant@google.com>.
   5
   6 // This file is part of gold.
   7
   8 // This program is free software; you can redistribute it and/or modify
   9 // it under the terms of the GNU General Public License as published by
  10 // the Free Software Foundation; either version 3 of the License, or
  11 // (at your option) any later version.
  12
  13 // This program is distributed in the hope that it will be useful,
  14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 // GNU General Public License for more details.
  17
  18 // You should have received a copy of the GNU General Public License
  19 // along with this program; if not, write to the Free Software
  20 // Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
  21 // MA 02110-1301, USA.
  22
  23 #ifndef GOLD_PARAMETERS_H
  24 #define GOLD_PARAMETERS_H
  25
  26 namespace gold
  27 {
  28
  29 class General_options;
  30 class Errors;
  31 class Timer;
  32 class Target;
  33 template<int size, bool big_endian>
  34 class Sized_target;
  35 class Set_parameters_target_once;
  36
  37 // Here we define the Parameters class which simply holds simple
  38 // general parameters which apply to the entire link.  We use a global
  39 // variable for this.  The parameters class holds three types of data:
  40 //    1) An Errors struct.  Any part of the code that wants to log an
  41 //       error can use parameters->errors().
  42 //    2) A const General_options.  These are the options as read on
  43 //       the commandline.
  44 //    3) Target information, such as size and endian-ness.  This is
  45 //       available as soon as we've decided on the Target (after
  46 //       parsing the first .o file).
  47 //    4) Whether we're doing a static link or not.  This is set
  48 //       after all inputs have been read and we know if any is a
  49 //       dynamic library.
  50
  51 class Parameters
  52 {
  53  public:
  54   Parameters();
  55
  56   // These should be called as soon as they are known.
  57   void
  58   set_errors(Errors* errors);
  59
  60   void
  61   set_timer(Timer* timer);
  62
  63   void
  64   set_options(const General_options* options);
  65
  66   void
  67   set_target(Target* target);
  68
  69   void
  70   set_doing_static_link(bool doing_static_link);
  71
  72   // Return the error object.
  73   Errors*
  74   errors() const
  75   { return this->errors_; }
  76
  77   // Return the timer object.
  78   Timer*
  79   timer() const
  80   { return this->timer_; }
  81
  82   // Whether the options are valid.  This should not normally be
  83   // called, but it is needed by gold_exit.
  84   bool
  85   options_valid() const
  86   { return this->options_ != NULL; }
  87
  88   // Return the options object.
  89   const General_options&
  90   options() const
  91   {
  92     gold_assert(this->options_valid());
  93     return *this->options_;
  94   }
  95
  96   // Return whether the target field has been set.
  97   bool
  98   target_valid() const
  99   { return this->target_ != NULL; }
 100
 101   // The target of the output file we are generating.
 102   const Target&
 103   target() const
 104   {
 105     gold_assert(this->target_valid());
 106     return *this->target_;
 107   }
 108
 109   // The Sized_target of the output file.  The caller must request the
 110   // right size and endianness.
 111   template<int size, bool big_endian>
 112   Sized_target<size, big_endian>*
 113   sized_target() const
 114   {
 115     gold_assert(this->target_valid());
 116     return static_cast<Sized_target<size, big_endian>*>(this->target_);
 117   }
 118
 119   // Clear the target, for testing.
 120   void
 121   clear_target();
 122
 123   // Return true if TARGET is compatible with the current target.
 124   bool
 125   is_compatible_target(const Target*) const;
 126
 127   bool
 128   doing_static_link() const
 129   {
 130     gold_assert(this->doing_static_link_valid_);
 131     return this->doing_static_link_;
 132   }
 133
 134   // This is just a copy of options().debug().  We make a copy so we
 135   // don't have to #include options.h in order to inline
 136   // is_debugging_enabled, below.
 137   int
 138   debug() const
 139   {
 140     // This can be called before the options are set up.
 141     if (!this->options_valid())
 142       return 0;
 143     return debug_;
 144   }
 145
 146   // Return the name of the entry symbol.
 147   const char*
 148   entry() const;
 149
 150   // A convenience routine for combining size and endianness.  It also
 151   // checks the HAVE_TARGET_FOO configure options and dies if the
 152   // current target's size/endianness is not supported according to
 153   // HAVE_TARGET_FOO.  Otherwise it returns this enum
 154   enum Target_size_endianness
 155   { TARGET_32_LITTLE, TARGET_32_BIG, TARGET_64_LITTLE, TARGET_64_BIG };
 156
 157   Target_size_endianness
 158   size_and_endianness() const;
 159
 160   // Set the incremental linking mode to INCREMENTAL_FULL.  Used when
 161   // the linker determines that an incremental update is not possible.
 162   // Returns false if the incremental mode was INCREMENTAL_UPDATE,
 163   // indicating that the linker should exit if an update is not possible.
 164   bool
 165   set_incremental_full();
 166
 167   // Return true if we need to prepare incremental linking information.
 168   bool
 169   incremental() const;
 170
 171   // Return true if we are doing a full incremental link.
 172   bool
 173   incremental_full() const;
 174
 175   // Return true if we are doing an incremental update.
 176   bool
 177   incremental_update() const;
 178
 179  private:
 180   void
 181   set_target_once(Target*);
 182
 183   void
 184   check_target_endianness();
 185
 186   void
 187   check_rodata_segment();
 188
 189   friend class Set_parameters_target_once;
 190
 191   Errors* errors_;
 192   Timer* timer_;
 193   const General_options* options_;
 194   Target* target_;
 195   bool doing_static_link_valid_;
 196   bool doing_static_link_;
 197   int debug_;
 198   int incremental_mode_;
 199   Set_parameters_target_once* set_parameters_target_once_;
 200 };
 201
 202 // This is a global variable.
 203 extern const Parameters* parameters;
 204
 205 // We use free functions for these since they affect a global variable
 206 // that is internal to parameters.cc.
 207
 208 extern void
 209 set_parameters_errors(Errors* errors);
 210
 211 extern void
 212 set_parameters_timer(Timer* timer);
 213
 214 extern void
 215 set_parameters_options(const General_options* options);
 216
 217 extern void
 218 set_parameters_target(Target* target);
 219
 220 extern void
 221 set_parameters_doing_static_link(bool doing_static_link);
 222
 223 extern bool
 224 set_parameters_incremental_full();
 225
 226 // Ensure that the target to be valid by using the default target if
 227 // necessary.
 228
 229 extern void
 230 parameters_force_valid_target();
 231
 232 // Clear the current target, for testing.
 233
 234 extern void
 235 parameters_clear_target();
 236
 237 // Return whether we are doing a particular debugging type.  The
 238 // argument is one of the flags from debug.h.
 239
 240 inline bool
 241 is_debugging_enabled(unsigned int type)
 242 { return (parameters->debug() & type) != 0; }
 243
 244 } // End namespace gold.
 245
 246 #endif // !defined(GOLD_PARAMETERS_H)