include/babeltrace/format.h

   1 #ifndef _BABELTRACE_FORMAT_H
   2 #define _BABELTRACE_FORMAT_H
   3
   4 /*
   5  * BabelTrace
   6  *
   7  * Trace Format Header
   8  *
   9  * Copyright 2010-2011 EfficiOS Inc. and Linux Foundation
  10  *
  11  * Author: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
  12  *
  13  * Permission is hereby granted, free of charge, to any person obtaining a copy
  14  * of this software and associated documentation files (the "Software"), to deal
  15  * in the Software without restriction, including without limitation the rights
  16  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  17  * copies of the Software, and to permit persons to whom the Software is
  18  * furnished to do so, subject to the following conditions:
  19  *
  20  * The above copyright notice and this permission notice shall be included in
  21  * all copies or substantial portions of the Software.
  22  */
  23
  24 #include <babeltrace/list.h>
  25 #include <babeltrace/clock-types.h>
  26 #include <stdint.h>
  27 #include <stdio.h>
  28
  29 typedef int bt_intern_str;
  30
  31 /* forward declaration */
  32 struct stream_pos;
  33 struct bt_context;
  34 struct bt_trace_handle;
  35
  36 /* Parent trace descriptor */
  37 struct trace_descriptor {
  38 };
  39
  40 struct mmap_stream {
  41         int fd;
  42         struct bt_list_head list;
  43 };
  44
  45 struct mmap_stream_list {
  46         struct bt_list_head head;
  47 };
  48
  49 struct format {
  50         bt_intern_str name;
  51
  52         struct trace_descriptor *(*open_trace)(const char *path, int flags,
  53                         void (*packet_seek)(struct stream_pos *pos,
  54                                 size_t index, int whence),
  55                         FILE *metadata_fp);
  56         struct trace_descriptor *(*open_mmap_trace)(
  57                         struct mmap_stream_list *mmap_list,
  58                         void (*packet_seek)(struct stream_pos *pos,
  59                                 size_t index, int whence),
  60                         FILE *metadata_fp);
  61         void (*close_trace)(struct trace_descriptor *descriptor);
  62         void (*set_context)(struct trace_descriptor *descriptor,
  63                         struct bt_context *ctx);
  64         void (*set_handle)(struct trace_descriptor *descriptor,
  65                         struct bt_trace_handle *handle);
  66         uint64_t (*timestamp_begin)(struct trace_descriptor *descriptor,
  67                         struct bt_trace_handle *handle, enum bt_clock_type type);
  68         uint64_t (*timestamp_end)(struct trace_descriptor *descriptor,
  69                         struct bt_trace_handle *handle, enum bt_clock_type type);
  70         int (*convert_index_timestamp)(struct trace_descriptor *descriptor);
  71 };
  72
  73 extern struct format *bt_lookup_format(bt_intern_str qname);
  74 extern void bt_fprintf_format_list(FILE *fp);
  75 extern int bt_register_format(struct format *format);
  76
  77 /* TBD: format unregistration */
  78
  79 #endif /* _BABELTRACE_FORMAT_H */