ovni/README.md

32 lines
1.0 KiB
Markdown
Raw Normal View History

2022-11-04 16:14:05 +01:00
![Ovni logo](doc/fig/logo2.png)
2021-10-27 10:16:22 +02:00
2022-09-30 10:35:04 +02:00
The ovni project is composed of a runtime library (libovni.so), which generates
2022-11-04 16:14:05 +01:00
a fast binary trace, and post-processing tools such as the emulator ovniemu,
2022-09-30 10:35:04 +02:00
which transform the binary trace to the PRV format, suitable to be loaded in
Paraver.
2021-10-27 10:16:22 +02:00
The libovni.so library is licensed under MIT, while the rest of tools are GPLv3
unless otherwise stated.
2022-11-04 16:14:05 +01:00
For more information, read the [documentation online][doc] or take a look at the
doc/ directory. You can display the documentation in HTML by running `mkdocs
serve` from the root directory.
[doc]: https://ovni.readthedocs.io
2021-11-15 15:38:55 +01:00
2022-09-12 16:13:28 +02:00
To build ovni you would need a C compiler, MPI and cmake version 3.20 or newer.
2022-11-04 16:14:05 +01:00
To compile in build/ and install into `$prefix` use:
2021-11-15 15:38:55 +01:00
2022-11-04 16:14:05 +01:00
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=$prefix ..
$ make
$ make install
2021-11-15 15:38:55 +01:00
2021-11-16 13:56:52 +01:00
To run the tests you can run (from the build directory):
2022-11-04 16:14:05 +01:00
$ make test
2021-11-16 13:56:52 +01:00
2021-11-15 15:38:55 +01:00
See cmake(1) and cmake-env-variables(7) to see more information about
the variables affecting the generation and build process.