[ANNOUNCE] libtracececmd 1.0.0

From: Steven Rostedt
Date: Sat Apr 10 2021 - 09:54:40 EST


This is the initial official release of libtracecmd 1.0.0. This is
needed by KernelShark in order to be in a stand alone repository:

https://git.kernel.org/pub/scm/utils/trace-cmd/kernel-shark.git/

All new development for KernelShark now takes place in the above
repository, which will depend on this library. The code that exists
currently in the trace-cmd.git repository for KernelShark will be
removed.

This library lives (and will always live) with the trace-cmd repository.

https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/snapshot/trace-cmd-libtracecmd-1.1.0.tar.gz
https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/

The purpose of his library is to be able to create and read the
trace.dat file that trace-cmd produces. It may also include
functionality to start trace recordings and other features provided by
trace-cmd itself. But for this release, it only contains the bare
necessities that a stand alone KernelShark requires.

The current API for this release are:

- APIs to open and close a trace.dat file
tracecmd_open()
tracecmd_open_head()
tracecmd_open_fd()
tracecmd_close()

- APIs to initialize and read tracing records from a trace.dat file
tracecmd_init_data()
tracecmd_read_cpu_first()
tracecmd_read_data()
tracecmd_read_at()
tracecmd_free_record()

- APIs to retrieve the libtracevent tep handler
tracecmd_get_tep()

- APIs to manage host and guest data mappings
tracecmd_get_traceid()
tracecmd_get_guest_cpumap()

- APIs to manage the different instances existing in a trace.dat file
tracecmd_buffer_instances()
tracecmd_buffer_instance_name()
tracecmd_buffer_instance_handle()

Many more APIs will come in later releases.

Enjoy!

-- Steve