add docs etc

PoroCYon 4 years ago committed by PoroCYon
parent 38ea8e9531
commit 75c1cfe603
  1. 94
  2. 32
  3. 10
  4. 23

@ -0,0 +1,94 @@
# smol
Shoddy minsize-oriented linker
PoC by Shiz, bugfixing and 64-bit version by PoroCYon.
## Usage
./ -lfoo -lbar input.o... smol-output.asm
nasm -I src/ [-DUSE_NX] [-DUSE_DL_FINI] -o nasm-output.o smol-output.asm
ld -T ld/link.ld -o binary nasm-output.o input.o...
usage: [-h] [-m TARGET] [-l LIB] [-L DIR] [--nasm NASM] [--cc CC]
[--scanelf SCANELF] [--readelf READELF]
input [input ...] output
positional arguments:
input input object file
output output nasm file
optional arguments:
-h, --help show this help message and exit
-m TARGET, --target TARGET
architecture to generate asm code for (default: auto)
-l LIB, --library LIB
libraries to link against
-L DIR, --libdir DIR directories to search libraries in
--nasm NASM which nasm binary to use
--cc CC which cc binary to use
--scanelf SCANELF which scanelf binary to use
--readelf READELF which readelf binary to use
A minimal crt (and `_start` funcion) are provided in case you want to use `main`.
## Internal workings
`` inspects the input object files for needed library files and symbols.
It then outputs the list of needed libraries, hashes of the needed symbols and
provides stubs for the external functions. This is then combined with a
custom-made, small ELF header and 'runtime linker' which resolves the symbols
(from the hashes) so that the function stubs are usable.
The runtime linker uses an unorthodox way of resolving the symbols (which only
works for glibc): on both i386 and x86_64, the linker startup code
(`_dl_start_user`) leaks the global `struct link_map` to the user code:
on i386, a pointer to it is passed directly through `eax`:
# (eax, edx, ecx, esi) = (_dl_loaded, argc, argv, envp)
movl _rtld_local@GOTOFF(%ebx), %eax
## [ boring stuff... ]
pushl %eax
# Call the function to run the initializers.
call _dl_init
## eax still lives thanks to the ABI and calling convention
## [ boring stuff... ]
# Jump to the user's entry point.
jmp *%edi
## eax contains the pointer to the link_map!
On x86_64, it's a bit more convoluted: the contents of `_rtld_local` is loaded
into `rsi`, but because of the x86_64 ABI, the caller isn't required to restore
that register. However, due to the `call` instruction, a pointer to the
instruction after the call will be placed on the stack, at `_start`, it's at
`rsp - 8`. Then, the offset to the "load from `_rtld_local`"-instruction can be
calculated, and the part of the instruction which contains the offset to
`_rtld_local`, from the instruction after the load (of which the address is now
also known), can be read, and thus the contents of that global variable are
available as well.
Now the code continues with walking the "import tables" for the needed
libraries (which already have been automatically parsed by ``), looks
though their hash tables for the hashes of the imported symbols, gets their
addresses, and replaces the hashes in the table with the function addresses.
However, because the `struct link_map` can change between glibc versions,
especially the size of the `l_info` field (a fixed-size array, the `DT_*NUM`
constants tend to change every few versions). To remediate this, one can note
that the `l_entry` field comes a few bytes after `l_info`, that the root
`struct link_map` is the one of the main executable, and that the contents of
the `l_entry` field is known at compile-time. Thus, the loader scans the struct
for the entry point address, and uses that as an offset for the 'far fields' of
the `struct link_map`. ('Near' fields like `l_name` and `l_addr` are resp. 8
and 0, and will thus pretty much never change.)
## Greets
auld alrj blackle breadbox faemiyah gib3&tix0 las leblane parcelshit unlord

@ -23,19 +23,23 @@ ehdr:
dw phdr.load - phdr.dynamic ; e_phentsize
%ifdef USE_NX
dw 4 ; e_phnum
dw 3 ; e_phnum
dw 0, 0, 0 ; e_shentsize, e_shnum, e_shstrndx
dd PT_INTERP ; p_type ; e_phnum, e_shentsize
dd 0 ; p_flags ; e_shnum, e_shstrndx
%ifndef USE_NX
dq interp - ehdr ; p_offset
dq interp, interp ; p_vaddr, p_paddr
dq interp.end - interp ; p_filesz
@ -63,10 +67,24 @@ phdr.load:
dq _smol_total_memsize ; p_memsz
dq 0x1000 ; p_align
%error "TODO" ; TODO
dq 0
dq ehdr, 0
dq _smol_textandheader_size
dq _smol_textandheader_size
dq 0x1000 ; let's hope this works
dq _smol_data_off
dq _smol_data_start, 0
dq _smol_dataandbss_size
dq _smol_dataandbss_size
dq 0x1000

@ -2,11 +2,19 @@
%include ""
%ifdef ELF_TYPE
[section .text.startup.smol]
; not defined -> debugging!
[section .text]
%ifdef USE_DL_FINI
push edx ; _dl_fini
; try to get the 'version-agnostic' pffset of the stuff we're
; interested in
mov ebx, eax
@ -118,7 +126,9 @@ link.done:
;xor ebp, ebp ; let's put that burden on the user code, so they can leave
; it out if they want to
%ifdef USE_DL_FINI
pop edx ; _dl_fini
sub esp, 20 ; put the stack where _start (C code) expects it to be
; this can't be left out, because X needs the envvars

@ -9,19 +9,10 @@
[section .text]
; rax: special op reg
;!rbx: ptrdiff_t glibc_vercompat_extra_hi_field_off
; rcx: special op reg
; rdx: special op reg
; rsi: special op reg
; rdi: struct link_map* root / special op reg
; rbp:
; r8 :
; r9 :
;!r10: struct link_map* entry + far correction factor
; r11: temp storage var
;!r12: struct link_map* entry
;!r13: _dl_fini address (reqd by the ABI)
; rbx: ptrdiff_t glibc_vercompat_extra_hi_field_off
; r10: struct link_map* entry + far correction factor
; r12: struct link_map* entry
; r13: _dl_fini address (reqd by the ABI)
%ifndef ELF_TYPE
extern _symbols
@ -29,7 +20,9 @@ global _start
%ifdef USE_DL_FINI
xchg r13, rdx ; _dl_fini
mov r12, [rsp - 8] ; return address of _dl_init
mov r11d, dword [r12 - 20] ; decode part of 'mov rdi, [rel _rtld_global]'
@ -164,9 +157,11 @@ _smol_start:
jmp short .next_hash
;xor rbp, rbp
;xor rbp, rbp ; still 0 from _dl_start_user
mov rdi, rsp
push rax
%ifdef USE_DL_FINI
xchg rsi, r13 ; _dl_fini
; fallthru to _start