binutils/gold/object.h

6 // This file is part of gold.
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
14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
18 // You should have received a copy of the GNU General Public License
71   // Size of section name data in bytes.
75   // Size of symbol data in bytes.
77   // Offset of external symbols within symbol data.  This structure
83   // Size of symbol name data in bytes.
121   // Index of reloc section.
123   // Index of section that relocs apply to.
125   // Contents of reloc section.
129   // Number of reloc entries.
169   // section index of the symbol table to use.
181   // Symbol SYMNDX in OBJECT has a section of SHN_XINDEX; return the
187   // The type of the array giving the real section index for symbols
209 // but will usually have at most one.  GOT_TYPE identifies the type of
241   // Set the offset for the GOT entry of type GOT_TYPE.
266   // Return the offset for a GOT entry of type GOT_TYPE.
394   // NAME is the name of the object as we would report it to the user
420   // Return the name of the object as we would report it to the user.
435   // Return the word size of the object file.
540   // Return the last modified time of the file.
545   // Get the number of sections.
550   // Return a view of the contents of a section.  Set *PLEN to the
556   // of the symbol and SHNDX is the symbol's section from
578   // Return the size of a section given a section index.
583   // Return the name of a section given a section index.
757   // Get the number of global symbols defined by this object, and the
758   // number of the symbols whose final definition came from this
825   // Return a view of the decompressed contents of a section.  Set *PLEN
832   // Discard any buffers of decompressed sections.  This is done
833   // at the end of the Add_symbols task.
837   // Return the index of the first incremental relocation for symbol SYMNDX.
842   // Return the number of incremental relocations for symbol SYMNDX.
872   // Return the last modified time of the file.  This method may be
906   // Return the location of the contents of a section.  Implemented by
912   // Get the size of a section--implemented by child class.
916   // Get the name of a section--implemented by child class.
954   // Get the address of a section--implemented by child class.
959   // Get the offset of a section--implemented by child class.
975   // Set the number of sections.
1006   // If NAME is the name of a special .gnu.warning section, arrange
1013   // If NAME is the name of the special section which indicates that
1019   // Discard any buffers of decompressed sections.  This is done
1020   // at the end of the Add_symbols task.
1025   // Return the index of the first incremental relocation for symbol SYMNDX--
1031   // Return the number of incremental relocations for symbol SYMNDX--
1055   // Name of object as printed to user.
1062   // Number of input sections.
1131   // This data is also used to compute the list of relevant sections.
1158   // Return the value of the local symbol whose index is SYMNDX, plus
1171   // Return whether the local symbol SYMNDX has a GOT offset of type
1178   // of type GOT_TYPE.
1184   // Return the GOT offset of type GOT_TYPE of the local symbol
1186   // a GOT offset of the specified type.
1191   // Return the GOT offset of type GOT_TYPE of the local symbol
1193   // does not have a GOT offset of the specified type.
1199   // Set the GOT offset with type GOT_TYPE of the local symbol SYMNDX
1206   // Set the GOT offset with type GOT_TYPE of the local symbol SYMNDX
1218   // The number of local symbols in the input symbol table.
1223   // The number of local symbols in the output symbol table.
1233   // Initial local symbol processing: count the number of local symbols
1241   // Set the values of the local symbols, set the output symbol table
1267   // Return the index of the first dynamic relocation.
1272   // Return the count of dynamic relocations.
1279   relocate(const Symbol_table* symtab, const Layout* layout, Output_file* of)
1280   { return this->do_relocate(symtab, layout, of); }
1290   // The output section of the input section with index SHNDX.
1300   // Set the offset of an input section within its output section.
1358   // Return the index of the first incremental relocation for symbol SYMNDX.
1363   // Return the number of incremental relocations for symbol SYMNDX.
1368   // Return the word size of the object file.
1396   // Return the value of a local symbol.
1400   // Return the PLT offset of a local symbol.
1405   // of a given type.
1410   // Return the GOT offset of a given type of a local symbol plus addend.
1424   // Return the number of local symbols--implemented by child class.
1428   // Return the number of output local symbols--implemented by child class.
1458   do_relocate(const Symbol_table* symtab, const Layout*, Output_file* of) = 0;
1460   // Set the offset of a section--implemented by child class.
1488   // Set the size of the relocatable relocs array.
1527   // Return the index of the next relocation to be written for global symbol
1542   // Return the word size of the object file--
1565   // Used during garbage collection of unused sections.
1571   // Per-symbol counts of relocations, for incremental links.
1573   // Per-symbol base indexes of relocations, for incremental links.
1575   // Index of the first dynamic relocation for this object.
1577   // Count of dynamic relocations for this object.
1583 // addend of the relocation before we can determine the final value.
1586 // non-section symbol, we apply the addend to the final value of the
1621     // offset in the section.  The result should be the start of some
1627     // general case.  However, we can handle the special case of a
1628     // negative addend, by assuming that it refers to the start of the
1659   // The value of the section symbol in the input file.  This is
1662   // The start address of this merged section in the output file.
1669 // This POD class is holds the value of a symbol.  This is used for
1692   // Get the value of this symbol.  OBJECT is the object in which this
1708   // Set the value of this symbol in the output symbol table.
1724   // merged section.  We also initialize the value of a non-section
1746   // Set the value of the symbol from the input file.  This is only
1865   // Set the index of the input section in the input file.
1876   // Return the index of the input section in the input file.
1923   // The index of this local symbol in the output symbol table.  This
1929   // The index of this local symbol in the dynamic symbol table.  This
2021   // Checks if the offset of input section SHNDX within its output
2027   // Get the offset of input section SHNDX within its output section.
2030   // output_sections_ field of the parent class Relobj.
2051   // Return the vector of section offsets.
2056   // Get the address of an output section.
2060   // Get the offset of a section.
2070   // Set the offset of a section.
2082   // of type GOT_TYPE.
2094   // Return the GOT offset of type GOT_TYPE of the local symbol
2109   // Set the GOT offset with type GOT_TYPE of the local symbol SYMNDX
2129   // Return the word size of the object file.
2140   // The GOT offsets of local symbols. This map also stores GOT offsets
2149   // For each input section, the offset of the input section in its
2203   // Return the number of symbols.  This is only valid after
2209   // If SYM is the index of a global symbol in the object file's
2222   // Return the section index of symbol SYM.  Set *VALUE to its value
2227   // it will not return the final value of the symbol in the link.
2232   // value of a local symbol.
2240   // Return the index of local symbol SYM in the ordinary symbol
2241   // table.  A value of -1U means that the symbol is not being output.
2249   // Return the index of local symbol SYM in the dynamic symbol
2250   // table.  A value of -1U means that the symbol is not being output.
2258   // Return the input section index of local symbol SYM.
2286   // Set the PLT offset of the local symbol SYMNDX.
2296   // Return the name of the symbol that spans the given offset in the
2342   // overrides of do_read_symbols.
2346   // Return the value of a local symbol.
2364   // Return the number of local symbols.
2369   // Return the number of local symbols in the output symbol table.
2374   // Return the number of local symbols in the output symbol table.
2405   // Process the relocs to find list of referenced sections. Used only
2433   do_relocate(const Symbol_table* symtab, const Layout*, Output_file* of);
2435   // Get the size of a section.
2440   // Get the name of a section.
2445   // Return the location of the contents of a section.
2554   // Stash away info for a number of special sections.
2555   // Return true if any of the sections found require local symbols to be read.
2562 		       const unsigned char* pshdrs, Output_file* of,
2565   // Relocate section data for a range of sections.
2568 			 const unsigned char* pshdrs, Output_file* of,
2595   // To keep track of discarded comdat sections, we need to map a member
2596   // section index to the object and section index of the corresponding
2659 		    const unsigned char* pshdrs, Output_file* of,
2661   { this->do_relocate_sections(symtab, layout, pshdrs, of, pviews); }
2674   // type of the relocation section.
2687   // type of the relocation section.
2776   // linking a relocatable output.  OUT_SECTIONS is an array of output
2777   // sections.  OUT_OFFSETS is an array of offsets of the sections.  SYMTAB
2793   // The PLT offsets of local symbols.
2817   // Type of ELF file (ET_REL or ET_EXEC).  ET_EXEC files are allowed
2820   // Index of SHT_SYMTAB section.
2822   // The number of local symbols.
2824   // The number of local symbols which go into the output file.
2826   // The number of local symbols which go into the output file's dynamic
2831   // Number of symbols defined in object file itself.
2833   // File offset for local symbols (relative to start of symbol table).
2837   // Values of local symbols.
2848   // True if the layout of this object was deferred, waiting for plugin
2851   // The list of sections whose layout was deferred.
2853   // The list of relocation sections whose layout was deferred.
2855   // Pointer to the list of output views; valid only during do_relocate().
2859 // A class to manage the list of all objects.
2868   // The type of the list of input relocateable objects.
2872   // The type of the list of input dynamic objects.
2889   // For each dynamic object, check whether we've seen all of its
2932   // Return the number of non dynamic objects.
2937   // Return the number of input objects.
2946   // The list of ordinary objects included in the link.
2948   // The list of dynamic objects included in the link.
2956 // Some of the information we pass to the relocation routines.  We
2968   // Section index of relocation section.
2970   // Section header of relocation section.
2974   // Section index of section being relocated.
2976   // Section header of data section.
2979   // Return a string showing the location of a relocation.  This is
2993 // The hash value is based on the address of an object in memory during
3011 // offset OFFSET.  This sets *START to point to a view of the start of
3012 // the file.  It sets *READ_SIZE to the number of bytes in the view.