src/{ctfser,fd-cache}/Makefile.am: remove unneeded `AM_CPPFLAGS`
[babeltrace.git] / include / babeltrace2 / graph / graph.h
CommitLineData
1ca80abd
PP
1#ifndef BABELTRACE_GRAPH_GRAPH_H
2#define BABELTRACE_GRAPH_GRAPH_H
c0418dd9
JG
3
4/*
f2b0325d 5 * Copyright 2017-2018 Philippe Proulx <pproulx@efficios.com>
f60c8b34 6 * Copyright 2017 Jérémie Galarneau <jeremie.galarneau@efficios.com>
c0418dd9 7 *
c0418dd9
JG
8 * Permission is hereby granted, free of charge, to any person obtaining a copy
9 * of this software and associated documentation files (the "Software"), to deal
10 * in the Software without restriction, including without limitation the rights
11 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12 * copies of the Software, and to permit persons to whom the Software is
13 * furnished to do so, subject to the following conditions:
14 *
15 * The above copyright notice and this permission notice shall be included in
16 * all copies or substantial portions of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24 * SOFTWARE.
25 */
26
8eee8ea2
PP
27/*
28 * For bt_bool, bt_component, bt_component_class,
29 * bt_component_class_filter, bt_component_class_sink,
30 * bt_component_class_source, bt_component_filter, bt_component_sink,
31 * bt_component_source, bt_connection, bt_graph, bt_port_input,
32 * bt_port_output, bt_value
33 */
71c5da58 34#include <babeltrace2/types.h>
c0418dd9 35
cc81b5ab
PP
36/* For bt_logging_level */
37#include <babeltrace2/logging.h>
38
fb25b9e3
PP
39/* For __BT_FUNC_STATUS_* */
40#define __BT_FUNC_STATUS_ENABLE
41#include <babeltrace2/func-status.h>
42#undef __BT_FUNC_STATUS_ENABLE
43
c0418dd9
JG
44#ifdef __cplusplus
45extern "C" {
46#endif
47
fb25b9e3
PP
48typedef enum bt_graph_listener_func_status {
49 BT_GRAPH_LISTENER_FUNC_STATUS_OK = __BT_FUNC_STATUS_OK,
50 BT_GRAPH_LISTENER_FUNC_STATUS_ERROR = __BT_FUNC_STATUS_ERROR,
51 BT_GRAPH_LISTENER_FUNC_STATUS_MEMORY_ERROR = __BT_FUNC_STATUS_MEMORY_ERROR,
52} bt_graph_listener_func_status;
e18f3e2b 53
fb25b9e3 54typedef bt_graph_listener_func_status
e18f3e2b 55(*bt_graph_filter_component_input_port_added_listener_func)(
8eee8ea2
PP
56 const bt_component_filter *component,
57 const bt_port_input *port, void *data);
7b53201c 58
fb25b9e3 59typedef bt_graph_listener_func_status
e18f3e2b 60(*bt_graph_sink_component_input_port_added_listener_func)(
8eee8ea2
PP
61 const bt_component_sink *component,
62 const bt_port_input *port, void *data);
7b53201c 63
fb25b9e3 64typedef bt_graph_listener_func_status
e18f3e2b 65(*bt_graph_source_component_output_port_added_listener_func)(
8eee8ea2
PP
66 const bt_component_source *component,
67 const bt_port_output *port, void *data);
7b53201c 68
fb25b9e3 69typedef bt_graph_listener_func_status
e18f3e2b 70(*bt_graph_filter_component_output_port_added_listener_func)(
8eee8ea2
PP
71 const bt_component_filter *component,
72 const bt_port_output *port, void *data);
7b53201c 73
fb25b9e3 74typedef bt_graph_listener_func_status
e18f3e2b 75(*bt_graph_source_filter_component_ports_connected_listener_func)(
8eee8ea2
PP
76 const bt_component_source *source_component,
77 const bt_component_filter *filter_component,
78 const bt_port_output *upstream_port,
79 const bt_port_input *downstream_port, void *data);
7b53201c 80
fb25b9e3 81typedef bt_graph_listener_func_status
e18f3e2b 82(*bt_graph_source_sink_component_ports_connected_listener_func)(
8eee8ea2
PP
83 const bt_component_source *source_component,
84 const bt_component_sink *sink_component,
85 const bt_port_output *upstream_port,
86 const bt_port_input *downstream_port, void *data);
7b53201c 87
fb25b9e3 88typedef bt_graph_listener_func_status
e18f3e2b 89(*bt_graph_filter_filter_component_ports_connected_listener_func)(
ee976410
PP
90 const bt_component_filter *filter_component_upstream,
91 const bt_component_filter *filter_component_downstream,
92 const bt_port_output *upstream_port,
93 const bt_port_input *downstream_port,
94 void *data);
95
fb25b9e3 96typedef bt_graph_listener_func_status
e18f3e2b 97(*bt_graph_filter_sink_component_ports_connected_listener_func)(
8eee8ea2
PP
98 const bt_component_filter *filter_component,
99 const bt_component_sink *sink_component,
100 const bt_port_output *upstream_port,
101 const bt_port_input *downstream_port, void *data);
7b53201c 102
7b53201c
PP
103typedef void (* bt_graph_listener_removed_func)(void *data);
104
8eee8ea2 105extern bt_graph *bt_graph_create(void);
7b53201c 106
fb25b9e3
PP
107typedef enum bt_graph_add_component_status {
108 BT_GRAPH_ADD_COMPONENT_STATUS_OK = __BT_FUNC_STATUS_OK,
109 BT_GRAPH_ADD_COMPONENT_STATUS_ERROR = __BT_FUNC_STATUS_ERROR,
110 BT_GRAPH_ADD_COMPONENT_STATUS_MEMORY_ERROR = __BT_FUNC_STATUS_MEMORY_ERROR,
111} bt_graph_add_component_status;
112
113extern bt_graph_add_component_status
114bt_graph_add_source_component(bt_graph *graph,
8eee8ea2
PP
115 const bt_component_class_source *component_class,
116 const char *name, const bt_value *params,
cc81b5ab 117 bt_logging_level log_level, const bt_component_source **component);
7b53201c 118
fb25b9e3
PP
119extern bt_graph_add_component_status
120bt_graph_add_source_component_with_init_method_data(
8eee8ea2
PP
121 bt_graph *graph,
122 const bt_component_class_source *component_class,
123 const char *name, const bt_value *params,
cc81b5ab 124 void *init_method_data, bt_logging_level log_level,
8eee8ea2 125 const bt_component_source **component);
7b53201c 126
fb25b9e3
PP
127extern bt_graph_add_component_status
128bt_graph_add_filter_component(bt_graph *graph,
8eee8ea2
PP
129 const bt_component_class_filter *component_class,
130 const char *name, const bt_value *params,
cc81b5ab 131 bt_logging_level log_level,
8eee8ea2 132 const bt_component_filter **component);
7b53201c 133
fb25b9e3
PP
134extern bt_graph_add_component_status
135bt_graph_add_filter_component_with_init_method_data(
8eee8ea2
PP
136 bt_graph *graph,
137 const bt_component_class_filter *component_class,
138 const char *name, const bt_value *params,
cc81b5ab 139 void *init_method_data, bt_logging_level log_level,
8eee8ea2 140 const bt_component_filter **component);
7b53201c 141
fb25b9e3
PP
142extern bt_graph_add_component_status
143bt_graph_add_sink_component(
ee78f405 144 bt_graph *graph, const bt_component_class_sink *component_class,
8eee8ea2 145 const char *name, const bt_value *params,
cc81b5ab 146 bt_logging_level log_level,
8eee8ea2 147 const bt_component_sink **component);
7b53201c 148
fb25b9e3
PP
149extern bt_graph_add_component_status
150bt_graph_add_sink_component_with_init_method_data(
ee78f405 151 bt_graph *graph, const bt_component_class_sink *component_class,
8eee8ea2 152 const char *name, const bt_value *params,
cc81b5ab 153 void *init_method_data, bt_logging_level log_level,
8eee8ea2 154 const bt_component_sink **component);
7b53201c 155
fb25b9e3
PP
156typedef enum bt_graph_connect_ports_status {
157 BT_GRAPH_CONNECT_PORTS_STATUS_OK = __BT_FUNC_STATUS_OK,
158 BT_GRAPH_CONNECT_PORTS_STATUS_ERROR = __BT_FUNC_STATUS_ERROR,
159 BT_GRAPH_CONNECT_PORTS_STATUS_CANCELED = __BT_FUNC_STATUS_CANCELED,
160 BT_GRAPH_CONNECT_PORTS_STATUS_MEMORY_ERROR = __BT_FUNC_STATUS_MEMORY_ERROR,
161} bt_graph_connect_ports_status;
162
163extern bt_graph_connect_ports_status bt_graph_connect_ports(bt_graph *graph,
8eee8ea2
PP
164 const bt_port_output *upstream,
165 const bt_port_input *downstream,
166 const bt_connection **connection);
7b53201c 167
fb25b9e3
PP
168typedef enum bt_graph_run_status {
169 BT_GRAPH_RUN_STATUS_OK = __BT_FUNC_STATUS_OK,
170 BT_GRAPH_RUN_STATUS_ERROR = __BT_FUNC_STATUS_ERROR,
171 BT_GRAPH_RUN_STATUS_MEMORY_ERROR = __BT_FUNC_STATUS_MEMORY_ERROR,
172 BT_GRAPH_RUN_STATUS_AGAIN = __BT_FUNC_STATUS_AGAIN,
173 BT_GRAPH_RUN_STATUS_END = __BT_FUNC_STATUS_END,
174 BT_GRAPH_RUN_STATUS_CANCELED = __BT_FUNC_STATUS_CANCELED,
175} bt_graph_run_status;
176
177extern bt_graph_run_status bt_graph_run(bt_graph *graph);
178
179typedef enum bt_graph_consume_status {
180 BT_GRAPH_CONSUME_STATUS_OK = __BT_FUNC_STATUS_OK,
181 BT_GRAPH_CONSUME_STATUS_ERROR = __BT_FUNC_STATUS_ERROR,
182 BT_GRAPH_CONSUME_STATUS_MEMORY_ERROR = __BT_FUNC_STATUS_MEMORY_ERROR,
183 BT_GRAPH_CONSUME_STATUS_AGAIN = __BT_FUNC_STATUS_AGAIN,
184 BT_GRAPH_CONSUME_STATUS_END = __BT_FUNC_STATUS_END,
185 BT_GRAPH_CONSUME_STATUS_CANCELED = __BT_FUNC_STATUS_CANCELED,
186} bt_graph_consume_status;
187
188extern bt_graph_consume_status bt_graph_consume(bt_graph *graph);
189
190typedef enum bt_graph_add_listener_status {
191 BT_GRAPH_ADD_LISTENER_STATUS_OK = __BT_FUNC_STATUS_OK,
192 BT_GRAPH_ADD_LISTENER_STATUS_MEMORY_ERROR = __BT_FUNC_STATUS_MEMORY_ERROR,
193} bt_graph_add_listener_status;
194
195extern bt_graph_add_listener_status
196bt_graph_add_filter_component_input_port_added_listener(
8eee8ea2 197 bt_graph *graph,
7b53201c
PP
198 bt_graph_filter_component_input_port_added_listener_func listener,
199 bt_graph_listener_removed_func listener_removed, void *data,
200 int *listener_id);
201
fb25b9e3
PP
202extern bt_graph_add_listener_status
203bt_graph_add_sink_component_input_port_added_listener(
8eee8ea2 204 bt_graph *graph,
7b53201c
PP
205 bt_graph_sink_component_input_port_added_listener_func listener,
206 bt_graph_listener_removed_func listener_removed, void *data,
207 int *listener_id);
208
fb25b9e3
PP
209extern bt_graph_add_listener_status
210bt_graph_add_source_component_output_port_added_listener(
8eee8ea2 211 bt_graph *graph,
7b53201c
PP
212 bt_graph_source_component_output_port_added_listener_func listener,
213 bt_graph_listener_removed_func listener_removed, void *data,
214 int *listener_id);
215
fb25b9e3
PP
216extern bt_graph_add_listener_status
217bt_graph_add_filter_component_output_port_added_listener(
8eee8ea2 218 bt_graph *graph,
7b53201c
PP
219 bt_graph_filter_component_output_port_added_listener_func listener,
220 bt_graph_listener_removed_func listener_removed, void *data,
221 int *listener_id);
222
fb25b9e3 223extern bt_graph_add_listener_status
7b53201c 224bt_graph_add_source_filter_component_ports_connected_listener(
8eee8ea2 225 bt_graph *graph,
7b53201c
PP
226 bt_graph_source_filter_component_ports_connected_listener_func listener,
227 bt_graph_listener_removed_func listener_removed, void *data,
228 int *listener_id);
229
fb25b9e3 230extern bt_graph_add_listener_status
ee976410
PP
231bt_graph_add_filter_filter_component_ports_connected_listener(
232 bt_graph *graph,
233 bt_graph_filter_filter_component_ports_connected_listener_func listener,
234 bt_graph_listener_removed_func listener_removed, void *data,
235 int *listener_id);
236
fb25b9e3 237extern bt_graph_add_listener_status
7b53201c 238bt_graph_add_source_sink_component_ports_connected_listener(
8eee8ea2 239 bt_graph *graph,
7b53201c
PP
240 bt_graph_source_sink_component_ports_connected_listener_func listener,
241 bt_graph_listener_removed_func listener_removed, void *data,
242 int *listener_id);
243
fb25b9e3 244extern bt_graph_add_listener_status
7b53201c 245bt_graph_add_filter_sink_component_ports_connected_listener(
8eee8ea2 246 bt_graph *graph,
7b53201c
PP
247 bt_graph_filter_sink_component_ports_connected_listener_func listener,
248 bt_graph_listener_removed_func listener_removed, void *data,
249 int *listener_id);
250
fb25b9e3
PP
251typedef enum bt_graph_cancel_status {
252 BT_GRAPH_CANCEL_STATUS_OK = __BT_FUNC_STATUS_OK,
253} bt_graph_cancel_status;
254
255extern bt_graph_cancel_status bt_graph_cancel(bt_graph *graph);
202a3a13 256
c0418dd9
JG
257#ifdef __cplusplus
258}
259#endif
260
fb25b9e3
PP
261#include <babeltrace2/undef-func-status.h>
262
1ca80abd 263#endif /* BABELTRACE_GRAPH_GRAPH_H */
This page took 0.055479 seconds and 4 git commands to generate.