carta
tep_event_common_fields(3)

tep_event_common_fields3

Get a list of fields for an event.

Usage

struct tep_format_field **tep_event_common_fields(struct tep_event *event);

struct tep_format_field **tep_event_fields(struct tep_event *event);

Overview

The tep_event_common_fields() function returns an array of pointers to common fields for the event. The array is allocated in the function and must be freed by free(). The last element of the array is NULL.

The tep_event_fields() function returns an array of pointers to event specific fields for the event. The array is allocated in the function and must be freed by free(). The last element of the array is NULL.

Return value

Both tep_event_common_fields() and tep_event_fields() functions return an array of pointers to tep_format_field structures in case of success, or NULL in case of an error.

Examples

#include <event-parse.h>
...
struct tep_handle *tep = tep_alloc();
...
int i;
struct tep_format_field **fields;
struct tep_event *event = tep_find_event_by_name(tep, "kvm", "kvm_exit");
if (event != NULL) {
        fields = tep_event_common_fields(event);
        if (fields != NULL) {
                i = 0;
                while (fields[i]) {
                        /*
                          walk through the list of the common fields
                          of the kvm_exit event
                        */
                        i++;
                }
                free(fields);
        }
        fields = tep_event_fields(event);
        if (fields != NULL) {
                i = 0;
                while (fields[i]) {
                        /*
                          walk through the list of the event specific
                          fields of the kvm_exit event
                        */
                        i++;
                }
                free(fields);
        }
}
...

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

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)

Author

Steven Rostedt <[email protected][1]>, author of libtraceevent.
Tzvetomir Stoyanov <[email protected][2]>, author of this man page.

Reporting bugs

Report bugs to <[email protected][3]>

License

libtraceevent is Free Software licensed under the GNU LGPL 2.1

From libtraceevent 1:1.9.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.