include/babeltrace/graph/component-class-internal.h

   1 #ifndef BABELTRACE_COMPONENT_COMPONENT_CLASS_INTERNAL_H
   2 #define BABELTRACE_COMPONENT_COMPONENT_CLASS_INTERNAL_H
   3
   4 /*
   5  * BabelTrace - Component Class Internal
   6  *
   7  * Copyright 2015 Jérémie Galarneau <jeremie.galarneau@efficios.com>
   8  * Copyright 2017 Philippe Proulx <pproulx@efficios.com>
   9  *
  10  * Author: Jérémie Galarneau <jeremie.galarneau@efficios.com>
  11  *
  12  * Permission is hereby granted, free of charge, to any person obtaining a copy
  13  * of this software and associated documentation files (the "Software"), to deal
  14  * in the Software without restriction, including without limitation the rights
  15  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  16  * copies of the Software, and to permit persons to whom the Software is
  17  * furnished to do so, subject to the following conditions:
  18  *
  19  * The above copyright notice and this permission notice shall be included in
  20  * all copies or substantial portions of the Software.
  21  *
  22  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  23  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  24  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  25  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  26  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  27  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  28  * SOFTWARE.
  29  */
  30
  31 #include <babeltrace/graph/component.h>
  32 #include <babeltrace/graph/component-class.h>
  33 #include <babeltrace/graph/component-class-source.h>
  34 #include <babeltrace/graph/component-class-filter.h>
  35 #include <babeltrace/graph/component-class-sink.h>
  36 #include <babeltrace/babeltrace-internal.h>
  37 #include <babeltrace/object-internal.h>
  38 #include <babeltrace/list-internal.h>
  39 #include <babeltrace/types.h>
  40 #include <glib.h>
  41
  42 struct bt_component_class;
  43 struct bt_plugin_so_shared_lib_handle;
  44
  45 typedef void (*bt_component_class_destroy_listener_func)(
  46                 struct bt_component_class *class, void *data);
  47
  48 struct bt_component_class_destroy_listener {
  49         bt_component_class_destroy_listener_func func;
  50         void *data;
  51 };
  52
  53 struct bt_component_class {
  54         struct bt_object base;
  55         enum bt_component_class_type type;
  56         GString *name;
  57         GString *description;
  58         GString *help;
  59         struct {
  60                 bt_component_class_init_method init;
  61                 bt_component_class_finalize_method finalize;
  62                 bt_component_class_query_method query;
  63                 bt_component_class_accept_port_connection_method accept_port_connection;
  64                 bt_component_class_port_connected_method port_connected;
  65                 bt_component_class_port_disconnected_method port_disconnected;
  66         } methods;
  67         /* Array of struct bt_component_class_destroy_listener */
  68         GArray *destroy_listeners;
  69         bt_bool frozen;
  70         struct bt_list_head node;
  71         struct bt_plugin_so_shared_lib_handle *so_handle;
  72 };
  73
  74 struct bt_component_class_iterator_methods {
  75         bt_component_class_notification_iterator_init_method init;
  76         bt_component_class_notification_iterator_finalize_method finalize;
  77         bt_component_class_notification_iterator_next_method next;
  78         bt_component_class_notification_iterator_seek_time_method seek_time;
  79 };
  80
  81 struct bt_component_class_source {
  82         struct bt_component_class parent;
  83         struct {
  84                 struct bt_component_class_iterator_methods iterator;
  85         } methods;
  86 };
  87
  88 struct bt_component_class_sink {
  89         struct bt_component_class parent;
  90         struct {
  91                 bt_component_class_sink_consume_method consume;
  92         } methods;
  93 };
  94
  95 struct bt_component_class_filter {
  96         struct bt_component_class parent;
  97         struct {
  98                 struct bt_component_class_iterator_methods iterator;
  99         } methods;
 100 };
 101
 102 BT_HIDDEN
 103 void bt_component_class_add_destroy_listener(struct bt_component_class *class,
 104                 bt_component_class_destroy_listener_func func, void *data);
 105
 106 static inline
 107 const char *bt_component_class_type_string(enum bt_component_class_type type)
 108 {
 109         switch (type) {
 110         case BT_COMPONENT_CLASS_TYPE_UNKNOWN:
 111                 return "BT_COMPONENT_CLASS_TYPE_UNKNOWN";
 112         case BT_COMPONENT_CLASS_TYPE_SOURCE:
 113                 return "BT_COMPONENT_CLASS_TYPE_SOURCE";
 114         case BT_COMPONENT_CLASS_TYPE_SINK:
 115                 return "BT_COMPONENT_CLASS_TYPE_SINK";
 116         case BT_COMPONENT_CLASS_TYPE_FILTER:
 117                 return "BT_COMPONENT_CLASS_TYPE_FILTER";
 118         default:
 119                 return "(unknown)";
 120         }
 121 }
 122
 123 #endif /* BABELTRACE_COMPONENT_COMPONENT_CLASS_INTERNAL_H */