ovni/README.txt

30 lines
1003 B
Plaintext
Raw Permalink Normal View History

2021-10-27 10:16:22 +02:00
2022-09-12 16:13:28 +02:00
ovni - Obtuse but Versatile Nanoscale Instrumentation
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
a fast binary trace, and post-processing tools such as the emulator (ovniemu),
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-09-30 10:35:04 +02:00
For more information, take a look at the doc/ directory. You can display the
documentation in HTML by running `mkdocs serve` from the root directory.
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.
2021-11-15 15:38:55 +01:00
To compile in build/ and install into $prefix use:
2022-01-12 10:54:35 +01:00
% mkdir build
2021-11-15 15:38:55 +01:00
% cd build
2022-01-12 10:54:35 +01:00
% cmake -DCMAKE_INSTALL_PREFIX=$prefix ..
2021-11-15 15:38:55 +01:00
% make
% make install
2021-11-16 13:56:52 +01:00
To run the tests you can run (from the build directory):
% make test
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.