lib: make public reference count functions have strict types
[babeltrace.git] / lib / trace-ir / event.c
CommitLineData
273b65be 1/*
e2f7325d 2 * Copyright 2017-2018 Philippe Proulx <pproulx@efficios.com>
de9dd397 3 * Copyright 2013, 2014 Jérémie Galarneau <jeremie.galarneau@efficios.com>
273b65be
JG
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
7b010242
PP
24#define BT_LOG_TAG "EVENT"
25#include <babeltrace/lib-logging-internal.h>
26
3dca2276 27#include <babeltrace/assert-pre-internal.h>
c6bd8523
PP
28#include <babeltrace/trace-ir/field-internal.h>
29#include <babeltrace/trace-ir/field-class-internal.h>
56e18c4c 30#include <babeltrace/trace-ir/clock-class.h>
40f4ba76 31#include <babeltrace/trace-ir/clock-value-const.h>
56e18c4c
PP
32#include <babeltrace/trace-ir/clock-value-internal.h>
33#include <babeltrace/trace-ir/clock-class-internal.h>
40f4ba76 34#include <babeltrace/trace-ir/event-const.h>
56e18c4c
PP
35#include <babeltrace/trace-ir/event-internal.h>
36#include <babeltrace/trace-ir/event-class.h>
37#include <babeltrace/trace-ir/event-class-internal.h>
38#include <babeltrace/trace-ir/stream-class.h>
40f4ba76 39#include <babeltrace/trace-ir/stream-class-const.h>
56e18c4c
PP
40#include <babeltrace/trace-ir/stream-class-internal.h>
41#include <babeltrace/trace-ir/stream-internal.h>
42#include <babeltrace/trace-ir/packet.h>
43#include <babeltrace/trace-ir/packet-internal.h>
44#include <babeltrace/trace-ir/trace.h>
45#include <babeltrace/trace-ir/trace-internal.h>
46#include <babeltrace/trace-ir/packet-internal.h>
56e18c4c 47#include <babeltrace/trace-ir/attributes-internal.h>
f6ccaed9 48#include <babeltrace/assert-internal.h>
c5b9b441 49#include <babeltrace/compiler-internal.h>
7b010242 50#include <inttypes.h>
273b65be 51
3dca2276 52BT_HIDDEN
40f4ba76 53void _bt_event_set_is_frozen(const struct bt_event *event, bool is_frozen)
3dca2276 54{
3dca2276 55 BT_ASSERT(event);
44c440bc
PP
56 BT_LIB_LOGD("Setting event's frozen state: %!+e, is-frozen=%d",
57 event, is_frozen);
312c056a
PP
58
59 if (event->header_field) {
44c440bc
PP
60 BT_LOGD_STR("Setting event's header field's frozen state.");
61 bt_field_set_is_frozen(
6c677fb5 62 event->header_field->field, is_frozen);
312c056a
PP
63 }
64
44c440bc
PP
65 if (event->common_context_field) {
66 BT_LOGD_STR("Setting event's common context field's frozen state.");
67 bt_field_set_is_frozen(
68 event->common_context_field, is_frozen);
312c056a
PP
69 }
70
44c440bc
PP
71 if (event->specific_context_field) {
72 BT_LOGD_STR("Setting event's specific context field's frozen state.");
73 bt_field_set_is_frozen(event->specific_context_field,
6c677fb5 74 is_frozen);
312c056a
PP
75 }
76
77 if (event->payload_field) {
44c440bc
PP
78 BT_LOGD_STR("Setting event's payload field's frozen state.");
79 bt_field_set_is_frozen(event->payload_field,
6c677fb5 80 is_frozen);
312c056a
PP
81 }
82
40f4ba76 83 ((struct bt_event *) event)->frozen = is_frozen;
44c440bc 84 BT_LOGD_STR("Setting event's packet's frozen state.");
cb6f1f7d 85 bt_packet_set_is_frozen(event->packet, is_frozen);
3dca2276
PP
86}
87
312c056a 88static
44c440bc 89void recycle_event_header_field(struct bt_field_wrapper *field_wrapper,
312c056a
PP
90 struct bt_stream_class *stream_class)
91{
92 BT_ASSERT(field_wrapper);
93 BT_LIB_LOGD("Recycling event header field: "
94 "addr=%p, %![sc-]+S, %![field-]+f", field_wrapper,
95 stream_class, field_wrapper->field);
96 bt_object_pool_recycle_object(
97 &stream_class->event_header_field_pool,
98 field_wrapper);
99}
100
44c440bc 101static inline
312c056a 102struct bt_field_wrapper *create_event_header_field(
44c440bc 103 struct bt_stream_class *stream_class)
312c056a
PP
104{
105 struct bt_field_wrapper *field_wrapper = NULL;
106
107 field_wrapper = bt_field_wrapper_create(
44c440bc 108 &stream_class->event_header_field_pool,
40f4ba76 109 stream_class->event_header_fc);
312c056a
PP
110 if (!field_wrapper) {
111 goto error;
112 }
113
114 goto end;
115
116error:
117 if (field_wrapper) {
44c440bc 118 recycle_event_header_field(field_wrapper, stream_class);
312c056a
PP
119 field_wrapper = NULL;
120 }
121
122end:
123 return field_wrapper;
124}
125
126BT_HIDDEN
127struct bt_event *bt_event_new(struct bt_event_class *event_class)
3dca2276 128{
3dca2276 129 struct bt_event *event = NULL;
312c056a 130 struct bt_stream_class *stream_class;
5cd6d0e5 131 struct bt_field_class *fc;
3dca2276 132
44c440bc 133 BT_ASSERT(event_class);
3dca2276
PP
134 event = g_new0(struct bt_event, 1);
135 if (!event) {
136 BT_LOGE_STR("Failed to allocate one event.");
137 goto error;
138 }
139
44c440bc 140 bt_object_init_unique(&event->base);
312c056a
PP
141 stream_class = bt_event_class_borrow_stream_class(event_class);
142 BT_ASSERT(stream_class);
44c440bc 143
40f4ba76 144 if (stream_class->event_header_fc) {
44c440bc
PP
145 event->header_field = create_event_header_field(stream_class);
146 if (!event->header_field) {
147 BT_LOGE_STR("Cannot create event header field.");
148 goto error;
149 }
150 }
151
40f4ba76 152 fc = stream_class->event_common_context_fc;
5cd6d0e5
PP
153 if (fc) {
154 event->common_context_field = bt_field_create(fc);
44c440bc
PP
155 if (!event->common_context_field) {
156 /* bt_field_create() logs errors */
157 goto error;
158 }
159 }
160
40f4ba76 161 fc = event_class->specific_context_fc;
5cd6d0e5
PP
162 if (fc) {
163 event->specific_context_field = bt_field_create(fc);
44c440bc
PP
164 if (!event->specific_context_field) {
165 /* bt_field_create() logs errors */
166 goto error;
167 }
168 }
169
40f4ba76 170 fc = event_class->payload_fc;
5cd6d0e5
PP
171 if (fc) {
172 event->payload_field = bt_field_create(fc);
44c440bc
PP
173 if (!event->payload_field) {
174 /* bt_field_create() logs errors */
175 goto error;
176 }
177 }
178
179 if (stream_class->default_clock_class) {
180 event->default_cv = bt_clock_value_create(
181 stream_class->default_clock_class);
182 if (!event->default_cv) {
183 /* bt_clock_value_create() logs errors */
184 goto error;
185 }
312c056a
PP
186 }
187
3dca2276
PP
188 goto end;
189
190error:
312c056a
PP
191 if (event) {
192 bt_event_destroy(event);
193 event = NULL;
194 }
195
196end:
197 return event;
198}
199
094ff7c0 200struct bt_event_class *bt_event_borrow_class(struct bt_event *event)
2f100782 201{
f6ccaed9 202 BT_ASSERT_PRE_NON_NULL(event, "Event");
cb6f1f7d 203 return event->class;
2f100782
JG
204}
205
40f4ba76
PP
206const struct bt_event_class *bt_event_borrow_class_const(
207 const struct bt_event *event)
208{
209 return bt_event_borrow_class((void *) event);
210}
211
f6ccaed9 212struct bt_stream *bt_event_borrow_stream(struct bt_event *event)
f6ccaed9
PP
213{
214 BT_ASSERT_PRE_NON_NULL(event, "Event");
094ff7c0 215 return event->packet ? event->packet->stream : NULL;
f6ccaed9
PP
216}
217
40f4ba76
PP
218const struct bt_stream *bt_event_borrow_stream_const(
219 const struct bt_event *event)
220{
221 return bt_event_borrow_stream((void *) event);
222}
223
44c440bc 224struct bt_field *bt_event_borrow_header_field(struct bt_event *event)
e5e6eb3a 225{
cb6f1f7d 226 BT_ASSERT_PRE_NON_NULL(event, "Event");
44c440bc 227 return event->header_field ? event->header_field->field : NULL;
e5e6eb3a
JG
228}
229
40f4ba76
PP
230const struct bt_field *bt_event_borrow_header_field_const(
231 const struct bt_event *event)
e5be10ef 232{
40f4ba76
PP
233 BT_ASSERT_PRE_NON_NULL(event, "Event");
234 return event->header_field ? event->header_field->field : NULL;
e5be10ef
PP
235}
236
44c440bc 237struct bt_field *bt_event_borrow_common_context_field(struct bt_event *event)
662e778c 238{
cb6f1f7d 239 BT_ASSERT_PRE_NON_NULL(event, "Event");
44c440bc 240 return event->common_context_field;
662e778c
JG
241}
242
40f4ba76
PP
243const struct bt_field *bt_event_borrow_common_context_field_const(
244 const struct bt_event *event)
e5be10ef 245{
40f4ba76
PP
246 BT_ASSERT_PRE_NON_NULL(event, "Event");
247 return event->common_context_field;
e5be10ef
PP
248}
249
44c440bc 250struct bt_field *bt_event_borrow_specific_context_field(struct bt_event *event)
f655a84d 251{
cb6f1f7d 252 BT_ASSERT_PRE_NON_NULL(event, "Event");
44c440bc 253 return event->specific_context_field;
f655a84d
JG
254}
255
40f4ba76
PP
256const struct bt_field *bt_event_borrow_specific_context_field_const(
257 const struct bt_event *event)
e5be10ef 258{
40f4ba76
PP
259 BT_ASSERT_PRE_NON_NULL(event, "Event");
260 return event->specific_context_field;
e5be10ef
PP
261}
262
44c440bc 263struct bt_field *bt_event_borrow_payload_field(struct bt_event *event)
5fd2e9fd 264{
cb6f1f7d 265 BT_ASSERT_PRE_NON_NULL(event, "Event");
44c440bc 266 return event->payload_field;
5fd2e9fd
PP
267}
268
40f4ba76
PP
269const struct bt_field *bt_event_borrow_payload_field_const(
270 const struct bt_event *event)
e5be10ef 271{
40f4ba76
PP
272 BT_ASSERT_PRE_NON_NULL(event, "Event");
273 return event->payload_field;
e5be10ef
PP
274}
275
312c056a
PP
276static
277void release_event_header_field(struct bt_field_wrapper *field_wrapper,
cb6f1f7d 278 struct bt_event *event)
273b65be 279{
44c440bc 280 if (!event->class) {
312c056a
PP
281 bt_field_wrapper_destroy(field_wrapper);
282 } else {
283 struct bt_stream_class *stream_class =
44c440bc 284 bt_event_class_borrow_stream_class(event->class);
312c056a
PP
285
286 BT_ASSERT(stream_class);
44c440bc 287 recycle_event_header_field(field_wrapper, stream_class);
312c056a 288 }
273b65be
JG
289}
290
44c440bc
PP
291BT_HIDDEN
292void bt_event_destroy(struct bt_event *event)
cb6f1f7d 293{
44c440bc
PP
294 BT_ASSERT(event);
295 BT_LIB_LOGD("Destroying event: %!+e", event);
cb6f1f7d
PP
296
297 if (event->header_field) {
298 BT_LOGD_STR("Releasing event's header field.");
44c440bc 299 release_event_header_field(event->header_field, event);
238b7404 300 event->header_field = NULL;
cb6f1f7d
PP
301 }
302
44c440bc
PP
303 if (event->common_context_field) {
304 BT_LOGD_STR("Destroying event's stream event context field.");
305 bt_field_destroy(event->common_context_field);
238b7404 306 event->common_context_field = NULL;
cb6f1f7d
PP
307 }
308
44c440bc
PP
309 if (event->specific_context_field) {
310 BT_LOGD_STR("Destroying event's context field.");
311 bt_field_destroy(event->specific_context_field);
238b7404 312 event->specific_context_field = NULL;
cb6f1f7d
PP
313 }
314
315 if (event->payload_field) {
44c440bc
PP
316 BT_LOGD_STR("Destroying event's payload field.");
317 bt_field_destroy(event->payload_field);
238b7404 318 event->payload_field = NULL;
cb6f1f7d
PP
319 }
320
44c440bc 321 BT_LOGD_STR("Putting event's class.");
65300d60 322 bt_object_put_ref(event->class);
44c440bc
PP
323
324 if (event->default_cv) {
325 bt_clock_value_recycle(event->default_cv);
238b7404 326 event->default_cv = NULL;
cb6f1f7d 327 }
cb6f1f7d 328
03039f21 329 BT_LOGD_STR("Putting event's packet.");
238b7404 330 BT_OBJECT_PUT_REF_AND_RESET(event->packet);
273b65be
JG
331 g_free(event);
332}
333
40f4ba76
PP
334void bt_event_set_default_clock_value(struct bt_event *event,
335 uint64_t value_cycles)
e22b45d0 336{
44c440bc
PP
337 struct bt_stream_class *sc;
338
e22b45d0 339 BT_ASSERT_PRE_NON_NULL(event, "Event");
44c440bc
PP
340 BT_ASSERT_PRE_EVENT_HOT(event);
341 sc = bt_event_class_borrow_stream_class_inline(event->class);
342 BT_ASSERT(sc);
343 BT_ASSERT_PRE(sc->default_clock_class,
344 "Event's stream class has no default clock class: "
345 "%![ev-]+e, %![sc-]+S", event, sc);
346 BT_ASSERT(event->default_cv);
347 bt_clock_value_set_value_inline(event->default_cv, value_cycles);
348 BT_LIB_LOGV("Set event's default clock value: %![event-]+e, "
349 "value=%" PRIu64, event, value_cycles);
e22b45d0
PP
350}
351
40f4ba76
PP
352enum bt_clock_value_status bt_event_borrow_default_clock_value_const(
353 const struct bt_event *event,
354 const struct bt_clock_value **clock_value)
78586d8a 355{
f6ccaed9 356 BT_ASSERT_PRE_NON_NULL(event, "Event");
44c440bc
PP
357 BT_ASSERT_PRE_NON_NULL(clock_value, "Clock value (output)");
358 *clock_value = event->default_cv;
359 return BT_CLOCK_VALUE_STATUS_KNOWN;
1556a1af
JG
360}
361
094ff7c0 362struct bt_packet *bt_event_borrow_packet(struct bt_event *event)
5c0f40f4 363{
f6ccaed9 364 BT_ASSERT_PRE_NON_NULL(event, "Event");
44c440bc 365 return event->packet;
5c0f40f4
JG
366}
367
40f4ba76
PP
368const struct bt_packet *bt_event_borrow_packet_const(
369 const struct bt_event *event)
e5be10ef 370{
40f4ba76 371 return bt_event_borrow_packet((void *) event);
e5be10ef
PP
372}
373
40f4ba76
PP
374int bt_event_move_header_field(struct bt_event *event,
375 struct bt_event_header_field *header_field)
312c056a
PP
376{
377 struct bt_stream_class *stream_class;
40f4ba76 378 struct bt_field_wrapper *field_wrapper = (void *) header_field;
312c056a
PP
379
380 BT_ASSERT_PRE_NON_NULL(event, "Event");
381 BT_ASSERT_PRE_NON_NULL(field_wrapper, "Header field");
44c440bc
PP
382 BT_ASSERT_PRE_EVENT_HOT(event);
383 stream_class = bt_event_class_borrow_stream_class_inline(event->class);
5cd6d0e5 384 BT_ASSERT_PRE(stream_class->event_header_fc,
e6276565 385 "Stream class has no event header field class: %!+S",
312c056a
PP
386 stream_class);
387
388 /* Recycle current header field: always exists */
cb6f1f7d 389 BT_ASSERT(event->header_field);
44c440bc 390 recycle_event_header_field(event->header_field, stream_class);
312c056a
PP
391
392 /* Move new field */
44c440bc 393 event->header_field = field_wrapper;
312c056a
PP
394 return 0;
395}
This page took 0.074506 seconds and 4 git commands to generate.