LLVM 19.0.0git
ObjectFile.h
Go to the documentation of this file.
1//===- ObjectFile.h - File format independent object file -------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file declares a file format independent ObjectFile class.
10//
11//===----------------------------------------------------------------------===//
12
13#ifndef LLVM_OBJECT_OBJECTFILE_H
14#define LLVM_OBJECT_OBJECTFILE_H
15
16#include "llvm/ADT/ArrayRef.h"
17#include "llvm/ADT/Hashing.h"
18#include "llvm/ADT/StringRef.h"
22#include "llvm/Object/Binary.h"
23#include "llvm/Object/Error.h"
26#include "llvm/Support/Error.h"
29#include <cassert>
30#include <cstdint>
31#include <memory>
32
33namespace llvm {
34
35class SubtargetFeatures;
36
37namespace object {
38
39class COFFObjectFile;
40class MachOObjectFile;
41class ObjectFile;
42class SectionRef;
43class SymbolRef;
44class symbol_iterator;
45class WasmObjectFile;
46
48
49typedef std::function<bool(const SectionRef &)> SectionFilterPredicate;
50/// This is a value type class that represents a single relocation in the list
51/// of relocations in the object file.
53 DataRefImpl RelocationPimpl;
54 const ObjectFile *OwningObject = nullptr;
55
56public:
57 RelocationRef() = default;
58 RelocationRef(DataRefImpl RelocationP, const ObjectFile *Owner);
59
60 bool operator==(const RelocationRef &Other) const;
61
62 void moveNext();
63
64 uint64_t getOffset() const;
66 uint64_t getType() const;
67
68 /// Get a string that represents the type of this relocation.
69 ///
70 /// This is for display purposes only.
71 void getTypeName(SmallVectorImpl<char> &Result) const;
72
74 const ObjectFile *getObject() const;
75};
76
78
79/// This is a value type class that represents a single section in the list of
80/// sections in the object file.
82 friend class SymbolRef;
83
84 DataRefImpl SectionPimpl;
85 const ObjectFile *OwningObject = nullptr;
86
87public:
88 SectionRef() = default;
89 SectionRef(DataRefImpl SectionP, const ObjectFile *Owner);
90
91 bool operator==(const SectionRef &Other) const;
92 bool operator!=(const SectionRef &Other) const;
93 bool operator<(const SectionRef &Other) const;
94
95 void moveNext();
96
98 uint64_t getAddress() const;
99 uint64_t getIndex() const;
100 uint64_t getSize() const;
102
103 /// Get the alignment of this section.
104 Align getAlignment() const;
105
106 bool isCompressed() const;
107 /// Whether this section contains instructions.
108 bool isText() const;
109 /// Whether this section contains data, not instructions.
110 bool isData() const;
111 /// Whether this section contains BSS uninitialized data.
112 bool isBSS() const;
113 bool isVirtual() const;
114 bool isBitcode() const;
115 bool isStripped() const;
116
117 /// Whether this section will be placed in the text segment, according to the
118 /// Berkeley size format. This is true if the section is allocatable, and
119 /// contains either code or readonly data.
120 bool isBerkeleyText() const;
121 /// Whether this section will be placed in the data segment, according to the
122 /// Berkeley size format. This is true if the section is allocatable and
123 /// contains data (e.g. PROGBITS), but is not text.
124 bool isBerkeleyData() const;
125
126 /// Whether this section is a debug section.
127 bool isDebugSection() const;
128
129 bool containsSymbol(SymbolRef S) const;
130
135 }
136
137 /// Returns the related section if this section contains relocations. The
138 /// returned section may or may not have applied its relocations.
140
142 const ObjectFile *getObject() const;
143};
144
147
150};
151
152inline bool operator<(const SectionedAddress &LHS,
153 const SectionedAddress &RHS) {
154 return std::tie(LHS.SectionIndex, LHS.Address) <
155 std::tie(RHS.SectionIndex, RHS.Address);
156}
157
158inline bool operator==(const SectionedAddress &LHS,
159 const SectionedAddress &RHS) {
160 return std::tie(LHS.SectionIndex, LHS.Address) ==
161 std::tie(RHS.SectionIndex, RHS.Address);
162}
163
165
166/// This is a value type class that represents a single symbol in the list of
167/// symbols in the object file.
168class SymbolRef : public BasicSymbolRef {
169 friend class SectionRef;
170
171public:
172 enum Type {
173 ST_Unknown, // Type not specified
179 };
180
181 SymbolRef() = default;
182 SymbolRef(DataRefImpl SymbolP, const ObjectFile *Owner);
184 assert(isa<ObjectFile>(BasicSymbolRef::getObject()));
185 }
186
188 /// Returns the symbol virtual address (i.e. address at which it will be
189 /// mapped).
191
192 /// Return the value of the symbol depending on the object this can be an
193 /// offset or a virtual address.
195
196 /// Get the alignment of this symbol as the actual value (not log 2).
197 uint32_t getAlignment() const;
198 uint64_t getCommonSize() const;
200
201 /// Get section this symbol is defined in reference to. Result is
202 /// end_sections() if it is undefined or is an absolute symbol.
204
205 const ObjectFile *getObject() const;
206};
207
209public:
212 : basic_symbol_iterator(SymbolRef(B->getRawDataRefImpl(),
213 cast<ObjectFile>(B->getObject()))) {}
214
215 const SymbolRef *operator->() const {
217 return static_cast<const SymbolRef*>(&P);
218 }
219
220 const SymbolRef &operator*() const {
222 return static_cast<const SymbolRef&>(P);
223 }
224};
225
226/// This class is the base class for all object file types. Concrete instances
227/// of this object are created by createObjectFile, which figures out which type
228/// to create.
229class ObjectFile : public SymbolicFile {
230 virtual void anchor();
231
232protected:
233 ObjectFile(unsigned int Type, MemoryBufferRef Source);
234
235 const uint8_t *base() const {
236 return reinterpret_cast<const uint8_t *>(Data.getBufferStart());
237 }
238
239 // These functions are for SymbolRef to call internally. The main goal of
240 // this is to allow SymbolRef::SymbolPimpl to point directly to the symbol
241 // entry in the memory mapped object file. SymbolPimpl cannot contain any
242 // virtual functions because then it could not point into the memory mapped
243 // file.
244 //
245 // Implementations assume that the DataRefImpl is valid and has not been
246 // modified externally. It's UB otherwise.
247 friend class SymbolRef;
248
251 DataRefImpl Symb) const override;
253 virtual uint64_t getSymbolValueImpl(DataRefImpl Symb) const = 0;
254 virtual uint32_t getSymbolAlignment(DataRefImpl Symb) const;
259
260 // Same as above for SectionRef.
261 friend class SectionRef;
262
263 virtual void moveSectionNext(DataRefImpl &Sec) const = 0;
265 virtual uint64_t getSectionAddress(DataRefImpl Sec) const = 0;
266 virtual uint64_t getSectionIndex(DataRefImpl Sec) const = 0;
267 virtual uint64_t getSectionSize(DataRefImpl Sec) const = 0;
271 virtual bool isSectionCompressed(DataRefImpl Sec) const = 0;
272 virtual bool isSectionText(DataRefImpl Sec) const = 0;
273 virtual bool isSectionData(DataRefImpl Sec) const = 0;
274 virtual bool isSectionBSS(DataRefImpl Sec) const = 0;
275 // A section is 'virtual' if its contents aren't present in the object image.
276 virtual bool isSectionVirtual(DataRefImpl Sec) const = 0;
277 virtual bool isSectionBitcode(DataRefImpl Sec) const;
278 virtual bool isSectionStripped(DataRefImpl Sec) const;
279 virtual bool isBerkeleyText(DataRefImpl Sec) const;
280 virtual bool isBerkeleyData(DataRefImpl Sec) const;
281 virtual bool isDebugSection(DataRefImpl Sec) const;
285
286 // Same as above for RelocationRef.
287 friend class RelocationRef;
288 virtual void moveRelocationNext(DataRefImpl &Rel) const = 0;
291 virtual uint64_t getRelocationType(DataRefImpl Rel) const = 0;
293 SmallVectorImpl<char> &Result) const = 0;
294
298 };
299
301
302public:
303 ObjectFile() = delete;
304 ObjectFile(const ObjectFile &other) = delete;
305
307 Expected<uint32_t> SymbolFlagsOrErr = getSymbolFlags(Symb);
308 if (!SymbolFlagsOrErr)
309 // TODO: Actually report errors helpfully.
310 report_fatal_error(SymbolFlagsOrErr.takeError());
311 assert(*SymbolFlagsOrErr & SymbolRef::SF_Common);
312 return getCommonSymbolSizeImpl(Symb);
313 }
314
315 virtual std::vector<SectionRef> dynamic_relocation_sections() const {
316 return std::vector<SectionRef>();
317 }
318
322 }
323
324 virtual section_iterator section_begin() const = 0;
325 virtual section_iterator section_end() const = 0;
326
330 }
331
332 virtual bool hasDebugInfo() const;
333
334 /// The number of bytes used to represent an address in this object
335 /// file format.
336 virtual uint8_t getBytesInAddress() const = 0;
337
338 virtual StringRef getFileFormatName() const = 0;
339 virtual Triple::ArchType getArch() const = 0;
340 virtual Triple::OSType getOS() const { return Triple::UnknownOS; }
342 virtual std::optional<StringRef> tryGetCPUName() const {
343 return std::nullopt;
344 };
345 virtual void setARMSubArch(Triple &TheTriple) const { }
348 };
349
350 /// Create a triple from the data in this object file.
351 Triple makeTriple() const;
352
353 /// Maps a debug section name to a standard DWARF section name.
355
356 /// True if this is a relocatable object (.o/.obj).
357 virtual bool isRelocatableObject() const = 0;
358
359 /// True if the reflection section can be stripped by the linker.
362 const;
363
364 /// @returns Pointer to ObjectFile subclass to handle this type of object.
365 /// @param ObjectPath The path to the object file. ObjectPath.isObject must
366 /// return true.
367 /// Create ObjectFile from path.
369 createObjectFile(StringRef ObjectPath);
370
373 bool InitContent = true);
377 }
378
379 static bool classof(const Binary *v) {
380 return v->isObject();
381 }
382
385
387 createXCOFFObjectFile(MemoryBufferRef Object, unsigned FileType);
388
390 createELFObjectFile(MemoryBufferRef Object, bool InitContent = true);
391
393 createMachOObjectFile(MemoryBufferRef Object, uint32_t UniversalCputype = 0,
394 uint32_t UniversalIndex = 0,
395 size_t MachOFilesetEntryOffset = 0);
396
399
402};
403
404/// A filtered iterator for SectionRefs that skips sections based on some given
405/// predicate.
407public:
409 const section_iterator &Begin,
410 const section_iterator &End)
411 : Predicate(std::move(Pred)), Iterator(Begin), End(End) {
412 scanPredicate();
413 }
414 const SectionRef &operator*() const { return *Iterator; }
416 ++Iterator;
417 scanPredicate();
418 return *this;
419 }
421 return Iterator != Other.Iterator;
422 }
423
424private:
425 void scanPredicate() {
426 while (Iterator != End && !Predicate(*Iterator)) {
427 ++Iterator;
428 }
429 }
430 SectionFilterPredicate Predicate;
431 section_iterator Iterator;
433};
434
435/// Creates an iterator range of SectionFilterIterators for a given Object and
436/// predicate.
438public:
440 : Predicate(std::move(Pred)), Object(Obj) {}
442 return SectionFilterIterator(Predicate, Object.section_begin(),
443 Object.section_end());
444 }
446 return SectionFilterIterator(Predicate, Object.section_end(),
447 Object.section_end());
448 }
449
450private:
451 SectionFilterPredicate Predicate;
452 const ObjectFile &Object;
453};
454
455// Inline function definitions.
456inline SymbolRef::SymbolRef(DataRefImpl SymbolP, const ObjectFile *Owner)
457 : BasicSymbolRef(SymbolP, Owner) {}
458
461}
462
465}
466
469}
470
473}
474
477}
478
481}
482
485}
486
487inline const ObjectFile *SymbolRef::getObject() const {
489 return cast<ObjectFile>(O);
490}
491
492/// SectionRef
494 const ObjectFile *Owner)
495 : SectionPimpl(SectionP)
496 , OwningObject(Owner) {}
497
498inline bool SectionRef::operator==(const SectionRef &Other) const {
499 return OwningObject == Other.OwningObject &&
500 SectionPimpl == Other.SectionPimpl;
501}
502
503inline bool SectionRef::operator!=(const SectionRef &Other) const {
504 return !(*this == Other);
505}
506
507inline bool SectionRef::operator<(const SectionRef &Other) const {
508 assert(OwningObject == Other.OwningObject);
509 return SectionPimpl < Other.SectionPimpl;
510}
511
512inline void SectionRef::moveNext() {
513 return OwningObject->moveSectionNext(SectionPimpl);
514}
515
517 return OwningObject->getSectionName(SectionPimpl);
518}
519
521 return OwningObject->getSectionAddress(SectionPimpl);
522}
523
525 return OwningObject->getSectionIndex(SectionPimpl);
526}
527
529 return OwningObject->getSectionSize(SectionPimpl);
530}
531
534 OwningObject->getSectionContents(SectionPimpl);
535 if (!Res)
536 return Res.takeError();
537 return StringRef(reinterpret_cast<const char *>(Res->data()), Res->size());
538}
539
541 return MaybeAlign(OwningObject->getSectionAlignment(SectionPimpl))
542 .valueOrOne();
543}
544
545inline bool SectionRef::isCompressed() const {
546 return OwningObject->isSectionCompressed(SectionPimpl);
547}
548
549inline bool SectionRef::isText() const {
550 return OwningObject->isSectionText(SectionPimpl);
551}
552
553inline bool SectionRef::isData() const {
554 return OwningObject->isSectionData(SectionPimpl);
555}
556
557inline bool SectionRef::isBSS() const {
558 return OwningObject->isSectionBSS(SectionPimpl);
559}
560
561inline bool SectionRef::isVirtual() const {
562 return OwningObject->isSectionVirtual(SectionPimpl);
563}
564
565inline bool SectionRef::isBitcode() const {
566 return OwningObject->isSectionBitcode(SectionPimpl);
567}
568
569inline bool SectionRef::isStripped() const {
570 return OwningObject->isSectionStripped(SectionPimpl);
571}
572
573inline bool SectionRef::isBerkeleyText() const {
574 return OwningObject->isBerkeleyText(SectionPimpl);
575}
576
577inline bool SectionRef::isBerkeleyData() const {
578 return OwningObject->isBerkeleyData(SectionPimpl);
579}
580
581inline bool SectionRef::isDebugSection() const {
582 return OwningObject->isDebugSection(SectionPimpl);
583}
584
586 return OwningObject->section_rel_begin(SectionPimpl);
587}
588
590 return OwningObject->section_rel_end(SectionPimpl);
591}
592
594 return OwningObject->getRelocatedSection(SectionPimpl);
595}
596
598 return SectionPimpl;
599}
600
601inline const ObjectFile *SectionRef::getObject() const {
602 return OwningObject;
603}
604
605/// RelocationRef
607 const ObjectFile *Owner)
608 : RelocationPimpl(RelocationP)
609 , OwningObject(Owner) {}
610
612 return RelocationPimpl == Other.RelocationPimpl;
613}
614
616 return OwningObject->moveRelocationNext(RelocationPimpl);
617}
618
620 return OwningObject->getRelocationOffset(RelocationPimpl);
621}
622
624 return OwningObject->getRelocationSymbol(RelocationPimpl);
625}
626
628 return OwningObject->getRelocationType(RelocationPimpl);
629}
630
632 return OwningObject->getRelocationTypeName(RelocationPimpl, Result);
633}
634
636 return RelocationPimpl;
637}
638
640 return OwningObject;
641}
642
643} // end namespace object
644
645template <> struct DenseMapInfo<object::SectionRef> {
646 static bool isEqual(const object::SectionRef &A,
647 const object::SectionRef &B) {
648 return A == B;
649 }
651 return object::SectionRef({}, nullptr);
652 }
655 TS.p = (uintptr_t)-1;
656 return object::SectionRef(TS, nullptr);
657 }
658 static unsigned getHashValue(const object::SectionRef &Sec) {
660 return hash_combine(Raw.p, Raw.d.a, Raw.d.b);
661 }
662};
663
664} // end namespace llvm
665
666#endif // LLVM_OBJECT_OBJECTFILE_H
static GCRegistry::Add< OcamlGC > B("ocaml", "ocaml 3.10-compatible GC")
static GCRegistry::Add< ErlangGC > A("erlang", "erlang-compatible garbage collector")
uint64_t Addr
std::string Name
bool End
Definition: ELF_riscv.cpp:480
Symbol * Sym
Definition: ELF_riscv.cpp:479
#define P(N)
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
raw_pwrite_stream & OS
Value * RHS
Value * LHS
Lightweight error class with error context and mandatory checking.
Definition: Error.h:160
Tagged union holding either a T or a Error.
Definition: Error.h:474
Error takeError()
Take ownership of the stored error.
Definition: Error.h:601
const char * getBufferStart() const
This class consists of common code factored out of the SmallVector class to reduce code duplication b...
Definition: SmallVector.h:586
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
Triple - Helper class for working with autoconf configuration names.
Definition: Triple.h:44
The instances of the Type class are immutable: once they are created, they are never changed.
Definition: Type.h:45
A range adaptor for a pair of iterators.
This is a value type class that represents a single symbol in the list of symbols in the object file.
Definition: SymbolicFile.h:103
const SymbolicFile * getObject() const
Definition: SymbolicFile.h:214
DataRefImpl getRawDataRefImpl() const
Definition: SymbolicFile.h:210
MemoryBufferRef Data
Definition: Binary.h:37
This class is the base class for all object file types.
Definition: ObjectFile.h:229
virtual bool isBerkeleyText(DataRefImpl Sec) const
Definition: ObjectFile.cpp:89
virtual Expected< section_iterator > getRelocatedSection(DataRefImpl Sec) const
Definition: ObjectFile.cpp:105
uint64_t getCommonSymbolSize(DataRefImpl Symb) const
Definition: ObjectFile.h:306
virtual uint64_t getSectionIndex(DataRefImpl Sec) const =0
virtual Expected< StringRef > getSectionName(DataRefImpl Sec) const =0
virtual uint64_t getSectionAlignment(DataRefImpl Sec) const =0
virtual bool isBerkeleyData(DataRefImpl Sec) const
Definition: ObjectFile.cpp:93
virtual bool isSectionBSS(DataRefImpl Sec) const =0
virtual Expected< StringRef > getSymbolName(DataRefImpl Symb) const =0
virtual void getRelocationTypeName(DataRefImpl Rel, SmallVectorImpl< char > &Result) const =0
virtual std::vector< SectionRef > dynamic_relocation_sections() const
Definition: ObjectFile.h:315
static Expected< std::unique_ptr< MachOObjectFile > > createMachOObjectFile(MemoryBufferRef Object, uint32_t UniversalCputype=0, uint32_t UniversalIndex=0, size_t MachOFilesetEntryOffset=0)
Create a MachOObjectFile instance from a given buffer.
static Expected< std::unique_ptr< COFFObjectFile > > createCOFFObjectFile(MemoryBufferRef Object)
virtual section_iterator section_end() const =0
virtual llvm::binaryformat::Swift5ReflectionSectionKind mapReflectionSectionNameToEnumValue(StringRef SectionName) const
Definition: ObjectFile.h:296
virtual uint8_t getBytesInAddress() const =0
The number of bytes used to represent an address in this object file format.
Error printSymbolName(raw_ostream &OS, DataRefImpl Symb) const override
Definition: ObjectFile.cpp:69
virtual Expected< uint64_t > getSymbolAddress(DataRefImpl Symb) const =0
virtual Expected< ArrayRef< uint8_t > > getSectionContents(DataRefImpl Sec) const =0
virtual bool isSectionVirtual(DataRefImpl Sec) const =0
virtual uint64_t getRelocationType(DataRefImpl Rel) const =0
static Expected< std::unique_ptr< ObjectFile > > createELFObjectFile(MemoryBufferRef Object, bool InitContent=true)
virtual uint64_t getCommonSymbolSizeImpl(DataRefImpl Symb) const =0
virtual Expected< SubtargetFeatures > getFeatures() const =0
virtual bool isSectionCompressed(DataRefImpl Sec) const =0
virtual uint64_t getSectionSize(DataRefImpl Sec) const =0
Triple makeTriple() const
Create a triple from the data in this object file.
Definition: ObjectFile.cpp:109
virtual bool isSectionText(DataRefImpl Sec) const =0
virtual relocation_iterator section_rel_begin(DataRefImpl Sec) const =0
section_iterator_range sections() const
Definition: ObjectFile.h:328
virtual StringRef getFileFormatName() const =0
virtual uint64_t getSymbolValueImpl(DataRefImpl Symb) const =0
virtual void moveSectionNext(DataRefImpl &Sec) const =0
virtual bool isDebugSection(DataRefImpl Sec) const
Definition: ObjectFile.cpp:97
virtual void setARMSubArch(Triple &TheTriple) const
Definition: ObjectFile.h:345
virtual symbol_iterator getRelocationSymbol(DataRefImpl Rel) const =0
virtual uint64_t getSectionAddress(DataRefImpl Sec) const =0
static Expected< std::unique_ptr< WasmObjectFile > > createWasmObjectFile(MemoryBufferRef Object)
static Expected< OwningBinary< ObjectFile > > createObjectFile(StringRef ObjectPath)
Definition: ObjectFile.cpp:209
virtual uint32_t getSymbolAlignment(DataRefImpl Symb) const
Definition: ObjectFile.cpp:77
ObjectFile(const ObjectFile &other)=delete
virtual StringRef mapDebugSectionName(StringRef Name) const
Maps a debug section name to a standard DWARF section name.
Definition: ObjectFile.h:354
symbol_iterator_range symbols() const
Definition: ObjectFile.h:320
virtual bool isSectionData(DataRefImpl Sec) const =0
Expected< uint64_t > getSymbolValue(DataRefImpl Symb) const
Definition: ObjectFile.cpp:56
iterator_range< section_iterator > section_iterator_range
Definition: ObjectFile.h:327
virtual void moveRelocationNext(DataRefImpl &Rel) const =0
const uint8_t * base() const
Definition: ObjectFile.h:235
virtual Expected< section_iterator > getSymbolSection(DataRefImpl Symb) const =0
virtual bool isRelocatableObject() const =0
True if this is a relocatable object (.o/.obj).
virtual Triple::OSType getOS() const
Definition: ObjectFile.h:340
bool isReflectionSectionStrippable(llvm::binaryformat::Swift5ReflectionSectionKind ReflectionSectionKind) const
True if the reflection section can be stripped by the linker.
Definition: ObjectFile.cpp:225
virtual bool hasDebugInfo() const
Definition: ObjectFile.cpp:99
static Expected< std::unique_ptr< ObjectFile > > createGOFFObjectFile(MemoryBufferRef Object)
static bool classof(const Binary *v)
Definition: ObjectFile.h:379
static Expected< std::unique_ptr< ObjectFile > > createXCOFFObjectFile(MemoryBufferRef Object, unsigned FileType)
virtual Expected< uint64_t > getStartAddress() const
Definition: ObjectFile.h:346
virtual relocation_iterator section_rel_end(DataRefImpl Sec) const =0
virtual Triple::ArchType getArch() const =0
virtual bool isSectionStripped(DataRefImpl Sec) const
Definition: ObjectFile.cpp:87
virtual std::optional< StringRef > tryGetCPUName() const
Definition: ObjectFile.h:342
virtual bool isSectionBitcode(DataRefImpl Sec) const
Definition: ObjectFile.cpp:79
iterator_range< symbol_iterator > symbol_iterator_range
Definition: ObjectFile.h:319
virtual uint64_t getRelocationOffset(DataRefImpl Rel) const =0
static Expected< std::unique_ptr< ObjectFile > > createObjectFile(MemoryBufferRef Object)
Definition: ObjectFile.h:375
virtual Expected< SymbolRef::Type > getSymbolType(DataRefImpl Symb) const =0
virtual section_iterator section_begin() const =0
This is a value type class that represents a single relocation in the list of relocations in the obje...
Definition: ObjectFile.h:52
uint64_t getType() const
Definition: ObjectFile.h:627
bool operator==(const RelocationRef &Other) const
Definition: ObjectFile.h:611
uint64_t getOffset() const
Definition: ObjectFile.h:619
symbol_iterator getSymbol() const
Definition: ObjectFile.h:623
const ObjectFile * getObject() const
Definition: ObjectFile.h:639
void getTypeName(SmallVectorImpl< char > &Result) const
Get a string that represents the type of this relocation.
Definition: ObjectFile.h:631
DataRefImpl getRawDataRefImpl() const
Definition: ObjectFile.h:635
A filtered iterator for SectionRefs that skips sections based on some given predicate.
Definition: ObjectFile.h:406
SectionFilterIterator & operator++()
Definition: ObjectFile.h:415
const SectionRef & operator*() const
Definition: ObjectFile.h:414
bool operator!=(const SectionFilterIterator &Other) const
Definition: ObjectFile.h:420
SectionFilterIterator(SectionFilterPredicate Pred, const section_iterator &Begin, const section_iterator &End)
Definition: ObjectFile.h:408
Creates an iterator range of SectionFilterIterators for a given Object and predicate.
Definition: ObjectFile.h:437
SectionFilterIterator begin()
Definition: ObjectFile.h:441
SectionFilter(SectionFilterPredicate Pred, const ObjectFile &Obj)
Definition: ObjectFile.h:439
SectionFilterIterator end()
Definition: ObjectFile.h:445
This is a value type class that represents a single section in the list of sections in the object fil...
Definition: ObjectFile.h:81
uint64_t getIndex() const
Definition: ObjectFile.h:524
bool operator<(const SectionRef &Other) const
Definition: ObjectFile.h:507
DataRefImpl getRawDataRefImpl() const
Definition: ObjectFile.h:597
bool operator!=(const SectionRef &Other) const
Definition: ObjectFile.h:503
bool isDebugSection() const
Whether this section is a debug section.
Definition: ObjectFile.h:581
iterator_range< relocation_iterator > relocations() const
Definition: ObjectFile.h:133
bool isData() const
Whether this section contains data, not instructions.
Definition: ObjectFile.h:553
Expected< StringRef > getContents() const
Definition: ObjectFile.h:532
relocation_iterator relocation_end() const
Definition: ObjectFile.h:589
bool isCompressed() const
Definition: ObjectFile.h:545
bool isStripped() const
Definition: ObjectFile.h:569
bool isBSS() const
Whether this section contains BSS uninitialized data.
Definition: ObjectFile.h:557
uint64_t getSize() const
Definition: ObjectFile.h:528
bool containsSymbol(SymbolRef S) const
Definition: ObjectFile.cpp:46
bool operator==(const SectionRef &Other) const
Definition: ObjectFile.h:498
uint64_t getAddress() const
Definition: ObjectFile.h:520
bool isBerkeleyText() const
Whether this section will be placed in the text segment, according to the Berkeley size format.
Definition: ObjectFile.h:573
bool isVirtual() const
Definition: ObjectFile.h:561
bool isText() const
Whether this section contains instructions.
Definition: ObjectFile.h:549
relocation_iterator relocation_begin() const
Definition: ObjectFile.h:585
Align getAlignment() const
Get the alignment of this section.
Definition: ObjectFile.h:540
bool isBerkeleyData() const
Whether this section will be placed in the data segment, according to the Berkeley size format.
Definition: ObjectFile.h:577
const ObjectFile * getObject() const
Definition: ObjectFile.h:601
bool isBitcode() const
Definition: ObjectFile.h:565
Expected< StringRef > getName() const
Definition: ObjectFile.h:516
Expected< section_iterator > getRelocatedSection() const
Returns the related section if this section contains relocations.
Definition: ObjectFile.h:593
This is a value type class that represents a single symbol in the list of symbols in the object file.
Definition: ObjectFile.h:168
Expected< SymbolRef::Type > getType() const
Definition: ObjectFile.h:483
SymbolRef(const BasicSymbolRef &B)
Definition: ObjectFile.h:183
Expected< StringRef > getName() const
Definition: ObjectFile.h:459
uint32_t getAlignment() const
Get the alignment of this symbol as the actual value (not log 2).
Definition: ObjectFile.h:471
const ObjectFile * getObject() const
Definition: ObjectFile.h:487
Expected< uint64_t > getAddress() const
Returns the symbol virtual address (i.e.
Definition: ObjectFile.h:463
Expected< uint64_t > getValue() const
Return the value of the symbol depending on the object this can be an offset or a virtual address.
Definition: ObjectFile.h:467
Expected< section_iterator > getSection() const
Get section this symbol is defined in reference to.
Definition: ObjectFile.h:479
uint64_t getCommonSize() const
Definition: ObjectFile.h:475
virtual basic_symbol_iterator symbol_begin() const =0
virtual basic_symbol_iterator symbol_end() const =0
virtual Expected< uint32_t > getSymbolFlags(DataRefImpl Symb) const =0
const content_type & operator*() const
Definition: SymbolicFile.h:83
const SymbolRef * operator->() const
Definition: ObjectFile.h:215
symbol_iterator(const basic_symbol_iterator &B)
Definition: ObjectFile.h:211
const SymbolRef & operator*() const
Definition: ObjectFile.h:220
symbol_iterator(SymbolRef Sym)
Definition: ObjectFile.h:210
This class implements an extremely fast bulk output stream that can only output to a stream.
Definition: raw_ostream.h:52
This provides a very simple, boring adaptor for a begin and end iterator into a range type.
#define UINT64_MAX
Definition: DataTypes.h:77
Swift5ReflectionSectionKind
Definition: Swift.h:14
static Expected< const T * > getObject(MemoryBufferRef M, const void *Ptr, const uint64_t Size=sizeof(T))
content_iterator< SectionRef > section_iterator
Definition: ObjectFile.h:47
bool operator==(const SectionedAddress &LHS, const SectionedAddress &RHS)
Definition: ObjectFile.h:158
bool operator<(const SectionedAddress &LHS, const SectionedAddress &RHS)
Definition: ObjectFile.h:152
std::function< bool(const SectionRef &)> SectionFilterPredicate
Definition: ObjectFile.h:49
raw_ostream & operator<<(raw_ostream &OS, const SectionedAddress &Addr)
Definition: ObjectFile.cpp:34
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
iterator_range< T > make_range(T x, T y)
Convenience function for iterating over sub-ranges.
void report_fatal_error(Error Err, bool gen_crash_diag=true)
Report a serious error, calling any installed error handler.
Definition: Error.cpp:156
StringRef getTypeName()
We provide a function which tries to compute the (demangled) name of a type statically.
Definition: TypeName.h:27
@ Other
Any other memory.
OutputIt move(R &&Range, OutputIt Out)
Provide wrappers to std::move which take ranges instead of having to pass begin/end explicitly.
Definition: STLExtras.h:1858
decltype(auto) cast(const From &Val)
cast<X> - Return the argument parameter cast to the specified type.
Definition: Casting.h:565
Error errorCodeToError(std::error_code EC)
Helper for converting an std::error_code to a Error.
Definition: Error.cpp:103
hash_code hash_combine(const Ts &...args)
Combine values into a single hash_code.
Definition: Hashing.h:613
Implement std::hash so that hash_code can be used in STL containers.
Definition: BitVector.h:858
This struct is a compact representation of a valid (non-zero power of two) alignment.
Definition: Alignment.h:39
static unsigned getHashValue(const object::SectionRef &Sec)
Definition: ObjectFile.h:658
static object::SectionRef getEmptyKey()
Definition: ObjectFile.h:650
static object::SectionRef getTombstoneKey()
Definition: ObjectFile.h:653
static bool isEqual(const object::SectionRef &A, const object::SectionRef &B)
Definition: ObjectFile.h:646
An information struct used to provide DenseMap with the various necessary components for a given valu...
Definition: DenseMapInfo.h:50
This struct is a compact representation of a valid (power of two) or undefined (0) alignment.
Definition: Alignment.h:117
Align valueOrOne() const
For convenience, returns a valid alignment or 1 if undefined.
Definition: Alignment.h:141
file_magic - An "enum class" enumeration of file types based on magic (the first N bytes of the file)...
Definition: Magic.h:20
@ unknown
Unrecognized file.
Definition: Magic.h:22
static const uint64_t UndefSection
Definition: ObjectFile.h:146
struct llvm::object::DataRefImpl::@353 d