m2-internship
/
dwarf-assembly
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
Some experiments around compiling the most used Dwarf information (ELF debug data) directly into assembly.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
92 Commits
8 Branches
0 Tags
461 KiB
Branch: master
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
Théophile Bastian e5693328e2
DwAsm: check global bounds 		3 years ago
benching Add python benchmark 3 years ago
env env/apply: fix deactivate 4 years ago
shared Handle rbx 4 years ago
src DwAsm: check global bounds 3 years ago
stack_walker Use max(uintptr_t) as error, not assert(0) 4 years ago
stack_walker_libunwind Add a libunwind-powered stack_walker 4 years ago
stats stats: various modifications 4 years ago
tests Add a libunwind-powered stack_walker 4 years ago
.gitignore Add two csmith benching scripts 4 years ago
LICENSE Initial commit 4 years ago
Makefile Add python script to compile easily 4 years ago
README.md Update README 4 years ago
compare_sizes.py compare_sizes: compare to original program size 4 years ago
extract_pc.py Refactor extract_pc 4 years ago
generate_eh_elf.py Generate_eh_elf: apply black 3 years ago
shared_python.py Add auxiliary eh_elfs directories 4 years ago

README.md

Dwarf Assembly

A compiler from DWARF unwinding data to native x86_64 binaries.

This repository also contains various experiments, tools, benchmarking scripts, stats scripts, etc. to work on this compiler.

Dependencies

As of now, this project relies on the following libraries:

These libraries are expected to be installed somewhere your compiler can find them. If you are using Archlinux, you can check these PKGBUILDs.

Scripts and directories

  • ./generate_eh_elf.py: generate .eh_elf.so files for a binary (and its dependencies if required)

  • ./compare_sizes.py: compare the sizes of the .eh_frame of a binary (and its dependencies) with the sizes of the .text of the generated ELFs.

  • ./extract_pc.py: extracts a list of valid program counters of an ELF and produce a file as read by dwarf-assembly, deprecated.

  • benching: all about benchmarking

  • env: environment variables manager to ease the use of various eh_elfs in parallel, for experiments.

  • shared: code shared between various subprojects

  • src: the compiler code itself

  • stack_walker: a primitive stack walker using eh_elfs

  • stack_walker_libunwind: a primitive stack walker using vanilla libunwind

  • stats: a statistics gathering module

  • tests: some tests regarding eh_elfs, deprecated.

How to use

To compile eh_elfs for a given ELF file, say foo.bin, it is recommended to use generate_eh_elf.py. Help can be obtained with --help. A standard command is

./generate_eh_elf.py --deps --enable-deref-arg --global-switch -o eh_elfs foo.bin

This will compile foo.bin and all the shared objects it relies on into eh_elfs, in the directory ./eh_elfs, using a dereferencing argument (which is necessary for perf-eh_elfs).

Generate the intermediary C file

If you're curious about the intermediary C file generated for a given ELF file foo.bin, you must call dwarf-assembly directly. A parameter --help can be passed; a standard command is

./dwarf-assembly --global-switch --enable-deref-arg foo.bin

Beware! This will generate the C code on the standard output.