Skip to content

Latest commit

 

History

History
27 lines (19 loc) · 1.17 KB

trace_file_overview_file_formats.adoc

File metadata and controls

27 lines (19 loc) · 1.17 KB

Overview file formats

There are three formats for storing OSI messages in trace files:

*.osi

Native binary trace file.

*.txth

Human-readable plain-text trace file.

*.mcap

Binary trace file supporting more advanced features like indexed data, additional metadata and more.

Note
Previous releases of OSI also supported a so-called plain-text trace file format, with file extension .txt. This legacy format did not contain plain-text, but rather binary protobuf messages separated by a special separator. For obvious reasons the format was deprecated and fully replaced with the .osi binary file format. This release no longer contains any support for the legacy .txt file format. These files may be used for manual checks.
Tip
For efficient handling of trace files, you can utilize the specification-compliant tools and libraries provided in the companion osi-utilities repository. For example, convenient writer and reader classes are provided handling OSI messages for the different file formats.