emu_elf.h

Go to the documentation of this file.

 
#pragma once
 
#include <stddef.h>
#include <stdint.h>
#include <unicorn/unicorn.h>
 
#include "ra8_attributes.h"
 
#ifdef __cplusplus
extern "C" {
#endif

typedef enum : uint32_t {
  k_elf_ehdr_size       = 52U,   
  k_elf_em_arm          = 40U,   
  k_elf_e_machine_off   = 18U,   
  k_elf_e_phoff_off     = 28U,   
  k_elf_e_phentsize_off = 42U,   
  k_elf_e_phnum_off     = 44U,   
  k_elf_ph_offset_off   = 4U,    
  k_elf_ph_vaddr_off    = 8U,    
  k_elf_ph_paddr_off    = 12U,   
  k_elf_ph_filesz_off   = 16U,   
  k_elf_ph_flags_off    = 24U,   
  k_elf_pf_x            = 1U,    
  k_elf_pt_load         = 1U,    
  k_elf_shentsize_min   = 40U,   
  k_elf_sh_size_off     = 20U,   
  k_elf_sh_link_off     = 24U,   
  k_elf_sh_entsize_off  = 36U,   
  k_elf_sym_info_off    = 12U,   
  k_elf_st_type_mask    = 0x0FU, 
} emu_elf_layout_t;

typedef enum : uint8_t {
  k_emu_elf_io_ok = 0U,  
  k_emu_elf_io_invalid,  
  k_emu_elf_io_capacity, 
  k_emu_elf_io_eof,      
  k_emu_elf_io_error,    
} emu_elf_io_status_t;

typedef struct {
  emu_elf_io_status_t status;         
  uint64_t            required_bytes; 
  uint64_t            supplied_bytes; 
  int                 os_error;       
} emu_elf_io_result_t;

typedef struct {
  int      fd;     
  uint64_t length; 
} emu_elf_source_t;

typedef struct {
  const uint8_t* bytes;  
  size_t         length; 
  uint64_t       offset; 
} emu_elf_view_t;

int load_elf(uc_engine* uc, const emu_elf_source_t* elf);

uint32_t elf_vector_base(const emu_elf_source_t* elf);

uint32_t elf_sym_addr(const emu_elf_source_t* elf, const char* name, uint32_t* size_out);

uint32_t warm_reboot(uc_engine* uc, const emu_elf_source_t* elf, bool trace);

typedef struct {
  const emu_elf_source_t* source; 
  uint32_t                offset; 
  uint32_t                vaddr;  
  uint32_t                paddr;  
  uint32_t                filesz; 
  uint32_t                flags;  
} elf_exec_segment_t;

typedef bool (*elf_exec_segment_fn)(const elf_exec_segment_t* seg, void* ctx);

uint32_t elf_foreach_load_segment(const emu_elf_source_t* elf, elf_exec_segment_fn fn, void* ctx);

uint32_t elf_foreach_exec_segment(const emu_elf_source_t* elf, elf_exec_segment_fn fn, void* ctx);

typedef struct {
  uint64_t name_offset; 
  uint32_t value;       
  uint32_t size;        
  uint8_t  info;        
} emu_elf_symbol_t;

typedef bool (*emu_elf_symbol_fn)(const emu_elf_symbol_t* symbol, void* ctx);

uint32_t elf_foreach_symbol(const emu_elf_source_t* elf, emu_elf_symbol_fn fn, void* ctx);

typedef bool (*emu_elf_string_fn)(const char* bytes, size_t length, void* ctx);

bool elf_string_foreach(const emu_elf_source_t* elf,
                        uint64_t                offset,
                        emu_elf_string_fn       fn,
                        void*                   ctx);
 
#ifdef __cplusplus
}
#endif