ruler-trace | Ruler Trace Container : a robust file format to save traces

ruler-trace is a C++ library. ruler-trace has no bugs, it has no vulnerabilities, it has a Weak Copyleft License and it has low support. You can download it from GitHub.

A file format to save multiple streams of trace to. It has a few interesting properties:. The reader is work in progress... The data structure is more or less like a ruler: you have a major unit (10 MB in file size), which is subdivided in minor units (100 KB). At every unit boundary, there is a index table in the file that tells you what data there is around it, or where the last data of a specific stream can be found. Therefore, search through the file is easy, if you know the position of one such index, the rest can be predicted. Synchronizing to this ruler unit sequence is done by a specific marker frame at every major unit. From there, the unit size and meta data can be read. To find a specific sample, a binary search can be done through the indices. Streams are split in frames. Frames of different streams can be multiplexed freely. If a frame contains one sample, let's say a 32-bit integer, the overhead of writing this frame is one byte, which contains the identifier of the stream. For details, see doc/format.md.