Linux-Trace-Users Archive on lore.kernel.org
 help / color / Atom feed
* [ANNOUNCE] libtracececmd 1.0.0
@ 2021-04-10 13:54 Steven Rostedt
  0 siblings, 0 replies; only message in thread
From: Steven Rostedt @ 2021-04-10 13:54 UTC (permalink / raw)
  To: LKML, linux-trace-devel, Linux-trace Users
  Cc: Zamir SUN, Arnaldo Carvalho de Melo, Jiri Olsa, zsun,
	Vitaly Chikunov, Tzvetomir Stoyanov, Yordan Karadzhov,
	Ben Hutchings, Sudip Mukherjee, Tony Jones, John Kacur,
	Clark Williams, Al Stone, Mauro Carvalho Chehab, Jes Sorensen

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

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, back to index

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-04-10 13:54 [ANNOUNCE] libtracececmd 1.0.0 Steven Rostedt

Linux-Trace-Users Archive on lore.kernel.org

Archives are clonable:
	git clone --mirror https://lore.kernel.org/linux-trace-users/0 linux-trace-users/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-trace-users linux-trace-users/ https://lore.kernel.org/linux-trace-users \
		linux-trace-users@vger.kernel.org
	public-inbox-index linux-trace-users

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://nntp.lore.kernel.org/org.kernel.vger.linux-trace-users


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git