1 #ifndef BABELTRACE2_GRAPH_GRAPH_H
2 #define BABELTRACE2_GRAPH_GRAPH_H
5 * Copyright (c) 2010-2019 EfficiOS Inc. and Linux Foundation
7 * Permission is hereby granted, free of charge, to any person obtaining a copy
8 * of this software and associated documentation files (the "Software"), to deal
9 * in the Software without restriction, including without limitation the rights
10 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11 * copies of the Software, and to permit persons to whom the Software is
12 * furnished to do so, subject to the following conditions:
14 * The above copyright notice and this permission notice shall be included in
15 * all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
26 #ifndef __BT_IN_BABELTRACE_H
27 # error "Please include <babeltrace2/babeltrace.h> instead."
30 #include <babeltrace2/types.h>
31 #include <babeltrace2/logging.h>
37 typedef enum bt_graph_listener_func_status
{
38 BT_GRAPH_LISTENER_FUNC_STATUS_OK
= __BT_FUNC_STATUS_OK
,
39 BT_GRAPH_LISTENER_FUNC_STATUS_ERROR
= __BT_FUNC_STATUS_ERROR
,
40 BT_GRAPH_LISTENER_FUNC_STATUS_MEMORY_ERROR
= __BT_FUNC_STATUS_MEMORY_ERROR
,
41 } bt_graph_listener_func_status
;
43 typedef bt_graph_listener_func_status
44 (*bt_graph_filter_component_input_port_added_listener_func
)(
45 const bt_component_filter
*component
,
46 const bt_port_input
*port
, void *data
);
48 typedef bt_graph_listener_func_status
49 (*bt_graph_sink_component_input_port_added_listener_func
)(
50 const bt_component_sink
*component
,
51 const bt_port_input
*port
, void *data
);
53 typedef bt_graph_listener_func_status
54 (*bt_graph_source_component_output_port_added_listener_func
)(
55 const bt_component_source
*component
,
56 const bt_port_output
*port
, void *data
);
58 typedef bt_graph_listener_func_status
59 (*bt_graph_filter_component_output_port_added_listener_func
)(
60 const bt_component_filter
*component
,
61 const bt_port_output
*port
, void *data
);
63 typedef bt_graph_listener_func_status
64 (*bt_graph_source_filter_component_ports_connected_listener_func
)(
65 const bt_component_source
*source_component
,
66 const bt_component_filter
*filter_component
,
67 const bt_port_output
*upstream_port
,
68 const bt_port_input
*downstream_port
, void *data
);
70 typedef bt_graph_listener_func_status
71 (*bt_graph_source_sink_component_ports_connected_listener_func
)(
72 const bt_component_source
*source_component
,
73 const bt_component_sink
*sink_component
,
74 const bt_port_output
*upstream_port
,
75 const bt_port_input
*downstream_port
, void *data
);
77 typedef bt_graph_listener_func_status
78 (*bt_graph_filter_filter_component_ports_connected_listener_func
)(
79 const bt_component_filter
*filter_component_upstream
,
80 const bt_component_filter
*filter_component_downstream
,
81 const bt_port_output
*upstream_port
,
82 const bt_port_input
*downstream_port
,
85 typedef bt_graph_listener_func_status
86 (*bt_graph_filter_sink_component_ports_connected_listener_func
)(
87 const bt_component_filter
*filter_component
,
88 const bt_component_sink
*sink_component
,
89 const bt_port_output
*upstream_port
,
90 const bt_port_input
*downstream_port
, void *data
);
92 typedef void (* bt_graph_listener_removed_func
)(void *data
);
94 typedef enum bt_graph_simple_sink_component_initialize_func_status
{
95 BT_GRAPH_SIMPLE_SINK_COMPONENT_INITIALIZE_FUNC_STATUS_OK
= __BT_FUNC_STATUS_OK
,
96 BT_GRAPH_SIMPLE_SINK_COMPONENT_INITIALIZE_FUNC_STATUS_ERROR
= __BT_FUNC_STATUS_ERROR
,
97 BT_GRAPH_SIMPLE_SINK_COMPONENT_INITIALIZE_FUNC_STATUS_MEMORY_ERROR
= __BT_FUNC_STATUS_MEMORY_ERROR
,
98 } bt_graph_simple_sink_component_initialize_func_status
;
100 typedef bt_graph_simple_sink_component_initialize_func_status
101 (*bt_graph_simple_sink_component_initialize_func
)(
102 bt_self_component_port_input_message_iterator
*iterator
,
105 typedef enum bt_graph_simple_sink_component_consume_func_status
{
106 BT_GRAPH_SIMPLE_SINK_COMPONENT_CONSUME_FUNC_STATUS_OK
= __BT_FUNC_STATUS_OK
,
107 BT_GRAPH_SIMPLE_SINK_COMPONENT_CONSUME_FUNC_STATUS_ERROR
= __BT_FUNC_STATUS_ERROR
,
108 BT_GRAPH_SIMPLE_SINK_COMPONENT_CONSUME_FUNC_STATUS_MEMORY_ERROR
= __BT_FUNC_STATUS_MEMORY_ERROR
,
109 BT_GRAPH_SIMPLE_SINK_COMPONENT_CONSUME_FUNC_STATUS_AGAIN
= __BT_FUNC_STATUS_AGAIN
,
110 BT_GRAPH_SIMPLE_SINK_COMPONENT_CONSUME_FUNC_STATUS_END
= __BT_FUNC_STATUS_END
,
111 } bt_graph_simple_sink_component_consume_func_status
;
113 typedef bt_graph_simple_sink_component_consume_func_status
114 (*bt_graph_simple_sink_component_consume_func
)(
115 bt_self_component_port_input_message_iterator
*iterator
,
118 typedef void (*bt_graph_simple_sink_component_finalize_func
)(void *data
);
120 extern bt_graph
*bt_graph_create(uint64_t mip_version
);
122 typedef enum bt_graph_add_component_status
{
123 BT_GRAPH_ADD_COMPONENT_STATUS_OK
= __BT_FUNC_STATUS_OK
,
124 BT_GRAPH_ADD_COMPONENT_STATUS_ERROR
= __BT_FUNC_STATUS_ERROR
,
125 BT_GRAPH_ADD_COMPONENT_STATUS_MEMORY_ERROR
= __BT_FUNC_STATUS_MEMORY_ERROR
,
126 } bt_graph_add_component_status
;
128 extern bt_graph_add_component_status
129 bt_graph_add_source_component(bt_graph
*graph
,
130 const bt_component_class_source
*component_class
,
131 const char *name
, const bt_value
*params
,
132 bt_logging_level log_level
, const bt_component_source
**component
);
134 extern bt_graph_add_component_status
135 bt_graph_add_source_component_with_initialize_method_data(
137 const bt_component_class_source
*component_class
,
138 const char *name
, const bt_value
*params
,
139 void *init_method_data
, bt_logging_level log_level
,
140 const bt_component_source
**component
);
142 extern bt_graph_add_component_status
143 bt_graph_add_filter_component(bt_graph
*graph
,
144 const bt_component_class_filter
*component_class
,
145 const char *name
, const bt_value
*params
,
146 bt_logging_level log_level
,
147 const bt_component_filter
**component
);
149 extern bt_graph_add_component_status
150 bt_graph_add_filter_component_with_initialize_method_data(
152 const bt_component_class_filter
*component_class
,
153 const char *name
, const bt_value
*params
,
154 void *init_method_data
, bt_logging_level log_level
,
155 const bt_component_filter
**component
);
157 extern bt_graph_add_component_status
158 bt_graph_add_sink_component(
159 bt_graph
*graph
, const bt_component_class_sink
*component_class
,
160 const char *name
, const bt_value
*params
,
161 bt_logging_level log_level
,
162 const bt_component_sink
**component
);
164 extern bt_graph_add_component_status
165 bt_graph_add_sink_component_with_initialize_method_data(
166 bt_graph
*graph
, const bt_component_class_sink
*component_class
,
167 const char *name
, const bt_value
*params
,
168 void *init_method_data
, bt_logging_level log_level
,
169 const bt_component_sink
**component
);
171 extern bt_graph_add_component_status
172 bt_graph_add_simple_sink_component(bt_graph
*graph
, const char *name
,
173 bt_graph_simple_sink_component_initialize_func init_func
,
174 bt_graph_simple_sink_component_consume_func consume_func
,
175 bt_graph_simple_sink_component_finalize_func finalize_func
,
176 void *user_data
, const bt_component_sink
**component
);
178 typedef enum bt_graph_connect_ports_status
{
179 BT_GRAPH_CONNECT_PORTS_STATUS_OK
= __BT_FUNC_STATUS_OK
,
180 BT_GRAPH_CONNECT_PORTS_STATUS_ERROR
= __BT_FUNC_STATUS_ERROR
,
181 BT_GRAPH_CONNECT_PORTS_STATUS_MEMORY_ERROR
= __BT_FUNC_STATUS_MEMORY_ERROR
,
182 } bt_graph_connect_ports_status
;
184 extern bt_graph_connect_ports_status
bt_graph_connect_ports(bt_graph
*graph
,
185 const bt_port_output
*upstream
,
186 const bt_port_input
*downstream
,
187 const bt_connection
**connection
);
189 typedef enum bt_graph_run_status
{
190 BT_GRAPH_RUN_STATUS_OK
= __BT_FUNC_STATUS_OK
,
191 BT_GRAPH_RUN_STATUS_ERROR
= __BT_FUNC_STATUS_ERROR
,
192 BT_GRAPH_RUN_STATUS_MEMORY_ERROR
= __BT_FUNC_STATUS_MEMORY_ERROR
,
193 BT_GRAPH_RUN_STATUS_AGAIN
= __BT_FUNC_STATUS_AGAIN
,
194 } bt_graph_run_status
;
196 extern bt_graph_run_status
bt_graph_run(bt_graph
*graph
);
198 typedef enum bt_graph_run_once_status
{
199 BT_GRAPH_RUN_ONCE_STATUS_OK
= __BT_FUNC_STATUS_OK
,
200 BT_GRAPH_RUN_ONCE_STATUS_ERROR
= __BT_FUNC_STATUS_ERROR
,
201 BT_GRAPH_RUN_ONCE_STATUS_MEMORY_ERROR
= __BT_FUNC_STATUS_MEMORY_ERROR
,
202 BT_GRAPH_RUN_ONCE_STATUS_AGAIN
= __BT_FUNC_STATUS_AGAIN
,
203 BT_GRAPH_RUN_ONCE_STATUS_END
= __BT_FUNC_STATUS_END
,
204 } bt_graph_run_once_status
;
206 extern bt_graph_run_once_status
bt_graph_run_once(bt_graph
*graph
);
208 typedef enum bt_graph_add_listener_status
{
209 BT_GRAPH_ADD_LISTENER_STATUS_OK
= __BT_FUNC_STATUS_OK
,
210 BT_GRAPH_ADD_LISTENER_STATUS_MEMORY_ERROR
= __BT_FUNC_STATUS_MEMORY_ERROR
,
211 } bt_graph_add_listener_status
;
213 extern bt_graph_add_listener_status
214 bt_graph_add_filter_component_input_port_added_listener(
216 bt_graph_filter_component_input_port_added_listener_func listener
,
217 bt_graph_listener_removed_func listener_removed
, void *data
,
218 bt_listener_id
*listener_id
);
220 extern bt_graph_add_listener_status
221 bt_graph_add_sink_component_input_port_added_listener(
223 bt_graph_sink_component_input_port_added_listener_func listener
,
224 bt_graph_listener_removed_func listener_removed
, void *data
,
225 bt_listener_id
*listener_id
);
227 extern bt_graph_add_listener_status
228 bt_graph_add_source_component_output_port_added_listener(
230 bt_graph_source_component_output_port_added_listener_func listener
,
231 bt_graph_listener_removed_func listener_removed
, void *data
,
232 bt_listener_id
*listener_id
);
234 extern bt_graph_add_listener_status
235 bt_graph_add_filter_component_output_port_added_listener(
237 bt_graph_filter_component_output_port_added_listener_func listener
,
238 bt_graph_listener_removed_func listener_removed
, void *data
,
239 bt_listener_id
*listener_id
);
241 typedef enum bt_graph_add_interrupter_status
{
242 BT_GRAPH_ADD_INTERRUPTER_STATUS_OK
= __BT_FUNC_STATUS_OK
,
243 BT_GRAPH_ADD_INTERRUPTER_STATUS_MEMORY_ERROR
= __BT_FUNC_STATUS_MEMORY_ERROR
,
244 } bt_graph_add_interrupter_status
;
246 extern bt_graph_add_interrupter_status
bt_graph_add_interrupter(bt_graph
*graph
,
247 const bt_interrupter
*interrupter
);
249 extern void bt_graph_interrupt(bt_graph
*graph
);
255 #endif /* BABELTRACE2_GRAPH_GRAPH_H */