1d341c932SEugene Zelenko //===- ObjectFile.cpp - File format independent object file ---------------===//
2fe5ee802SMichael J. Spencer //
32946cd70SChandler Carruth // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
42946cd70SChandler Carruth // See https://llvm.org/LICENSE.txt for license information.
52946cd70SChandler Carruth // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6fe5ee802SMichael J. Spencer //
7fe5ee802SMichael J. Spencer //===----------------------------------------------------------------------===//
8fe5ee802SMichael J. Spencer //
9fe5ee802SMichael J. Spencer // This file defines a file format independent ObjectFile class.
10fe5ee802SMichael J. Spencer //
11fe5ee802SMichael J. Spencer //===----------------------------------------------------------------------===//
12fe5ee802SMichael J. Spencer 
136bda14b3SChandler Carruth #include "llvm/Object/ObjectFile.h"
14d341c932SEugene Zelenko #include "llvm/ADT/StringRef.h"
15264b5d9eSZachary Turner #include "llvm/BinaryFormat/Magic.h"
16d341c932SEugene Zelenko #include "llvm/Object/Binary.h"
17437b0d58SRafael Espindola #include "llvm/Object/COFF.h"
18d341c932SEugene Zelenko #include "llvm/Object/Error.h"
19437b0d58SRafael Espindola #include "llvm/Object/MachO.h"
202c6f75ddSDerek Schuff #include "llvm/Object/Wasm.h"
21d341c932SEugene Zelenko #include "llvm/Support/Error.h"
22fe5ee802SMichael J. Spencer #include "llvm/Support/ErrorHandling.h"
23d341c932SEugene Zelenko #include "llvm/Support/ErrorOr.h"
24cd81b909SRafael Espindola #include "llvm/Support/FileSystem.h"
25fe5ee802SMichael J. Spencer #include "llvm/Support/MemoryBuffer.h"
26b1f8a5a5SAaron Ballman #include "llvm/Support/raw_ostream.h"
27d341c932SEugene Zelenko #include <algorithm>
28d341c932SEugene Zelenko #include <cstdint>
29d341c932SEugene Zelenko #include <memory>
30a6e9c3e4SRafael Espindola #include <system_error>
31fe5ee802SMichael J. Spencer 
32f177d16fSMichael J. Spencer using namespace llvm;
33f177d16fSMichael J. Spencer using namespace object;
34fe5ee802SMichael J. Spencer 
35c0fc29c4SPavel Labath raw_ostream &object::operator<<(raw_ostream &OS, const SectionedAddress &Addr) {
36c0fc29c4SPavel Labath   OS << "SectionedAddress{" << format_hex(Addr.Address, 10);
37c0fc29c4SPavel Labath   if (Addr.SectionIndex != SectionedAddress::UndefSection)
38c0fc29c4SPavel Labath     OS << ", " << Addr.SectionIndex;
39c0fc29c4SPavel Labath   return OS << "}";
40c0fc29c4SPavel Labath }
41c0fc29c4SPavel Labath 
42a379b181SDavid Blaikie void ObjectFile::anchor() {}
43a379b181SDavid Blaikie 
4448af1c2aSRafael Espindola ObjectFile::ObjectFile(unsigned int Type, MemoryBufferRef Source)
4548af1c2aSRafael Espindola     : SymbolicFile(Type, Source) {}
46f12b8282SRafael Espindola 
47e9c58c74SRafael Espindola bool SectionRef::containsSymbol(SymbolRef S) const {
487bd8d994SKevin Enderby   Expected<section_iterator> SymSec = S.getSection();
497bd8d994SKevin Enderby   if (!SymSec) {
507bd8d994SKevin Enderby     // TODO: Actually report errors helpfully.
517bd8d994SKevin Enderby     consumeError(SymSec.takeError());
52e9c58c74SRafael Espindola     return false;
537bd8d994SKevin Enderby   }
548bab889bSRafael Espindola   return *this == **SymSec;
55e9c58c74SRafael Espindola }
56e9c58c74SRafael Espindola 
57be8b0ea8SRafael Espindola uint64_t ObjectFile::getSymbolValue(DataRefImpl Ref) const {
58be8b0ea8SRafael Espindola   uint32_t Flags = getSymbolFlags(Ref);
59be8b0ea8SRafael Espindola   if (Flags & SymbolRef::SF_Undefined)
60be8b0ea8SRafael Espindola     return 0;
61be8b0ea8SRafael Espindola   if (Flags & SymbolRef::SF_Common)
62be8b0ea8SRafael Espindola     return getCommonSymbolSize(Ref);
63be8b0ea8SRafael Espindola   return getSymbolValueImpl(Ref);
64be8b0ea8SRafael Espindola }
65be8b0ea8SRafael Espindola 
66e357ca82SFangrui Song Error ObjectFile::printSymbolName(raw_ostream &OS, DataRefImpl Symb) const {
6781e8b7d9SKevin Enderby   Expected<StringRef> Name = getSymbolName(Symb);
6881e8b7d9SKevin Enderby   if (!Name)
69e357ca82SFangrui Song     return Name.takeError();
705d0c2ffaSRafael Espindola   OS << *Name;
71e357ca82SFangrui Song   return Error::success();
72f12b8282SRafael Espindola }
73fe5ee802SMichael J. Spencer 
74a4d22472SRafael Espindola uint32_t ObjectFile::getSymbolAlignment(DataRefImpl DRI) const { return 0; }
75e4dd2e01SRafael Espindola 
76f2fe0141SSteven Wu bool ObjectFile::isSectionBitcode(DataRefImpl Sec) const {
7778e8011aSGeorge Rimar   Expected<StringRef> NameOrErr = getSectionName(Sec);
7878e8011aSGeorge Rimar   if (NameOrErr)
798be28cdcSFangrui Song     return *NameOrErr == ".llvmbc";
8078e8011aSGeorge Rimar   consumeError(NameOrErr.takeError());
81f2fe0141SSteven Wu   return false;
82f2fe0141SSteven Wu }
83f2fe0141SSteven Wu 
848af2387bSJonas Devlieghere bool ObjectFile::isSectionStripped(DataRefImpl Sec) const { return false; }
858af2387bSJonas Devlieghere 
864888c4abSJordan Rupprecht bool ObjectFile::isBerkeleyText(DataRefImpl Sec) const {
874888c4abSJordan Rupprecht   return isSectionText(Sec);
884888c4abSJordan Rupprecht }
894888c4abSJordan Rupprecht 
904888c4abSJordan Rupprecht bool ObjectFile::isBerkeleyData(DataRefImpl Sec) const {
914888c4abSJordan Rupprecht   return isSectionData(Sec);
924888c4abSJordan Rupprecht }
934888c4abSJordan Rupprecht 
942bf01dcbSGeorge Rimar Expected<section_iterator>
952bf01dcbSGeorge Rimar ObjectFile::getRelocatedSection(DataRefImpl Sec) const {
964f60a38fSRafael Espindola   return section_iterator(SectionRef(Sec, this));
974f60a38fSRafael Espindola }
984f60a38fSRafael Espindola 
99de62046dSVlad Tsyrklevich Triple ObjectFile::makeTriple() const {
100de62046dSVlad Tsyrklevich   Triple TheTriple;
101de62046dSVlad Tsyrklevich   auto Arch = getArch();
102de62046dSVlad Tsyrklevich   TheTriple.setArch(Triple::ArchType(Arch));
103de62046dSVlad Tsyrklevich 
104de62046dSVlad Tsyrklevich   // For ARM targets, try to use the build attributes to build determine
105de62046dSVlad Tsyrklevich   // the build target. Target features are also added, but later during
106de62046dSVlad Tsyrklevich   // disassembly.
107de62046dSVlad Tsyrklevich   if (Arch == Triple::arm || Arch == Triple::armeb)
108de62046dSVlad Tsyrklevich     setARMSubArch(TheTriple);
109de62046dSVlad Tsyrklevich 
110de62046dSVlad Tsyrklevich   // TheTriple defaults to ELF, and COFF doesn't have an environment:
111*478af447SHubert Tong   // something we can do here is indicate that it is mach-o.
112*478af447SHubert Tong   if (isMachO()) {
113de62046dSVlad Tsyrklevich     TheTriple.setObjectFormat(Triple::MachO);
114*478af447SHubert Tong   } else if (isCOFF()) {
115bc9a1b37SSimon Pilgrim     const auto COFFObj = cast<COFFObjectFile>(this);
116de62046dSVlad Tsyrklevich     if (COFFObj->getArch() == Triple::thumb)
117de62046dSVlad Tsyrklevich       TheTriple.setTriple("thumbv7-windows");
118*478af447SHubert Tong   } else if (isXCOFF()) {
119*478af447SHubert Tong     // XCOFF implies AIX.
120*478af447SHubert Tong     TheTriple.setOS(Triple::AIX);
121*478af447SHubert Tong     TheTriple.setObjectFormat(Triple::XCOFF);
122de62046dSVlad Tsyrklevich   }
123de62046dSVlad Tsyrklevich 
124de62046dSVlad Tsyrklevich   return TheTriple;
125de62046dSVlad Tsyrklevich }
126de62046dSVlad Tsyrklevich 
1273fcdf6aeSKevin Enderby Expected<std::unique_ptr<ObjectFile>>
128264b5d9eSZachary Turner ObjectFile::createObjectFile(MemoryBufferRef Object, file_magic Type) {
12948af1c2aSRafael Espindola   StringRef Data = Object.getBuffer();
130264b5d9eSZachary Turner   if (Type == file_magic::unknown)
131264b5d9eSZachary Turner     Type = identify_magic(Data);
13251cc3602SRafael Espindola 
133cd81b909SRafael Espindola   switch (Type) {
134264b5d9eSZachary Turner   case file_magic::unknown:
135264b5d9eSZachary Turner   case file_magic::bitcode:
136264b5d9eSZachary Turner   case file_magic::coff_cl_gl_object:
137264b5d9eSZachary Turner   case file_magic::archive:
138264b5d9eSZachary Turner   case file_magic::macho_universal_binary:
139264b5d9eSZachary Turner   case file_magic::windows_resource:
140aac28f31SZachary Turner   case file_magic::pdb:
141581d79a4SPavel Labath   case file_magic::minidump:
1423fcdf6aeSKevin Enderby     return errorCodeToError(object_error::invalid_file_type);
143359840a6SCyndy Ishida   case file_magic::tapi_file:
144359840a6SCyndy Ishida     return errorCodeToError(object_error::invalid_file_type);
145264b5d9eSZachary Turner   case file_magic::elf:
146264b5d9eSZachary Turner   case file_magic::elf_relocatable:
147264b5d9eSZachary Turner   case file_magic::elf_executable:
148264b5d9eSZachary Turner   case file_magic::elf_shared_object:
149264b5d9eSZachary Turner   case file_magic::elf_core:
15012db383eSRafael Espindola     return createELFObjectFile(Object);
151264b5d9eSZachary Turner   case file_magic::macho_object:
152264b5d9eSZachary Turner   case file_magic::macho_executable:
153264b5d9eSZachary Turner   case file_magic::macho_fixed_virtual_memory_shared_lib:
154264b5d9eSZachary Turner   case file_magic::macho_core:
155264b5d9eSZachary Turner   case file_magic::macho_preload_executable:
156264b5d9eSZachary Turner   case file_magic::macho_dynamically_linked_shared_lib:
157264b5d9eSZachary Turner   case file_magic::macho_dynamic_linker:
158264b5d9eSZachary Turner   case file_magic::macho_bundle:
159264b5d9eSZachary Turner   case file_magic::macho_dynamically_linked_shared_lib_stub:
160264b5d9eSZachary Turner   case file_magic::macho_dsym_companion:
161264b5d9eSZachary Turner   case file_magic::macho_kext_bundle:
1623fcdf6aeSKevin Enderby     return createMachOObjectFile(Object);
163264b5d9eSZachary Turner   case file_magic::coff_object:
164264b5d9eSZachary Turner   case file_magic::coff_import_library:
165264b5d9eSZachary Turner   case file_magic::pecoff_executable:
16612db383eSRafael Espindola     return createCOFFObjectFile(Object);
167ab2eb2bfSHubert Tong   case file_magic::xcoff_object_32:
168837ae69fSSean Fertile     return createXCOFFObjectFile(Object, Binary::ID_XCOFF32);
169837ae69fSSean Fertile   case file_magic::xcoff_object_64:
170837ae69fSSean Fertile     return createXCOFFObjectFile(Object, Binary::ID_XCOFF64);
171264b5d9eSZachary Turner   case file_magic::wasm_object:
1722c6f75ddSDerek Schuff     return createWasmObjectFile(Object);
173fe5ee802SMichael J. Spencer   }
174cd81b909SRafael Espindola   llvm_unreachable("Unexpected Object File Type");
175fe5ee802SMichael J. Spencer }
176fe5ee802SMichael J. Spencer 
1773fcdf6aeSKevin Enderby Expected<OwningBinary<ObjectFile>>
178437b0d58SRafael Espindola ObjectFile::createObjectFile(StringRef ObjectPath) {
179adf21f2aSRafael Espindola   ErrorOr<std::unique_ptr<MemoryBuffer>> FileOrErr =
180adf21f2aSRafael Espindola       MemoryBuffer::getFile(ObjectPath);
181adf21f2aSRafael Espindola   if (std::error_code EC = FileOrErr.getError())
1823fcdf6aeSKevin Enderby     return errorCodeToError(EC);
18348af1c2aSRafael Espindola   std::unique_ptr<MemoryBuffer> Buffer = std::move(FileOrErr.get());
18448af1c2aSRafael Espindola 
1853fcdf6aeSKevin Enderby   Expected<std::unique_ptr<ObjectFile>> ObjOrErr =
18648af1c2aSRafael Espindola       createObjectFile(Buffer->getMemBufferRef());
187b7c9deb5SJustin Bogner   if (Error Err = ObjOrErr.takeError())
188c55cf4afSBill Wendling     return std::move(Err);
18948af1c2aSRafael Espindola   std::unique_ptr<ObjectFile> Obj = std::move(ObjOrErr.get());
19048af1c2aSRafael Espindola 
19148af1c2aSRafael Espindola   return OwningBinary<ObjectFile>(std::move(Obj), std::move(Buffer));
192fe5ee802SMichael J. Spencer }
193