2 * Copyright 2016 Philippe Proulx <pproulx@efficios.com>
4 * Permission is hereby granted, free of charge, to any person obtaining a copy
5 * of this software and associated documentation files (the "Software"), to deal
6 * in the Software without restriction, including without limitation the rights
7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8 * copies of the Software, and to permit persons to whom the Software is
9 * furnished to do so, subject to the following conditions:
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23 #define BT_LOG_TAG "PACKET"
24 #include <babeltrace/lib-logging-internal.h>
26 #include <babeltrace/assert-pre-internal.h>
27 #include <babeltrace/trace-ir/fields-internal.h>
28 #include <babeltrace/trace-ir/private-packet.h>
29 #include <babeltrace/trace-ir/packet.h>
30 #include <babeltrace/trace-ir/packet-internal.h>
31 #include <babeltrace/trace-ir/field-wrapper-internal.h>
32 #include <babeltrace/trace-ir/trace.h>
33 #include <babeltrace/trace-ir/stream-class-internal.h>
34 #include <babeltrace/trace-ir/stream-class.h>
35 #include <babeltrace/trace-ir/stream.h>
36 #include <babeltrace/trace-ir/stream-internal.h>
37 #include <babeltrace/trace-ir/clock-value-internal.h>
38 #include <babeltrace/trace-ir/trace-internal.h>
39 #include <babeltrace/object-internal.h>
40 #include <babeltrace/object.h>
41 #include <babeltrace/assert-internal.h>
44 #define BT_ASSERT_PRE_PACKET_HOT(_packet) \
45 BT_ASSERT_PRE_HOT((_packet), "Packet", ": %!+a", (_packet))
47 struct bt_stream
*bt_packet_borrow_stream(struct bt_packet
*packet
)
49 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
50 return packet
->stream
;
53 struct bt_private_stream
*bt_private_packet_borrow_private_stream(
54 struct bt_private_packet
*packet
)
56 return (void *) bt_packet_borrow_stream((void *) packet
);
59 struct bt_field
*bt_packet_borrow_header_field(struct bt_packet
*packet
)
61 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
62 return packet
->header_field
? packet
->header_field
->field
: NULL
;
65 struct bt_private_field
*bt_private_packet_borrow_header_private_field(
66 struct bt_private_packet
*packet
)
68 return (void *) bt_packet_borrow_header_field((void *) packet
);
71 struct bt_field
*bt_packet_borrow_context_field(struct bt_packet
*packet
)
73 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
74 return packet
->context_field
? packet
->context_field
->field
: NULL
;
77 struct bt_private_field
*bt_private_packet_borrow_context_private_field(
78 struct bt_private_packet
*packet
)
80 return (void *) bt_packet_borrow_context_field((void *) packet
);
84 void _bt_packet_set_is_frozen(struct bt_packet
*packet
, bool is_frozen
)
90 BT_LIB_LOGD("Setting packet's frozen state: %![packet-]+a, "
91 "is-frozen=%d", packet
, is_frozen
);
93 if (packet
->header_field
) {
94 BT_LOGD_STR("Setting packet's header field's frozen state.");
95 bt_field_set_is_frozen(packet
->header_field
->field
,
99 if (packet
->context_field
) {
100 BT_LOGD_STR("Setting packet's context field's frozen state.");
101 bt_field_set_is_frozen(packet
->context_field
->field
,
105 packet
->frozen
= is_frozen
;
109 void reset_counter_snapshots(struct bt_packet
*packet
)
111 packet
->discarded_event_counter_snapshot
.base
.avail
=
112 BT_PROPERTY_AVAILABILITY_NOT_AVAILABLE
;
113 packet
->packet_counter_snapshot
.base
.avail
=
114 BT_PROPERTY_AVAILABILITY_NOT_AVAILABLE
;
118 void reset_packet(struct bt_packet
*packet
)
121 BT_LIB_LOGD("Resetting packet: %!+a", packet
);
122 bt_packet_set_is_frozen(packet
, false);
124 if (packet
->header_field
) {
125 bt_field_set_is_frozen(packet
->header_field
->field
, false);
126 bt_field_reset(packet
->header_field
->field
);
129 if (packet
->context_field
) {
130 bt_field_set_is_frozen(packet
->context_field
->field
, false);
131 bt_field_reset(packet
->context_field
->field
);
134 if (packet
->default_beginning_cv
) {
135 bt_clock_value_reset(packet
->default_beginning_cv
);
138 if (packet
->default_end_cv
) {
139 bt_clock_value_reset(packet
->default_end_cv
);
142 reset_counter_snapshots(packet
);
146 void recycle_header_field(struct bt_field_wrapper
*header_field
,
147 struct bt_trace
*trace
)
149 BT_ASSERT(header_field
);
150 BT_LIB_LOGD("Recycling packet header field: "
151 "addr=%p, %![trace-]+t, %![field-]+f", header_field
,
152 trace
, header_field
->field
);
153 bt_object_pool_recycle_object(&trace
->packet_header_field_pool
,
158 void recycle_context_field(struct bt_field_wrapper
*context_field
,
159 struct bt_stream_class
*stream_class
)
161 BT_ASSERT(context_field
);
162 BT_LIB_LOGD("Recycling packet context field: "
163 "addr=%p, %![sc-]+S, %![field-]+f", context_field
,
164 stream_class
, context_field
->field
);
165 bt_object_pool_recycle_object(&stream_class
->packet_context_field_pool
,
170 void bt_packet_recycle(struct bt_packet
*packet
)
172 struct bt_stream
*stream
;
175 BT_LIB_LOGD("Recycling packet: %!+a", packet
);
178 * Those are the important ordered steps:
180 * 1. Reset the packet object (put any permanent reference it
181 * has, unfreeze it and its fields in developer mode, etc.),
182 * but do NOT put its stream's reference. This stream
183 * contains the pool to which we're about to recycle this
184 * packet object, so we must guarantee its existence thanks
185 * to this existing reference.
187 * 2. Move the stream reference to our `stream`
188 * variable so that we can set the packet's stream member
189 * to NULL before recycling it. We CANNOT do this after
190 * we put the stream reference because this bt_object_put_ref()
191 * could destroy the stream, also destroying its
192 * packet pool, thus also destroying our packet object (this
193 * would result in an invalid write access).
195 * 3. Recycle the packet object.
197 * 4. Put our stream reference.
199 reset_packet(packet
);
200 stream
= packet
->stream
;
202 packet
->stream
= NULL
;
203 bt_object_pool_recycle_object(&stream
->packet_pool
, packet
);
204 bt_object_put_no_null_check(&stream
->base
);
208 void bt_packet_destroy(struct bt_packet
*packet
)
210 BT_LIB_LOGD("Destroying packet: %!+a", packet
);
212 if (packet
->header_field
) {
213 if (packet
->stream
) {
214 BT_LOGD_STR("Recycling packet's header field.");
215 recycle_header_field(packet
->header_field
,
216 bt_stream_class_borrow_trace_inline(
217 packet
->stream
->class));
219 bt_field_wrapper_destroy(packet
->header_field
);
223 if (packet
->context_field
) {
224 if (packet
->stream
) {
225 BT_LOGD_STR("Recycling packet's context field.");
226 recycle_context_field(packet
->context_field
,
227 packet
->stream
->class);
229 bt_field_wrapper_destroy(packet
->context_field
);
233 if (packet
->default_beginning_cv
) {
234 BT_LOGD_STR("Recycling beginning clock value.");
235 bt_clock_value_recycle(packet
->default_beginning_cv
);
238 if (packet
->default_end_cv
) {
239 BT_LOGD_STR("Recycling end clock value.");
240 bt_clock_value_recycle(packet
->default_end_cv
);
243 BT_LOGD_STR("Putting packet's stream.");
244 bt_object_put_ref(packet
->stream
);
249 struct bt_packet
*bt_packet_new(struct bt_stream
*stream
)
251 struct bt_packet
*packet
= NULL
;
252 struct bt_trace
*trace
= NULL
;
255 BT_LIB_LOGD("Creating packet object: %![stream-]+s", stream
);
256 packet
= g_new0(struct bt_packet
, 1);
258 BT_LOGE_STR("Failed to allocate one packet object.");
262 bt_object_init_shared(&packet
->base
,
263 (bt_object_release_func
) bt_packet_recycle
);
264 packet
->stream
= bt_object_get_ref(stream
);
265 trace
= bt_stream_class_borrow_trace_inline(stream
->class);
268 if (trace
->packet_header_fc
) {
269 BT_LOGD_STR("Creating initial packet header field.");
270 packet
->header_field
= bt_field_wrapper_create(
271 &trace
->packet_header_field_pool
,
272 trace
->packet_header_fc
);
273 if (!packet
->header_field
) {
274 BT_LOGE_STR("Cannot create packet header field wrapper.");
279 if (stream
->class->packet_context_fc
) {
280 BT_LOGD_STR("Creating initial packet context field.");
281 packet
->context_field
= bt_field_wrapper_create(
282 &stream
->class->packet_context_field_pool
,
283 stream
->class->packet_context_fc
);
284 if (!packet
->context_field
) {
285 BT_LOGE_STR("Cannot create packet context field wrapper.");
290 if (stream
->class->default_clock_class
) {
291 if (stream
->class->packets_have_default_beginning_cv
) {
292 packet
->default_beginning_cv
= bt_clock_value_create(
293 stream
->class->default_clock_class
);
294 if (!packet
->default_beginning_cv
) {
295 /* bt_clock_value_create() logs errors */
300 if (stream
->class->packets_have_default_end_cv
) {
301 packet
->default_end_cv
= bt_clock_value_create(
302 stream
->class->default_clock_class
);
303 if (!packet
->default_end_cv
) {
304 /* bt_clock_value_create() logs errors */
310 reset_counter_snapshots(packet
);
311 BT_LIB_LOGD("Created packet object: %!+a", packet
);
315 BT_OBJECT_PUT_REF_AND_RESET(packet
);
321 struct bt_private_packet
*bt_private_packet_create(
322 struct bt_private_stream
*priv_stream
)
324 struct bt_stream
*stream
= (void *) priv_stream
;
325 struct bt_packet
*packet
= NULL
;
327 BT_ASSERT_PRE_NON_NULL(stream
, "Stream");
328 packet
= bt_object_pool_create_object(&stream
->packet_pool
);
329 if (unlikely(!packet
)) {
330 BT_LIB_LOGE("Cannot allocate one packet from stream's packet pool: "
331 "%![stream-]+s", stream
);
335 if (likely(!packet
->stream
)) {
336 packet
->stream
= stream
;
337 bt_object_get_no_null_check_no_parent_check(
338 &packet
->stream
->base
);
342 return (void *) packet
;
345 int bt_private_packet_move_private_header_field(
346 struct bt_private_packet
*priv_packet
,
347 struct bt_private_packet_header_field
*header_field
)
349 struct bt_packet
*packet
= (void *) priv_packet
;
350 struct bt_trace
*trace
;
351 struct bt_field_wrapper
*field_wrapper
= (void *) header_field
;
353 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
354 BT_ASSERT_PRE_NON_NULL(field_wrapper
, "Header field");
355 BT_ASSERT_PRE_PACKET_HOT(packet
);
356 trace
= bt_stream_class_borrow_trace_inline(packet
->stream
->class);
357 BT_ASSERT_PRE(trace
->packet_header_fc
,
358 "Trace has no packet header field classe: %!+t",
360 BT_ASSERT_PRE(field_wrapper
->field
->class ==
361 trace
->packet_header_fc
,
362 "Unexpected packet header field's class: "
363 "%![fc-]+F, %![expected-fc-]+F", field_wrapper
->field
->class,
364 trace
->packet_header_fc
);
366 /* Recycle current header field: always exists */
367 BT_ASSERT(packet
->header_field
);
368 recycle_header_field(packet
->header_field
, trace
);
371 packet
->header_field
= field_wrapper
;
375 int bt_private_packet_move_private_context_field(
376 struct bt_private_packet
*priv_packet
,
377 struct bt_private_packet_context_field
*context_field
)
379 struct bt_packet
*packet
= (void *) priv_packet
;
380 struct bt_stream_class
*stream_class
;
381 struct bt_field_wrapper
*field_wrapper
= (void *) context_field
;
383 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
384 BT_ASSERT_PRE_NON_NULL(field_wrapper
, "Context field");
385 BT_ASSERT_PRE_HOT(packet
, "Packet", ": %!+a", packet
);
386 stream_class
= packet
->stream
->class;
387 BT_ASSERT_PRE(stream_class
->packet_context_fc
,
388 "Stream class has no packet context field classe: %!+S",
390 BT_ASSERT_PRE(field_wrapper
->field
->class ==
391 stream_class
->packet_context_fc
,
392 "Unexpected packet header field's class: "
393 "%![fc-]+F, %![expected-fc-]+F", field_wrapper
->field
->class,
394 stream_class
->packet_context_fc
);
396 /* Recycle current context field: always exists */
397 BT_ASSERT(packet
->context_field
);
398 recycle_context_field(packet
->context_field
, stream_class
);
401 packet
->context_field
= field_wrapper
;
405 int bt_private_packet_set_default_beginning_clock_value(
406 struct bt_private_packet
*priv_packet
,
407 uint64_t value_cycles
)
409 struct bt_packet
*packet
= (void *) priv_packet
;
410 struct bt_stream_class
*sc
;
412 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
413 BT_ASSERT_PRE_PACKET_HOT(packet
);
414 sc
= packet
->stream
->class;
416 BT_ASSERT_PRE(sc
->default_clock_class
,
417 "Packet's stream class has no default clock class: "
418 "%![packet-]+a, %![sc-]+S", packet
, sc
);
419 BT_ASSERT_PRE(sc
->packets_have_default_beginning_cv
,
420 "Packet's stream class indicates that its packets have "
421 "no default beginning clock value: %![packet-]+a, %![sc-]+S",
423 BT_ASSERT(packet
->default_beginning_cv
);
424 bt_clock_value_set_value_inline(packet
->default_beginning_cv
, value_cycles
);
425 BT_LIB_LOGV("Set packet's default beginning clock value: "
426 "%![packet-]+a, value=%" PRIu64
, packet
, value_cycles
);
430 enum bt_clock_value_status
bt_packet_borrow_default_beginning_clock_value(
431 struct bt_packet
*packet
, struct bt_clock_value
**clock_value
)
433 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
434 BT_ASSERT_PRE_NON_NULL(clock_value
, "Clock value (output)");
435 *clock_value
= packet
->default_beginning_cv
;
436 return BT_CLOCK_VALUE_STATUS_KNOWN
;
439 int bt_private_packet_set_default_end_clock_value(
440 struct bt_private_packet
*priv_packet
,
441 uint64_t value_cycles
)
443 struct bt_packet
*packet
= (void *) priv_packet
;
444 struct bt_stream_class
*sc
;
446 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
447 BT_ASSERT_PRE_PACKET_HOT(packet
);
448 sc
= packet
->stream
->class;
450 BT_ASSERT_PRE(sc
->default_clock_class
,
451 "Packet's stream class has no default clock class: "
452 "%![packet-]+a, %![sc-]+S", packet
, sc
);
453 BT_ASSERT_PRE(sc
->packets_have_default_end_cv
,
454 "Packet's stream class indicates that its packets have "
455 "no default end clock value: %![packet-]+a, %![sc-]+S",
457 BT_ASSERT(packet
->default_end_cv
);
458 bt_clock_value_set_value_inline(packet
->default_end_cv
, value_cycles
);
459 BT_LIB_LOGV("Set packet's default end clock value: "
460 "%![packet-]+a, value=%" PRIu64
, packet
, value_cycles
);
464 enum bt_clock_value_status
bt_packet_borrow_default_end_clock_value(
465 struct bt_packet
*packet
, struct bt_clock_value
**clock_value
)
467 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
468 BT_ASSERT_PRE_NON_NULL(clock_value
, "Clock value (output)");
469 *clock_value
= packet
->default_end_cv
;
470 return BT_CLOCK_VALUE_STATUS_KNOWN
;
473 enum bt_property_availability
bt_packet_get_discarded_event_counter_snapshot(
474 struct bt_packet
*packet
, uint64_t *value
)
476 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
477 BT_ASSERT_PRE_NON_NULL(value
, "Value (output)");
478 *value
= packet
->discarded_event_counter_snapshot
.value
;
479 return packet
->discarded_event_counter_snapshot
.base
.avail
;
482 int bt_private_packet_set_discarded_event_counter_snapshot(
483 struct bt_private_packet
*priv_packet
, uint64_t value
)
485 struct bt_packet
*packet
= (void *) priv_packet
;
487 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
488 BT_ASSERT_PRE_PACKET_HOT(packet
);
489 BT_ASSERT_PRE(packet
->stream
->class->packets_have_discarded_event_counter_snapshot
,
490 "Packet's stream's discarded event counter is not enabled: "
491 "%![packet-]+a", packet
);
492 bt_property_uint_set(&packet
->discarded_event_counter_snapshot
, value
);
496 enum bt_property_availability
bt_packet_get_packet_counter_snapshot(
497 struct bt_packet
*packet
, uint64_t *value
)
499 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
500 BT_ASSERT_PRE_NON_NULL(value
, "Value (output)");
501 *value
= packet
->packet_counter_snapshot
.value
;
502 return packet
->packet_counter_snapshot
.base
.avail
;
505 int bt_private_packet_set_packet_counter_snapshot(
506 struct bt_private_packet
*priv_packet
, uint64_t value
)
508 struct bt_packet
*packet
= (void *) priv_packet
;
510 BT_ASSERT_PRE_NON_NULL(packet
, "Packet");
511 BT_ASSERT_PRE_PACKET_HOT(packet
);
512 BT_ASSERT_PRE(packet
->stream
->class->packets_have_packet_counter_snapshot
,
513 "Packet's stream's packet counter is not enabled: "
514 "%![packet-]+a", packet
);
515 bt_property_uint_set(&packet
->packet_counter_snapshot
, value
);
519 struct bt_packet
*bt_packet_borrow_from_private(
520 struct bt_private_packet
*priv_packet
)
522 return (void *) priv_packet
;