HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH. |  |
NAME |SYNOPSIS |DESCRIPTION |RETURN VALUE |EXAMPLE |FILES |SEE ALSO |AUTHOR |REPORTING BUGS |LICENSE |RESOURCES |NOTES |COLOPHON | |
LIBTRACEEVENT(3) libtraceevent ManualLIBTRACEEVENT(3)tep_find_event, tep_find_event_by_name, tep_find_event_by_record, tep_record_is_event - Find events by given key.
#include <event-parse.h> struct tep_event *tep_find_event(struct tep_handle *tep, intid); struct tep_event *tep_find_event_by_name(struct tep_handle *tep, const char *sys, const char *name); struct tep_event *tep_find_event_by_record(struct tep_handle *tep, struct tep_record *record); booltep_record_is_event(struct tep_record *record, struct tep_event *event);
This set of functions can be used to search for an event, based on a given criteria. All functions require a pointer to atep, trace event parser context. Thetep_find_event()function searches for an event by given eventid. The event ID is assigned dynamically and can be viewed in event’s format file, "ID" field. Thetep_find_event_by_name()function searches for an event by given eventname, under the systemsys. If thesys is NULL (not specified), the first event withname is returned. Thetep_find_event_by_record()function searches for an event from a givenrecord. Thetep_record_is_event()function tests if the givenrecord is of the type of theevent. This is normally used to know if therecord being processed is of anevent where further processing should be done.
All these functions excepttep_record_is_event()return a pointer to the found event, or NULL if there is no such event.
#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 */ } } ...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.
libtraceevent(3),trace-cmd(1)
Steven Rostedt<rostedt@goodmis.org[1]>, author oflibtraceevent.Tzvetomir Stoyanov<tz.stoyanov@gmail.com[2]>, author of this man page.
Report bugs to <linux-trace-devel@vger.kernel.org[3]>
libtraceevent is Free Software licensed under the GNU LGPL 2.1
https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git/
1. rostedt@goodmis.org mailto:rostedt@goodmis.org 2. tz.stoyanov@gmail.com mailto:tz.stoyanov@gmail.com 3. linux-trace-devel@vger.kernel.org mailto:linux-trace-devel@vger.kernel.org
This page is part of thelibtraceevent (Linux kernel trace event library) project. Information about the project can be found at ⟨https://www.trace-cmd.org/⟩. If you have a bug report for this manual page, see ⟨https://www.trace-cmd.org/⟩. This page was obtained from the project's upstream Git repository ⟨https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git⟩ on 2025-08-11. (At that time, the date of the most recent commit that was found in the repository was 2025-05-30.) If you discover any rendering problems in this HTML version of the page, or you believe there is a better or more up-to-date source for the page, or you have corrections or improvements to the information in this COLOPHON (which isnot part of the original manual page), send a mail to man-pages@man7.orglibtraceevent 1.8.2 06/07/2024LIBTRACEEVENT(3)HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH. | |