# tep_event_common_fields

## NAME



           tep_event_common_fields, tep_event_fields - Get a list of fields
           for an event.
    


## SYNOPSIS



           **#include <event-parse.h>**
    
           struct tep_format_field ** **tep_event_common_fields**(struct tep_event *_event_);
           struct tep_format_field ** **tep_event_fields**(struct tep_event *_event_);
    


## DESCRIPTION



           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.
    


## EXAMPLE



               #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.
    


## LICENSE



           libtraceevent is Free Software licensed under the GNU LGPL 2.1
    


## RESOURCES



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


## NOTES



            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
    


* * *