1 //===- MCSectionELF.h - ELF Machine Code Sections ---------------*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file declares the MCSectionELF class.
12 //===----------------------------------------------------------------------===//
14 #ifndef LLVM_MC_MCSECTIONELF_H
15 #define LLVM_MC_MCSECTIONELF_H
17 #include "llvm/MC/MCSection.h"
21 /// MCSectionELF - This represents a section on linux, lots of unix variants
22 /// and some bare metal systems.
23 class MCSectionELF : public MCSection {
24 std::string SectionName;
26 /// Type - This is the sh_type field of a section, drawn from the enums below.
29 /// Flags - This is the sh_flags field of a section, drawn from the enums.
33 /// IsExplicit - Indicates that this section comes from globals with an
34 /// explicit section specfied.
38 MCSectionELF(const StringRef &Section, unsigned type, unsigned flags,
39 SectionKind K, bool isExplicit)
40 : MCSection(K), SectionName(Section.str()), Type(type), Flags(flags),
41 IsExplicit(isExplicit) {}
44 static MCSectionELF *Create(const StringRef &Section, unsigned Type,
45 unsigned Flags, SectionKind K, bool isExplicit,
48 /// ShouldOmitSectionDirective - Decides whether a '.section' directive
49 /// should be printed before the section name
50 bool ShouldOmitSectionDirective(const char *Name,
51 const TargetAsmInfo &TAI) const;
53 /// ShouldPrintSectionType - Only prints the section type if supported
54 bool ShouldPrintSectionType(unsigned Ty) const;
56 /// HasCommonSymbols - True if this section holds common symbols, this is
57 /// indicated on the ELF object file by a symbol with SHN_COMMON section
59 bool HasCommonSymbols() const;
61 /// These are the section type and flags fields. An ELF section can have
62 /// only one Type, but can have more than one of the flags specified.
64 /// Valid section types.
66 // This value marks the section header as inactive.
69 // Holds information defined by the program, with custom format and meaning.
72 // This section holds a symbol table.
75 // The section holds a string table.
78 // The section holds relocation entries with explicit addends.
81 // The section holds a symbol hash table.
84 // Information for dynamic linking.
87 // The section holds information that marks the file in some way.
90 // A section of this type occupies no space in the file.
93 // The section holds relocation entries without explicit addends.
96 // This section type is reserved but has unspecified semantics.
99 // This section holds a symbol table.
102 // This section contains an array of pointers to initialization functions.
103 SHT_INIT_ARRAY = 0x0EU,
105 // This section contains an array of pointers to termination functions.
106 SHT_FINI_ARRAY = 0x0FU,
108 // This section contains an array of pointers to functions that are invoked
109 // before all other initialization functions.
110 SHT_PREINIT_ARRAY = 0x10U,
112 // A section group is a set of sections that are related and that must be
113 // treated specially by the linker.
116 // This section is associated with a section of type SHT_SYMTAB, when the
117 // referenced symbol table contain the escape value SHN_XINDEX
118 SHT_SYMTAB_SHNDX = 0x12U,
120 LAST_KNOWN_SECTION_TYPE = SHT_SYMTAB_SHNDX
123 /// Valid section flags.
125 // The section contains data that should be writable.
128 // The section occupies memory during execution.
131 // The section contains executable machine instructions.
132 SHF_EXECINSTR = 0x4U,
134 // The data in the section may be merged to eliminate duplication.
137 // Elements in the section consist of null-terminated character strings.
140 // A field in this section holds a section header table index.
141 SHF_INFO_LINK = 0x40U,
143 // Adds special ordering requirements for link editors.
144 SHF_LINK_ORDER = 0x80U,
146 // This section requires special OS-specific processing to avoid incorrect
148 SHF_OS_NONCONFORMING = 0x100U,
150 // This section is a member of a section group.
153 // This section holds Thread-Local Storage.
156 /// FIRST_TARGET_DEP_FLAG - This is the first flag that subclasses are
157 /// allowed to specify.
158 FIRST_TARGET_DEP_FLAG = 0x800U,
160 /// TARGET_INDEP_SHF - This is the bitmask for all the target independent
161 /// section flags. Targets can define their own target flags above these.
162 /// If they do that, they should implement their own MCSectionELF subclasses
163 /// and implement the virtual method hooks below to handle printing needs.
164 TARGET_INDEP_SHF = FIRST_TARGET_DEP_FLAG-1U
167 StringRef getSectionName() const {
168 return StringRef(SectionName);
171 unsigned getType() const { return Type; }
172 unsigned getFlags() const { return Flags; }
174 virtual void PrintSwitchToSection(const TargetAsmInfo &TAI,
175 raw_ostream &OS) const;
178 /// PrintTargetSpecificSectionFlags - Targets that define their own
179 /// MCSectionELF subclasses with target specific section flags should
180 /// implement this method if they end up adding letters to the attributes
182 virtual void PrintTargetSpecificSectionFlags(const TargetAsmInfo &TAI,
183 raw_ostream &OS) const {
189 } // end namespace llvm