1 //===- ObjectFile.cpp - File format independent object file ---------------===//
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
7 //===----------------------------------------------------------------------===//
9 // This file defines a file format independent ObjectFile class.
11 //===----------------------------------------------------------------------===//
13 #include "llvm/Object/ObjectFile.h"
14 #include "llvm/ADT/StringRef.h"
15 #include "llvm/BinaryFormat/Magic.h"
16 #include "llvm/Object/Binary.h"
17 #include "llvm/Object/COFF.h"
18 #include "llvm/Object/Error.h"
19 #include "llvm/Object/MachO.h"
20 #include "llvm/Object/Wasm.h"
21 #include "llvm/Support/Error.h"
22 #include "llvm/Support/ErrorHandling.h"
23 #include "llvm/Support/ErrorOr.h"
24 #include "llvm/Support/FileSystem.h"
25 #include "llvm/Support/MemoryBuffer.h"
26 #include "llvm/Support/raw_ostream.h"
30 #include <system_error>
33 using namespace object
;
35 void ObjectFile::anchor() {}
37 ObjectFile::ObjectFile(unsigned int Type
, MemoryBufferRef Source
)
38 : SymbolicFile(Type
, Source
) {}
40 bool SectionRef::containsSymbol(SymbolRef S
) const {
41 Expected
<section_iterator
> SymSec
= S
.getSection();
43 // TODO: Actually report errors helpfully.
44 consumeError(SymSec
.takeError());
47 return *this == **SymSec
;
50 uint64_t ObjectFile::getSymbolValue(DataRefImpl Ref
) const {
51 uint32_t Flags
= getSymbolFlags(Ref
);
52 if (Flags
& SymbolRef::SF_Undefined
)
54 if (Flags
& SymbolRef::SF_Common
)
55 return getCommonSymbolSize(Ref
);
56 return getSymbolValueImpl(Ref
);
59 Error
ObjectFile::printSymbolName(raw_ostream
&OS
, DataRefImpl Symb
) const {
60 Expected
<StringRef
> Name
= getSymbolName(Symb
);
62 return Name
.takeError();
64 return Error::success();
67 uint32_t ObjectFile::getSymbolAlignment(DataRefImpl DRI
) const { return 0; }
69 bool ObjectFile::isSectionBitcode(DataRefImpl Sec
) const {
70 Expected
<StringRef
> NameOrErr
= getSectionName(Sec
);
72 return *NameOrErr
== ".llvmbc";
73 consumeError(NameOrErr
.takeError());
77 bool ObjectFile::isSectionStripped(DataRefImpl Sec
) const { return false; }
79 bool ObjectFile::isBerkeleyText(DataRefImpl Sec
) const {
80 return isSectionText(Sec
);
83 bool ObjectFile::isBerkeleyData(DataRefImpl Sec
) const {
84 return isSectionData(Sec
);
87 section_iterator
ObjectFile::getRelocatedSection(DataRefImpl Sec
) const {
88 return section_iterator(SectionRef(Sec
, this));
91 Triple
ObjectFile::makeTriple() const {
93 auto Arch
= getArch();
94 TheTriple
.setArch(Triple::ArchType(Arch
));
96 // For ARM targets, try to use the build attributes to build determine
97 // the build target. Target features are also added, but later during
99 if (Arch
== Triple::arm
|| Arch
== Triple::armeb
)
100 setARMSubArch(TheTriple
);
102 // TheTriple defaults to ELF, and COFF doesn't have an environment:
103 // the best we can do here is indicate that it is mach-o.
105 TheTriple
.setObjectFormat(Triple::MachO
);
108 const auto COFFObj
= dyn_cast
<COFFObjectFile
>(this);
109 if (COFFObj
->getArch() == Triple::thumb
)
110 TheTriple
.setTriple("thumbv7-windows");
116 Expected
<std::unique_ptr
<ObjectFile
>>
117 ObjectFile::createObjectFile(MemoryBufferRef Object
, file_magic Type
) {
118 StringRef Data
= Object
.getBuffer();
119 if (Type
== file_magic::unknown
)
120 Type
= identify_magic(Data
);
123 case file_magic::unknown
:
124 case file_magic::bitcode
:
125 case file_magic::coff_cl_gl_object
:
126 case file_magic::archive
:
127 case file_magic::macho_universal_binary
:
128 case file_magic::windows_resource
:
129 case file_magic::pdb
:
130 case file_magic::minidump
:
131 return errorCodeToError(object_error::invalid_file_type
);
132 case file_magic::tapi_file
:
133 return errorCodeToError(object_error::invalid_file_type
);
134 case file_magic::elf
:
135 case file_magic::elf_relocatable
:
136 case file_magic::elf_executable
:
137 case file_magic::elf_shared_object
:
138 case file_magic::elf_core
:
139 return createELFObjectFile(Object
);
140 case file_magic::macho_object
:
141 case file_magic::macho_executable
:
142 case file_magic::macho_fixed_virtual_memory_shared_lib
:
143 case file_magic::macho_core
:
144 case file_magic::macho_preload_executable
:
145 case file_magic::macho_dynamically_linked_shared_lib
:
146 case file_magic::macho_dynamic_linker
:
147 case file_magic::macho_bundle
:
148 case file_magic::macho_dynamically_linked_shared_lib_stub
:
149 case file_magic::macho_dsym_companion
:
150 case file_magic::macho_kext_bundle
:
151 return createMachOObjectFile(Object
);
152 case file_magic::coff_object
:
153 case file_magic::coff_import_library
:
154 case file_magic::pecoff_executable
:
155 return createCOFFObjectFile(Object
);
156 case file_magic::xcoff_object_32
:
157 return createXCOFFObjectFile(Object
, Binary::ID_XCOFF32
);
158 case file_magic::xcoff_object_64
:
159 return createXCOFFObjectFile(Object
, Binary::ID_XCOFF64
);
160 case file_magic::wasm_object
:
161 return createWasmObjectFile(Object
);
163 llvm_unreachable("Unexpected Object File Type");
166 Expected
<OwningBinary
<ObjectFile
>>
167 ObjectFile::createObjectFile(StringRef ObjectPath
) {
168 ErrorOr
<std::unique_ptr
<MemoryBuffer
>> FileOrErr
=
169 MemoryBuffer::getFile(ObjectPath
);
170 if (std::error_code EC
= FileOrErr
.getError())
171 return errorCodeToError(EC
);
172 std::unique_ptr
<MemoryBuffer
> Buffer
= std::move(FileOrErr
.get());
174 Expected
<std::unique_ptr
<ObjectFile
>> ObjOrErr
=
175 createObjectFile(Buffer
->getMemBufferRef());
176 if (Error Err
= ObjOrErr
.takeError())
177 return std::move(Err
);
178 std::unique_ptr
<ObjectFile
> Obj
= std::move(ObjOrErr
.get());
180 return OwningBinary
<ObjectFile
>(std::move(Obj
), std::move(Buffer
));