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:
111de62046dSVlad Tsyrklevich   // the best we can do here is indicate that it is mach-o.
112de62046dSVlad Tsyrklevich   if (isMachO())
113de62046dSVlad Tsyrklevich     TheTriple.setObjectFormat(Triple::MachO);
114de62046dSVlad Tsyrklevich 
115de62046dSVlad Tsyrklevich   if (isCOFF()) {
116bc9a1b37SSimon Pilgrim     const auto COFFObj = cast<COFFObjectFile>(this);
117de62046dSVlad Tsyrklevich     if (COFFObj->getArch() == Triple::thumb)
118de62046dSVlad Tsyrklevich       TheTriple.setTriple("thumbv7-windows");
119de62046dSVlad Tsyrklevich   }
120de62046dSVlad Tsyrklevich 
121de62046dSVlad Tsyrklevich   return TheTriple;
122de62046dSVlad Tsyrklevich }
123de62046dSVlad Tsyrklevich 
1243fcdf6aeSKevin Enderby Expected<std::unique_ptr<ObjectFile>>
125264b5d9eSZachary Turner ObjectFile::createObjectFile(MemoryBufferRef Object, file_magic Type) {
12648af1c2aSRafael Espindola   StringRef Data = Object.getBuffer();
127264b5d9eSZachary Turner   if (Type == file_magic::unknown)
128264b5d9eSZachary Turner     Type = identify_magic(Data);
12951cc3602SRafael Espindola 
130cd81b909SRafael Espindola   switch (Type) {
131264b5d9eSZachary Turner   case file_magic::unknown:
132264b5d9eSZachary Turner   case file_magic::bitcode:
133264b5d9eSZachary Turner   case file_magic::coff_cl_gl_object:
134264b5d9eSZachary Turner   case file_magic::archive:
135264b5d9eSZachary Turner   case file_magic::macho_universal_binary:
136264b5d9eSZachary Turner   case file_magic::windows_resource:
137aac28f31SZachary Turner   case file_magic::pdb:
138581d79a4SPavel Labath   case file_magic::minidump:
1393fcdf6aeSKevin Enderby     return errorCodeToError(object_error::invalid_file_type);
140359840a6SCyndy Ishida   case file_magic::tapi_file:
141359840a6SCyndy Ishida     return errorCodeToError(object_error::invalid_file_type);
142264b5d9eSZachary Turner   case file_magic::elf:
143264b5d9eSZachary Turner   case file_magic::elf_relocatable:
144264b5d9eSZachary Turner   case file_magic::elf_executable:
145264b5d9eSZachary Turner   case file_magic::elf_shared_object:
146264b5d9eSZachary Turner   case file_magic::elf_core:
14712db383eSRafael Espindola     return createELFObjectFile(Object);
148264b5d9eSZachary Turner   case file_magic::macho_object:
149264b5d9eSZachary Turner   case file_magic::macho_executable:
150264b5d9eSZachary Turner   case file_magic::macho_fixed_virtual_memory_shared_lib:
151264b5d9eSZachary Turner   case file_magic::macho_core:
152264b5d9eSZachary Turner   case file_magic::macho_preload_executable:
153264b5d9eSZachary Turner   case file_magic::macho_dynamically_linked_shared_lib:
154264b5d9eSZachary Turner   case file_magic::macho_dynamic_linker:
155264b5d9eSZachary Turner   case file_magic::macho_bundle:
156264b5d9eSZachary Turner   case file_magic::macho_dynamically_linked_shared_lib_stub:
157264b5d9eSZachary Turner   case file_magic::macho_dsym_companion:
158264b5d9eSZachary Turner   case file_magic::macho_kext_bundle:
1593fcdf6aeSKevin Enderby     return createMachOObjectFile(Object);
160264b5d9eSZachary Turner   case file_magic::coff_object:
161264b5d9eSZachary Turner   case file_magic::coff_import_library:
162264b5d9eSZachary Turner   case file_magic::pecoff_executable:
16312db383eSRafael Espindola     return createCOFFObjectFile(Object);
164ab2eb2bfSHubert Tong   case file_magic::xcoff_object_32:
165837ae69fSSean Fertile     return createXCOFFObjectFile(Object, Binary::ID_XCOFF32);
166837ae69fSSean Fertile   case file_magic::xcoff_object_64:
167837ae69fSSean Fertile     return createXCOFFObjectFile(Object, Binary::ID_XCOFF64);
168264b5d9eSZachary Turner   case file_magic::wasm_object:
1692c6f75ddSDerek Schuff     return createWasmObjectFile(Object);
170fe5ee802SMichael J. Spencer   }
171cd81b909SRafael Espindola   llvm_unreachable("Unexpected Object File Type");
172fe5ee802SMichael J. Spencer }
173fe5ee802SMichael J. Spencer 
1743fcdf6aeSKevin Enderby Expected<OwningBinary<ObjectFile>>
175437b0d58SRafael Espindola ObjectFile::createObjectFile(StringRef ObjectPath) {
176adf21f2aSRafael Espindola   ErrorOr<std::unique_ptr<MemoryBuffer>> FileOrErr =
177adf21f2aSRafael Espindola       MemoryBuffer::getFile(ObjectPath);
178adf21f2aSRafael Espindola   if (std::error_code EC = FileOrErr.getError())
1793fcdf6aeSKevin Enderby     return errorCodeToError(EC);
18048af1c2aSRafael Espindola   std::unique_ptr<MemoryBuffer> Buffer = std::move(FileOrErr.get());
18148af1c2aSRafael Espindola 
1823fcdf6aeSKevin Enderby   Expected<std::unique_ptr<ObjectFile>> ObjOrErr =
18348af1c2aSRafael Espindola       createObjectFile(Buffer->getMemBufferRef());
184b7c9deb5SJustin Bogner   if (Error Err = ObjOrErr.takeError())
185*c55cf4afSBill Wendling     return std::move(Err);
18648af1c2aSRafael Espindola   std::unique_ptr<ObjectFile> Obj = std::move(ObjOrErr.get());
18748af1c2aSRafael Espindola 
18848af1c2aSRafael Espindola   return OwningBinary<ObjectFile>(std::move(Obj), std::move(Buffer));
189fe5ee802SMichael J. Spencer }
190