blob: dc2abb8dfc5770d74fdf2b4639e66678b0d20073 [file] [log] [blame]
/*
* Copyright (c) 2011-2013, 2019 ARM Limited
* All rights reserved
*
* The license below extends only to copyright in the software and shall
* not be construed as granting a license to any other intellectual
* property including but not limited to intellectual property relating
* to a hardware implementation of the functionality of the software
* licensed hereunder. You may use the software subject to the license
* terms below provided that you ensure that this notice is replicated
* unmodified and in its entirety in all distributions of the software,
* modified or unmodified, in source code or in binary form.
*
* Copyright (c) 2003-2005 The Regents of The University of Michigan
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met: redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer;
* redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution;
* neither the name of the copyright holders nor the names of its
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#include "base/loader/elf_object.hh"
#include <fcntl.h>
#include <sys/mman.h>
#include <sys/stat.h>
#include <sys/types.h>
#include <unistd.h>
#include <cassert>
#include <string>
#include "base/bitfield.hh"
#include "base/compiler.hh"
#include "base/loader/symtab.hh"
#include "base/logging.hh"
#include "base/trace.hh"
#include "debug/Loader.hh"
#include "gelf.h"
#include "sim/byteswap.hh"
namespace gem5
{
GEM5_DEPRECATED_NAMESPACE(Loader, loader);
namespace loader
{
ObjectFile *
ElfObjectFormat::load(ImageFileDataPtr ifd)
{
// check that header matches library version
if (elf_version(EV_CURRENT) == EV_NONE)
panic("wrong elf version number!");
ObjectFile *object = nullptr;
// get a pointer to elf structure
// Check that we actually have a elf file
Elf *elf =
elf_memory((char *)const_cast<uint8_t *>(ifd->data()), ifd->len());
assert(elf);
GElf_Ehdr ehdr;
if (gelf_getehdr(elf, &ehdr) == 0)
DPRINTFR(Loader, "Not ELF\n");
else
object = new ElfObject(ifd);
elf_end(elf);
return object;
}
namespace
{
ElfObjectFormat elfObjectFormat;
std::string interpDir;
} // anonymous namespace
void
setInterpDir(const std::string &dirname)
{
fatal_if(!interpDir.empty(),
"Error: setInterpDir has already been called once\n");
interpDir = dirname;
}
ElfObject::ElfObject(ImageFileDataPtr ifd) : ObjectFile(ifd)
{
// get a pointer to elf structure
elf = elf_memory((char *)const_cast<uint8_t *>(imageData->data()),
imageData->len());
assert(elf);
gelf_getehdr(elf, &ehdr);
determineArch();
determineOpSys();
determineByteOrder();
entry = ehdr.e_entry;
_programHeaderCount = ehdr.e_phnum;
_programHeaderSize = ehdr.e_phentsize;
// Go through all the segments in the program and record them.
for (int i = 0; i < ehdr.e_phnum; ++i) {
GElf_Phdr phdr;
if (gelf_getphdr(elf, i, &phdr) == 0) {
panic("gelf_getphdr failed for segment %d.", i);
}
if (phdr.p_type == PT_LOAD)
handleLoadableSegment(phdr, i);
if (phdr.p_type == PT_INTERP) {
// Make sure the interpreter is an valid ELF file.
auto interp_path = getInterpPath(phdr);
ObjectFile *obj = createObjectFile(interp_path);
interpreter = dynamic_cast<ElfObject *>(obj);
assert(interpreter != nullptr);
_symtab.insert(obj->symtab());
}
}
// should have found at least one loadable segment
warn_if(image.segments().empty(),
"No loadable segments in '%s'. ELF file corrupted?\n",
imageData->filename());
for ([[maybe_unused]] auto &seg: image.segments())
DPRINTFR(Loader, "%s\n", seg);
// We will actually read the sections when we need to load them
// check that header matches library version
if (elf_version(EV_CURRENT) == EV_NONE)
panic("wrong elf version number!");
// Get the first section
int sec_idx = 1; // there is a 0 but it is nothing, go figure
Elf_Scn *section = elf_getscn(elf, sec_idx);
// While there are no more sections
while (section) {
GElf_Shdr shdr;
gelf_getshdr(section, &shdr);
if (shdr.sh_type == SHT_SYMTAB) {
Elf_Data *data = elf_getdata(section, nullptr);
int count = shdr.sh_size / shdr.sh_entsize;
DPRINTF(Loader, "Found Symbol Table, %d symbols present.", count);
// Loop through all the symbols.
for (int i = 0; i < count; ++i) {
GElf_Sym sym;
gelf_getsym(data, i, &sym);
char *sym_name = elf_strptr(elf, shdr.sh_link, sym.st_name);
if (!sym_name || sym_name[0] == '$')
continue;
loader::Symbol symbol;
symbol.address = sym.st_value;
symbol.name = sym_name;
switch (GELF_ST_BIND(sym.st_info)) {
case STB_GLOBAL:
symbol.binding = loader::Symbol::Binding::Global;
break;
case STB_LOCAL:
symbol.binding = loader::Symbol::Binding::Local;
break;
case STB_WEAK:
symbol.binding = loader::Symbol::Binding::Weak;
break;
default:
continue;
}
if (_symtab.insert(symbol)) {
DPRINTF(Loader, "Symbol: %-40s value %#x.\n",
symbol.name, symbol.address);
}
}
}
++sec_idx;
section = elf_getscn(elf, sec_idx);
}
}
std::string
ElfObject::getInterpPath(const GElf_Phdr &phdr) const
{
// This is the interpreter path as specified in the elf file
const std::string elf_path = (char *)imageData->data() + phdr.p_offset;
if (!interpDir.empty())
return interpDir + elf_path;
else
return elf_path;
}
void
ElfObject::determineArch()
{
auto &emach = ehdr.e_machine;
auto &eclass = ehdr.e_ident[EI_CLASS];
auto &edata = ehdr.e_ident[EI_DATA];
// Detect the architecture
if (emach == EM_SPARC64 || (emach == EM_SPARC && eclass == ELFCLASS64) ||
emach == EM_SPARCV9) {
arch = SPARC64;
} else if (emach == EM_SPARC32PLUS ||
(emach == EM_SPARC && eclass == ELFCLASS32)) {
arch = SPARC32;
} else if (emach == EM_MIPS && eclass == ELFCLASS32) {
arch = Mips;
if (edata != ELFDATA2LSB) {
fatal("The binary you're trying to load is compiled for big "
"endian MIPS. gem5\nonly supports little endian MIPS. "
"Please recompile your binary.\n");
}
} else if (emach == EM_X86_64 && eclass == ELFCLASS64) {
arch = X86_64;
} else if (emach == EM_386 && eclass == ELFCLASS32) {
arch = I386;
} else if (emach == EM_ARM && eclass == ELFCLASS32) {
arch = bits(ehdr.e_entry, 0) ? Thumb : Arm;
} else if (emach == EM_AARCH64 && eclass == ELFCLASS64) {
arch = Arm64;
} else if (emach == EM_RISCV) {
arch = (eclass == ELFCLASS64) ? Riscv64 : Riscv32;
} else if (emach == EM_PPC && eclass == ELFCLASS32) {
arch = Power;
} else if (emach == EM_PPC64 && eclass == ELFCLASS64) {
arch = Power64;
} else {
warn("Unknown architecture: %d\n", emach);
}
}
void
ElfObject::determineOpSys()
{
// For 64-bit Power, EI_OSABI and EI_ABIVERSION cannot be used to
// determine the ABI version used by the ELF object
if (ehdr.e_machine == EM_PPC64) {
switch (ehdr.e_flags & 0x3) {
case 0x1: opSys = LinuxPower64ABIv1; return;
case 0x2: opSys = LinuxPower64ABIv2; return;
default:
if (ehdr.e_ident[EI_DATA] == ELFDATA2MSB)
opSys = LinuxPower64ABIv1;
if (ehdr.e_ident[EI_DATA] == ELFDATA2LSB)
opSys = LinuxPower64ABIv2;
return;
}
}
// Detect the operating system
switch (ehdr.e_ident[EI_OSABI]) {
case ELFOSABI_LINUX:
opSys = Linux;
return;
case ELFOSABI_SOLARIS:
opSys = Solaris;
return;
case ELFOSABI_TRU64:
opSys = Tru64;
return;
case ELFOSABI_ARM:
opSys = LinuxArmOABI;
return;
case ELFOSABI_FREEBSD:
opSys = FreeBSD;
return;
default:
opSys = UnknownOpSys;
}
Elf_Scn *section = elf_getscn(elf, 1);
for (int sec_idx = 1; section; section = elf_getscn(elf, ++sec_idx)) {
GElf_Shdr shdr;
gelf_getshdr(section, &shdr);
char *e_str = elf_strptr(elf, ehdr.e_shstrndx, shdr.sh_name);
if (shdr.sh_type == SHT_NOTE && !strcmp(".note.ABI-tag", e_str)) {
// we have found a ABI note section
// Check the 5th 32bit word for OS 0 == linux, 1 == hurd,
// 2 == solaris, 3 == freebsd
Elf_Data *raw_data = elf_rawdata(section, nullptr);
assert(raw_data && raw_data->d_buf);
uint32_t raw_abi = ((uint32_t *)raw_data->d_buf)[4];
bool is_le = ehdr.e_ident[EI_DATA] == ELFDATA2LSB;
uint32_t os_abi = is_le ? htole(raw_abi) : htobe(raw_abi);
switch (os_abi) {
case 0:
opSys = Linux;
return;
case 1:
fatal("gem5 does not support the HURD ABI.\n");
case 2:
opSys = Solaris;
return;
case 3:
opSys = FreeBSD;
return;
}
}
if (!strcmp(".SUNW_version", e_str) || !strcmp(".stab.index", e_str)) {
opSys = Solaris;
return;
}
}
}
void
ElfObject::determineByteOrder()
{
auto edata = ehdr.e_ident[EI_DATA];
if (edata == ELFDATANONE)
panic("invalid ELF data encoding");
byteOrder = (edata == ELFDATA2MSB) ? ByteOrder::big : ByteOrder::little;
}
void
ElfObject::handleLoadableSegment(GElf_Phdr phdr, int seg_num)
{
auto name = std::to_string(seg_num);
if (phdr.p_memsz == 0) {
warn("Ignoring empty loadable segment %s", name);
return;
}
image.addSegment({ name, phdr.p_paddr, imageData,
phdr.p_offset, phdr.p_filesz });
Addr uninitialized = phdr.p_memsz - phdr.p_filesz;
if (uninitialized) {
// There may be parts of a segment which aren't included in the
// file. In those cases, we need to create a new segment with no
// data to take up the extra space. This should be zeroed when
// loaded into memory.
image.addSegment({ name + "(uninitialized)",
phdr.p_paddr + phdr.p_filesz, uninitialized });
}
const Addr file_start = phdr.p_offset;
const Addr file_end = file_start + phdr.p_filesz;
// If there is a program header table, figure out the virtual
// address of the header table in the final memory image. We use
// the program headers themselves to translate from a file offset
// to the address in the image.
if (file_start <= ehdr.e_phoff && file_end > ehdr.e_phoff)
_programHeaderTable = phdr.p_vaddr + (ehdr.e_phoff - file_start);
}
ElfObject::~ElfObject()
{
elf_end(elf);
}
void
ElfObject::getSections()
{
assert(!sectionNames.size());
// check that header matches library version
if (elf_version(EV_CURRENT) == EV_NONE)
panic("wrong elf version number!");
// get a pointer to elf structure
Elf *elf =
elf_memory((char *)const_cast<uint8_t *>(imageData->data()),
imageData->len());
assert(elf != NULL);
// Check that we actually have a elf file
GElf_Ehdr ehdr;
if (gelf_getehdr(elf, &ehdr) ==0) {
panic("Not ELF, shouldn't be here");
}
// Get the first section
int sec_idx = 1; // there is a 0 but it is nothing, go figure
Elf_Scn *section = elf_getscn(elf, sec_idx);
// While there are no more sections
while (section) {
GElf_Shdr shdr;
gelf_getshdr(section, &shdr);
sectionNames.insert(elf_strptr(elf, ehdr.e_shstrndx, shdr.sh_name));
section = elf_getscn(elf, ++sec_idx);
} // while sections
elf_end(elf);
}
bool
ElfObject::sectionExists(std::string sec)
{
if (!sectionNames.size())
getSections();
return sectionNames.find(sec) != sectionNames.end();
}
void
ElfObject::updateBias(Addr bias_addr)
{
// Record the bias.
ldBias = bias_addr;
// Patch the entry point with bias_addr.
entry += bias_addr;
// Patch segments with the bias_addr.
image.offset(bias_addr);
}
} // namespace loader
} // namespace gem5