[ANNOUNCE] libtracececmd 1.0.0

[ANNOUNCE] libtracececmd 1.0.0

[Steven Rostedt]

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