mirror of
https://github.com/Zenithsiz/ftmemsim.git
synced 2026-02-03 09:50:32 +00:00
Added README to project.
This commit is contained in:
parent
684c0c9f5c
commit
aa006ca178
40
README.md
Normal file
40
README.md
Normal file
@ -0,0 +1,40 @@
|
||||
# `ftmemsim`
|
||||
|
||||
A tiered-memory simulator.
|
||||
|
||||
# Usage
|
||||
|
||||
To use this library, first clone it:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/Zenithsiz/ftmemsim
|
||||
```
|
||||
|
||||
(If you need to generate traces, also clone the submodules with `--recurse-submodules`).
|
||||
|
||||
After this, you can check `run-tracer.sh` for an example on how to trace a program. You'll need to compile the valgrind fork in `extern/ftmemsim-valgrind`. Follow the instructions on it's README for building.
|
||||
|
||||
You'll also need the `parse-valgrind` rust tool. You can use the following to build it:
|
||||
|
||||
```bash
|
||||
cargo build --release --package "parse-valgrind"
|
||||
```
|
||||
|
||||
You can now run the simulator with these traces. Look in the `run.sh` file for examples, but it boils down to running the simulator itself:
|
||||
|
||||
```bash
|
||||
cargo run --release --package ftmemsim -- \
|
||||
--config <config-file> \
|
||||
<trace-file> \
|
||||
--output <output-file>
|
||||
```
|
||||
|
||||
Finally you can use `ftmemsim-graphs` to generate some graphs from it's output. See `./ftmemsim-graphs --help` for a list of all the graphs. You can run, for example, the following:
|
||||
|
||||
```bash
|
||||
cargo run --release --package ftmemsim-graphs -- \
|
||||
page-migrations \
|
||||
<simulator-output-file> \
|
||||
--config <config-file> \
|
||||
--output <output-image>
|
||||
```
|
||||
Loading…
x
Reference in New Issue
Block a user