;;; Guile ELF reader and writer ;; Copyright (C) 2011, 2012, 2013, 2014, 2015 Free Software Foundation, Inc. ;;;; This library is free software; you can redistribute it and/or ;;;; modify it under the terms of the GNU Lesser General Public ;;;; License as published by the Free Software Foundation; either ;;;; version 3 of the License, or (at your option) any later version. ;;;; ;;;; This library is distributed in the hope that it will be useful, ;;;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU ;;;; Lesser General Public License for more details. ;;;; ;;;; You should have received a copy of the GNU Lesser General Public ;;;; License along with this library; if not, write to the Free Software ;;;; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA ;;; Commentary: ;;; ;;; This file was taken from the Guile 2.1 branch, where it is known as ;;; (system vm elf), and renamed to (guix elf). It will be unneeded when Guix ;;; switches to Guile 2.1/2.2. ;;; ;;; A module to read and write Executable and Linking Format (ELF) ;;; files. ;;; ;;; This module exports a number of record types that represent the ;;; various parts that make up ELF files. Fundamentally this is the ;;; main header, the segment headers (program headers), and the section ;;; headers. It also exports bindings for symbolic constants and ;;; utilities to parse and write special kinds of ELF sections. ;;; ;;; See elf(5) for more information on ELF. ;;; ;;; Code: (define-module (guix elf) #:use-module (rnrs bytevectors) #:use-module (system foreign) #:use-module (system base target) #:use-module (srfi srfi-9) #:use-module (ice-9 receive) #:use-module (ice-9 vlist) #:export (has-elf-header? (make-elf* . make-elf) elf? elf-bytes elf-word-size elf-byte-order elf-abi elf-type elf-machine-type elf-entry elf-phoff elf-shoff elf-flags elf-ehsize elf-phentsize elf-phnum elf-shentsize elf-shnum elf-shstrndx ELFOSABI_NONE ELFOSABI_HPUX ELFOSABI_NETBSD ELFOSABI_GNU ELFOSABI_SOLARIS ELFOSABI_AIX ELFOSABI_IRIX ELFOSABI_FREEBSD ELFOSABI_TRU64 ELFOSABI_MODESTO ELFOSABI_OPENBSD ELFOSABI_ARM_AEABI ELFOSABI_ARM ELFOSABI_STANDALONE ET_NONE ET_REL ET_EXEC ET_DYN ET_CORE EM_NONE EM_SPARC EM_386 EM_MIPS EM_PPC EM_PPC64 EM_ARM EM_SH EM_SPARCV9 EM_IA_64 EM_X86_64 elf-header-len elf-header-shoff-offset write-elf-header (make-elf-segment* . make-elf-segment) elf-segment? elf-segment-index elf-segment-type elf-segment-offset elf-segment-vaddr elf-segment-paddr elf-segment-filesz elf-segment-memsz elf-segment-flags elf-segment-align elf-program-header-len write-elf-program-header PT_NULL PT_LOAD PT_DYNAMIC PT_INTERP PT_NOTE PT_SHLIB PT_PHDR PT_TLS PT_NUM PT_LOOS PT_GNU_EH_FRAME PT_GNU_STACK PT_GNU_RELRO PF_R PF_W PF_X (make-elf-section* . make-elf-section) elf-section? elf-section-index elf-section-name elf-section-type elf-section-flags elf-section-addr elf-section-offset elf-section-size elf-section-link elf-section-info elf-section-addralign elf-section-entsize elf-section-header-len elf-section-header-addr-offset elf-section-header-offset-offset write-elf-section-header (make-elf-symbol* . make-elf-symbol) elf-symbol? elf-symbol-name elf-symbol-value elf-symbol-size elf-symbol-info elf-symbol-other elf-symbol-shndx elf-symbol-binding elf-symbol-type elf-symbol-visibility elf-symbol-len elf-symbol-value-offset write-elf-symbol SHN_UNDEF SHT_NULL SHT_PROGBITS SHT_SYMTAB SHT_STRTAB SHT_RELA SHT_HASH SHT_DYNAMIC SHT_NOTE SHT_NOBITS SHT_REL SHT_SHLIB SHT_DYNSYM SHT_INIT_ARRAY SHT_FINI_ARRAY SHT_PREINIT_ARRAY SHT_GROUP SHT_SYMTAB_SHNDX SHT_NUM SHT_LOOS SHT_HIOS SHT_LOPROC SHT_HIPROC SHT_LOUSER SHT_HIUSER SHF_WRITE SHF_ALLOC SHF_EXECINSTR SHF_MERGE SHF_STRINGS SHF_INFO_LINK SHF_LINK_ORDER SHF_OS_NONCONFORMING SHF_GROUP SHF_TLS DT_NULL DT_NEEDED DT_PLTRELSZ DT_PLTGOT DT_HASH DT_STRTAB DT_SYMTAB DT_RELA DT_RELASZ DT_RELAENT DT_STRSZ DT_SYMENT DT_INIT DT_FINI DT_SONAME DT_RPATH DT_SYMBOLIC DT_REL DT_RELSZ DT_RELENT DT_PLTREL DT_DEBUG DT_TEXTREL DT_JMPREL DT_BIND_NOW DT_INIT_ARRAY DT_FINI_ARRAY DT_INIT_ARRAYSZ DT_FINI_ARRAYSZ DT_RUNPATH DT_FLAGS DT_ENCODING DT_PREINIT_ARRAY DT_PREINIT_ARRAYSZ DT_NUM DT_LOGUILE DT_GUILE_GC_ROOT DT_GUILE_GC_ROOT_SZ DT_GUILE_ENTRY DT_GUILE_VM_VERSION DT_GUILE_FRAME_MAPS DT_HIGUILE DT_LOOS DT_HIOS DT_LOPROC DT_HIPROC string-table-ref STB_LOCAL STB_GLOBAL STB_WEAK STB_NUM STB_LOOS STB_GNU STB_HIOS STB_LOPROC STB_HIPROC STT_NOTYPE STT_OBJECT STT_FUNC STT_SECTION STT_FILE STT_COMMON STT_TLS STT_NUM STT_LOOS STT_GNU STT_HIOS STT_LOPROC STT_HIPROC STV_DEFAULT STV_INTERNAL STV_HIDDEN STV_PROTECTED NT_GNU_ABI_TAG NT_GNU_HWCAP NT_GNU_BUILD_ID NT_GNU_GOLD_VERSION parse-elf elf-segment elf-segments elf-section elf-sections elf-section-by-name elf-sections-by-name elf-symbol-table-len elf-symbol-table-ref parse-elf-note elf-note-name elf-note-desc elf-note-type)) ;; #define EI_NIDENT 16 ;; typedef struct { ;; unsigned char e_ident[EI_NIDENT]; ;; uint16_t e_type; ;; uint16_t e_machine; ;; uint32_t e_version; ;; ElfN_Addr e_entry; ;; ElfN_Off e_phoff; ;; ElfN_Off e_shoff; ;; uint32_t e_flags; ;; uint16_t e_ehsize; ;; uint16_t e_phentsize; ;; uint16_t e_phnum; ;; uint16_t e_shentsize; ;; uint16_t e_shnum; ;; uint16_t e_shstrndx; ;; } ElfN_Ehdr; (define elf32-header-len 52) (define elf64-header-len 64) (define (elf-header-len word-size) (case word-size ((4) elf32-header-len) ((8) elf64-header-len) (else (error "invalid word size" word-size)))) (define (elf-header-shoff-offset word-size) (case word-size ((4) 32) ((8) 40) (else (error "bad word size" word-size)))) (define ELFCLASS32 1) ; 32-bit objects (define ELFCLASS64 2) ; 64-bit objects (define ELFDATA2LSB 1) ; 2's complement, little endian (define ELFDATA2MSB 2) ; 2's complement, big endian (define EV_CURRENT 1) ; Current version (define ELFOSABI_NONE 0) ; UNIX System V ABI */ (define ELFOSABI_HPUX 1) ; HP-UX (define ELFOSABI_NETBSD 2) ; NetBSD. (define ELFOSABI_GNU 3) ; Object uses GNU ELF extensions. (define ELFOSABI_SOLARIS 6) ; Sun Solaris. (define ELFOSABI_AIX 7) ; IBM AIX. (define ELFOSABI_IRIX 8) ; SGI Irix. (define ELFOSABI_FREEBSD 9) ; FreeBSD. (define ELFOSABI_TRU64 10) ; Compaq TRU64 UNIX. (define ELFOSABI_MODESTO 11) ; Novell Modesto. (define ELFOSABI_OPENBSD 12) ; OpenBSD. (define ELFOSABI_ARM_AEABI 64) ; ARM EABI (define ELFOSABI_ARM 97) ; ARM (define ELFOSABI_STANDALONE 255) ; Standalone (embedded) application (define ET_NONE 0) ; No file type (define ET_REL 1) ; Relocatable file (define ET_EXEC 2) ; Executable file (define ET_DYN 3) ; Shared object file (define ET_CORE 4) ; Core file ;; ;; Machine types ;; ;; Just a sampling of these values. We could include more, but the ;; important thing is to recognize architectures for which we have a ;; native compiler. Recognizing more common machine types is icing on ;; the cake. ;; (define EM_NONE 0) ; No machine (define EM_SPARC 2) ; SUN SPARC (define EM_386 3) ; Intel 80386 (define EM_MIPS 8) ; MIPS R3000 big-endian (define EM_PPC 20) ; PowerPC (define EM_PPC64 21) ; PowerPC 64-bit (define EM_ARM 40) ; ARM (define EM_SH 42) ; Hitachi SH (define EM_SPARCV9 43) ; SPARC v9 64-bit (define EM_IA_64 50) ; Intel Merced (define EM_X86_64 62) ; AMD x86-64 architecture (define cpu-mapping (make-hash-table)) (for-each (lambda (pair) (hashq-set! cpu-mapping (car pair) (cdr pair))) `((none . ,EM_NONE) (sparc . ,EM_SPARC) ; FIXME: map 64-bit to SPARCV9 ? (i386 . ,EM_386) (mips . ,EM_MIPS) (ppc . ,EM_PPC) (ppc64 . ,EM_PPC64) (arm . ,EM_ARM) ; FIXME: there are more arm cpu variants (sh . ,EM_SH) ; FIXME: there are more sh cpu variants (ia64 . ,EM_IA_64) (x86_64 . ,EM_X86_64))) (define SHN_UNDEF 0) (define host-machine-type (hashq-ref cpu-mapping (string->symbol (car (string-split %host-type #\-))) EM_NONE)) (define host-word-size (sizeof '*)) (define host-byte-order (native-endianness)) (define (has-elf-header? bv) (and ;; e_ident (>= (bytevector-length bv) 16) (= (bytevector-u8-ref bv 0) #x7f) (= (bytevector-u8-ref bv 1) (char->integer #\E)) (= (bytevector-u8-ref bv 2) (char->integer #\L)) (= (bytevector-u8-ref bv 3) (char->integer #\F)) (cond ((= (bytevector-u8-ref bv 4) ELFCLASS32) (>= (bytevector-length bv) elf32-header-len)) ((= (bytevector-u8-ref bv 4) ELFCLASS64) (>= (bytevector-length bv) elf64-header-len)) (else #f)) (or (= (bytevector-u8-ref bv 5) ELFDATA2LSB) (= (bytevector-u8-ref bv 5) ELFDATA2MSB)) (= (bytevector-u8-ref bv 6) EV_CURRENT) ;; Look at ABI later. (= (bytevector-u8-ref bv 8) 0) ; ABI version ;; The rest of the e_ident is padding. ;; e_version (let ((byte-order (if (= (bytevector-u8-ref bv 5) ELFDATA2LSB) (endianness little) (endianness big)))) (= (bytevector-u32-ref bv 20 byte-order) EV_CURRENT)))) (define-record-type (make-elf bytes word-size byte-order abi type machine-type entry phoff shoff flags ehsize phentsize phnum shentsize shnum shstrndx) elf? (bytes elf-bytes) (word-size elf-word-size) (byte-order elf-byte-order) (abi elf-abi) (type elf-type) (machine-type elf-machine-type) (entry elf-entry) (phoff elf-phoff) (shoff elf-shoff) (flags elf-flags) (ehsize elf-ehsize) (phentsize elf-phentsize) (phnum elf-phnum) (shentsize elf-shentsize) (shnum elf-shnum) (shstrndx elf-shstrndx)) (define* (make-elf* #:key (bytes #f) (byte-order (target-endianness)) (word-size (target-word-size)) (abi ELFOSABI_STANDALONE) (type ET_DYN) (machine-type EM_NONE) (entry 0) (phoff (elf-header-len word-size)) (shoff -1) (flags 0) (ehsize (elf-header-len word-size)) (phentsize (elf-program-header-len word-size)) (phnum 0) (shentsize (elf-section-header-len word-size)) (shnum 0) (shstrndx SHN_UNDEF)) (make-elf bytes word-size byte-order abi type machine-type entry phoff shoff flags ehsize phentsize phnum shentsize shnum shstrndx)) (define (parse-elf32 bv byte-order) (make-elf bv 4 byte-order (bytevector-u8-ref bv 7) (bytevector-u16-ref bv 16 byte-order) (bytevector-u16-ref bv 18 byte-order) (bytevector-u32-ref bv 24 byte-order) (bytevector-u32-ref bv 28 byte-order) (bytevector-u32-ref bv 32 byte-order) (bytevector-u32-ref bv 36 byte-order) (bytevector-u16-ref bv 40 byte-order) (bytevector-u16-ref bv 42 byte-order) (bytevector-u16-ref bv 44 byte-order) (bytevector-u16-ref bv 46 byte-order) (bytevector-u16-ref bv 48 byte-order) (bytevector-u16-ref bv 50 byte-order))) (define (write-elf-ident bv class data abi) (bytevector-u8-set! bv 0 #x7f) (bytevector-u8-set! bv 1 (char->integer #\E)) (bytevector-u8-set! bv 2 (char->integer #\L)) (bytevector-u8-set! bv 3 (char->integer #\F)) (bytevector-u8-set! bv 4 class) (bytevector-u8-set! bv 5 data) (bytevector-u8-set! bv 6 EV_CURRENT) (bytevector-u8-set! bv 7 abi) (bytevector-u8-set! bv 8 0) ; ABI version (bytevector-u8-set! bv 9 0) ; Pad to 16 bytes. (bytevector-u8-set! bv 10 0) (bytevector-u8-set! bv 11 0) (bytevector-u8-set! bv 12 0) (bytevector-u8-set! bv 13 0) (bytevector-u8-set! bv 14 0) (bytevector-u8-set! bv 15 0)) (define (write-elf32-header bv elf) (let ((byte-order (elf-byte-order elf))) (write-elf-ident bv ELFCLASS32 (case byte-order ((little) ELFDATA2LSB) ((big) ELFDATA2MSB) (else (error "unknown endianness" byte-order))) (elf-abi elf)) (bytevector-u16-set! bv 16 (elf-type elf) byte-order) (bytevector-u16-set! bv 18 (elf-machine-type elf) byte-order) (bytevector-u32-set! bv 20 EV_CURRENT byte-order) (bytevector-u32-set! bv 24 (elf-entry elf) byte-order) (bytevector-u32-set! bv 28 (elf-phoff elf) byte-order) (bytevector-u32-set! bv 32 (elf-shoff elf) byte-order) (bytevector-u32-set! bv 36 (elf-flags elf) byte-order) (bytevector-u16-set! bv 40 (elf-ehsize elf) byte-order) (bytevector-u16-set! bv 42 (elf-phentsize elf) byte-order) (bytevector-u16-set! bv 44 (elf-phnum elf) byte-order) (bytevector-u16-set! bv 46 (elf-shentsize elf) byte-order) (bytevector-u16-set! bv 48 (elf-shnum elf) byte-order) (bytevector-u16-set! bv 50 (elf-shstrndx elf) byte-order))) (define (parse-elf64 bv byte-order) (make-elf bv 8 byte-order (bytevector-u8-ref bv 7) (bytevector-u16-ref bv 16 byte-order) (bytevector-u16-ref bv 18 byte-order) (bytevector-u64-ref bv 24 byte-order) (bytevector-u64-ref bv 32 byte-order) (bytevector-u64-ref bv 40 byte-order) (bytevector-u32-ref bv 48 byte-order) (bytevector-u16-ref bv 52 byte-order) (bytevector-u16-ref bv 54 byte-order) (bytevector-u16-ref bv 56 byte-order) (bytevector-u16-ref bv 58 byte-order) (bytevector-u16-ref bv 60 byte-order) (bytevector-u16-ref bv 62 byte-order))) (define (write-elf64-header bv elf) (let ((byte-order (elf-byte-order elf))) (write-elf-ident bv ELFCLASS64 (case byte-order ((little) ELFDATA2LSB) ((big) ELFDATA2MSB) (else (error "unknown endianness" byte-order))) (elf-abi elf)) (bytevector-u16-set! bv 16 (elf-type elf) byte-order) (bytevector-u16-set! bv 18 (elf-machine-type elf) byte-order) (bytevector-u32-set! bv 20 EV_CURRENT byte-order) (bytevector-u64-set! bv 24 (elf-entry elf) byte-order) (bytevector-u64-set! bv 32 (elf-phoff elf) byte-order) (bytevector-u64-set! bv 40 (elf-shoff elf) byte-order) (bytevector-u32-set! bv 48 (elf-flags elf) byte-order) (bytevector-u16-set! bv 52 (elf-ehsize elf) byte-order) (bytevector-u16-set! bv 54 (elf-phentsize elf) byte-order) (bytevector-u16-set! bv 56 (elf-phnum elf) byte-order) (bytevector-u16-set! bv 58 (elf-shentsize elf) byte-order) (bytevector-u16-set! bv 60 (elf-shnum elf) byte-order) (bytevector-u16-set! bv 62 (elf-shstrndx elf) byte-order))) (define (parse-elf bv) (cond ((has-elf-header? bv) (let ((class (bytevector-u8-ref bv 4)) (byte-order (let ((data (bytevector-u8-ref bv 5))) (cond ((= data ELFDATA2LSB) (endianness little)) ((= data ELFDATA2MSB) (endianness big)) (else (error "unhandled byte order" data)))))) (cond ((= class ELFCLASS32) (parse-elf32 bv byte-order)) ((= class ELFCLASS64) (parse-elf64 bv byte-order)) (else (error "unhandled class" class))))) (else (error "Invalid ELF" bv)))) (define* (write-elf-header bv elf) ((case (elf-word-size elf) ((4) write-elf32-header) ((8) write-elf64-header) (else (error "unknown word size" (elf-word-size elf)))) bv elf)) ;; ;; Segment types ;; (define PT_NULL 0) ; Program header table entry unused (define PT_LOAD 1) ; Loadable program segment (define PT_DYNAMIC 2) ; Dynamic linking information (define PT_INTERP 3) ; Program interpreter (define PT_NOTE 4) ; Auxiliary information (define PT_SHLIB 5) ; Reserved (define PT_PHDR 6) ; Entry for header table itself (define PT_TLS 7) ; Thread-local storage segment (define PT_NUM 8) ; Number of defined types (define PT_LOOS #x60000000) ; Start of OS-specific (define PT_GNU_EH_FRAME #x6474e550) ; GCC .eh_frame_hdr segment (define PT_GNU_STACK #x6474e551) ; Indicates stack executability (define PT_GNU_RELRO #x6474e552) ; Read-only after relocation ;; ;; Segment flags ;; (define PF_X (ash 1 0)) ; Segment is executable (define PF_W (ash 1 1)) ; Segment is writable (define PF_R (ash 1 2)) ; Segment is readable (define-record-type (make-elf-segment index type offset vaddr paddr filesz memsz flags align) elf-segment? (index elf-segment-index) (type elf-segment-type) (offset elf-segment-offset) (vaddr elf-segment-vaddr) (paddr elf-segment-paddr) (filesz elf-segment-filesz) (memsz elf-segment-memsz) (flags elf-segment-flags) (align elf-segment-align)) (define* (make-elf-segment* #:key (index -1) (type PT_LOAD) (offset 0) (vaddr 0) (paddr 0) (filesz 0) (memsz filesz) (flags (logior PF_W PF_R)) (align 8)) (make-elf-segment index type offset vaddr paddr filesz memsz flags align)) ;; typedef struct { ;; uint32_t p_type; ;; Elf32_Off p_offset; ;; Elf32_Addr p_vaddr; ;; Elf32_Addr p_paddr; ;; uint32_t p_filesz; ;; uint32_t p_memsz; ;; uint32_t p_flags; ;; uint32_t p_align; ;; } Elf32_Phdr; (define (parse-elf32-program-header index bv offset byte-order) (if (<= (+ offset 32) (bytevector-length bv)) (make-elf-segment index (bytevector-u32-ref bv offset byte-order) (bytevector-u32-ref bv (+ offset 4) byte-order) (bytevector-u32-ref bv (+ offset 8) byte-order) (bytevector-u32-ref bv (+ offset 12) byte-order) (bytevector-u32-ref bv (+ offset 16) byte-order) (bytevector-u32-ref bv (+ offset 20) byte-order) (bytevector-u32-ref bv (+ offset 24) byte-order) (bytevector-u32-ref bv (+ offset 28) byte-order)) (error "corrupt ELF (offset out of range)" offset))) (define (write-elf32-program-header bv offset byte-order seg) (bytevector-u32-set! bv offset (elf-segment-type seg) byte-order) (bytevector-u32-set! bv (+ offset 4) (elf-segment-offset seg) byte-order) (bytevector-u32-set! bv (+ offset 8) (elf-segment-vaddr seg) byte-order) (bytevector-u32-set! bv (+ offset 12) (elf-segment-paddr seg) byte-order) (bytevector-u32-set! bv (+ offset 16) (elf-segment-filesz seg) byte-order) (bytevector-u32-set! bv (+ offset 20) (elf-segment-memsz seg) byte-order) (bytevector-u32-set! bv (+ offset 24) (elf-segment-flags seg) byte-order) (bytevector-u32-set! bv (+ offset 28) (elf-segment-align seg) byte-order)) ;; typedef struct { ;; uint32_t p_type; ;; uint32_t p_flags; ;; Elf64_Off p_offset; ;; Elf64_Addr p_vaddr; ;; Elf64_Addr p_paddr; ;; uint64_t p_filesz; ;; uint64_t p_memsz; ;; uint64_t p_align; ;; } Elf64_Phdr; ;; NB: position of `flags' is different! (define (parse-elf64-program-header index bv offset byte-order) (if (<= (+ offset 56) (bytevector-length bv)) (make-elf-segment index (bytevector-u32-ref bv offset byte-order) (bytevector-u64-ref bv (+ offset 8) byte-order) (bytevector-u64-ref bv (+ offset 16) byte-order) (bytevector-u64-ref bv (+ offset 24) byte-order) (bytevector-u64-ref bv (+ offset 32) byte-order) (bytevector-u64-ref bv (+ offset 40) byte-order) (bytevector-u32-ref bv (+ offset 4) byte-order) (bytevector-u64-ref bv (+ offset 48) byte-order)) (error "corrupt ELF (offset out of range)" offset))) (define (write-elf64-program-header bv offset byte-order seg) (bytevector-u32-set! bv offset (elf-segment-type seg) byte-order) (bytevector-u64-set! bv (+ offset 8) (elf-segment-offset seg) byte-order) (bytevector-u64-set! bv (+ offset 16) (elf-segment-vaddr seg) byte-order) (bytevector-u64-set! bv (+ offset 24) (elf-segment-paddr seg) byte-order) (bytevector-u64-set! bv (+ offset 32) (elf-segment-filesz seg) byte-order) (bytevector-u64-set! bv (+ offset 40) (elf-segment-memsz seg) byte-order) (bytevector-u32-set! bv (+ offset 4) (elf-segment-flags seg) byte-order) (bytevector-u64-set! bv (+ offset 48) (elf-segment-align seg) byte-order)) (define (write-elf-program-header bv offset byte-order word-size seg) ((case word-size ((4) write-elf32-program-header) ((8) write-elf64-program-header) (else (error "invalid word size" word-size))) bv offset byte-order seg)) (define (elf-program-header-len word-size) (case word-size ((4) 32) ((8) 56) (else (error "bad word size" word-size)))) (define (elf-segment elf n) (if (not (< -1 n (elf-phnum elf))) (error "bad segment number" n)) ((case (elf-word-size elf) ((4) parse-elf32-program-header) ((8) parse-elf64-program-header) (else (error "unhandled pointer size"))) n (elf-bytes elf) (+ (elf-phoff elf) (* n (elf-phentsize elf))) (elf-byte-order elf))) (define (elf-segments elf) (let lp ((n (elf-phnum elf)) (out '())) (if (zero? n) out (lp (1- n) (cons (elf-segment elf (1- n)) out))))) (define-record-type (make-elf-section index name type flags addr offset size link info addralign entsize) elf-section? (index elf-section-index) (name elf-section-name) (type elf-section-type) (flags elf-section-flags) (addr elf-section-addr) (offset elf-section-offset) (size elf-section-size) (link elf-section-link) (info elf-section-info) (addralign elf-section-addralign) (entsize elf-section-entsize)) (define* (make-elf-section* #:key (index SHN_UNDEF) (name 0) (type SHT_PROGBITS) (flags SHF_ALLOC) (addr 0) (offset 0) (size 0) (link 0) (info 0) (addralign 8) (entsize 0)) (make-elf-section index name type flags addr offset size link info addralign entsize)) ;; typedef struct { ;; uint32_t sh_name; ;; uint32_t sh_type; ;; uint32_t sh_flags; ;; Elf32_Addr sh_addr; ;; Elf32_Off sh_offset; ;; uint32_t sh_size; ;; uint32_t sh_link; ;; uint32_t sh_info; ;; uint32_t sh_addralign; ;; uint32_t sh_entsize; ;; } Elf32_Shdr; (define (parse-elf32-section-header index bv offset byte-order) (if (<= (+ offset 40) (bytevector-length bv)) (make-elf-section index (bytevector-u32-ref bv offset byte-order) (bytevector-u32-ref bv (+ offset 4) byte-order) (bytevector-u32-ref bv (+ offset 8) byte-order) (bytevector-u32-ref bv (+ offset 12) byte-order) (bytevector-u32-ref bv (+ offset 16) byte-order) (bytevector-u32-ref bv (+ offset 20) byte-order) (bytevector-u32-ref bv (+ offset 24) byte-order) (bytevector-u32-ref bv (+ offset 28) byte-order) (bytevector-u32-ref bv (+ offset 32) byte-order) (bytevector-u32-ref bv (+ offset 36) byte-order)) (error "corrupt ELF (offset out of range)" offset))) (define (write-elf32-section-header bv offset byte-order sec) (bytevector-u32-set! bv offset (elf-section-name sec) byte-order) (bytevector-u32-set! bv (+ offset 4) (elf-section-type sec) byte-order) (bytevector-u32-set! bv (+ offset 8) (elf-section-flags sec) byte-order) (bytevector-u32-set! bv (+ offset 12) (elf-section-addr sec) byte-order) (bytevector-u32-set! bv (+ offset 16) (elf-section-offset sec) byte-order) (bytevector-u32-set! bv (+ offset 20) (elf-section-size sec) byte-order) (bytevector-u32-set! bv (+ offset 24) (elf-section-link sec) byte-order) (bytevector-u32-set! bv (+ offset 28) (elf-section-info sec) byte-order) (bytevector-u32-set! bv (+ offset 32) (elf-section-addralign sec) byte-order) (bytevector-u32-set! bv (+ offset 36) (elf-section-entsize sec) byte-order)) ;; typedef struct { ;; uint32_t sh_name; ;; uint32_t sh_type; ;; uint64_t sh_flags; ;; Elf64_Addr sh_addr; ;; Elf64_Off sh_offset; ;; uint64_t sh_size; ;; uint32_t sh_link; ;; uint32_t sh_info; ;; uint64_t sh_addralign; ;; uint64_t sh_entsize; ;; } Elf64_Shdr; (define (elf-section-header-len word-size) (case word-size ((4) 40) ((8) 64) (else (error "bad word size" word-size)))) (define (elf-section-header-addr-offset word-size) (case word-size ((4) 12) ((8) 16) (else (error "bad word size" word-size)))) (define (elf-section-header-offset-offset word-size) (case word-size ((4) 16) ((8) 24) (else (error "bad word size" word-size)))) (define (parse-elf64-section-header index bv offset byte-order) (if (<= (+ offset 64) (bytevector-length bv)) (make-elf-section index (bytevector-u32-ref bv offset byte-order) (bytevector-u32-ref bv (+ offset 4) byte-order) (bytevector-u64-ref bv (+ offset 8) byte-order) (bytevector-u64-ref bv (+ offset 16) byte-order) (bytevector-u64-ref bv (+ offset 24) byte-order) (bytevector-u64-ref bv (+ offset 32) byte-order) (bytevector-u32-ref bv (+ offset 40) byte-order) (bytevector-u32-ref bv (+ offset 44) byte-order) (bytevector-u64-ref bv (+ offset 48) byte-order) (bytevector-u64-ref bv (+ offset 56) byte-order)) (error "corrupt ELF (offset out of range)" offset))) (define (write-elf64-section-header bv offset byte-order sec) (bytevector-u32-set! bv offset (elf-section-name sec) byte-order) (bytevector-u32-set! bv (+ offset 4) (elf-section-type sec) byte-order) (bytevector-u64-set! bv (+ offset 8) (elf-section-flags sec) byte-order) (bytevector-u64-set! bv (+ offset 16) (elf-section-addr sec) byte-order) (bytevector-u64-set! bv (+ offset 24) (elf-section-offset sec) byte-order) (bytevector-u64-set! bv (+ offset 32) (elf-section-size sec) byte-order) (bytevector-u32-set! bv (+ offset 40) (elf-section-link sec) byte-order) (bytevector-u32-set! bv (+ offset 44) (elf-section-info sec) byte-order) (bytevector-u64-set! bv (+ offset 48) (elf-section-addralign sec) byte-order) (bytevector-u64-set! bv (+ offset 56) (elf-section-entsize sec) byte-order)) (define (elf-section elf n) (if (not (< -1 n (elf-shnum elf))) (error "bad section number" n)) ((case (elf-word-size elf) ((4) parse-elf32-section-header) ((8) parse-elf64-section-header) (else (error "unhandled pointer size"))) n (elf-bytes elf) (+ (elf-shoff elf) (* n (elf-shentsize elf))) (elf-byte-order elf))) (define (write-elf-section-header bv offset byte-order word-size sec) ((case word-size ((4) write-elf32-section-header) ((8) write-elf64-section-header) (else (error "invalid word size" word-size))) bv offset byte-order sec)) (define (elf-sections elf) (let lp ((n (elf-shnum elf)) (out '())) (if (zero? n) out (lp (1- n) (cons (elf-section elf (1- n)) out))))) ;; ;; Section Types ;; (define SHT_NULL 0) ; Section header table entry unused (define SHT_PROGBITS 1) ; Program data (define SHT_SYMTAB 2) ; Symbol table (define SHT_STRTAB 3) ; String table (define SHT_RELA 4) ; Relocation entries with addends (define SHT_HASH 5) ; Symbol hash table (define SHT_DYNAMIC 6) ; Dynamic linking information (define SHT_NOTE 7) ; Notes (define SHT_NOBITS 8) ; Program space with no data (bss) (define SHT_REL 9) ; Relocation entries, no addends (define SHT_SHLIB 10) ; Reserved (define SHT_DYNSYM 11) ; Dynamic linker symbol table (define SHT_INIT_ARRAY 14) ; Array of constructors (define SHT_FINI_ARRAY 15) ; Array of destructors (define SHT_PREINIT_ARRAY 16) ; Array of pre-constructors (define SHT_GROUP 17) ; Section group (define SHT_SYMTAB_SHNDX 18) ; Extended section indeces (define SHT_NUM 19) ; Number of defined types. (define SHT_LOOS #x60000000) ; Start OS-specific. (define SHT_HIOS #x6fffffff) ; End OS-specific type (define SHT_LOPROC #x70000000) ; Start of processor-specific (define SHT_HIPROC #x7fffffff) ; End of processor-specific (define SHT_LOUSER #x80000000) ; Start of application-specific (define SHT_HIUSER #x8fffffff) ; End of application-specific ;; ;; Section Flags ;; (define SHF_WRITE (ash 1 0)) ; Writable (define SHF_ALLOC (ash 1 1)) ; Occupies memory during execution (define SHF_EXECINSTR (ash 1 2)) ; Executable (define SHF_MERGE (ash 1 4)) ; Might be merged (define SHF_STRINGS (ash 1 5)) ; Contains nul-terminated strings (define SHF_INFO_LINK (ash 1 6)) ; `sh_info' contains SHT index (define SHF_LINK_ORDER (ash 1 7)) ; Preserve order after combining (define SHF_OS_NONCONFORMING (ash 1 8)) ; Non-standard OS specific handling required (define SHF_GROUP (ash 1 9)) ; Section is member of a group. (define SHF_TLS (ash 1 10)) ; Section hold thread-local data. ;; ;; Dynamic entry types. The DT_GUILE types are non-standard. ;; (define DT_NULL 0) ; Marks end of dynamic section (define DT_NEEDED 1) ; Name of needed library (define DT_PLTRELSZ 2) ; Size in bytes of PLT relocs (define DT_PLTGOT 3) ; Processor defined value (define DT_HASH 4) ; Address of symbol hash table (define DT_STRTAB 5) ; Address of string table (define DT_SYMTAB 6) ; Address of symbol table (define DT_RELA 7) ; Address of Rela relocs (define DT_RELASZ 8) ; Total size of Rela relocs (define DT_RELAENT 9) ; Size of one Rela reloc (define DT_STRSZ 10) ; Size of string table (define DT_SYMENT 11) ; Size of one symbol table entry (define DT_INIT 12) ; Address of init function (define DT_FINI 13) ; Address of termination function (define DT_SONAME 14) ; Name of shared object (define DT_RPATH 15) ; Library search path (deprecated) (define DT_SYMBOLIC 16) ; Start symbol search here (define DT_REL 17) ; Address of Rel relocs (define DT_RELSZ 18) ; Total size of Rel relocs (define DT_RELENT 19) ; Size of one Rel reloc (define DT_PLTREL 20) ; Type of reloc in PLT (define DT_DEBUG 21) ; For debugging ; unspecified (define DT_TEXTREL 22) ; Reloc might modify .text (define DT_JMPREL 23) ; Address of PLT relocs (define DT_BIND_NOW 24) ; Process relocations of object (define DT_INIT_ARRAY 25) ; Array with addresses of init fct (define DT_FINI_ARRAY 26) ; Array with addresses of fini fct (define DT_INIT_ARRAYSZ 27) ; Size in bytes of DT_INIT_ARRAY (define DT_FINI_ARRAYSZ 28) ; Size in bytes of DT_FINI_ARRAY (define DT_RUNPATH 29) ; Library search path (define DT_FLAGS 30) ; Flags for the object being loaded (define DT_ENCODING 32) ; Start of encoded range (define DT_PREINIT_ARRAY 32) ; Array with addresses of preinit fc (define DT_PREINIT_ARRAYSZ 33) ; size in bytes of DT_PREINIT_ARRAY (define DT_NUM 34) ; Number used (define DT_LOGUILE #x37146000) ; Start of Guile-specific (define DT_GUILE_GC_ROOT #x37146000) ; Offset of GC roots (define DT_GUILE_GC_ROOT_SZ #x37146001) ; Size in machine words of GC roots (define DT_GUILE_ENTRY #x37146002) ; Address of entry thunk (define DT_GUILE_VM_VERSION #x37146003) ; Bytecode version (define DT_GUILE_FRAME_MAPS #x37146004) ; Offset of .guile.frame-maps (define DT_HIGUILE #x37146fff) ; End of Guile-specific (define DT_LOOS #x6000000d) ; Start of OS-specific (define DT_HIOS #x6ffff000) ; End of OS-specific (define DT_LOPROC #x70000000) ; Start of processor-specific (define DT_HIPROC #x7fffffff) ; End of processor-specific (define (string-table-ref bv offset) (let lp ((end offset)) (if (zero? (bytevector-u8-ref bv end)) (let ((out (make-bytevector (- end offset)))) (bytevector-copy! bv offset out 0 (- end offset)) (utf8->string out)) (lp (1+ end))))) (define (elf-section-by-name elf name) (let ((off (elf-section-offset (elf-section elf (elf-shstrndx elf))))) (let lp ((n (elf-shnum elf))) (and (> n 0) (let ((section (elf-section elf (1- n)))) (if (equal? (string-table-ref (elf-bytes elf) (+ off (elf-section-name section))) name) section (lp (1- n)))))))) (define (elf-sections-by-name elf) (let* ((sections (elf-sections elf)) (off (elf-section-offset (list-ref sections (elf-shstrndx elf))))) (map (lambda (section) (cons (string-table-ref (elf-bytes elf) (+ off (elf-section-name section))) section)) sections))) (define-record-type (make-elf-symbol name value size info other shndx) elf-symbol? (name elf-symbol-name) (value elf-symbol-value) (size elf-symbol-size) (info elf-symbol-info) (other elf-symbol-other) (shndx elf-symbol-shndx)) (define* (make-elf-symbol* #:key (name 0) (value 0) (size 0) (binding STB_LOCAL) (type STT_NOTYPE) (info (logior (ash binding 4) type)) (visibility STV_DEFAULT) (other visibility) (shndx SHN_UNDEF)) (make-elf-symbol name value size info other shndx)) ;; typedef struct { ;; uint32_t st_name; ;; Elf32_Addr st_value; ;; uint32_t st_size; ;; unsigned char st_info; ;; unsigned char st_other; ;; uint16_t st_shndx; ;; } Elf32_Sym; (define (elf-symbol-len word-size) (case word-size ((4) 16) ((8) 24) (else (error "bad word size" word-size)))) (define (elf-symbol-value-offset word-size) (case word-size ((4) 4) ((8) 8) (else (error "bad word size" word-size)))) (define (parse-elf32-symbol bv offset stroff byte-order) (if (<= (+ offset 16) (bytevector-length bv)) (make-elf-symbol (let ((name (bytevector-u32-ref bv offset byte-order))) (if stroff (string-table-ref bv (+ stroff name)) name)) (bytevector-u32-ref bv (+ offset 4) byte-order) (bytevector-u32-ref bv (+ offset 8) byte-order) (bytevector-u8-ref bv (+ offset 12)) (bytevector-u8-ref bv (+ offset 13)) (bytevector-u16-ref bv (+ offset 14) byte-order)) (error "corrupt ELF (offset out of range)" offset))) (define (write-elf32-symbol bv offset byte-order sym) (bytevector-u32-set! bv offset (elf-symbol-name sym) byte-order) (bytevector-u32-set! bv (+ offset 4) (elf-symbol-value sym) byte-order) (bytevector-u32-set! bv (+ offset 8) (elf-symbol-size sym) byte-order) (bytevector-u8-set! bv (+ offset 12) (elf-symbol-info sym)) (bytevector-u8-set! bv (+ offset 13) (elf-symbol-other sym)) (bytevector-u16-set! bv (+ offset 14) (elf-symbol-shndx sym) byte-order)) ;; typedef struct { ;; uint32_t st_name; ;; unsigned char st_info; ;; unsigned char st_other; ;; uint16_t st_shndx; ;; Elf64_Addr st_value; ;; uint64_t st_size; ;; } Elf64_Sym; (define (parse-elf64-symbol bv offset stroff byte-order) (if (<= (+ offset 24) (bytevector-length bv)) (make-elf-symbol (let ((name (bytevector-u32-ref bv offset byte-order))) (if stroff (string-table-ref bv (+ stroff name)) name)) (bytevector-u64-ref bv (+ offset 8) byte-order) (bytevector-u64-ref bv (+ offset 16) byte-order) (bytevector-u8-ref bv (+ offset 4)) (bytevector-u8-ref bv (+ offset 5)) (bytevector-u16-ref bv (+ offset 6) byte-order)) (error "corrupt ELF (offset out of range)" offset))) (define (write-elf64-symbol bv offset byte-order sym) (bytevector-u32-set! bv offset (elf-symbol-name sym) byte-order) (bytevector-u8-set! bv (+ offset 4) (elf-symbol-info sym)) (bytevector-u8-set! bv (+ offset 5) (elf-symbol-other sym)) (bytevector-u16-set! bv (+ offset 6) (elf-symbol-shndx sym) byte-order) (bytevector-u64-set! bv (+ offset 8) (elf-symbol-value sym) byte-order) (bytevector-u64-set! bv (+ offset 16) (elf-symbol-size sym) byte-order)) (define (write-elf-symbol bv offset byte-order word-size sym) ((case word-size ((4) write-elf32-symbol) ((8) write-elf64-symbol) (else (error "invalid word size" word-size))) bv offset byte-order sym)) (define (elf-symbol-table-len section) (let ((len (elf-section-size section)) (entsize (elf-section-entsize section))) (unless (and (not (zero? entsize)) (zero? (modulo len entsize))) (error "bad symbol table" section)) (/ len entsize))) (define* (elf-symbol-table-ref elf section n #:optional strtab) (let ((bv (elf-bytes elf)) (byte-order (elf-byte-order elf)) (stroff (and strtab (elf-section-offset strtab))) (base (elf-section-offset section)) (len (elf-section-size section)) (entsize (elf-section-entsize section))) (unless (<= (* (1+ n) entsize) len) (error "out of range symbol table access" section n)) (case (elf-word-size elf) ((4) (unless (<= 16 entsize) (error "bad entsize for symbol table" section)) (parse-elf32-symbol bv (+ base (* n entsize)) stroff byte-order)) ((8) (unless (<= 24 entsize) (error "bad entsize for symbol table" section)) (parse-elf64-symbol bv (+ base (* n entsize)) stroff byte-order)) (else (error "bad word size" elf))))) ;; Legal values for ST_BIND subfield of st_info (symbol binding). (define STB_LOCAL 0) ; Local symbol (define STB_GLOBAL 1) ; Global symbol (define STB_WEAK 2) ; Weak symbol (define STB_NUM 3) ; Number of defined types. (define STB_LOOS 10) ; Start of OS-specific (define STB_GNU_UNIQUE 10) ; Unique symbol. (define STB_HIOS 12) ; End of OS-specific (define STB_LOPROC 13) ; Start of processor-specific (define STB_HIPROC 15) ; End of processor-specific ;; Legal values for ST_TYPE subfield of st_info (symbol type). (define STT_NOTYPE 0) ; Symbol type is unspecified (define STT_OBJECT 1) ; Symbol is a data object (define STT_FUNC 2) ; Symbol is a code object (define STT_SECTION 3) ; Symbol associated with a section (define STT_FILE 4) ; Symbol's name is file name (define STT_COMMON 5) ; Symbol is a common data object (define STT_TLS 6) ; Symbol is thread-local data objec (define STT_NUM 7) ; Number of defined types. (define STT_LOOS 10) ; Start of OS-specific (define STT_GNU_IFUNC 10) ; Symbol is indirect code object (define STT_HIOS 12) ; End of OS-specific (define STT_LOPROC 13) ; Start of processor-specific (define STT_HIPROC 15) ; End of processor-specific ;; Symbol visibility specification encoded in the st_other field. (define STV_DEFAULT 0) ; Default symbol visibility rules (define STV_INTERNAL 1) ; Processor specific hidden class (define STV_HIDDEN 2) ; Sym unavailable in other modules (define STV_PROTECTED 3) ; Not preemptible, not exported (define (elf-symbol-binding sym) (ash (elf-symbol-info sym) -4)) (define (elf-symbol-type sym) (logand (elf-symbol-info sym) #xf)) (define (elf-symbol-visibility sym) (logand (elf-symbol-other sym) #x3)) (define NT_GNU_ABI_TAG 1) (define NT_GNU_HWCAP 2) (define NT_GNU_BUILD_ID 3) (define NT_GNU_GOLD_VERSION 4) (define-record-type (make-elf-note name desc type) elf-note? (name elf-note-name) (desc elf-note-desc) (type elf-note-type)) (define (parse-elf-note elf section) (let ((bv (elf-bytes elf)) (byte-order (elf-byte-order elf)) (offset (elf-section-offset section))) (unless (<= (+ offset 12) (bytevector-length bv)) (error "corrupt ELF (offset out of range)" offset)) (let ((namesz (bytevector-u32-ref bv offset byte-order)) (descsz (bytevector-u32-ref bv (+ offset 4) byte-order)) (type (bytevector-u32-ref bv (+ offset 8) byte-order))) (unless (<= (+ offset 12 namesz descsz) (bytevector-length bv)) (error "corrupt ELF (offset out of range)" offset)) (let ((name (make-bytevector (1- namesz))) (desc (make-bytevector descsz))) (bytevector-copy! bv (+ offset 12) name 0 (1- namesz)) (bytevector-copy! bv (+ offset 12 namesz) desc 0 descsz) (make-elf-note (utf8->string name) desc type)))))