2 * Copyright 2019 - Francis Deslauriers <francis.deslauriers@efficios.com>
3 * Copyright 2016 - Philippe Proulx <pproulx@efficios.com>
4 * Copyright 2010-2011 - EfficiOS Inc. and Linux Foundation
6 * Some functions are based on older functions written by Mathieu Desnoyers.
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:
15 * The above copyright notice and this permission notice shall be included in
16 * all copies or substantial portions of the Software.
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
27 #define BT_COMP_LOG_SELF_COMP self_comp
28 #define BT_LOG_OUTPUT_LEVEL log_level
29 #define BT_LOG_TAG "PLUGIN/SRC.CTF.LTTNG-LIVE/META"
30 #include "logging/comp-logging.h"
37 #include "compat/memstream.h"
38 #include <babeltrace2/babeltrace.h>
41 #include "../common/metadata/decoder.h"
42 #include "../common/metadata/ctf-meta-configure-ir-trace.h"
44 #define TSDL_MAGIC 0x75d11d57
46 struct packet_header
{
50 uint32_t content_size
;
52 uint8_t compression_scheme
;
53 uint8_t encryption_scheme
;
54 uint8_t checksum_scheme
;
57 } __attribute__((__packed__
));
61 bool stream_classes_all_have_default_clock_class(bt_trace_class
*tc
,
62 bt_logging_level log_level
,
63 bt_self_component
*self_comp
)
66 const bt_clock_class
*cc
= NULL
;
67 const bt_stream_class
*sc
;
70 sc_count
= bt_trace_class_get_stream_class_count(tc
);
71 for (i
= 0; i
< sc_count
; i
++) {
72 sc
= bt_trace_class_borrow_stream_class_by_index_const(tc
, i
);
76 cc
= bt_stream_class_borrow_default_clock_class_const(sc
);
79 BT_COMP_LOGE_APPEND_CAUSE(self_comp
,
80 "Stream class doesn't have a default clock class: "
81 "sc-id=%" PRIu64
", sc-name=\"%s\"",
82 bt_stream_class_get_id(sc
),
83 bt_stream_class_get_name(sc
));
92 * Iterate over the stream classes and returns the first clock class
93 * encountered. This is useful to create message iterator inactivity message as
94 * we don't need a particular clock class.
97 const bt_clock_class
*borrow_any_clock_class(bt_trace_class
*tc
)
100 const bt_clock_class
*cc
= NULL
;
101 const bt_stream_class
*sc
;
103 sc_count
= bt_trace_class_get_stream_class_count(tc
);
104 for (i
= 0; i
< sc_count
; i
++) {
105 sc
= bt_trace_class_borrow_stream_class_by_index_const(tc
, i
);
108 cc
= bt_stream_class_borrow_default_clock_class_const(sc
);
119 enum lttng_live_iterator_status
lttng_live_metadata_update(
120 struct lttng_live_trace
*trace
)
122 struct lttng_live_session
*session
= trace
->session
;
123 struct lttng_live_metadata
*metadata
= trace
->metadata
;
124 size_t size
, len_read
= 0;
125 char *metadata_buf
= NULL
;
128 enum ctf_metadata_decoder_status decoder_status
;
129 enum lttng_live_iterator_status status
=
130 LTTNG_LIVE_ITERATOR_STATUS_OK
;
131 bt_logging_level log_level
= trace
->log_level
;
132 bt_self_component
*self_comp
= trace
->self_comp
;
133 enum lttng_live_get_one_metadata_status metadata_status
;
135 BT_COMP_LOGD("Updating metadata for trace: trace-id=%"PRIu64
, trace
->id
);
137 /* No metadata stream yet. */
139 if (session
->new_streams_needed
) {
140 status
= LTTNG_LIVE_ITERATOR_STATUS_AGAIN
;
142 session
->new_streams_needed
= true;
143 status
= LTTNG_LIVE_ITERATOR_STATUS_CONTINUE
;
148 if (!metadata
->trace
) {
149 trace
->new_metadata_needed
= false;
152 if (!trace
->new_metadata_needed
) {
157 * Open a new write only file handle to populate the `metadata_buf`
158 * memory buffer so we can write in loop in it easily.
160 fp
= bt_open_memstream(&metadata_buf
, &size
);
162 if (errno
== EINTR
&&
163 lttng_live_graph_is_canceled(session
->lttng_live_msg_iter
)) {
164 session
->lttng_live_msg_iter
->was_interrupted
= true;
165 status
= LTTNG_LIVE_ITERATOR_STATUS_AGAIN
;
167 BT_COMP_LOGE_APPEND_CAUSE_ERRNO(self_comp
,
168 "Metadata open_memstream", ".");
169 status
= LTTNG_LIVE_ITERATOR_STATUS_ERROR
;
174 keep_receiving
= true;
175 /* Grab all available metadata. */
176 while (keep_receiving
) {
177 size_t reply_len
= 0;
179 * lttng_live_get_one_metadata_packet() asks the Relay Daemon
180 * for new metadata. If new metadata is received, the function
181 * writes it to the provided file handle and updates the
182 * reply_len output parameter. We call this function in loop
183 * until it returns _END meaning that no new metadata is
185 * We may receive a _CLOSED status if the metadata stream we
186 * are requesting is no longer available on the relay.
187 * If we receive an _ERROR status, it means there was a
188 * networking, allocating, or some other unrecoverable error.
190 metadata_status
= lttng_live_get_one_metadata_packet(trace
, fp
,
193 switch (metadata_status
) {
194 case LTTNG_LIVE_GET_ONE_METADATA_STATUS_OK
:
195 len_read
+= reply_len
;
197 case LTTNG_LIVE_GET_ONE_METADATA_STATUS_END
:
198 keep_receiving
= false;
200 case LTTNG_LIVE_GET_ONE_METADATA_STATUS_CLOSED
:
201 BT_COMP_LOGD("Metadata stream was closed by the Relay, the trace is no longer active: "
202 "trace-id=%"PRIu64
", metadata-stream-id=%"PRIu64
,
203 trace
->id
, metadata
->stream_id
);
204 keep_receiving
= false;
206 case LTTNG_LIVE_GET_ONE_METADATA_STATUS_ERROR
:
207 BT_COMP_LOGE_APPEND_CAUSE(self_comp
,
208 "Error getting one trace metadata packet: "
209 "trace-id=%"PRIu64
, trace
->id
);
217 * A closed metadata stream means the trace is no longer active. Return
218 * _END so that the caller can remove the trace from its list.
220 if (metadata_status
== LTTNG_LIVE_GET_ONE_METADATA_STATUS_CLOSED
) {
221 status
= LTTNG_LIVE_ITERATOR_STATUS_END
;
225 /* The memory buffer `metadata_buf` contains all the metadata. */
226 if (bt_close_memstream(&metadata_buf
, &size
, fp
)) {
227 BT_COMP_LOGW_ERRNO("Metadata bt_close_memstream", ".");
234 status
= LTTNG_LIVE_ITERATOR_STATUS_AGAIN
;
237 trace
->new_metadata_needed
= false;
242 * Open a new reading file handle on the `metadata_buf` and pass it to
243 * the metadata decoder.
245 fp
= bt_fmemopen(metadata_buf
, len_read
, "rb");
247 if (errno
== EINTR
&&
248 lttng_live_graph_is_canceled(session
->lttng_live_msg_iter
)) {
249 session
->lttng_live_msg_iter
->was_interrupted
= true;
250 status
= LTTNG_LIVE_ITERATOR_STATUS_AGAIN
;
252 BT_COMP_LOGE_APPEND_CAUSE_ERRNO(self_comp
,
253 "Cannot memory-open metadata buffer", ".");
254 status
= LTTNG_LIVE_ITERATOR_STATUS_ERROR
;
260 * The call to ctf_metadata_decoder_append_content() will append
261 * new metadata to our current trace class.
263 BT_COMP_LOGD("Appending new metadata to the ctf_trace class");
264 decoder_status
= ctf_metadata_decoder_append_content(
265 metadata
->decoder
, fp
);
266 switch (decoder_status
) {
267 case CTF_METADATA_DECODER_STATUS_OK
:
268 if (!trace
->trace_class
) {
269 struct ctf_trace_class
*tc
=
270 ctf_metadata_decoder_borrow_ctf_trace_class(
274 ctf_metadata_decoder_get_ir_trace_class(
276 trace
->trace
= bt_trace_create(trace
->trace_class
);
278 BT_COMP_LOGE_APPEND_CAUSE(self_comp
,
279 "Failed to create bt_trace");
282 if (ctf_trace_class_configure_ir_trace(tc
,
284 BT_COMP_LOGE_APPEND_CAUSE(self_comp
,
285 "Failed to configure ctf trace class");
288 if (!stream_classes_all_have_default_clock_class(
289 trace
->trace_class
, log_level
,
291 /* Error logged in function. */
295 borrow_any_clock_class(trace
->trace_class
);
297 trace
->new_metadata_needed
= false;
300 case CTF_METADATA_DECODER_STATUS_INCOMPLETE
:
301 status
= LTTNG_LIVE_ITERATOR_STATUS_AGAIN
;
310 status
= LTTNG_LIVE_ITERATOR_STATUS_ERROR
;
315 closeret
= fclose(fp
);
317 BT_COMP_LOGW_ERRNO("Error on fclose", ".");
325 int lttng_live_metadata_create_stream(struct lttng_live_session
*session
,
326 uint64_t ctf_trace_id
, uint64_t stream_id
,
327 const char *trace_name
)
329 bt_self_component
*self_comp
= session
->self_comp
;
330 bt_logging_level log_level
= session
->log_level
;
331 struct lttng_live_metadata
*metadata
= NULL
;
332 struct lttng_live_trace
*trace
;
333 struct ctf_metadata_decoder_config cfg
= {
334 .log_level
= session
->log_level
,
335 .self_comp
= session
->self_comp
,
336 .clock_class_offset_s
= 0,
337 .clock_class_offset_ns
= 0,
338 .create_trace_class
= true,
341 metadata
= g_new0(struct lttng_live_metadata
, 1);
345 metadata
->log_level
= session
->log_level
;
346 metadata
->self_comp
= session
->self_comp
;
347 metadata
->stream_id
= stream_id
;
349 metadata
->decoder
= ctf_metadata_decoder_create(&cfg
);
350 if (!metadata
->decoder
) {
351 BT_COMP_LOGE_APPEND_CAUSE(self_comp
,
352 "Failed to create CTF metadata decoder");
355 trace
= lttng_live_borrow_trace(session
, ctf_trace_id
);
357 BT_COMP_LOGE_APPEND_CAUSE(self_comp
,
358 "Failed to borrow trace");
361 metadata
->trace
= trace
;
362 trace
->metadata
= metadata
;
366 ctf_metadata_decoder_destroy(metadata
->decoder
);
372 void lttng_live_metadata_fini(struct lttng_live_trace
*trace
)
374 struct lttng_live_metadata
*metadata
= trace
->metadata
;
379 ctf_metadata_decoder_destroy(metadata
->decoder
);
380 trace
->metadata
= NULL
;