From 2b9746c966a43aec16e467822d3c79c999f8def8 Mon Sep 17 00:00:00 2001 From: Florian Fischer Date: Fri, 15 Feb 2019 15:43:31 +0100 Subject: fix links and use single sane code blocks --- doc/Allocators.md | 18 +++++++++--------- doc/Benchmarks.md | 6 +++--- 2 files changed, 12 insertions(+), 12 deletions(-) (limited to 'doc') diff --git a/doc/Allocators.md b/doc/Allocators.md index 2fce8d8..0ce5d77 100644 --- a/doc/Allocators.md +++ b/doc/Allocators.md @@ -1,26 +1,26 @@ # Allocators allocbench supports three mechanisms to change the used allocator for program -run with exec. The easiest is using ```LD_PRELOAD``` to overwrite ```malloc/free``` +run with exec. The easiest is using `LD_PRELOAD` to overwrite `malloc/free` with the functions of a shared library like libtcmalloc.so. If LD_PRELOAD can't be used you can specify a command prefix to somehow load and use your allocator. This command prefix is used for different versions of glibc. The command is prefixed with the loader of the glibc version to test. *Note that the whole glibc is changed maybe tampering with the results*. Additionally binary suffixes are -supported. This could be used to use with ```patchelf``` patched binaries to -use different ```rpath``` or ```linker```. +supported. This could be used to use with `patchelf` patched binaries to +use different `rpath` or `linker`. The used allocators are stored in a global python dictionary associating -their names with the fields: ```cmd_prefix, binary_suffix, LD_PRELOAD``` and ```color```. +their names with the fields: `cmd_prefix, binary_suffix, LD_PRELOAD` and `color`. -By default this dictionary is build from locally installed allocators found by ```whereis```. +By default this dictionary is build from locally installed allocators found by `whereis`. -You can overwrite the default allocators with the ```-a | --allocators``` option -and a python script exporting a global dictionary with the name ```allocators```. +You can overwrite the default allocators with the `-a | --allocators` option +and a python script exporting a global dictionary with the name `allocators`. ## Building Allocators To reproducible build allocators and patched version you can use the -classes ```Allocator{_Sources,_Patched}``` provided in ```src/allocator.py```. +classes `Allocator{_Sources,_Patched}``` provided in ```src/allocator.py`. -See allocators/no_falsesharing.py or allocators/BA_allocators.py for examples. +See [](allocators/no_falsesharing.py) or [](allocators/BA_allocators.py) for examples. diff --git a/doc/Benchmarks.md b/doc/Benchmarks.md index 7e78947..5320582 100644 --- a/doc/Benchmarks.md +++ b/doc/Benchmarks.md @@ -129,16 +129,16 @@ for number_of_runs #### run hooks -* ```preallocator_hook((alloc_name, alloc_definition), current_run, verbose)``` is called +* `preallocator_hook((alloc_name, alloc_definition), current_run, verbose)` is called if available once per allocator before any command is executed. This hook may be useful if you want to prepare stuff for each allocator. The mysql benchmark uses this hook to start the mysql server with the current allocator. -* ```process_output(result_dict, stdout, stderr, allocator_name, permutation, verbose)``` +* `process_output(result_dict, stdout, stderr, allocator_name, permutation, verbose)` is called after each run of your command. Store relevant data in result_dict to use it for your summary. -* ```postallocator_hook((alloc_name, alloc_definition), current_run, verbose)`` +* `postallocator_hook((alloc_name, alloc_definition), current_run, verbose)` is called after all permutations are done for the current allocator. The mysql benchmark uses this hook to terminate the in preallocator_hook started mysql server. -- cgit v1.2.3