1 //===- ObjectFile.cpp - File format independent object file ---------------===// 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 defines a file format independent ObjectFile class. 10 // 11 //===----------------------------------------------------------------------===// 12 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/Format.h" 25 #include "llvm/Support/MemoryBuffer.h" 26 #include "llvm/Support/raw_ostream.h" 27 #include <cstdint> 28 #include <memory> 29 #include <system_error> 30 31 using namespace llvm; 32 using namespace object; 33 34 raw_ostream &object::operator<<(raw_ostream &OS, const SectionedAddress &Addr) { 35 OS << "SectionedAddress{" << format_hex(Addr.Address, 10); 36 if (Addr.SectionIndex != SectionedAddress::UndefSection) 37 OS << ", " << Addr.SectionIndex; 38 return OS << "}"; 39 } 40 41 void ObjectFile::anchor() {} 42 43 ObjectFile::ObjectFile(unsigned int Type, MemoryBufferRef Source) 44 : SymbolicFile(Type, Source) {} 45 46 bool SectionRef::containsSymbol(SymbolRef S) const { 47 Expected<section_iterator> SymSec = S.getSection(); 48 if (!SymSec) { 49 // TODO: Actually report errors helpfully. 50 consumeError(SymSec.takeError()); 51 return false; 52 } 53 return *this == **SymSec; 54 } 55 56 Expected<uint64_t> ObjectFile::getSymbolValue(DataRefImpl Ref) const { 57 uint32_t Flags; 58 if (Error E = getSymbolFlags(Ref).moveInto(Flags)) 59 // TODO: Test this error. 60 return std::move(E); 61 62 if (Flags & SymbolRef::SF_Undefined) 63 return 0; 64 if (Flags & SymbolRef::SF_Common) 65 return getCommonSymbolSize(Ref); 66 return getSymbolValueImpl(Ref); 67 } 68 69 Error ObjectFile::printSymbolName(raw_ostream &OS, DataRefImpl Symb) const { 70 Expected<StringRef> Name = getSymbolName(Symb); 71 if (!Name) 72 return Name.takeError(); 73 OS << *Name; 74 return Error::success(); 75 } 76 77 uint32_t ObjectFile::getSymbolAlignment(DataRefImpl DRI) const { return 0; } 78 79 bool ObjectFile::isSectionBitcode(DataRefImpl Sec) const { 80 Expected<StringRef> NameOrErr = getSectionName(Sec); 81 if (NameOrErr) 82 return *NameOrErr == ".llvm.lto"; 83 consumeError(NameOrErr.takeError()); 84 return false; 85 } 86 87 bool ObjectFile::isSectionStripped(DataRefImpl Sec) const { return false; } 88 89 bool ObjectFile::isBerkeleyText(DataRefImpl Sec) const { 90 return isSectionText(Sec); 91 } 92 93 bool ObjectFile::isBerkeleyData(DataRefImpl Sec) const { 94 return isSectionData(Sec); 95 } 96 97 bool ObjectFile::isDebugSection(DataRefImpl Sec) const { return false; } 98 99 bool ObjectFile::hasDebugInfo() const { 100 return any_of(sections(), 101 [](SectionRef Sec) { return Sec.isDebugSection(); }); 102 } 103 104 Expected<section_iterator> 105 ObjectFile::getRelocatedSection(DataRefImpl Sec) const { 106 return section_iterator(SectionRef(Sec, this)); 107 } 108 109 Triple ObjectFile::makeTriple() const { 110 Triple TheTriple; 111 auto Arch = getArch(); 112 TheTriple.setArch(Triple::ArchType(Arch)); 113 114 auto OS = getOS(); 115 if (OS != Triple::UnknownOS) 116 TheTriple.setOS(OS); 117 118 // For ARM targets, try to use the build attributes to build determine 119 // the build target. Target features are also added, but later during 120 // disassembly. 121 if (Arch == Triple::arm || Arch == Triple::armeb) 122 setARMSubArch(TheTriple); 123 124 // TheTriple defaults to ELF, and COFF doesn't have an environment: 125 // something we can do here is indicate that it is mach-o. 126 if (isMachO()) { 127 TheTriple.setObjectFormat(Triple::MachO); 128 } else if (isCOFF()) { 129 const auto COFFObj = cast<COFFObjectFile>(this); 130 if (COFFObj->getArch() == Triple::thumb) 131 TheTriple.setTriple("thumbv7-windows"); 132 } else if (isXCOFF()) { 133 // XCOFF implies AIX. 134 TheTriple.setOS(Triple::AIX); 135 TheTriple.setObjectFormat(Triple::XCOFF); 136 } else if (isGOFF()) { 137 TheTriple.setOS(Triple::ZOS); 138 TheTriple.setObjectFormat(Triple::GOFF); 139 } else if (TheTriple.isAMDGPU()) { 140 TheTriple.setVendor(Triple::AMD); 141 } else if (TheTriple.isNVPTX()) { 142 TheTriple.setVendor(Triple::NVIDIA); 143 } 144 145 return TheTriple; 146 } 147 148 Expected<std::unique_ptr<ObjectFile>> 149 ObjectFile::createObjectFile(MemoryBufferRef Object, file_magic Type, 150 bool InitContent) { 151 StringRef Data = Object.getBuffer(); 152 if (Type == file_magic::unknown) 153 Type = identify_magic(Data); 154 155 switch (Type) { 156 case file_magic::unknown: 157 case file_magic::bitcode: 158 case file_magic::coff_cl_gl_object: 159 case file_magic::archive: 160 case file_magic::macho_universal_binary: 161 case file_magic::windows_resource: 162 case file_magic::pdb: 163 case file_magic::minidump: 164 case file_magic::goff_object: 165 case file_magic::cuda_fatbinary: 166 case file_magic::offload_binary: 167 case file_magic::dxcontainer_object: 168 case file_magic::offload_bundle: 169 case file_magic::offload_bundle_compressed: 170 case file_magic::spirv_object: 171 return errorCodeToError(object_error::invalid_file_type); 172 case file_magic::tapi_file: 173 return errorCodeToError(object_error::invalid_file_type); 174 case file_magic::elf: 175 case file_magic::elf_relocatable: 176 case file_magic::elf_executable: 177 case file_magic::elf_shared_object: 178 case file_magic::elf_core: 179 return createELFObjectFile(Object, InitContent); 180 case file_magic::macho_object: 181 case file_magic::macho_executable: 182 case file_magic::macho_fixed_virtual_memory_shared_lib: 183 case file_magic::macho_core: 184 case file_magic::macho_preload_executable: 185 case file_magic::macho_dynamically_linked_shared_lib: 186 case file_magic::macho_dynamic_linker: 187 case file_magic::macho_bundle: 188 case file_magic::macho_dynamically_linked_shared_lib_stub: 189 case file_magic::macho_dsym_companion: 190 case file_magic::macho_kext_bundle: 191 case file_magic::macho_file_set: 192 return createMachOObjectFile(Object); 193 case file_magic::coff_object: 194 case file_magic::coff_import_library: 195 case file_magic::pecoff_executable: 196 return createCOFFObjectFile(Object); 197 case file_magic::xcoff_object_32: 198 return createXCOFFObjectFile(Object, Binary::ID_XCOFF32); 199 case file_magic::xcoff_object_64: 200 return createXCOFFObjectFile(Object, Binary::ID_XCOFF64); 201 case file_magic::wasm_object: 202 return createWasmObjectFile(Object); 203 } 204 llvm_unreachable("Unexpected Object File Type"); 205 } 206 207 Expected<OwningBinary<ObjectFile>> 208 ObjectFile::createObjectFile(StringRef ObjectPath) { 209 ErrorOr<std::unique_ptr<MemoryBuffer>> FileOrErr = 210 MemoryBuffer::getFile(ObjectPath); 211 if (std::error_code EC = FileOrErr.getError()) 212 return errorCodeToError(EC); 213 std::unique_ptr<MemoryBuffer> Buffer = std::move(FileOrErr.get()); 214 215 Expected<std::unique_ptr<ObjectFile>> ObjOrErr = 216 createObjectFile(Buffer->getMemBufferRef()); 217 if (Error Err = ObjOrErr.takeError()) 218 return std::move(Err); 219 std::unique_ptr<ObjectFile> Obj = std::move(ObjOrErr.get()); 220 221 return OwningBinary<ObjectFile>(std::move(Obj), std::move(Buffer)); 222 } 223 224 bool ObjectFile::isReflectionSectionStrippable( 225 llvm::binaryformat::Swift5ReflectionSectionKind ReflectionSectionKind) 226 const { 227 using llvm::binaryformat::Swift5ReflectionSectionKind; 228 return ReflectionSectionKind == Swift5ReflectionSectionKind::fieldmd || 229 ReflectionSectionKind == Swift5ReflectionSectionKind::reflstr || 230 ReflectionSectionKind == Swift5ReflectionSectionKind::assocty; 231 } 232