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_get_event, tep_get_first_event, tep_get_events_count - Access events.
#include <event-parse.h> struct tep_event *tep_get_event(struct tep_handle *tep, intindex); struct tep_event *tep_get_first_event(struct tep_handle *tep); inttep_get_events_count(struct tep_handle *tep);
Thetep_get_event()function returns a pointer to event at the givenindex. Thetep argument is trace event parser context, theindex is the index of the requested event. Thetep_get_first_event()function returns a pointer to the first event. As events are stored in an array, this function returns the pointer to the beginning of the array. Thetep argument is trace event parser context. Thetep_get_events_count()function returns the number of the events in the array. Thetep argument is trace event parser context.
Thetep_get_event()returns a pointer to the event located atindex. NULL is returned in case of error, in case there are no events orindex is out of range. Thetep_get_first_event()returns a pointer to the first event. NULL is returned in case of error, or in case there are no events. Thetep_get_events_count()returns the number of the events. 0 is returned in case of error, or in case there are no events.
#include <event-parse.h> ... struct tep_handle *tep = tep_alloc(); ... int i,count = tep_get_events_count(tep); struct tep_event *event, *events = tep_get_first_event(tep); if (events == NULL) { /* There are no events */ } else { for (i = 0; i < count; i++) { event = (events+i); /* process events[i] */ } /* Get the last event */ event = tep_get_event(tep, count-1); }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.7.3 09/24/2023LIBTRACEEVENT(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. | |