1libtraceevent(3)
2================
3
4NAME
5----
6tep_event_common_fields, tep_event_fields - Get a list of fields for an event.
7
8SYNOPSIS
9--------
10[verse]
11--
12*#include <event-parse.h>*
13
14struct tep_format_field pass:[*]pass:[*]*tep_event_common_fields*(struct tep_event pass:[*]_event_);
15struct tep_format_field pass:[*]pass:[*]*tep_event_fields*(struct tep_event pass:[*]_event_);
16--
17
18DESCRIPTION
19-----------
20The _tep_event_common_fields()_ function returns an array of pointers to common
21fields for the _event_. The array is allocated in the function and must be freed
22by free(). The last element of the array is NULL.
23
24The _tep_event_fields()_ function returns an array of pointers to event specific
25fields for the _event_. The array is allocated in the function and must be freed
26by free(). The last element of the array is NULL.
27
28RETURN VALUE
29------------
30Both _tep_event_common_fields()_ and _tep_event_fields()_ functions return
31an array of pointers to tep_format_field structures in case of success, or
32NULL in case of an error.
33
34EXAMPLE
35-------
36[source,c]
37--
38#include <event-parse.h>
39...
40struct tep_handle *tep = tep_alloc();
41...
42int i;
43struct tep_format_field **fields;
44struct tep_event *event = tep_find_event_by_name(tep, "kvm", "kvm_exit");
45if (event != NULL) {
46	fields = tep_event_common_fields(event);
47	if (fields != NULL) {
48		i = 0;
49		while (fields[i]) {
50			/*
51			  walk through the list of the common fields
52			  of the kvm_exit event
53			*/
54			i++;
55		}
56		free(fields);
57	}
58	fields = tep_event_fields(event);
59	if (fields != NULL) {
60		i = 0;
61		while (fields[i]) {
62			/*
63			  walk through the list of the event specific
64			  fields of the kvm_exit event
65			*/
66			i++;
67		}
68		free(fields);
69	}
70}
71...
72--
73
74FILES
75-----
76[verse]
77--
78*event-parse.h*
79	Header file to include in order to have access to the library APIs.
80*-ltraceevent*
81	Linker switch to add when building a program that uses the library.
82--
83
84SEE ALSO
85--------
86_libtraceevent(3)_, _trace-cmd(1)_
87
88AUTHOR
89------
90[verse]
91--
92*Steven Rostedt* <rostedt@goodmis.org>, author of *libtraceevent*.
93*Tzvetomir Stoyanov* <tz.stoyanov@gmail.com>, author of this man page.
94--
95REPORTING BUGS
96--------------
97Report bugs to  <linux-trace-devel@vger.kernel.org>
98
99LICENSE
100-------
101libtraceevent is Free Software licensed under the GNU LGPL 2.1
102
103RESOURCES
104---------
105https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
106