tools/lib/traceevent/event-parse.h

   1 /*
   2  * Copyright (C) 2009, 2010 Red Hat Inc, Steven Rostedt <srostedt@redhat.com>
   3  *
   4  * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   5  * This program is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation;
   8  * version 2.1 of the License (not later!)
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General Public
  16  * License along with this program; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18  *
  19  * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  20  */
  21 #ifndef _PARSE_EVENTS_H
  22 #define _PARSE_EVENTS_H
  23
  24 #include <stdarg.h>
  25 #include <regex.h>
  26
  27 #ifndef __unused
  28 #define __unused __attribute__ ((unused))
  29 #endif
  30
  31 /* ----------------------- trace_seq ----------------------- */
  32
  33
  34 #ifndef TRACE_SEQ_BUF_SIZE
  35 #define TRACE_SEQ_BUF_SIZE 4096
  36 #endif
  37
  38 #ifndef DEBUG_RECORD
  39 #define DEBUG_RECORD 0
  40 #endif
  41
  42 struct pevent_record {
  43         unsigned long long      ts;
  44         unsigned long long      offset;
  45         long long               missed_events;  /* buffer dropped events before */
  46         int                     record_size;    /* size of binary record */
  47         int                     size;           /* size of data */
  48         void                    *data;
  49         int                     cpu;
  50         int                     ref_count;
  51         int                     locked;         /* Do not free, even if ref_count is zero */
  52         void                    *private;
  53 #if DEBUG_RECORD
  54         struct pevent_record    *prev;
  55         struct pevent_record    *next;
  56         long                    alloc_addr;
  57 #endif
  58 };
  59
  60 /*
  61  * Trace sequences are used to allow a function to call several other functions
  62  * to create a string of data to use (up to a max of PAGE_SIZE).
  63  */
  64
  65 struct trace_seq {
  66         char                    *buffer;
  67         unsigned int            buffer_size;
  68         unsigned int            len;
  69         unsigned int            readpos;
  70 };
  71
  72 void trace_seq_init(struct trace_seq *s);
  73 void trace_seq_destroy(struct trace_seq *s);
  74
  75 extern int trace_seq_printf(struct trace_seq *s, const char *fmt, ...)
  76         __attribute__ ((format (printf, 2, 3)));
  77 extern int trace_seq_vprintf(struct trace_seq *s, const char *fmt, va_list args)
  78         __attribute__ ((format (printf, 2, 0)));
  79
  80 extern int trace_seq_puts(struct trace_seq *s, const char *str);
  81 extern int trace_seq_putc(struct trace_seq *s, unsigned char c);
  82
  83 extern void trace_seq_terminate(struct trace_seq *s);
  84
  85 extern int trace_seq_do_printf(struct trace_seq *s);
  86
  87
  88 /* ----------------------- pevent ----------------------- */
  89
  90 struct pevent;
  91 struct event_format;
  92
  93 typedef int (*pevent_event_handler_func)(struct trace_seq *s,
  94                                          struct pevent_record *record,
  95                                          struct event_format *event,
  96                                          void *context);
  97
  98 typedef int (*pevent_plugin_load_func)(struct pevent *pevent);
  99 typedef int (*pevent_plugin_unload_func)(void);
 100
 101 struct plugin_option {
 102         struct plugin_option            *next;
 103         void                            *handle;
 104         char                            *file;
 105         char                            *name;
 106         char                            *plugin_alias;
 107         char                            *description;
 108         char                            *value;
 109         void                            *private;
 110         int                             set;
 111 };
 112
 113 /*
 114  * Plugin hooks that can be called:
 115  *
 116  * PEVENT_PLUGIN_LOADER:  (required)
 117  *   The function name to initialized the plugin.
 118  *
 119  *   int PEVENT_PLUGIN_LOADER(struct pevent *pevent)
 120  *
 121  * PEVENT_PLUGIN_UNLOADER:  (optional)
 122  *   The function called just before unloading
 123  *
 124  *   int PEVENT_PLUGIN_UNLOADER(void)
 125  *
 126  * PEVENT_PLUGIN_OPTIONS:  (optional)
 127  *   Plugin options that can be set before loading
 128  *
 129  *   struct plugin_option PEVENT_PLUGIN_OPTIONS[] = {
 130  *      {
 131  *              .name = "option-name",
 132  *              .plugin_alias = "overide-file-name", (optional)
 133  *              .description = "description of option to show users",
 134  *      },
 135  *      {
 136  *              .name = NULL,
 137  *      },
 138  *   };
 139  *
 140  *   Array must end with .name = NULL;
 141  *
 142  *
 143  *   .plugin_alias is used to give a shorter name to access
 144  *   the vairable. Useful if a plugin handles more than one event.
 145  *
 146  * PEVENT_PLUGIN_ALIAS: (optional)
 147  *   The name to use for finding options (uses filename if not defined)
 148  */
 149 #define PEVENT_PLUGIN_LOADER pevent_plugin_loader
 150 #define PEVENT_PLUGIN_UNLOADER pevent_plugin_unloader
 151 #define PEVENT_PLUGIN_OPTIONS pevent_plugin_options
 152 #define PEVENT_PLUGIN_ALIAS pevent_plugin_alias
 153 #define _MAKE_STR(x)    #x
 154 #define MAKE_STR(x)     _MAKE_STR(x)
 155 #define PEVENT_PLUGIN_LOADER_NAME MAKE_STR(PEVENT_PLUGIN_LOADER)
 156 #define PEVENT_PLUGIN_UNLOADER_NAME MAKE_STR(PEVENT_PLUGIN_UNLOADER)
 157 #define PEVENT_PLUGIN_OPTIONS_NAME MAKE_STR(PEVENT_PLUGIN_OPTIONS)
 158 #define PEVENT_PLUGIN_ALIAS_NAME MAKE_STR(PEVENT_PLUGIN_ALIAS)
 159
 160 #define NSECS_PER_SEC           1000000000ULL
 161 #define NSECS_PER_USEC          1000ULL
 162
 163 enum format_flags {
 164         FIELD_IS_ARRAY          = 1,
 165         FIELD_IS_POINTER        = 2,
 166         FIELD_IS_SIGNED         = 4,
 167         FIELD_IS_STRING         = 8,
 168         FIELD_IS_DYNAMIC        = 16,
 169         FIELD_IS_LONG           = 32,
 170         FIELD_IS_FLAG           = 64,
 171         FIELD_IS_SYMBOLIC       = 128,
 172 };
 173
 174 struct format_field {
 175         struct format_field     *next;
 176         struct event_format     *event;
 177         char                    *type;
 178         char                    *name;
 179         int                     offset;
 180         int                     size;
 181         unsigned int            arraylen;
 182         unsigned int            elementsize;
 183         unsigned long           flags;
 184 };
 185
 186 struct format {
 187         int                     nr_common;
 188         int                     nr_fields;
 189         struct format_field     *common_fields;
 190         struct format_field     *fields;
 191 };
 192
 193 struct print_arg_atom {
 194         char                    *atom;
 195 };
 196
 197 struct print_arg_string {
 198         char                    *string;
 199         int                     offset;
 200 };
 201
 202 struct print_arg_field {
 203         char                    *name;
 204         struct format_field     *field;
 205 };
 206
 207 struct print_flag_sym {
 208         struct print_flag_sym   *next;
 209         char                    *value;
 210         char                    *str;
 211 };
 212
 213 struct print_arg_typecast {
 214         char                    *type;
 215         struct print_arg        *item;
 216 };
 217
 218 struct print_arg_flags {
 219         struct print_arg        *field;
 220         char                    *delim;
 221         struct print_flag_sym   *flags;
 222 };
 223
 224 struct print_arg_symbol {
 225         struct print_arg        *field;
 226         struct print_flag_sym   *symbols;
 227 };
 228
 229 struct print_arg_hex {
 230         struct print_arg        *field;
 231         struct print_arg        *size;
 232 };
 233
 234 struct print_arg_dynarray {
 235         struct format_field     *field;
 236         struct print_arg        *index;
 237 };
 238
 239 struct print_arg;
 240
 241 struct print_arg_op {
 242         char                    *op;
 243         int                     prio;
 244         struct print_arg        *left;
 245         struct print_arg        *right;
 246 };
 247
 248 struct pevent_function_handler;
 249
 250 struct print_arg_func {
 251         struct pevent_function_handler  *func;
 252         struct print_arg                *args;
 253 };
 254
 255 enum print_arg_type {
 256         PRINT_NULL,
 257         PRINT_ATOM,
 258         PRINT_FIELD,
 259         PRINT_FLAGS,
 260         PRINT_SYMBOL,
 261         PRINT_HEX,
 262         PRINT_TYPE,
 263         PRINT_STRING,
 264         PRINT_BSTRING,
 265         PRINT_DYNAMIC_ARRAY,
 266         PRINT_OP,
 267         PRINT_FUNC,
 268 };
 269
 270 struct print_arg {
 271         struct print_arg                *next;
 272         enum print_arg_type             type;
 273         union {
 274                 struct print_arg_atom           atom;
 275                 struct print_arg_field          field;
 276                 struct print_arg_typecast       typecast;
 277                 struct print_arg_flags          flags;
 278                 struct print_arg_symbol         symbol;
 279                 struct print_arg_hex            hex;
 280                 struct print_arg_func           func;
 281                 struct print_arg_string         string;
 282                 struct print_arg_op             op;
 283                 struct print_arg_dynarray       dynarray;
 284         };
 285 };
 286
 287 struct print_fmt {
 288         char                    *format;
 289         struct print_arg        *args;
 290 };
 291
 292 struct event_format {
 293         struct pevent           *pevent;
 294         char                    *name;
 295         int                     id;
 296         int                     flags;
 297         struct format           format;
 298         struct print_fmt        print_fmt;
 299         char                    *system;
 300         pevent_event_handler_func handler;
 301         void                    *context;
 302 };
 303
 304 enum {
 305         EVENT_FL_ISFTRACE       = 0x01,
 306         EVENT_FL_ISPRINT        = 0x02,
 307         EVENT_FL_ISBPRINT       = 0x04,
 308         EVENT_FL_ISFUNCENT      = 0x10,
 309         EVENT_FL_ISFUNCRET      = 0x20,
 310
 311         EVENT_FL_FAILED         = 0x80000000
 312 };
 313
 314 enum event_sort_type {
 315         EVENT_SORT_ID,
 316         EVENT_SORT_NAME,
 317         EVENT_SORT_SYSTEM,
 318 };
 319
 320 enum event_type {
 321         EVENT_ERROR,
 322         EVENT_NONE,
 323         EVENT_SPACE,
 324         EVENT_NEWLINE,
 325         EVENT_OP,
 326         EVENT_DELIM,
 327         EVENT_ITEM,
 328         EVENT_DQUOTE,
 329         EVENT_SQUOTE,
 330 };
 331
 332 typedef unsigned long long (*pevent_func_handler)(struct trace_seq *s,
 333                                              unsigned long long *args);
 334
 335 enum pevent_func_arg_type {
 336         PEVENT_FUNC_ARG_VOID,
 337         PEVENT_FUNC_ARG_INT,
 338         PEVENT_FUNC_ARG_LONG,
 339         PEVENT_FUNC_ARG_STRING,
 340         PEVENT_FUNC_ARG_PTR,
 341         PEVENT_FUNC_ARG_MAX_TYPES
 342 };
 343
 344 enum pevent_flag {
 345         PEVENT_NSEC_OUTPUT              = 1,    /* output in NSECS */
 346 };
 347
 348 struct cmdline;
 349 struct cmdline_list;
 350 struct func_map;
 351 struct func_list;
 352 struct event_handler;
 353
 354 struct pevent {
 355         int ref_count;
 356
 357         int header_page_ts_offset;
 358         int header_page_ts_size;
 359         int header_page_size_offset;
 360         int header_page_size_size;
 361         int header_page_data_offset;
 362         int header_page_data_size;
 363         int header_page_overwrite;
 364
 365         int file_bigendian;
 366         int host_bigendian;
 367
 368         int latency_format;
 369
 370         int old_format;
 371
 372         int cpus;
 373         int long_size;
 374
 375         struct cmdline *cmdlines;
 376         struct cmdline_list *cmdlist;
 377         int cmdline_count;
 378
 379         struct func_map *func_map;
 380         struct func_list *funclist;
 381         unsigned int func_count;
 382
 383         struct printk_map *printk_map;
 384         struct printk_list *printklist;
 385         unsigned int printk_count;
 386
 387
 388         struct event_format **events;
 389         int nr_events;
 390         struct event_format **sort_events;
 391         enum event_sort_type last_type;
 392
 393         int type_offset;
 394         int type_size;
 395
 396         int pid_offset;
 397         int pid_size;
 398
 399         int pc_offset;
 400         int pc_size;
 401
 402         int flags_offset;
 403         int flags_size;
 404
 405         int ld_offset;
 406         int ld_size;
 407
 408         int print_raw;
 409
 410         int test_filters;
 411
 412         int flags;
 413
 414         struct format_field *bprint_ip_field;
 415         struct format_field *bprint_fmt_field;
 416         struct format_field *bprint_buf_field;
 417
 418         struct event_handler *handlers;
 419         struct pevent_function_handler *func_handlers;
 420
 421         /* cache */
 422         struct event_format *last_event;
 423 };
 424
 425 static inline void pevent_set_flag(struct pevent *pevent, int flag)
 426 {
 427         pevent->flags |= flag;
 428 }
 429
 430 static inline unsigned short
 431 __data2host2(struct pevent *pevent, unsigned short data)
 432 {
 433         unsigned short swap;
 434
 435         if (pevent->host_bigendian == pevent->file_bigendian)
 436                 return data;
 437
 438         swap = ((data & 0xffULL) << 8) |
 439                 ((data & (0xffULL << 8)) >> 8);
 440
 441         return swap;
 442 }
 443
 444 static inline unsigned int
 445 __data2host4(struct pevent *pevent, unsigned int data)
 446 {
 447         unsigned int swap;
 448
 449         if (pevent->host_bigendian == pevent->file_bigendian)
 450                 return data;
 451
 452         swap = ((data & 0xffULL) << 24) |
 453                 ((data & (0xffULL << 8)) << 8) |
 454                 ((data & (0xffULL << 16)) >> 8) |
 455                 ((data & (0xffULL << 24)) >> 24);
 456
 457         return swap;
 458 }
 459
 460 static inline unsigned long long
 461 __data2host8(struct pevent *pevent, unsigned long long data)
 462 {
 463         unsigned long long swap;
 464
 465         if (pevent->host_bigendian == pevent->file_bigendian)
 466                 return data;
 467
 468         swap = ((data & 0xffULL) << 56) |
 469                 ((data & (0xffULL << 8)) << 40) |
 470                 ((data & (0xffULL << 16)) << 24) |
 471                 ((data & (0xffULL << 24)) << 8) |
 472                 ((data & (0xffULL << 32)) >> 8) |
 473                 ((data & (0xffULL << 40)) >> 24) |
 474                 ((data & (0xffULL << 48)) >> 40) |
 475                 ((data & (0xffULL << 56)) >> 56);
 476
 477         return swap;
 478 }
 479
 480 #define data2host2(pevent, ptr)         __data2host2(pevent, *(unsigned short *)(ptr))
 481 #define data2host4(pevent, ptr)         __data2host4(pevent, *(unsigned int *)(ptr))
 482 #define data2host8(pevent, ptr)                                 \
 483 ({                                                              \
 484         unsigned long long __val;                               \
 485                                                                 \
 486         memcpy(&__val, (ptr), sizeof(unsigned long long));      \
 487         __data2host8(pevent, __val);                            \
 488 })
 489
 490 /* taken from kernel/trace/trace.h */
 491 enum trace_flag_type {
 492         TRACE_FLAG_IRQS_OFF             = 0x01,
 493         TRACE_FLAG_IRQS_NOSUPPORT       = 0x02,
 494         TRACE_FLAG_NEED_RESCHED         = 0x04,
 495         TRACE_FLAG_HARDIRQ              = 0x08,
 496         TRACE_FLAG_SOFTIRQ              = 0x10,
 497 };
 498
 499 int pevent_register_comm(struct pevent *pevent, const char *comm, int pid);
 500 int pevent_register_function(struct pevent *pevent, char *name,
 501                              unsigned long long addr, char *mod);
 502 int pevent_register_print_string(struct pevent *pevent, char *fmt,
 503                                  unsigned long long addr);
 504 int pevent_pid_is_registered(struct pevent *pevent, int pid);
 505
 506 void pevent_print_event(struct pevent *pevent, struct trace_seq *s,
 507                         struct pevent_record *record);
 508
 509 int pevent_parse_header_page(struct pevent *pevent, char *buf, unsigned long size,
 510                              int long_size);
 511
 512 int pevent_parse_event(struct pevent *pevent, const char *buf,
 513                        unsigned long size, const char *sys);
 514
 515 void *pevent_get_field_raw(struct trace_seq *s, struct event_format *event,
 516                            const char *name, struct pevent_record *record,
 517                            int *len, int err);
 518
 519 int pevent_get_field_val(struct trace_seq *s, struct event_format *event,
 520                          const char *name, struct pevent_record *record,
 521                          unsigned long long *val, int err);
 522 int pevent_get_common_field_val(struct trace_seq *s, struct event_format *event,
 523                                 const char *name, struct pevent_record *record,
 524                                 unsigned long long *val, int err);
 525 int pevent_get_any_field_val(struct trace_seq *s, struct event_format *event,
 526                              const char *name, struct pevent_record *record,
 527                              unsigned long long *val, int err);
 528
 529 int pevent_print_num_field(struct trace_seq *s, const char *fmt,
 530                            struct event_format *event, const char *name,
 531                            struct pevent_record *record, int err);
 532
 533 int pevent_register_event_handler(struct pevent *pevent, int id, char *sys_name, char *event_name,
 534                                   pevent_event_handler_func func, void *context);
 535 int pevent_register_print_function(struct pevent *pevent,
 536                                    pevent_func_handler func,
 537                                    enum pevent_func_arg_type ret_type,
 538                                    char *name, ...);
 539
 540 struct format_field *pevent_find_common_field(struct event_format *event, const char *name);
 541 struct format_field *pevent_find_field(struct event_format *event, const char *name);
 542 struct format_field *pevent_find_any_field(struct event_format *event, const char *name);
 543
 544 const char *pevent_find_function(struct pevent *pevent, unsigned long long addr);
 545 unsigned long long
 546 pevent_find_function_address(struct pevent *pevent, unsigned long long addr);
 547 unsigned long long pevent_read_number(struct pevent *pevent, const void *ptr, int size);
 548 int pevent_read_number_field(struct format_field *field, const void *data,
 549                              unsigned long long *value);
 550
 551 struct event_format *pevent_find_event(struct pevent *pevent, int id);
 552
 553 struct event_format *
 554 pevent_find_event_by_name(struct pevent *pevent, const char *sys, const char *name);
 555
 556 void pevent_data_lat_fmt(struct pevent *pevent,
 557                          struct trace_seq *s, struct pevent_record *record);
 558 int pevent_data_type(struct pevent *pevent, struct pevent_record *rec);
 559 struct event_format *pevent_data_event_from_type(struct pevent *pevent, int type);
 560 int pevent_data_pid(struct pevent *pevent, struct pevent_record *rec);
 561 const char *pevent_data_comm_from_pid(struct pevent *pevent, int pid);
 562 void pevent_event_info(struct trace_seq *s, struct event_format *event,
 563                        struct pevent_record *record);
 564
 565 struct event_format **pevent_list_events(struct pevent *pevent, enum event_sort_type);
 566 struct format_field **pevent_event_common_fields(struct event_format *event);
 567 struct format_field **pevent_event_fields(struct event_format *event);
 568
 569 static inline int pevent_get_cpus(struct pevent *pevent)
 570 {
 571         return pevent->cpus;
 572 }
 573
 574 static inline void pevent_set_cpus(struct pevent *pevent, int cpus)
 575 {
 576         pevent->cpus = cpus;
 577 }
 578
 579 static inline int pevent_get_long_size(struct pevent *pevent)
 580 {
 581         return pevent->long_size;
 582 }
 583
 584 static inline void pevent_set_long_size(struct pevent *pevent, int long_size)
 585 {
 586         pevent->long_size = long_size;
 587 }
 588
 589 static inline int pevent_is_file_bigendian(struct pevent *pevent)
 590 {
 591         return pevent->file_bigendian;
 592 }
 593
 594 static inline void pevent_set_file_bigendian(struct pevent *pevent, int endian)
 595 {
 596         pevent->file_bigendian = endian;
 597 }
 598
 599 static inline int pevent_is_host_bigendian(struct pevent *pevent)
 600 {
 601         return pevent->host_bigendian;
 602 }
 603
 604 static inline void pevent_set_host_bigendian(struct pevent *pevent, int endian)
 605 {
 606         pevent->host_bigendian = endian;
 607 }
 608
 609 static inline int pevent_is_latency_format(struct pevent *pevent)
 610 {
 611         return pevent->latency_format;
 612 }
 613
 614 static inline void pevent_set_latency_format(struct pevent *pevent, int lat)
 615 {
 616         pevent->latency_format = lat;
 617 }
 618
 619 struct pevent *pevent_alloc(void);
 620 void pevent_free(struct pevent *pevent);
 621 void pevent_ref(struct pevent *pevent);
 622 void pevent_unref(struct pevent *pevent);
 623
 624 /* access to the internal parser */
 625 void pevent_buffer_init(const char *buf, unsigned long long size);
 626 enum event_type pevent_read_token(char **tok);
 627 void pevent_free_token(char *token);
 628 int pevent_peek_char(void);
 629 const char *pevent_get_input_buf(void);
 630 unsigned long long pevent_get_input_buf_ptr(void);
 631
 632 /* for debugging */
 633 void pevent_print_funcs(struct pevent *pevent);
 634 void pevent_print_printk(struct pevent *pevent);
 635
 636 /* ----------------------- filtering ----------------------- */
 637
 638 enum filter_boolean_type {
 639         FILTER_FALSE,
 640         FILTER_TRUE,
 641 };
 642
 643 enum filter_op_type {
 644         FILTER_OP_AND = 1,
 645         FILTER_OP_OR,
 646         FILTER_OP_NOT,
 647 };
 648
 649 enum filter_cmp_type {
 650         FILTER_CMP_NONE,
 651         FILTER_CMP_EQ,
 652         FILTER_CMP_NE,
 653         FILTER_CMP_GT,
 654         FILTER_CMP_LT,
 655         FILTER_CMP_GE,
 656         FILTER_CMP_LE,
 657         FILTER_CMP_MATCH,
 658         FILTER_CMP_NOT_MATCH,
 659         FILTER_CMP_REGEX,
 660         FILTER_CMP_NOT_REGEX,
 661 };
 662
 663 enum filter_exp_type {
 664         FILTER_EXP_NONE,
 665         FILTER_EXP_ADD,
 666         FILTER_EXP_SUB,
 667         FILTER_EXP_MUL,
 668         FILTER_EXP_DIV,
 669         FILTER_EXP_MOD,
 670         FILTER_EXP_RSHIFT,
 671         FILTER_EXP_LSHIFT,
 672         FILTER_EXP_AND,
 673         FILTER_EXP_OR,
 674         FILTER_EXP_XOR,
 675         FILTER_EXP_NOT,
 676 };
 677
 678 enum filter_arg_type {
 679         FILTER_ARG_NONE,
 680         FILTER_ARG_BOOLEAN,
 681         FILTER_ARG_VALUE,
 682         FILTER_ARG_FIELD,
 683         FILTER_ARG_EXP,
 684         FILTER_ARG_OP,
 685         FILTER_ARG_NUM,
 686         FILTER_ARG_STR,
 687 };
 688
 689 enum filter_value_type {
 690         FILTER_NUMBER,
 691         FILTER_STRING,
 692         FILTER_CHAR
 693 };
 694
 695 struct fliter_arg;
 696
 697 struct filter_arg_boolean {
 698         enum filter_boolean_type        value;
 699 };
 700
 701 struct filter_arg_field {
 702         struct format_field     *field;
 703 };
 704
 705 struct filter_arg_value {
 706         enum filter_value_type  type;
 707         union {
 708                 char                    *str;
 709                 unsigned long long      val;
 710         };
 711 };
 712
 713 struct filter_arg_op {
 714         enum filter_op_type     type;
 715         struct filter_arg       *left;
 716         struct filter_arg       *right;
 717 };
 718
 719 struct filter_arg_exp {
 720         enum filter_exp_type    type;
 721         struct filter_arg       *left;
 722         struct filter_arg       *right;
 723 };
 724
 725 struct filter_arg_num {
 726         enum filter_cmp_type    type;
 727         struct filter_arg       *left;
 728         struct filter_arg       *right;
 729 };
 730
 731 struct filter_arg_str {
 732         enum filter_cmp_type    type;
 733         struct format_field     *field;
 734         char                    *val;
 735         char                    *buffer;
 736         regex_t                 reg;
 737 };
 738
 739 struct filter_arg {
 740         enum filter_arg_type    type;
 741         union {
 742                 struct filter_arg_boolean       boolean;
 743                 struct filter_arg_field         field;
 744                 struct filter_arg_value         value;
 745                 struct filter_arg_op            op;
 746                 struct filter_arg_exp           exp;
 747                 struct filter_arg_num           num;
 748                 struct filter_arg_str           str;
 749         };
 750 };
 751
 752 struct filter_type {
 753         int                     event_id;
 754         struct event_format     *event;
 755         struct filter_arg       *filter;
 756 };
 757
 758 struct event_filter {
 759         struct pevent           *pevent;
 760         int                     filters;
 761         struct filter_type      *event_filters;
 762 };
 763
 764 struct event_filter *pevent_filter_alloc(struct pevent *pevent);
 765
 766 #define FILTER_NONE             -2
 767 #define FILTER_NOEXIST          -1
 768 #define FILTER_MISS             0
 769 #define FILTER_MATCH            1
 770
 771 enum filter_trivial_type {
 772         FILTER_TRIVIAL_FALSE,
 773         FILTER_TRIVIAL_TRUE,
 774         FILTER_TRIVIAL_BOTH,
 775 };
 776
 777 int pevent_filter_add_filter_str(struct event_filter *filter,
 778                                  const char *filter_str,
 779                                  char **error_str);
 780
 781
 782 int pevent_filter_match(struct event_filter *filter,
 783                         struct pevent_record *record);
 784
 785 int pevent_event_filtered(struct event_filter *filter,
 786                           int event_id);
 787
 788 void pevent_filter_reset(struct event_filter *filter);
 789
 790 void pevent_filter_clear_trivial(struct event_filter *filter,
 791                                  enum filter_trivial_type type);
 792
 793 void pevent_filter_free(struct event_filter *filter);
 794
 795 char *pevent_filter_make_string(struct event_filter *filter, int event_id);
 796
 797 int pevent_filter_remove_event(struct event_filter *filter,
 798                                int event_id);
 799
 800 int pevent_filter_event_has_trivial(struct event_filter *filter,
 801                                     int event_id,
 802                                     enum filter_trivial_type type);
 803
 804 int pevent_filter_copy(struct event_filter *dest, struct event_filter *source);
 805
 806 int pevent_update_trivial(struct event_filter *dest, struct event_filter *source,
 807                           enum filter_trivial_type type);
 808
 809 int pevent_filter_compare(struct event_filter *filter1, struct event_filter *filter2);
 810
 811 #endif /* _PARSE_EVENTS_H */