tep_find_event3

Usage

Overview

This set of functions can be used to search for an event, based on a given criteria. All functions require a pointer to a tep, trace event parser context.

The tep_find_event() function searches for an event by given event id. The event ID is assigned dynamically and can be viewed in event’s format file, "ID" field.

The tep_find_event_by_name() function searches for an event by given event name, under the system sys. If the sys is NULL (not specified), the first event with name is returned.

The tep_find_event_by_record() function searches for an event from a given record.

The tep_record_is_event() function tests if the given record is of the type of the event. This is normally used to know if the record being processed is of an event where further processing should be done.

Return value

All these functions except tep_record_is_event() return a pointer to the found event, or NULL if there is no such event.

Examples

#include <event-parse.h>
...
struct tep_handle *tep = tep_alloc();
...
struct tep_event *event;
event = tep_find_event(tep, 1857);
if (event == NULL) {
        /* There is no event with ID 1857 */
}
event = tep_find_event_by_name(tep, "kvm", "kvm_exit");
if (event == NULL) {
        /* There is no kvm_exit event, from kvm system */
}
void event_from_record(struct tep_record *record)
{
 struct tep_event *event = tep_find_event_by_record(tep, record);
        if (event == NULL) {
                /* There is no event from given record */
        }
}
...

Files

event-parse.h
        Header file to include in order to have access to the library APIs.
-ltraceevent
        Linker switch to add when building a program that uses the library.

Resources

https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git/

Notes

1.

[email protected]

mailto:[email protected]

2.

[email protected]

mailto:[email protected]

3.

[email protected]

mailto:[email protected]