Import binutils-2.20
[dragonfly.git] / contrib / binutils-2.20 / gold / resolve.cc
1 // resolve.cc -- symbol resolution for gold
2
3 // Copyright 2006, 2007, 2008, 2009 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 #include "gold.h"
24
25 #include "elfcpp.h"
26 #include "target.h"
27 #include "object.h"
28 #include "symtab.h"
29 #include "plugin.h"
30
31 namespace gold
32 {
33
34 // Symbol methods used in this file.
35
36 // This symbol is being overridden by another symbol whose version is
37 // VERSION.  Update the VERSION_ field accordingly.
38
39 inline void
40 Symbol::override_version(const char* version)
41 {
42   if (version == NULL)
43     {
44       // This is the case where this symbol is NAME/VERSION, and the
45       // version was not marked as hidden.  That makes it the default
46       // version, so we create NAME/NULL.  Later we see another symbol
47       // NAME/NULL, and that symbol is overriding this one.  In this
48       // case, since NAME/VERSION is the default, we make NAME/NULL
49       // override NAME/VERSION as well.  They are already the same
50       // Symbol structure.  Setting the VERSION_ field to NULL ensures
51       // that it will be output with the correct, empty, version.
52       this->version_ = version;
53     }
54   else
55     {
56       // This is the case where this symbol is NAME/VERSION_ONE, and
57       // now we see NAME/VERSION_TWO, and NAME/VERSION_TWO is
58       // overriding NAME.  If VERSION_ONE and VERSION_TWO are
59       // different, then this can only happen when VERSION_ONE is NULL
60       // and VERSION_TWO is not hidden.
61       gold_assert(this->version_ == version || this->version_ == NULL);
62       this->version_ = version;
63     }
64 }
65
66 // This symbol is being overidden by another symbol whose visibility
67 // is VISIBILITY.  Updated the VISIBILITY_ field accordingly.
68
69 inline void
70 Symbol::override_visibility(elfcpp::STV visibility)
71 {
72   // The rule for combining visibility is that we always choose the
73   // most constrained visibility.  In order of increasing constraint,
74   // visibility goes PROTECTED, HIDDEN, INTERNAL.  This is the reverse
75   // of the numeric values, so the effect is that we always want the
76   // smallest non-zero value.
77   if (visibility != elfcpp::STV_DEFAULT)
78     {
79       if (this->visibility_ == elfcpp::STV_DEFAULT)
80         this->visibility_ = visibility;
81       else if (this->visibility_ > visibility)
82         this->visibility_ = visibility;
83     }
84 }
85
86 // Override the fields in Symbol.
87
88 template<int size, bool big_endian>
89 void
90 Symbol::override_base(const elfcpp::Sym<size, big_endian>& sym,
91                       unsigned int st_shndx, bool is_ordinary,
92                       Object* object, const char* version)
93 {
94   gold_assert(this->source_ == FROM_OBJECT);
95   this->u_.from_object.object = object;
96   this->override_version(version);
97   this->u_.from_object.shndx = st_shndx;
98   this->is_ordinary_shndx_ = is_ordinary;
99   this->type_ = sym.get_st_type();
100   this->binding_ = sym.get_st_bind();
101   this->override_visibility(sym.get_st_visibility());
102   this->nonvis_ = sym.get_st_nonvis();
103   if (object->is_dynamic())
104     this->in_dyn_ = true;
105   else
106     this->in_reg_ = true;
107 }
108
109 // Override the fields in Sized_symbol.
110
111 template<int size>
112 template<bool big_endian>
113 void
114 Sized_symbol<size>::override(const elfcpp::Sym<size, big_endian>& sym,
115                              unsigned st_shndx, bool is_ordinary,
116                              Object* object, const char* version)
117 {
118   this->override_base(sym, st_shndx, is_ordinary, object, version);
119   this->value_ = sym.get_st_value();
120   this->symsize_ = sym.get_st_size();
121 }
122
123 // Override TOSYM with symbol FROMSYM, defined in OBJECT, with version
124 // VERSION.  This handles all aliases of TOSYM.
125
126 template<int size, bool big_endian>
127 void
128 Symbol_table::override(Sized_symbol<size>* tosym,
129                        const elfcpp::Sym<size, big_endian>& fromsym,
130                        unsigned int st_shndx, bool is_ordinary,
131                        Object* object, const char* version)
132 {
133   tosym->override(fromsym, st_shndx, is_ordinary, object, version);
134   if (tosym->has_alias())
135     {
136       Symbol* sym = this->weak_aliases_[tosym];
137       gold_assert(sym != NULL);
138       Sized_symbol<size>* ssym = this->get_sized_symbol<size>(sym);
139       do
140         {
141           ssym->override(fromsym, st_shndx, is_ordinary, object, version);
142           sym = this->weak_aliases_[ssym];
143           gold_assert(sym != NULL);
144           ssym = this->get_sized_symbol<size>(sym);
145         }
146       while (ssym != tosym);
147     }
148 }
149
150 // The resolve functions build a little code for each symbol.
151 // Bit 0: 0 for global, 1 for weak.
152 // Bit 1: 0 for regular object, 1 for shared object
153 // Bits 2-3: 0 for normal, 1 for undefined, 2 for common
154 // This gives us values from 0 to 11.
155
156 static const int global_or_weak_shift = 0;
157 static const unsigned int global_flag = 0 << global_or_weak_shift;
158 static const unsigned int weak_flag = 1 << global_or_weak_shift;
159
160 static const int regular_or_dynamic_shift = 1;
161 static const unsigned int regular_flag = 0 << regular_or_dynamic_shift;
162 static const unsigned int dynamic_flag = 1 << regular_or_dynamic_shift;
163
164 static const int def_undef_or_common_shift = 2;
165 static const unsigned int def_flag = 0 << def_undef_or_common_shift;
166 static const unsigned int undef_flag = 1 << def_undef_or_common_shift;
167 static const unsigned int common_flag = 2 << def_undef_or_common_shift;
168
169 // This convenience function combines all the flags based on facts
170 // about the symbol.
171
172 static unsigned int
173 symbol_to_bits(elfcpp::STB binding, bool is_dynamic,
174                unsigned int shndx, bool is_ordinary, elfcpp::STT type)
175 {
176   unsigned int bits;
177
178   switch (binding)
179     {
180     case elfcpp::STB_GLOBAL:
181       bits = global_flag;
182       break;
183
184     case elfcpp::STB_WEAK:
185       bits = weak_flag;
186       break;
187
188     case elfcpp::STB_LOCAL:
189       // We should only see externally visible symbols in the symbol
190       // table.
191       gold_error(_("invalid STB_LOCAL symbol in external symbols"));
192       bits = global_flag;
193
194     default:
195       // Any target which wants to handle STB_LOOS, etc., needs to
196       // define a resolve method.
197       gold_error(_("unsupported symbol binding"));
198       bits = global_flag;
199     }
200
201   if (is_dynamic)
202     bits |= dynamic_flag;
203   else
204     bits |= regular_flag;
205
206   switch (shndx)
207     {
208     case elfcpp::SHN_UNDEF:
209       bits |= undef_flag;
210       break;
211
212     case elfcpp::SHN_COMMON:
213       if (!is_ordinary)
214         bits |= common_flag;
215       break;
216
217     default:
218       if (type == elfcpp::STT_COMMON)
219         bits |= common_flag;
220       else if (!is_ordinary && Symbol::is_common_shndx(shndx))
221         bits |= common_flag;
222       else
223         bits |= def_flag;
224       break;
225     }
226
227   return bits;
228 }
229
230 // Resolve a symbol.  This is called the second and subsequent times
231 // we see a symbol.  TO is the pre-existing symbol.  ST_SHNDX is the
232 // section index for SYM, possibly adjusted for many sections.
233 // IS_ORDINARY is whether ST_SHNDX is a normal section index rather
234 // than a special code.  ORIG_ST_SHNDX is the original section index,
235 // before any munging because of discarded sections, except that all
236 // non-ordinary section indexes are mapped to SHN_UNDEF.  VERSION is
237 // the version of SYM.
238
239 template<int size, bool big_endian>
240 void
241 Symbol_table::resolve(Sized_symbol<size>* to,
242                       const elfcpp::Sym<size, big_endian>& sym,
243                       unsigned int st_shndx, bool is_ordinary,
244                       unsigned int orig_st_shndx,
245                       Object* object, const char* version)
246 {
247   if (parameters->target().has_resolve())
248     {
249       Sized_target<size, big_endian>* sized_target;
250       sized_target = parameters->sized_target<size, big_endian>();
251       sized_target->resolve(to, sym, object, version);
252       return;
253     }
254
255   if (!object->is_dynamic())
256     {
257       // Record that we've seen this symbol in a regular object.
258       to->set_in_reg();
259     }
260   else if (st_shndx == elfcpp::SHN_UNDEF
261            && (to->visibility() == elfcpp::STV_HIDDEN
262                || to->visibility() == elfcpp::STV_INTERNAL))
263     {
264       // A dynamic object cannot reference a hidden or internal symbol
265       // defined in another object.
266       gold_warning(_("%s symbol '%s' in %s is referenced by DSO %s"),
267                    (to->visibility() == elfcpp::STV_HIDDEN
268                     ? "hidden"
269                     : "internal"),
270                    to->demangled_name().c_str(),
271                    to->object()->name().c_str(),
272                    object->name().c_str());
273       return;
274     }
275   else
276     {
277       // Record that we've seen this symbol in a dynamic object.
278       to->set_in_dyn();
279     }
280
281   // Record if we've seen this symbol in a real ELF object (i.e., the
282   // symbol is referenced from outside the world known to the plugin).
283   if (object->pluginobj() == NULL)
284     to->set_in_real_elf();
285
286   // If we're processing replacement files, allow new symbols to override
287   // the placeholders from the plugin objects.
288   if (to->source() == Symbol::FROM_OBJECT)
289     {
290       Pluginobj* obj = to->object()->pluginobj();
291       if (obj != NULL
292           && parameters->options().plugins()->in_replacement_phase())
293         {
294           this->override(to, sym, st_shndx, is_ordinary, object, version);
295           return;
296         }
297     }
298
299   unsigned int frombits = symbol_to_bits(sym.get_st_bind(),
300                                          object->is_dynamic(),
301                                          st_shndx, is_ordinary,
302                                          sym.get_st_type());
303
304   bool adjust_common_sizes;
305   if (Symbol_table::should_override(to, frombits, object,
306                                     &adjust_common_sizes))
307     {
308       typename Sized_symbol<size>::Size_type tosize = to->symsize();
309
310       this->override(to, sym, st_shndx, is_ordinary, object, version);
311
312       if (adjust_common_sizes && tosize > to->symsize())
313         to->set_symsize(tosize);
314     }
315   else
316     {
317       if (adjust_common_sizes && sym.get_st_size() > to->symsize())
318         to->set_symsize(sym.get_st_size());
319       // The ELF ABI says that even for a reference to a symbol we
320       // merge the visibility.
321       to->override_visibility(sym.get_st_visibility());
322     }
323
324   // A new weak undefined reference, merging with an old weak
325   // reference, could be a One Definition Rule (ODR) violation --
326   // especially if the types or sizes of the references differ.  We'll
327   // store such pairs and look them up later to make sure they
328   // actually refer to the same lines of code.  (Note: not all ODR
329   // violations can be found this way, and not everything this finds
330   // is an ODR violation.  But it's helpful to warn about.)
331   bool to_is_ordinary;
332   if (parameters->options().detect_odr_violations()
333       && sym.get_st_bind() == elfcpp::STB_WEAK
334       && to->binding() == elfcpp::STB_WEAK
335       && orig_st_shndx != elfcpp::SHN_UNDEF
336       && to->shndx(&to_is_ordinary) != elfcpp::SHN_UNDEF
337       && to_is_ordinary
338       && sym.get_st_size() != 0    // Ignore weird 0-sized symbols.
339       && to->symsize() != 0
340       && (sym.get_st_type() != to->type()
341           || sym.get_st_size() != to->symsize())
342       // C does not have a concept of ODR, so we only need to do this
343       // on C++ symbols.  These have (mangled) names starting with _Z.
344       && to->name()[0] == '_' && to->name()[1] == 'Z')
345     {
346       Symbol_location fromloc
347           = { object, orig_st_shndx, sym.get_st_value() };
348       Symbol_location toloc = { to->object(), to->shndx(&to_is_ordinary),
349                                 to->value() };
350       this->candidate_odr_violations_[to->name()].insert(fromloc);
351       this->candidate_odr_violations_[to->name()].insert(toloc);
352     }
353 }
354
355 // Handle the core of symbol resolution.  This is called with the
356 // existing symbol, TO, and a bitflag describing the new symbol.  This
357 // returns true if we should override the existing symbol with the new
358 // one, and returns false otherwise.  It sets *ADJUST_COMMON_SIZES to
359 // true if we should set the symbol size to the maximum of the TO and
360 // FROM sizes.  It handles error conditions.
361
362 bool
363 Symbol_table::should_override(const Symbol* to, unsigned int frombits,
364                               Object* object, bool* adjust_common_sizes)
365 {
366   *adjust_common_sizes = false;
367
368   unsigned int tobits;
369   if (to->source() == Symbol::IS_UNDEFINED)
370     tobits = symbol_to_bits(to->binding(), false, elfcpp::SHN_UNDEF, true,
371                             to->type());
372   else if (to->source() != Symbol::FROM_OBJECT)
373     tobits = symbol_to_bits(to->binding(), false, elfcpp::SHN_ABS, false,
374                             to->type());
375   else
376     {
377       bool is_ordinary;
378       unsigned int shndx = to->shndx(&is_ordinary);
379       tobits = symbol_to_bits(to->binding(),
380                               to->object()->is_dynamic(),
381                               shndx,
382                               is_ordinary,
383                               to->type());
384     }
385
386   // FIXME: Warn if either but not both of TO and SYM are STT_TLS.
387
388   // We use a giant switch table for symbol resolution.  This code is
389   // unwieldy, but: 1) it is efficient; 2) we definitely handle all
390   // cases; 3) it is easy to change the handling of a particular case.
391   // The alternative would be a series of conditionals, but it is easy
392   // to get the ordering wrong.  This could also be done as a table,
393   // but that is no easier to understand than this large switch
394   // statement.
395
396   // These are the values generated by the bit codes.
397   enum
398   {
399     DEF =              global_flag | regular_flag | def_flag,
400     WEAK_DEF =         weak_flag   | regular_flag | def_flag,
401     DYN_DEF =          global_flag | dynamic_flag | def_flag,
402     DYN_WEAK_DEF =     weak_flag   | dynamic_flag | def_flag,
403     UNDEF =            global_flag | regular_flag | undef_flag,
404     WEAK_UNDEF =       weak_flag   | regular_flag | undef_flag,
405     DYN_UNDEF =        global_flag | dynamic_flag | undef_flag,
406     DYN_WEAK_UNDEF =   weak_flag   | dynamic_flag | undef_flag,
407     COMMON =           global_flag | regular_flag | common_flag,
408     WEAK_COMMON =      weak_flag   | regular_flag | common_flag,
409     DYN_COMMON =       global_flag | dynamic_flag | common_flag,
410     DYN_WEAK_COMMON =  weak_flag   | dynamic_flag | common_flag
411   };
412
413   switch (tobits * 16 + frombits)
414     {
415     case DEF * 16 + DEF:
416       // Two definitions of the same symbol.
417
418       // If either symbol is defined by an object included using
419       // --just-symbols, then don't warn.  This is for compatibility
420       // with the GNU linker.  FIXME: This is a hack.
421       if ((to->source() == Symbol::FROM_OBJECT && to->object()->just_symbols())
422           || object->just_symbols())
423         return false;
424
425       // FIXME: Do a better job of reporting locations.
426       gold_error(_("%s: multiple definition of %s"),
427                  object != NULL ? object->name().c_str() : _("command line"),
428                  to->demangled_name().c_str());
429       gold_error(_("%s: previous definition here"),
430                  (to->source() == Symbol::FROM_OBJECT
431                   ? to->object()->name().c_str()
432                   : _("command line")));
433       return false;
434
435     case WEAK_DEF * 16 + DEF:
436       // We've seen a weak definition, and now we see a strong
437       // definition.  In the original SVR4 linker, this was treated as
438       // a multiple definition error.  In the Solaris linker and the
439       // GNU linker, a weak definition followed by a regular
440       // definition causes the weak definition to be overridden.  We
441       // are currently compatible with the GNU linker.  In the future
442       // we should add a target specific option to change this.
443       // FIXME.
444       return true;
445
446     case DYN_DEF * 16 + DEF:
447     case DYN_WEAK_DEF * 16 + DEF:
448       // We've seen a definition in a dynamic object, and now we see a
449       // definition in a regular object.  The definition in the
450       // regular object overrides the definition in the dynamic
451       // object.
452       return true;
453
454     case UNDEF * 16 + DEF:
455     case WEAK_UNDEF * 16 + DEF:
456     case DYN_UNDEF * 16 + DEF:
457     case DYN_WEAK_UNDEF * 16 + DEF:
458       // We've seen an undefined reference, and now we see a
459       // definition.  We use the definition.
460       return true;
461
462     case COMMON * 16 + DEF:
463     case WEAK_COMMON * 16 + DEF:
464     case DYN_COMMON * 16 + DEF:
465     case DYN_WEAK_COMMON * 16 + DEF:
466       // We've seen a common symbol and now we see a definition.  The
467       // definition overrides.  FIXME: We should optionally issue, version a
468       // warning.
469       return true;
470
471     case DEF * 16 + WEAK_DEF:
472     case WEAK_DEF * 16 + WEAK_DEF:
473       // We've seen a definition and now we see a weak definition.  We
474       // ignore the new weak definition.
475       return false;
476
477     case DYN_DEF * 16 + WEAK_DEF:
478     case DYN_WEAK_DEF * 16 + WEAK_DEF:
479       // We've seen a dynamic definition and now we see a regular weak
480       // definition.  The regular weak definition overrides.
481       return true;
482
483     case UNDEF * 16 + WEAK_DEF:
484     case WEAK_UNDEF * 16 + WEAK_DEF:
485     case DYN_UNDEF * 16 + WEAK_DEF:
486     case DYN_WEAK_UNDEF * 16 + WEAK_DEF:
487       // A weak definition of a currently undefined symbol.
488       return true;
489
490     case COMMON * 16 + WEAK_DEF:
491     case WEAK_COMMON * 16 + WEAK_DEF:
492       // A weak definition does not override a common definition.
493       return false;
494
495     case DYN_COMMON * 16 + WEAK_DEF:
496     case DYN_WEAK_COMMON * 16 + WEAK_DEF:
497       // A weak definition does override a definition in a dynamic
498       // object.  FIXME: We should optionally issue a warning.
499       return true;
500
501     case DEF * 16 + DYN_DEF:
502     case WEAK_DEF * 16 + DYN_DEF:
503     case DYN_DEF * 16 + DYN_DEF:
504     case DYN_WEAK_DEF * 16 + DYN_DEF:
505       // Ignore a dynamic definition if we already have a definition.
506       return false;
507
508     case UNDEF * 16 + DYN_DEF:
509     case WEAK_UNDEF * 16 + DYN_DEF:
510     case DYN_UNDEF * 16 + DYN_DEF:
511     case DYN_WEAK_UNDEF * 16 + DYN_DEF:
512       // Use a dynamic definition if we have a reference.
513       return true;
514
515     case COMMON * 16 + DYN_DEF:
516     case WEAK_COMMON * 16 + DYN_DEF:
517     case DYN_COMMON * 16 + DYN_DEF:
518     case DYN_WEAK_COMMON * 16 + DYN_DEF:
519       // Ignore a dynamic definition if we already have a common
520       // definition.
521       return false;
522
523     case DEF * 16 + DYN_WEAK_DEF:
524     case WEAK_DEF * 16 + DYN_WEAK_DEF:
525     case DYN_DEF * 16 + DYN_WEAK_DEF:
526     case DYN_WEAK_DEF * 16 + DYN_WEAK_DEF:
527       // Ignore a weak dynamic definition if we already have a
528       // definition.
529       return false;
530
531     case UNDEF * 16 + DYN_WEAK_DEF:
532     case WEAK_UNDEF * 16 + DYN_WEAK_DEF:
533     case DYN_UNDEF * 16 + DYN_WEAK_DEF:
534     case DYN_WEAK_UNDEF * 16 + DYN_WEAK_DEF:
535       // Use a weak dynamic definition if we have a reference.
536       return true;
537
538     case COMMON * 16 + DYN_WEAK_DEF:
539     case WEAK_COMMON * 16 + DYN_WEAK_DEF:
540     case DYN_COMMON * 16 + DYN_WEAK_DEF:
541     case DYN_WEAK_COMMON * 16 + DYN_WEAK_DEF:
542       // Ignore a weak dynamic definition if we already have a common
543       // definition.
544       return false;
545
546     case DEF * 16 + UNDEF:
547     case WEAK_DEF * 16 + UNDEF:
548     case DYN_DEF * 16 + UNDEF:
549     case DYN_WEAK_DEF * 16 + UNDEF:
550     case UNDEF * 16 + UNDEF:
551       // A new undefined reference tells us nothing.
552       return false;
553
554     case WEAK_UNDEF * 16 + UNDEF:
555     case DYN_UNDEF * 16 + UNDEF:
556     case DYN_WEAK_UNDEF * 16 + UNDEF:
557       // A strong undef overrides a dynamic or weak undef.
558       return true;
559
560     case COMMON * 16 + UNDEF:
561     case WEAK_COMMON * 16 + UNDEF:
562     case DYN_COMMON * 16 + UNDEF:
563     case DYN_WEAK_COMMON * 16 + UNDEF:
564       // A new undefined reference tells us nothing.
565       return false;
566
567     case DEF * 16 + WEAK_UNDEF:
568     case WEAK_DEF * 16 + WEAK_UNDEF:
569     case DYN_DEF * 16 + WEAK_UNDEF:
570     case DYN_WEAK_DEF * 16 + WEAK_UNDEF:
571     case UNDEF * 16 + WEAK_UNDEF:
572     case WEAK_UNDEF * 16 + WEAK_UNDEF:
573     case DYN_UNDEF * 16 + WEAK_UNDEF:
574     case DYN_WEAK_UNDEF * 16 + WEAK_UNDEF:
575     case COMMON * 16 + WEAK_UNDEF:
576     case WEAK_COMMON * 16 + WEAK_UNDEF:
577     case DYN_COMMON * 16 + WEAK_UNDEF:
578     case DYN_WEAK_COMMON * 16 + WEAK_UNDEF:
579       // A new weak undefined reference tells us nothing.
580       return false;
581
582     case DEF * 16 + DYN_UNDEF:
583     case WEAK_DEF * 16 + DYN_UNDEF:
584     case DYN_DEF * 16 + DYN_UNDEF:
585     case DYN_WEAK_DEF * 16 + DYN_UNDEF:
586     case UNDEF * 16 + DYN_UNDEF:
587     case WEAK_UNDEF * 16 + DYN_UNDEF:
588     case DYN_UNDEF * 16 + DYN_UNDEF:
589     case DYN_WEAK_UNDEF * 16 + DYN_UNDEF:
590     case COMMON * 16 + DYN_UNDEF:
591     case WEAK_COMMON * 16 + DYN_UNDEF:
592     case DYN_COMMON * 16 + DYN_UNDEF:
593     case DYN_WEAK_COMMON * 16 + DYN_UNDEF:
594       // A new dynamic undefined reference tells us nothing.
595       return false;
596
597     case DEF * 16 + DYN_WEAK_UNDEF:
598     case WEAK_DEF * 16 + DYN_WEAK_UNDEF:
599     case DYN_DEF * 16 + DYN_WEAK_UNDEF:
600     case DYN_WEAK_DEF * 16 + DYN_WEAK_UNDEF:
601     case UNDEF * 16 + DYN_WEAK_UNDEF:
602     case WEAK_UNDEF * 16 + DYN_WEAK_UNDEF:
603     case DYN_UNDEF * 16 + DYN_WEAK_UNDEF:
604     case DYN_WEAK_UNDEF * 16 + DYN_WEAK_UNDEF:
605     case COMMON * 16 + DYN_WEAK_UNDEF:
606     case WEAK_COMMON * 16 + DYN_WEAK_UNDEF:
607     case DYN_COMMON * 16 + DYN_WEAK_UNDEF:
608     case DYN_WEAK_COMMON * 16 + DYN_WEAK_UNDEF:
609       // A new weak dynamic undefined reference tells us nothing.
610       return false;
611
612     case DEF * 16 + COMMON:
613       // A common symbol does not override a definition.
614       return false;
615
616     case WEAK_DEF * 16 + COMMON:
617     case DYN_DEF * 16 + COMMON:
618     case DYN_WEAK_DEF * 16 + COMMON:
619       // A common symbol does override a weak definition or a dynamic
620       // definition.
621       return true;
622
623     case UNDEF * 16 + COMMON:
624     case WEAK_UNDEF * 16 + COMMON:
625     case DYN_UNDEF * 16 + COMMON:
626     case DYN_WEAK_UNDEF * 16 + COMMON:
627       // A common symbol is a definition for a reference.
628       return true;
629
630     case COMMON * 16 + COMMON:
631       // Set the size to the maximum.
632       *adjust_common_sizes = true;
633       return false;
634
635     case WEAK_COMMON * 16 + COMMON:
636       // I'm not sure just what a weak common symbol means, but
637       // presumably it can be overridden by a regular common symbol.
638       return true;
639
640     case DYN_COMMON * 16 + COMMON:
641     case DYN_WEAK_COMMON * 16 + COMMON:
642       // Use the real common symbol, but adjust the size if necessary.
643       *adjust_common_sizes = true;
644       return true;
645
646     case DEF * 16 + WEAK_COMMON:
647     case WEAK_DEF * 16 + WEAK_COMMON:
648     case DYN_DEF * 16 + WEAK_COMMON:
649     case DYN_WEAK_DEF * 16 + WEAK_COMMON:
650       // Whatever a weak common symbol is, it won't override a
651       // definition.
652       return false;
653
654     case UNDEF * 16 + WEAK_COMMON:
655     case WEAK_UNDEF * 16 + WEAK_COMMON:
656     case DYN_UNDEF * 16 + WEAK_COMMON:
657     case DYN_WEAK_UNDEF * 16 + WEAK_COMMON:
658       // A weak common symbol is better than an undefined symbol.
659       return true;
660
661     case COMMON * 16 + WEAK_COMMON:
662     case WEAK_COMMON * 16 + WEAK_COMMON:
663     case DYN_COMMON * 16 + WEAK_COMMON:
664     case DYN_WEAK_COMMON * 16 + WEAK_COMMON:
665       // Ignore a weak common symbol in the presence of a real common
666       // symbol.
667       return false;
668
669     case DEF * 16 + DYN_COMMON:
670     case WEAK_DEF * 16 + DYN_COMMON:
671     case DYN_DEF * 16 + DYN_COMMON:
672     case DYN_WEAK_DEF * 16 + DYN_COMMON:
673       // Ignore a dynamic common symbol in the presence of a
674       // definition.
675       return false;
676
677     case UNDEF * 16 + DYN_COMMON:
678     case WEAK_UNDEF * 16 + DYN_COMMON:
679     case DYN_UNDEF * 16 + DYN_COMMON:
680     case DYN_WEAK_UNDEF * 16 + DYN_COMMON:
681       // A dynamic common symbol is a definition of sorts.
682       return true;
683
684     case COMMON * 16 + DYN_COMMON:
685     case WEAK_COMMON * 16 + DYN_COMMON:
686     case DYN_COMMON * 16 + DYN_COMMON:
687     case DYN_WEAK_COMMON * 16 + DYN_COMMON:
688       // Set the size to the maximum.
689       *adjust_common_sizes = true;
690       return false;
691
692     case DEF * 16 + DYN_WEAK_COMMON:
693     case WEAK_DEF * 16 + DYN_WEAK_COMMON:
694     case DYN_DEF * 16 + DYN_WEAK_COMMON:
695     case DYN_WEAK_DEF * 16 + DYN_WEAK_COMMON:
696       // A common symbol is ignored in the face of a definition.
697       return false;
698
699     case UNDEF * 16 + DYN_WEAK_COMMON:
700     case WEAK_UNDEF * 16 + DYN_WEAK_COMMON:
701     case DYN_UNDEF * 16 + DYN_WEAK_COMMON:
702     case DYN_WEAK_UNDEF * 16 + DYN_WEAK_COMMON:
703       // I guess a weak common symbol is better than a definition.
704       return true;
705
706     case COMMON * 16 + DYN_WEAK_COMMON:
707     case WEAK_COMMON * 16 + DYN_WEAK_COMMON:
708     case DYN_COMMON * 16 + DYN_WEAK_COMMON:
709     case DYN_WEAK_COMMON * 16 + DYN_WEAK_COMMON:
710       // Set the size to the maximum.
711       *adjust_common_sizes = true;
712       return false;
713
714     default:
715       gold_unreachable();
716     }
717 }
718
719 // A special case of should_override which is only called for a strong
720 // defined symbol from a regular object file.  This is used when
721 // defining special symbols.
722
723 bool
724 Symbol_table::should_override_with_special(const Symbol* to)
725 {
726   bool adjust_common_sizes;
727   unsigned int frombits = global_flag | regular_flag | def_flag;
728   bool ret = Symbol_table::should_override(to, frombits, NULL,
729                                            &adjust_common_sizes);
730   gold_assert(!adjust_common_sizes);
731   return ret;
732 }
733
734 // Override symbol base with a special symbol.
735
736 void
737 Symbol::override_base_with_special(const Symbol* from)
738 {
739   gold_assert(this->name_ == from->name_ || this->has_alias());
740
741   this->source_ = from->source_;
742   switch (from->source_)
743     {
744     case FROM_OBJECT:
745       this->u_.from_object = from->u_.from_object;
746       break;
747     case IN_OUTPUT_DATA:
748       this->u_.in_output_data = from->u_.in_output_data;
749       break;
750     case IN_OUTPUT_SEGMENT:
751       this->u_.in_output_segment = from->u_.in_output_segment;
752       break;
753     case IS_CONSTANT:
754     case IS_UNDEFINED:
755       break;
756     default:
757       gold_unreachable();
758       break;
759     }
760
761   this->override_version(from->version_);
762   this->type_ = from->type_;
763   this->binding_ = from->binding_;
764   this->override_visibility(from->visibility_);
765   this->nonvis_ = from->nonvis_;
766
767   // Special symbols are always considered to be regular symbols.
768   this->in_reg_ = true;
769
770   if (from->needs_dynsym_entry_)
771     this->needs_dynsym_entry_ = true;
772   if (from->needs_dynsym_value_)
773     this->needs_dynsym_value_ = true;
774
775   // We shouldn't see these flags.  If we do, we need to handle them
776   // somehow.
777   gold_assert(!from->is_target_special_ || this->is_target_special_);
778   gold_assert(!from->is_forwarder_);
779   gold_assert(!from->has_plt_offset_);
780   gold_assert(!from->has_warning_);
781   gold_assert(!from->is_copied_from_dynobj_);
782   gold_assert(!from->is_forced_local_);
783 }
784
785 // Override a symbol with a special symbol.
786
787 template<int size>
788 void
789 Sized_symbol<size>::override_with_special(const Sized_symbol<size>* from)
790 {
791   this->override_base_with_special(from);
792   this->value_ = from->value_;
793   this->symsize_ = from->symsize_;
794 }
795
796 // Override TOSYM with the special symbol FROMSYM.  This handles all
797 // aliases of TOSYM.
798
799 template<int size>
800 void
801 Symbol_table::override_with_special(Sized_symbol<size>* tosym,
802                                     const Sized_symbol<size>* fromsym)
803 {
804   tosym->override_with_special(fromsym);
805   if (tosym->has_alias())
806     {
807       Symbol* sym = this->weak_aliases_[tosym];
808       gold_assert(sym != NULL);
809       Sized_symbol<size>* ssym = this->get_sized_symbol<size>(sym);
810       do
811         {
812           ssym->override_with_special(fromsym);
813           sym = this->weak_aliases_[ssym];
814           gold_assert(sym != NULL);
815           ssym = this->get_sized_symbol<size>(sym);
816         }
817       while (ssym != tosym);
818     }
819   if (tosym->binding() == elfcpp::STB_LOCAL
820       || ((tosym->visibility() == elfcpp::STV_HIDDEN
821            || tosym->visibility() == elfcpp::STV_INTERNAL)
822           && (tosym->binding() == elfcpp::STB_GLOBAL
823               || tosym->binding() == elfcpp::STB_WEAK)
824           && !parameters->options().relocatable()))
825     this->force_local(tosym);
826 }
827
828 // Instantiate the templates we need.  We could use the configure
829 // script to restrict this to only the ones needed for implemented
830 // targets.
831
832 #ifdef HAVE_TARGET_32_LITTLE
833 template
834 void
835 Symbol_table::resolve<32, false>(
836     Sized_symbol<32>* to,
837     const elfcpp::Sym<32, false>& sym,
838     unsigned int st_shndx,
839     bool is_ordinary,
840     unsigned int orig_st_shndx,
841     Object* object,
842     const char* version);
843 #endif
844
845 #ifdef HAVE_TARGET_32_BIG
846 template
847 void
848 Symbol_table::resolve<32, true>(
849     Sized_symbol<32>* to,
850     const elfcpp::Sym<32, true>& sym,
851     unsigned int st_shndx,
852     bool is_ordinary,
853     unsigned int orig_st_shndx,
854     Object* object,
855     const char* version);
856 #endif
857
858 #ifdef HAVE_TARGET_64_LITTLE
859 template
860 void
861 Symbol_table::resolve<64, false>(
862     Sized_symbol<64>* to,
863     const elfcpp::Sym<64, false>& sym,
864     unsigned int st_shndx,
865     bool is_ordinary,
866     unsigned int orig_st_shndx,
867     Object* object,
868     const char* version);
869 #endif
870
871 #ifdef HAVE_TARGET_64_BIG
872 template
873 void
874 Symbol_table::resolve<64, true>(
875     Sized_symbol<64>* to,
876     const elfcpp::Sym<64, true>& sym,
877     unsigned int st_shndx,
878     bool is_ordinary,
879     unsigned int orig_st_shndx,
880     Object* object,
881     const char* version);
882 #endif
883
884 #if defined(HAVE_TARGET_32_LITTLE) || defined(HAVE_TARGET_32_BIG)
885 template
886 void
887 Symbol_table::override_with_special<32>(Sized_symbol<32>*,
888                                         const Sized_symbol<32>*);
889 #endif
890
891 #if defined(HAVE_TARGET_64_LITTLE) || defined(HAVE_TARGET_64_BIG)
892 template
893 void
894 Symbol_table::override_with_special<64>(Sized_symbol<64>*,
895                                         const Sized_symbol<64>*);
896 #endif
897
898 } // End namespace gold.