File: README.md

package info (click to toggle)
poti 5.0-1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 372 kB
  • sloc: ansic: 1,189; perl: 1,140; makefile: 24
file content (54 lines) | stat: -rw-r--r-- 1,837 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
Poti 
====

Poti is a library to create trace files in the [Paje file
format](http://paje.sf.net). You should not use it directly during the
tracing of your application (I won't stop you from doing this if you
want). I recommend its use after traces are collected in your
preferred file format (probably binary with memory buffers to avoid at
a maximum the tracing intrusion). Note that *the current version of
Poti does not provide any kind of correctness verification in the
parameters you pass for the library functions*, although we are
working on this to support some error verification with minimal memory
utilization.

Raw textual traces in the Paje file format are hard to be exploited. A
trace replay, in a simplistic simulation environment, is implemented
by [the PajeNG suite](http://github.com/schnorr/pajeng/) through the
`pj_dump` tool. It has an exhaustive set of semantic checks for
verification of the compliance to the Paje file format and model. As
output, the `pj_dump` dumps CSV files that can be easily exploited the
way you want with your preferred programming language.

Clone, Compilation and Installation
-----------------------------------

    git clone git://github.com/schnorr/poti.git
    cd poti
    mkdir build
    cd build
    cmake ..
    make install

Customized Installation
------------

Change the installation directory with:

    cmake -DCMAKE_INSTALL_PREFIX=/your/installation/directory/ ..
    make install

Examples
--------

There are many examples on how to use the poti API. You can execute them:

    ./examples/main_example
    ./examples/states

Roadmap
-------

* Check all function parameters and trace consistency according to the [Paje file format](http://paje.sf.net)
* Use data structures instead of strings for all parameters
* Alias management (get rid of user-generated aliases)