Document libbabeltrace2's C API
[babeltrace.git] / src / lib / graph / component-sink.c
CommitLineData
d94d92ac 1/*
e2f7325d 2 * Copyright 2017-2018 Philippe Proulx <pproulx@efficios.com>
d94d92ac 3 * Copyright 2015 Jérémie Galarneau <jeremie.galarneau@efficios.com>
d94d92ac
PP
4 *
5 * Permission is hereby granted, free of charge, to any person obtaining a copy
6 * of this software and associated documentation files (the "Software"), to deal
7 * in the Software without restriction, including without limitation the rights
8 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 * copies of the Software, and to permit persons to whom the Software is
10 * furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice shall be included in
13 * all copies or substantial portions of the Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 * SOFTWARE.
22 */
23
350ad6c1 24#define BT_LOG_TAG "LIB/COMPONENT-SINK"
c2d9d9cf 25#include "lib/logging.h"
d94d92ac 26
578e048b
MJ
27#include "common/assert.h"
28#include "lib/assert-pre.h"
9b4f9b42 29#include "lib/assert-post.h"
578e048b 30#include "compat/compiler.h"
3fadfbc0 31#include <babeltrace2/value.h>
43c59509
PP
32#include <babeltrace2/graph/self-component.h>
33#include <babeltrace2/graph/component.h>
3fadfbc0 34#include <babeltrace2/graph/graph.h>
d94d92ac 35
578e048b
MJ
36#include "component-sink.h"
37#include "component.h"
9b4f9b42 38#include "graph.h"
d24d5663 39#include "lib/func-status.h"
578e048b 40
d94d92ac
PP
41BT_HIDDEN
42void bt_component_sink_destroy(struct bt_component *component)
43{
44}
45
46BT_HIDDEN
0d72b8c3
PP
47struct bt_component *bt_component_sink_create(
48 const struct bt_component_class *class)
d94d92ac
PP
49{
50 struct bt_component_sink *sink = NULL;
51
17f3083a
SM
52 BT_ASSERT_PRE_NO_ERROR();
53
d94d92ac
PP
54 sink = g_new0(struct bt_component_sink, 1);
55 if (!sink) {
870631a2
PP
56 BT_LIB_LOGE_APPEND_CAUSE(
57 "Failed to allocate one sink component.");
d94d92ac
PP
58 goto end;
59 }
60
61end:
62 return (void *) sink;
63}
64
752d0e47
SM
65const bt_component_class_sink *
66bt_component_sink_borrow_class_const(
67 const bt_component_sink *component)
68{
69 struct bt_component_class *cls;
70
bdb288b3 71 BT_ASSERT_PRE_DEV_NON_NULL(component, "Component");
752d0e47
SM
72
73 cls = component->parent.class;
74
98b15851
PP
75 BT_ASSERT_DBG(cls);
76 BT_ASSERT_DBG(cls->type == BT_COMPONENT_CLASS_TYPE_SINK);
752d0e47
SM
77
78 return (bt_component_class_sink *) cls;
79}
80
d94d92ac 81uint64_t bt_component_sink_get_input_port_count(
0d72b8c3 82 const struct bt_component_sink *component)
d94d92ac
PP
83{
84 /* bt_component_get_input_port_count() logs details/errors */
85 return bt_component_get_input_port_count((void *) component);
86}
87
0d72b8c3
PP
88const struct bt_port_input *
89bt_component_sink_borrow_input_port_by_name_const(
90 const struct bt_component_sink *component, const char *name)
d94d92ac
PP
91{
92 /* bt_component_borrow_input_port_by_name() logs details/errors */
93 return bt_component_borrow_input_port_by_name((void *) component, name);
94}
95
96struct bt_self_component_port_input *
97bt_self_component_sink_borrow_input_port_by_name(
98 struct bt_self_component_sink *component, const char *name)
99{
100 /* bt_component_borrow_input_port_by_name() logs details/errors */
101 return (void *) bt_component_borrow_input_port_by_name(
102 (void *) component, name);
103}
104
0d72b8c3
PP
105const struct bt_port_input *bt_component_sink_borrow_input_port_by_index_const(
106 const struct bt_component_sink *component, uint64_t index)
d94d92ac
PP
107{
108 /* bt_component_borrow_input_port_by_index() logs details/errors */
109 return bt_component_borrow_input_port_by_index(
110 (void *) component, index);
111}
112
113struct bt_self_component_port_input *
114bt_self_component_sink_borrow_input_port_by_index(
115 struct bt_self_component_sink *component, uint64_t index)
116{
117 /* bt_component_borrow_input_port_by_index() logs details/errors */
118 return (void *) bt_component_borrow_input_port_by_index(
119 (void *) component, index);
120}
121
d24d5663 122enum bt_self_component_add_port_status bt_self_component_sink_add_input_port(
d94d92ac
PP
123 struct bt_self_component_sink *self_comp,
124 const char *name, void *user_data,
125 struct bt_self_component_port_input **self_port)
126{
d24d5663 127 enum bt_self_component_add_port_status status;
d94d92ac
PP
128 struct bt_port *port = NULL;
129 struct bt_component *comp = (void *) self_comp;
130
17f3083a
SM
131 BT_ASSERT_PRE_NO_ERROR();
132
d94d92ac 133 /* bt_component_add_input_port() logs details/errors */
8cc56726 134 status = bt_component_add_input_port(comp, name, user_data, &port);
d24d5663 135 if (status != BT_FUNC_STATUS_OK) {
d94d92ac
PP
136 goto end;
137 }
138
139 if (self_port) {
140 /* Move reference to user */
141 *self_port = (void *) port;
d94d92ac
PP
142 }
143
144end:
145 bt_object_put_ref(port);
146 return status;
147}
c5b9b441 148
9b4f9b42
PP
149bt_bool bt_self_component_sink_is_interrupted(
150 const struct bt_self_component_sink *self_comp)
151{
152 struct bt_component *comp = (void *) self_comp;
153
154 BT_ASSERT_PRE_NON_NULL(comp, "Component");
155 return (bt_bool) bt_graph_is_interrupted(
156 bt_component_borrow_graph(comp));
157}
158
c5b9b441
PP
159void bt_component_sink_get_ref(
160 const struct bt_component_sink *component_sink)
161{
162 bt_object_get_ref(component_sink);
163}
164
165void bt_component_sink_put_ref(
166 const struct bt_component_sink *component_sink)
167{
168 bt_object_put_ref(component_sink);
169}
This page took 0.074705 seconds and 4 git commands to generate.