2 * Copyright (C) 2014 - Jonathan Rajotte <jonathan.r.julien@gmail.com>
3 * - Olivier Cotte <olivier.cotte@polymtl.ca>
4 * Copyright (C) 2016 - Jérémie Galarneau <jeremie.galarneau@efficios.com>
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License, version 2 only, as
8 * published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
15 * You should have received a copy of the GNU General Public License along with
16 * this program; if not, write to the Free Software Foundation, Inc., 51
17 * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 #include <common/config/session-config.h>
22 #include <common/defaults.h>
23 #include <lttng/snapshot-internal.h>
24 #include <lttng/channel.h>
29 #define MI_SCHEMA_MAJOR_VERSION 3
30 #define MI_SCHEMA_MINOR_VERSION 0
32 /* Machine interface namespace URI */
33 LTTNG_HIDDEN
const char * const mi_lttng_xmlns
= "xmlns";
34 LTTNG_HIDDEN
const char * const mi_lttng_xmlns_xsi
= "xmlns:xsi";
35 LTTNG_HIDDEN
const char * const mi_lttng_w3_schema_uri
= "http://www.w3.org/2001/XMLSchema-instance";
36 LTTNG_HIDDEN
const char * const mi_lttng_schema_location
= "xsi:schemaLocation";
37 LTTNG_HIDDEN
const char * const mi_lttng_schema_location_uri
=
38 DEFAULT_LTTNG_MI_NAMESPACE
" "
39 "http://lttng.org/xml/schemas/lttng-mi/" XSTR(MI_SCHEMA_MAJOR_VERSION
)
40 "/lttng-mi-" XSTR(MI_SCHEMA_MAJOR_VERSION
) "."
41 XSTR(MI_SCHEMA_MINOR_VERSION
) ".xsd";
42 LTTNG_HIDDEN
const char * const mi_lttng_schema_version
= "schemaVersion";
43 LTTNG_HIDDEN
const char * const mi_lttng_schema_version_value
= XSTR(MI_SCHEMA_MAJOR_VERSION
)
44 "." XSTR(MI_SCHEMA_MINOR_VERSION
);
46 /* Strings related to command */
47 const char * const mi_lttng_element_command
= "command";
48 const char * const mi_lttng_element_command_action
= "snapshot_action";
49 const char * const mi_lttng_element_command_add_context
= "add-context";
50 const char * const mi_lttng_element_command_calibrate
= "calibrate";
51 const char * const mi_lttng_element_command_create
= "create";
52 const char * const mi_lttng_element_command_destroy
= "destroy";
53 const char * const mi_lttng_element_command_disable_channel
= "disable-channel";
54 const char * const mi_lttng_element_command_disable_event
= "disable-event";
55 const char * const mi_lttng_element_command_enable_channels
= "enable-channel";
56 const char * const mi_lttng_element_command_enable_event
= "enable-event";
57 const char * const mi_lttng_element_command_list
= "list";
58 const char * const mi_lttng_element_command_load
= "load";
59 LTTNG_HIDDEN
const char * const mi_lttng_element_command_metadata
= "metadata";
60 LTTNG_HIDDEN
const char * const mi_lttng_element_command_metadata_action
= "metadata_action";
61 const char * const mi_lttng_element_command_name
= "name";
62 const char * const mi_lttng_element_command_output
= "output";
63 const char * const mi_lttng_element_command_save
= "save";
64 const char * const mi_lttng_element_command_set_session
= "set-session";
65 const char * const mi_lttng_element_command_snapshot
= "snapshot";
66 const char * const mi_lttng_element_command_snapshot_add
= "add_snapshot";
67 const char * const mi_lttng_element_command_snapshot_del
= "del_snapshot";
68 const char * const mi_lttng_element_command_snapshot_list
= "list_snapshot";
69 const char * const mi_lttng_element_command_snapshot_record
= "record_snapshot";
70 const char * const mi_lttng_element_command_start
= "start";
71 const char * const mi_lttng_element_command_stop
= "stop";
72 const char * const mi_lttng_element_command_success
= "success";
73 const char * const mi_lttng_element_command_track
= "track";
74 const char * const mi_lttng_element_command_untrack
= "untrack";
75 const char * const mi_lttng_element_command_version
= "version";
77 /* Strings related to version command */
78 const char * const mi_lttng_element_version
= "version";
79 const char * const mi_lttng_element_version_commit
= "commit";
80 const char * const mi_lttng_element_version_description
= "description";
81 const char * const mi_lttng_element_version_license
= "license";
82 const char * const mi_lttng_element_version_major
= "major";
83 const char * const mi_lttng_element_version_minor
= "minor";
84 const char * const mi_lttng_element_version_patch_level
= "patchLevel";
85 const char * const mi_lttng_element_version_str
= "string";
86 const char * const mi_lttng_element_version_web
= "url";
88 /* String related to a lttng_event_field */
89 const char * const mi_lttng_element_event_field
= "event_field";
90 const char * const mi_lttng_element_event_fields
= "event_fields";
92 /* String related to lttng_event_perf_counter_ctx */
93 const char * const mi_lttng_element_perf_counter_context
= "perf";
95 /* Strings related to pid */
96 const char * const mi_lttng_element_pid_id
= "id";
98 /* Strings related to save command */
99 const char * const mi_lttng_element_save
= "save";
101 /* Strings related to load command */
102 const char * const mi_lttng_element_load
= "load";
104 /* General elements of mi_lttng */
105 const char * const mi_lttng_element_empty
= "";
106 const char * const mi_lttng_element_id
= "id";
107 const char * const mi_lttng_element_nowrite
= "nowrite";
108 const char * const mi_lttng_element_success
= "success";
109 const char * const mi_lttng_element_type_enum
= "ENUM";
110 const char * const mi_lttng_element_type_float
= "FLOAT";
111 const char * const mi_lttng_element_type_integer
= "INTEGER";
112 const char * const mi_lttng_element_type_other
= "OTHER";
113 const char * const mi_lttng_element_type_string
= "STRING";
115 /* String related to loglevel */
116 const char * const mi_lttng_loglevel_str_alert
= "TRACE_ALERT";
117 const char * const mi_lttng_loglevel_str_crit
= "TRACE_CRIT";
118 const char * const mi_lttng_loglevel_str_debug
= "TRACE_DEBUG";
119 const char * const mi_lttng_loglevel_str_debug_function
= "TRACE_DEBUG_FUNCTION";
120 const char * const mi_lttng_loglevel_str_debug_line
= "TRACE_DEBUG_LINE";
121 const char * const mi_lttng_loglevel_str_debug_module
= "TRACE_DEBUG_MODULE";
122 const char * const mi_lttng_loglevel_str_debug_process
= "TRACE_DEBUG_PROCESS";
123 const char * const mi_lttng_loglevel_str_debug_program
= "TRACE_DEBUG_PROGRAM";
124 const char * const mi_lttng_loglevel_str_debug_system
= "TRACE_DEBUG_SYSTEM";
125 const char * const mi_lttng_loglevel_str_debug_unit
= "TRACE_DEBUG_UNIT";
126 const char * const mi_lttng_loglevel_str_emerg
= "TRACE_EMERG";
127 const char * const mi_lttng_loglevel_str_err
= "TRACE_ERR";
128 const char * const mi_lttng_loglevel_str_info
= "TRACE_INFO";
129 const char * const mi_lttng_loglevel_str_notice
= "TRACE_NOTICE";
130 const char * const mi_lttng_loglevel_str_unknown
= "UNKNOWN";
131 const char * const mi_lttng_loglevel_str_warning
= "TRACE_WARNING";
133 /* String related to loglevel JUL */
134 const char * const mi_lttng_loglevel_str_jul_all
= "JUL_ALL";
135 const char * const mi_lttng_loglevel_str_jul_config
= "JUL_CONFIG";
136 const char * const mi_lttng_loglevel_str_jul_fine
= "JUL_FINE";
137 const char * const mi_lttng_loglevel_str_jul_finer
= "JUL_FINER";
138 const char * const mi_lttng_loglevel_str_jul_finest
= "JUL_FINEST";
139 const char * const mi_lttng_loglevel_str_jul_info
= "JUL_INFO";
140 const char * const mi_lttng_loglevel_str_jul_off
= "JUL_OFF";
141 const char * const mi_lttng_loglevel_str_jul_severe
= "JUL_SEVERE";
142 const char * const mi_lttng_loglevel_str_jul_warning
= "JUL_WARNING";
144 /* String related to loglevel LOG4J */
145 const char * const mi_lttng_loglevel_str_log4j_off
= "LOG4J_OFF";
146 const char * const mi_lttng_loglevel_str_log4j_fatal
= "LOG4J_FATAL";
147 const char * const mi_lttng_loglevel_str_log4j_error
= "LOG4J_ERROR";
148 const char * const mi_lttng_loglevel_str_log4j_warn
= "LOG4J_WARN";
149 const char * const mi_lttng_loglevel_str_log4j_info
= "LOG4J_INFO";
150 const char * const mi_lttng_loglevel_str_log4j_debug
= "LOG4J_DEBUG";
151 const char * const mi_lttng_loglevel_str_log4j_trace
= "LOG4J_TRACE";
152 const char * const mi_lttng_loglevel_str_log4j_all
= "LOG4J_ALL";
154 /* String related to loglevel Python */
155 const char * const mi_lttng_loglevel_str_python_critical
= "PYTHON_CRITICAL";
156 const char * const mi_lttng_loglevel_str_python_error
= "PYTHON_ERROR";
157 const char * const mi_lttng_loglevel_str_python_warning
= "PYTHON_WARNING";
158 const char * const mi_lttng_loglevel_str_python_info
= "PYTHON_INFO";
159 const char * const mi_lttng_loglevel_str_python_debug
= "PYTHON_DEBUG";
160 const char * const mi_lttng_loglevel_str_python_notset
= "PYTHON_NOTSET";
162 /* String related to loglevel type */
163 const char * const mi_lttng_loglevel_type_all
= "ALL";
164 const char * const mi_lttng_loglevel_type_range
= "RANGE";
165 const char * const mi_lttng_loglevel_type_single
= "SINGLE";
166 const char * const mi_lttng_loglevel_type_unknown
= "UNKNOWN";
168 /* String related to lttng_calibrate */
169 const char * const mi_lttng_element_calibrate
= "calibrate";
170 const char * const mi_lttng_element_calibrate_function
= "FUNCTION";
172 /* String related to a lttng_snapshot_output */
173 const char * const mi_lttng_element_snapshot_ctrl_url
= "ctrl_url";
174 const char * const mi_lttng_element_snapshot_data_url
= "data_url";
175 const char * const mi_lttng_element_snapshot_max_size
= "max_size";
176 const char * const mi_lttng_element_snapshot_n_ptr
= "n_ptr";
177 const char * const mi_lttng_element_snapshot_session_name
= "session_name";
178 const char * const mi_lttng_element_snapshots
= "snapshots";
180 /* String related to track/untrack command */
181 const char * const mi_lttng_element_track_untrack_all_wildcard
= "*";
183 /* Deprecated symbols preserved for ABI compatibility. */
184 const char * const mi_lttng_context_type_perf_counter
;
185 const char * const mi_lttng_context_type_perf_cpu_counter
;
186 const char * const mi_lttng_context_type_perf_thread_counter
;
187 const char * const mi_lttng_element_track_untrack_pid_target
;
188 const char * const mi_lttng_element_track_untrack_targets
;
190 /* This is a merge of jul loglevel and regular loglevel
191 * Those should never overlap by definition
192 * (see struct lttng_event loglevel)
195 const char *mi_lttng_loglevel_string(int value
, enum lttng_domain_type domain
)
198 case LTTNG_DOMAIN_KERNEL
:
199 case LTTNG_DOMAIN_UST
:
202 return mi_lttng_element_empty
;
203 case LTTNG_LOGLEVEL_EMERG
:
204 return mi_lttng_loglevel_str_emerg
;
205 case LTTNG_LOGLEVEL_ALERT
:
206 return mi_lttng_loglevel_str_alert
;
207 case LTTNG_LOGLEVEL_CRIT
:
208 return mi_lttng_loglevel_str_crit
;
209 case LTTNG_LOGLEVEL_ERR
:
210 return mi_lttng_loglevel_str_err
;
211 case LTTNG_LOGLEVEL_WARNING
:
212 return mi_lttng_loglevel_str_warning
;
213 case LTTNG_LOGLEVEL_NOTICE
:
214 return mi_lttng_loglevel_str_notice
;
215 case LTTNG_LOGLEVEL_INFO
:
216 return mi_lttng_loglevel_str_info
;
217 case LTTNG_LOGLEVEL_DEBUG_SYSTEM
:
218 return mi_lttng_loglevel_str_debug_system
;
219 case LTTNG_LOGLEVEL_DEBUG_PROGRAM
:
220 return mi_lttng_loglevel_str_debug_program
;
221 case LTTNG_LOGLEVEL_DEBUG_PROCESS
:
222 return mi_lttng_loglevel_str_debug_process
;
223 case LTTNG_LOGLEVEL_DEBUG_MODULE
:
224 return mi_lttng_loglevel_str_debug_module
;
225 case LTTNG_LOGLEVEL_DEBUG_UNIT
:
226 return mi_lttng_loglevel_str_debug_unit
;
227 case LTTNG_LOGLEVEL_DEBUG_FUNCTION
:
228 return mi_lttng_loglevel_str_debug_function
;
229 case LTTNG_LOGLEVEL_DEBUG_LINE
:
230 return mi_lttng_loglevel_str_debug_line
;
231 case LTTNG_LOGLEVEL_DEBUG
:
232 return mi_lttng_loglevel_str_debug
;
234 return mi_lttng_loglevel_str_unknown
;
237 case LTTNG_DOMAIN_LOG4J
:
240 return mi_lttng_element_empty
;
241 case LTTNG_LOGLEVEL_LOG4J_OFF
:
242 return mi_lttng_loglevel_str_log4j_off
;
243 case LTTNG_LOGLEVEL_LOG4J_FATAL
:
244 return mi_lttng_loglevel_str_log4j_fatal
;
245 case LTTNG_LOGLEVEL_LOG4J_ERROR
:
246 return mi_lttng_loglevel_str_log4j_error
;
247 case LTTNG_LOGLEVEL_LOG4J_WARN
:
248 return mi_lttng_loglevel_str_log4j_warn
;
249 case LTTNG_LOGLEVEL_LOG4J_INFO
:
250 return mi_lttng_loglevel_str_log4j_info
;
251 case LTTNG_LOGLEVEL_LOG4J_DEBUG
:
252 return mi_lttng_loglevel_str_log4j_debug
;
253 case LTTNG_LOGLEVEL_LOG4J_TRACE
:
254 return mi_lttng_loglevel_str_log4j_trace
;
255 case LTTNG_LOGLEVEL_LOG4J_ALL
:
256 return mi_lttng_loglevel_str_log4j_all
;
258 return mi_lttng_loglevel_str_unknown
;
261 case LTTNG_DOMAIN_JUL
:
264 return mi_lttng_element_empty
;
265 case LTTNG_LOGLEVEL_JUL_OFF
:
266 return mi_lttng_loglevel_str_jul_off
;
267 case LTTNG_LOGLEVEL_JUL_SEVERE
:
268 return mi_lttng_loglevel_str_jul_severe
;
269 case LTTNG_LOGLEVEL_JUL_WARNING
:
270 return mi_lttng_loglevel_str_jul_warning
;
271 case LTTNG_LOGLEVEL_JUL_INFO
:
272 return mi_lttng_loglevel_str_jul_info
;
273 case LTTNG_LOGLEVEL_JUL_CONFIG
:
274 return mi_lttng_loglevel_str_jul_config
;
275 case LTTNG_LOGLEVEL_JUL_FINE
:
276 return mi_lttng_loglevel_str_jul_fine
;
277 case LTTNG_LOGLEVEL_JUL_FINER
:
278 return mi_lttng_loglevel_str_jul_finer
;
279 case LTTNG_LOGLEVEL_JUL_FINEST
:
280 return mi_lttng_loglevel_str_jul_finest
;
281 case LTTNG_LOGLEVEL_JUL_ALL
:
282 return mi_lttng_loglevel_str_jul_all
;
284 return mi_lttng_loglevel_str_unknown
;
287 case LTTNG_DOMAIN_PYTHON
:
289 case LTTNG_LOGLEVEL_PYTHON_CRITICAL
:
290 return mi_lttng_loglevel_str_python_critical
;
291 case LTTNG_LOGLEVEL_PYTHON_ERROR
:
292 return mi_lttng_loglevel_str_python_error
;
293 case LTTNG_LOGLEVEL_PYTHON_WARNING
:
294 return mi_lttng_loglevel_str_python_warning
;
295 case LTTNG_LOGLEVEL_PYTHON_INFO
:
296 return mi_lttng_loglevel_str_python_info
;
297 case LTTNG_LOGLEVEL_PYTHON_DEBUG
:
298 return mi_lttng_loglevel_str_python_debug
;
299 case LTTNG_LOGLEVEL_PYTHON_NOTSET
:
300 return mi_lttng_loglevel_str_python_notset
;
302 return mi_lttng_loglevel_str_unknown
;
307 /* Reaching this means the domain is unknown. */
308 return mi_lttng_loglevel_str_unknown
;
312 const char *mi_lttng_logleveltype_string(enum lttng_loglevel_type value
)
315 case LTTNG_EVENT_LOGLEVEL_ALL
:
316 return mi_lttng_loglevel_type_all
;
317 case LTTNG_EVENT_LOGLEVEL_RANGE
:
318 return mi_lttng_loglevel_type_range
;
319 case LTTNG_EVENT_LOGLEVEL_SINGLE
:
320 return mi_lttng_loglevel_type_single
;
322 return mi_lttng_loglevel_type_unknown
;
327 const char *mi_lttng_eventtype_string(enum lttng_event_type value
)
330 case LTTNG_EVENT_ALL
:
331 return config_event_type_all
;
332 case LTTNG_EVENT_TRACEPOINT
:
333 return config_event_type_tracepoint
;
334 case LTTNG_EVENT_PROBE
:
335 return config_event_type_probe
;
336 case LTTNG_EVENT_FUNCTION
:
337 return config_event_type_function
;
338 case LTTNG_EVENT_FUNCTION_ENTRY
:
339 return config_event_type_function_entry
;
340 case LTTNG_EVENT_SYSCALL
:
341 return config_event_type_syscall
;
342 case LTTNG_EVENT_NOOP
:
343 return config_event_type_noop
;
345 return mi_lttng_element_empty
;
350 const char *mi_lttng_event_contexttype_string(enum lttng_event_context_type val
)
353 case LTTNG_EVENT_CONTEXT_PID
:
354 return config_event_context_pid
;
355 case LTTNG_EVENT_CONTEXT_PROCNAME
:
356 return config_event_context_procname
;
357 case LTTNG_EVENT_CONTEXT_PRIO
:
358 return config_event_context_prio
;
359 case LTTNG_EVENT_CONTEXT_NICE
:
360 return config_event_context_nice
;
361 case LTTNG_EVENT_CONTEXT_VPID
:
362 return config_event_context_vpid
;
363 case LTTNG_EVENT_CONTEXT_TID
:
364 return config_event_context_tid
;
365 case LTTNG_EVENT_CONTEXT_VTID
:
366 return config_event_context_vtid
;
367 case LTTNG_EVENT_CONTEXT_PPID
:
368 return config_event_context_ppid
;
369 case LTTNG_EVENT_CONTEXT_VPPID
:
370 return config_event_context_vppid
;
371 case LTTNG_EVENT_CONTEXT_PTHREAD_ID
:
372 return config_event_context_pthread_id
;
373 case LTTNG_EVENT_CONTEXT_HOSTNAME
:
374 return config_event_context_hostname
;
375 case LTTNG_EVENT_CONTEXT_IP
:
376 return config_event_context_ip
;
383 const char *mi_lttng_eventfieldtype_string(enum lttng_event_field_type val
)
386 case(LTTNG_EVENT_FIELD_INTEGER
):
387 return mi_lttng_element_type_integer
;
388 case(LTTNG_EVENT_FIELD_ENUM
):
389 return mi_lttng_element_type_enum
;
390 case(LTTNG_EVENT_FIELD_FLOAT
):
391 return mi_lttng_element_type_float
;
392 case(LTTNG_EVENT_FIELD_STRING
):
393 return mi_lttng_element_type_string
;
395 return mi_lttng_element_type_other
;
400 const char *mi_lttng_domaintype_string(enum lttng_domain_type value
)
402 /* Note: This is a *duplicate* of get_domain_str from bin/lttng/utils.c */
404 case LTTNG_DOMAIN_KERNEL
:
405 return config_domain_type_kernel
;
406 case LTTNG_DOMAIN_UST
:
407 return config_domain_type_ust
;
408 case LTTNG_DOMAIN_JUL
:
409 return config_domain_type_jul
;
410 case LTTNG_DOMAIN_LOG4J
:
411 return config_domain_type_log4j
;
412 case LTTNG_DOMAIN_PYTHON
:
413 return config_domain_type_python
;
415 /* Should not have an unknown domain */
422 const char *mi_lttng_buffertype_string(enum lttng_buffer_type value
)
425 case LTTNG_BUFFER_PER_PID
:
426 return config_buffer_type_per_pid
;
427 case LTTNG_BUFFER_PER_UID
:
428 return config_buffer_type_per_uid
;
429 case LTTNG_BUFFER_GLOBAL
:
430 return config_buffer_type_global
;
432 /* Should not have an unknow buffer type */
439 const char *mi_lttng_calibratetype_string(enum lttng_calibrate_type val
)
444 case LTTNG_CALIBRATE_FUNCTION
:
445 ret
= mi_lttng_element_calibrate_function
;
448 ret
= mi_lttng_element_empty
;
455 struct mi_writer
*mi_lttng_writer_create(int fd_output
, int mi_output_type
)
457 struct mi_writer
*mi_writer
;
459 mi_writer
= zmalloc(sizeof(struct mi_writer
));
461 PERROR("zmalloc mi_writer_create");
464 if (mi_output_type
== LTTNG_MI_XML
) {
465 mi_writer
->writer
= config_writer_create(fd_output
, 0);
466 if (!mi_writer
->writer
) {
469 mi_writer
->type
= LTTNG_MI_XML
;
483 int mi_lttng_writer_destroy(struct mi_writer
*writer
)
492 ret
= config_writer_destroy(writer
->writer
);
503 int mi_lttng_writer_command_open(struct mi_writer
*writer
, const char *command
)
508 * A command is always the MI's root node, it must declare the current
509 * namespace and schema URIs and the schema's version.
511 ret
= config_writer_open_element(writer
->writer
,
512 mi_lttng_element_command
);
517 ret
= config_writer_write_attribute(writer
->writer
,
518 mi_lttng_xmlns
, DEFAULT_LTTNG_MI_NAMESPACE
);
523 ret
= config_writer_write_attribute(writer
->writer
,
524 mi_lttng_xmlns_xsi
, mi_lttng_w3_schema_uri
);
529 ret
= config_writer_write_attribute(writer
->writer
,
530 mi_lttng_schema_location
,
531 mi_lttng_schema_location_uri
);
536 ret
= config_writer_write_attribute(writer
->writer
,
537 mi_lttng_schema_version
,
538 mi_lttng_schema_version_value
);
543 ret
= mi_lttng_writer_write_element_string(writer
,
544 mi_lttng_element_command_name
, command
);
550 int mi_lttng_writer_command_close(struct mi_writer
*writer
)
552 return mi_lttng_writer_close_element(writer
);
556 int mi_lttng_writer_open_element(struct mi_writer
*writer
,
557 const char *element_name
)
559 return config_writer_open_element(writer
->writer
, element_name
);
563 int mi_lttng_writer_close_element(struct mi_writer
*writer
)
565 return config_writer_close_element(writer
->writer
);
569 int mi_lttng_close_multi_element(struct mi_writer
*writer
,
570 unsigned int nb_element
)
574 if (nb_element
< 1) {
578 for (i
= 0; i
< nb_element
; i
++) {
579 ret
= mi_lttng_writer_close_element(writer
);
589 int mi_lttng_writer_write_element_unsigned_int(struct mi_writer
*writer
,
590 const char *element_name
, uint64_t value
)
592 return config_writer_write_element_unsigned_int(writer
->writer
,
593 element_name
, value
);
597 int mi_lttng_writer_write_element_signed_int(struct mi_writer
*writer
,
598 const char *element_name
, int64_t value
)
600 return config_writer_write_element_signed_int(writer
->writer
,
601 element_name
, value
);
605 int mi_lttng_writer_write_element_bool(struct mi_writer
*writer
,
606 const char *element_name
, int value
)
608 return config_writer_write_element_bool(writer
->writer
,
609 element_name
, value
);
613 int mi_lttng_writer_write_element_string(struct mi_writer
*writer
,
614 const char *element_name
, const char *value
)
616 return config_writer_write_element_string(writer
->writer
,
617 element_name
, value
);
621 int mi_lttng_version(struct mi_writer
*writer
, struct mi_lttng_version
*version
,
622 const char *lttng_description
, const char *lttng_license
)
627 ret
= mi_lttng_writer_open_element(writer
, mi_lttng_element_version
);
632 /* Version string (contain info like rc etc.) */
633 ret
= mi_lttng_writer_write_element_string(writer
,
634 mi_lttng_element_version_str
, version
->version
);
639 /* Major version number */
640 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
641 mi_lttng_element_version_major
, version
->version_major
);
646 /* Minor version number */
647 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
648 mi_lttng_element_version_minor
, version
->version_minor
);
653 /* Commit version number */
654 ret
= mi_lttng_writer_write_element_string(writer
,
655 mi_lttng_element_version_commit
, version
->version_commit
);
661 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
662 mi_lttng_element_version_patch_level
, version
->version_patchlevel
);
667 /* Name of the version */
668 ret
= mi_lttng_writer_write_element_string(writer
,
669 config_element_name
, version
->version_name
);
674 /* Description mostly related to beer... */
675 ret
= mi_lttng_writer_write_element_string(writer
,
676 mi_lttng_element_version_description
, lttng_description
);
682 ret
= mi_lttng_writer_write_element_string(writer
,
683 mi_lttng_element_version_web
, version
->package_url
);
688 /* License: free as in free beer...no...*speech* */
689 ret
= mi_lttng_writer_write_element_string(writer
,
690 mi_lttng_element_version_license
, lttng_license
);
695 /* Close version element */
696 ret
= mi_lttng_writer_close_element(writer
);
703 int mi_lttng_sessions_open(struct mi_writer
*writer
)
705 return mi_lttng_writer_open_element(writer
, config_element_sessions
);
709 int mi_lttng_session(struct mi_writer
*writer
,
710 struct lttng_session
*session
, int is_open
)
716 /* Open sessions element */
717 ret
= mi_lttng_writer_open_element(writer
,
718 config_element_session
);
723 /* Name of the session */
724 ret
= mi_lttng_writer_write_element_string(writer
,
725 config_element_name
, session
->name
);
731 ret
= mi_lttng_writer_write_element_string(writer
,
732 config_element_path
, session
->path
);
738 ret
= mi_lttng_writer_write_element_bool(writer
,
739 config_element_enabled
, session
->enabled
);
745 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
746 config_element_snapshot_mode
, session
->snapshot_mode
);
751 /* Live timer interval in usec */
752 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
753 config_element_live_timer_interval
,
754 session
->live_timer_interval
);
760 /* Closing session element */
761 ret
= mi_lttng_writer_close_element(writer
);
769 int mi_lttng_domains_open(struct mi_writer
*writer
)
771 return mi_lttng_writer_open_element(writer
, config_element_domains
);
775 int mi_lttng_domain(struct mi_writer
*writer
,
776 struct lttng_domain
*domain
, int is_open
)
779 const char *str_domain
;
780 const char *str_buffer
;
784 /* Open domain element */
785 ret
= mi_lttng_writer_open_element(writer
, config_element_domain
);
791 str_domain
= mi_lttng_domaintype_string(domain
->type
);
792 ret
= mi_lttng_writer_write_element_string(writer
, config_element_type
,
799 str_buffer
= mi_lttng_buffertype_string(domain
->buf_type
);
800 ret
= mi_lttng_writer_write_element_string(writer
,
801 config_element_buffer_type
, str_buffer
);
807 * This union is not currently used and was added for
808 * future ust domain support.
813 /* Closing domain element */
814 ret
= mi_lttng_writer_close_element(writer
);
823 int mi_lttng_channels_open(struct mi_writer
*writer
)
825 return mi_lttng_writer_open_element(writer
, config_element_channels
);
829 int mi_lttng_channel(struct mi_writer
*writer
,
830 struct lttng_channel
*channel
, int is_open
)
836 /* Opening channel element */
837 ret
= mi_lttng_writer_open_element(writer
, config_element_channel
);
843 ret
= mi_lttng_writer_write_element_string(writer
, config_element_name
,
850 ret
= mi_lttng_writer_write_element_bool(writer
,
851 config_element_enabled
, channel
->enabled
);
857 ret
= mi_lttng_channel_attr(writer
, &channel
->attr
);
863 /* Closing channel element */
864 ret
= mi_lttng_writer_close_element(writer
);
874 int mi_lttng_channel_attr(struct mi_writer
*writer
,
875 struct lttng_channel_attr
*attr
)
878 struct lttng_channel
*chan
= caa_container_of(attr
,
879 struct lttng_channel
, attr
);
880 uint64_t discarded_events
, lost_packets
;
884 ret
= lttng_channel_get_discarded_event_count(chan
, &discarded_events
);
889 ret
= lttng_channel_get_lost_packet_count(chan
, &lost_packets
);
894 /* Opening Attributes */
895 ret
= mi_lttng_writer_open_element(writer
, config_element_attributes
);
901 ret
= mi_lttng_writer_write_element_string(writer
,
902 config_element_overwrite_mode
,
903 attr
->overwrite
? config_overwrite_mode_overwrite
:
904 config_overwrite_mode_discard
);
909 /* Sub buffer size in byte */
910 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
911 config_element_subbuf_size
, attr
->subbuf_size
);
916 /* Number of subbuffer (power of two) */
917 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
918 config_element_num_subbuf
,
924 /* Switch timer interval in usec */
925 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
926 config_element_switch_timer_interval
,
927 attr
->switch_timer_interval
);
932 /* Read timer interval in usec */
933 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
934 config_element_read_timer_interval
,
935 attr
->read_timer_interval
);
941 ret
= mi_lttng_writer_write_element_string(writer
,
942 config_element_output_type
,
943 attr
->output
== LTTNG_EVENT_SPLICE
?
944 config_output_type_splice
: config_output_type_mmap
);
949 /* Tracefile size in bytes */
950 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
951 config_element_tracefile_size
, attr
->tracefile_size
);
956 /* Count of tracefiles */
957 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
958 config_element_tracefile_count
,
959 attr
->tracefile_count
);
964 /* Live timer interval in usec*/
965 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
966 config_element_live_timer_interval
,
967 attr
->live_timer_interval
);
972 /* Discarded events */
973 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
974 config_element_discarded_events
,
981 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
982 config_element_lost_packets
,
988 /* Closing attributes */
989 ret
= mi_lttng_writer_close_element(writer
);
999 int mi_lttng_event_common_attributes(struct mi_writer
*writer
,
1000 struct lttng_event
*event
)
1003 const char *filter_expression
;
1005 /* Open event element */
1006 ret
= mi_lttng_writer_open_element(writer
, config_element_event
);
1012 ret
= mi_lttng_writer_write_element_string(writer
,
1013 config_element_name
, event
->name
);
1019 ret
= mi_lttng_writer_write_element_string(writer
,
1020 config_element_type
, mi_lttng_eventtype_string(event
->type
));
1025 /* Is event enabled */
1026 ret
= mi_lttng_writer_write_element_bool(writer
,
1027 config_element_enabled
, event
->enabled
);
1032 /* Event filter expression */
1033 ret
= lttng_event_get_filter_expression(event
, &filter_expression
);
1038 if (filter_expression
) {
1039 ret
= mi_lttng_writer_write_element_string(writer
,
1040 config_element_filter_expression
,
1051 static int write_event_exclusions(struct mi_writer
*writer
,
1052 struct lttng_event
*event
)
1056 int exclusion_count
;
1058 /* Open event exclusions */
1059 ret
= mi_lttng_writer_open_element(writer
, config_element_exclusions
);
1064 exclusion_count
= lttng_event_get_exclusion_name_count(event
);
1065 if (exclusion_count
< 0) {
1066 ret
= exclusion_count
;
1070 for (i
= 0; i
< exclusion_count
; i
++) {
1073 ret
= lttng_event_get_exclusion_name(event
, i
, &name
);
1075 /* Close exclusions */
1076 mi_lttng_writer_close_element(writer
);
1080 ret
= mi_lttng_writer_write_element_string(writer
,
1081 config_element_exclusion
, name
);
1083 /* Close exclusions */
1084 mi_lttng_writer_close_element(writer
);
1089 /* Close exclusions */
1090 ret
= mi_lttng_writer_close_element(writer
);
1097 int mi_lttng_event_tracepoint_loglevel(struct mi_writer
*writer
,
1098 struct lttng_event
*event
, enum lttng_domain_type domain
)
1102 /* Event loglevel */
1103 ret
= mi_lttng_writer_write_element_string(writer
,
1104 config_element_loglevel
,
1105 mi_lttng_loglevel_string(event
->loglevel
, domain
));
1110 /* Log level type */
1111 ret
= mi_lttng_writer_write_element_string(writer
,
1112 config_element_loglevel_type
,
1113 mi_lttng_logleveltype_string(event
->loglevel_type
));
1118 /* Event exclusions */
1119 ret
= write_event_exclusions(writer
, event
);
1126 int mi_lttng_event_tracepoint_no_loglevel(struct mi_writer
*writer
,
1127 struct lttng_event
*event
)
1129 /* event exclusion filter */
1130 return write_event_exclusions(writer
, event
);
1134 int mi_lttng_event_function_probe(struct mi_writer
*writer
,
1135 struct lttng_event
*event
)
1139 ret
= mi_lttng_writer_open_element(writer
, config_element_attributes
);
1144 ret
= mi_lttng_writer_open_element(writer
, config_element_probe_attributes
);
1149 if (event
->attr
.probe
.addr
!= 0) {
1150 /* event probe address */
1151 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
1152 config_element_address
, event
->attr
.probe
.addr
);
1157 /* event probe offset */
1158 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
1159 config_element_offset
, event
->attr
.probe
.offset
);
1164 /* event probe symbol_name */
1165 ret
= mi_lttng_writer_write_element_string(writer
,
1166 config_element_symbol_name
, event
->attr
.probe
.symbol_name
);
1172 /* Close probe_attributes and attributes */
1173 ret
= mi_lttng_close_multi_element(writer
, 2);
1179 int mi_lttng_event_function_entry(struct mi_writer
*writer
,
1180 struct lttng_event
*event
)
1184 ret
= mi_lttng_writer_open_element(writer
, config_element_attributes
);
1189 ret
= mi_lttng_writer_open_element(writer
, config_element_probe_attributes
);
1194 /* event probe symbol_name */
1195 ret
= mi_lttng_writer_write_element_string(writer
,
1196 config_element_symbol_name
, event
->attr
.ftrace
.symbol_name
);
1201 /* Close function_attributes and attributes */
1202 ret
= mi_lttng_close_multi_element(writer
, 2);
1208 int mi_lttng_events_open(struct mi_writer
*writer
)
1210 return mi_lttng_writer_open_element(writer
, config_element_events
);
1214 int mi_lttng_event(struct mi_writer
*writer
,
1215 struct lttng_event
*event
, int is_open
, enum lttng_domain_type domain
)
1219 ret
= mi_lttng_event_common_attributes(writer
, event
);
1224 switch (event
->type
) {
1225 case LTTNG_EVENT_TRACEPOINT
:
1227 if (event
->loglevel
!= -1) {
1228 ret
= mi_lttng_event_tracepoint_loglevel(writer
, event
, domain
);
1230 ret
= mi_lttng_event_tracepoint_no_loglevel(writer
, event
);
1234 case LTTNG_EVENT_FUNCTION
:
1236 case LTTNG_EVENT_PROBE
:
1237 ret
= mi_lttng_event_function_probe(writer
, event
);
1239 case LTTNG_EVENT_FUNCTION_ENTRY
:
1240 ret
= mi_lttng_event_function_entry(writer
, event
);
1242 case LTTNG_EVENT_ALL
:
1249 ret
= mi_lttng_writer_close_element(writer
);
1257 int mi_lttng_trackers_open(struct mi_writer
*writer
)
1259 return mi_lttng_writer_open_element(writer
, config_element_trackers
);
1263 int mi_lttng_pid_tracker_open(struct mi_writer
*writer
)
1267 /* Open element pid_tracker */
1268 ret
= mi_lttng_writer_open_element(writer
, config_element_pid_tracker
);
1273 /* Open targets element */
1274 ret
= mi_lttng_targets_open(writer
);
1280 int mi_lttng_pids_open(struct mi_writer
*writer
)
1282 return mi_lttng_writer_open_element(writer
, config_element_pids
);
1286 * TODO: move the listing of pid for user agent to process semantic on
1287 * mi api bump. The use of process element break the mi api.
1290 int mi_lttng_pid(struct mi_writer
*writer
, pid_t pid
, const char *name
,
1295 /* Open pid process */
1296 ret
= mi_lttng_writer_open_element(writer
, config_element_pid
);
1301 /* Writing pid number */
1302 ret
= mi_lttng_writer_write_element_signed_int(writer
,
1303 mi_lttng_element_pid_id
, (int)pid
);
1308 /* Writing name of the process */
1310 ret
= mi_lttng_writer_write_element_string(writer
, config_element_name
,
1319 ret
= mi_lttng_writer_close_element(writer
);
1327 int mi_lttng_targets_open(struct mi_writer
*writer
)
1329 return mi_lttng_writer_open_element(writer
,
1330 config_element_targets
);
1334 int mi_lttng_pid_target(struct mi_writer
*writer
, pid_t pid
, int is_open
)
1338 ret
= mi_lttng_writer_open_element(writer
,
1339 config_element_target_pid
);
1344 /* Writing pid number
1345 * Special case for element all on track untrack command
1346 * All pid is represented as wildcard *
1348 if ((int) pid
== -1) {
1349 ret
= mi_lttng_writer_write_element_string(writer
,
1351 mi_lttng_element_track_untrack_all_wildcard
);
1353 ret
= mi_lttng_writer_write_element_signed_int(writer
,
1354 config_element_pid
, (int) pid
);
1361 ret
= mi_lttng_writer_close_element(writer
);
1372 int mi_lttng_event_fields_open(struct mi_writer
*writer
)
1374 return mi_lttng_writer_open_element(writer
, mi_lttng_element_event_fields
);
1378 int mi_lttng_event_field(struct mi_writer
*writer
,
1379 struct lttng_event_field
*field
)
1383 if (!field
->field_name
[0]) {
1389 ret
= mi_lttng_writer_open_element(writer
, mi_lttng_element_event_field
);
1394 if (!field
->field_name
[0]) {
1399 ret
= mi_lttng_writer_write_element_string(writer
, config_element_name
,
1406 ret
= mi_lttng_writer_write_element_string(writer
, config_element_type
,
1407 mi_lttng_eventfieldtype_string(field
->type
));
1413 ret
= mi_lttng_writer_write_element_signed_int(writer
,
1414 mi_lttng_element_nowrite
, field
->nowrite
);
1420 /* Close field element */
1421 ret
= mi_lttng_writer_close_element(writer
);
1428 int mi_lttng_calibrate(struct mi_writer
*writer
,
1429 struct lttng_calibrate
*calibrate
)
1433 /* Open calibrate element */
1434 ret
= mi_lttng_writer_open_element(writer
, mi_lttng_element_calibrate
);
1439 /* Calibration type */
1440 ret
= mi_lttng_writer_write_element_string(writer
, config_element_type
,
1441 mi_lttng_calibratetype_string(calibrate
->type
));
1446 /* Closing calibrate element */
1447 ret
= mi_lttng_writer_close_element(writer
);
1453 int mi_lttng_perf_counter_context(struct mi_writer
*writer
,
1454 struct lttng_event_perf_counter_ctx
*perf_context
)
1458 /* Open perf_counter_context */
1459 ret
= mi_lttng_writer_open_element(writer
,
1460 mi_lttng_element_perf_counter_context
);
1466 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
1467 config_element_type
, perf_context
->type
);
1473 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
1474 config_element_config
, perf_context
->config
);
1479 /* Name of the perf counter */
1480 ret
= mi_lttng_writer_write_element_string(writer
,
1481 config_element_name
, perf_context
->name
);
1486 /* Close perf_counter_context */
1487 ret
= mi_lttng_writer_close_element(writer
);
1493 int mi_lttng_app_context(struct mi_writer
*writer
,
1494 const char *provider_name
, const char *ctx_name
)
1499 ret
= mi_lttng_writer_open_element(writer
,
1500 config_element_context_app
);
1506 ret
= mi_lttng_writer_write_element_string(writer
,
1507 config_element_context_app_provider_name
,
1514 ret
= mi_lttng_writer_write_element_string(writer
,
1515 config_element_context_app_ctx_name
, ctx_name
);
1521 ret
= mi_lttng_writer_close_element(writer
);
1527 int mi_lttng_context(struct mi_writer
*writer
,
1528 struct lttng_event_context
*context
, int is_open
)
1533 ret
= mi_lttng_writer_open_element(writer
, config_element_context
);
1538 /* Special case for PERF_*_COUNTER
1539 * print the lttng_event_perf_counter_ctx*/
1540 switch (context
->ctx
) {
1541 case LTTNG_EVENT_CONTEXT_PERF_COUNTER
:
1542 case LTTNG_EVENT_CONTEXT_PERF_THREAD_COUNTER
:
1543 case LTTNG_EVENT_CONTEXT_PERF_CPU_COUNTER
:
1545 struct lttng_event_perf_counter_ctx
*perf_context
=
1546 &context
->u
.perf_counter
;
1547 ret
= mi_lttng_perf_counter_context(writer
, perf_context
);
1553 case LTTNG_EVENT_CONTEXT_APP_CONTEXT
:
1555 ret
= mi_lttng_app_context(writer
,
1556 context
->u
.app_ctx
.provider_name
,
1557 context
->u
.app_ctx
.ctx_name
);
1565 const char *type_string
= mi_lttng_event_contexttype_string(
1568 ret
= -LTTNG_ERR_INVALID
;
1572 /* Print context type */
1573 ret
= mi_lttng_writer_write_element_string(writer
,
1574 config_element_type
, type_string
);
1581 ret
= mi_lttng_writer_close_element(writer
);
1589 int mi_lttng_snapshot_output_session_name(struct mi_writer
*writer
,
1590 const char *session_name
)
1594 /* Open session element */
1595 ret
= mi_lttng_writer_open_element(writer
, config_element_session
);
1600 /* Snapshot output list for current session name */
1601 ret
= mi_lttng_writer_write_element_string(writer
, config_element_name
,
1607 /* Open element snapshots (sequence one snapshot) */
1608 ret
= mi_lttng_writer_open_element(writer
, mi_lttng_element_snapshots
);
1618 int mi_lttng_snapshot_list_output(struct mi_writer
*writer
,
1619 struct lttng_snapshot_output
*output
)
1623 /* Open element snapshot output */
1624 ret
= mi_lttng_writer_open_element(writer
,
1625 mi_lttng_element_command_snapshot
);
1630 /* ID of the snapshot output */
1631 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
1632 mi_lttng_element_id
, output
->id
);
1637 /* Name of the output */
1638 ret
= mi_lttng_writer_write_element_string(writer
, config_element_name
,
1644 /* Destination of the output (ctrl_url)*/
1645 ret
= mi_lttng_writer_write_element_string(writer
,
1646 mi_lttng_element_snapshot_ctrl_url
, output
->ctrl_url
);
1651 /* Destination of the output (data_url) */
1652 ret
= mi_lttng_writer_write_element_string(writer
,
1653 mi_lttng_element_snapshot_data_url
, output
->data_url
);
1658 /* total size of all stream combined */
1659 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
1660 mi_lttng_element_snapshot_max_size
, output
->max_size
);
1665 /* Close snapshot output element */
1666 ret
= mi_lttng_writer_close_element(writer
);
1673 int mi_lttng_snapshot_del_output(struct mi_writer
*writer
, int id
,
1674 const char *name
, const char *current_session_name
)
1678 /* Open element del_snapshot */
1679 ret
= mi_lttng_writer_open_element(writer
,
1680 mi_lttng_element_command_snapshot
);
1686 if (id
!= UINT32_MAX
) {
1687 /* "Snapshot output "id" successfully deleted
1688 * for "current_session_name"
1689 * ID of the snapshot output
1691 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
1692 mi_lttng_element_id
, id
);
1697 /* "Snapshot output "name" successfully deleted
1698 * for session "current_session_name"
1699 * Name of the output
1701 ret
= mi_lttng_writer_write_element_string(writer
, config_element_name
,
1708 /* Snapshot was deleted for session "current_session_name"*/
1709 ret
= mi_lttng_writer_write_element_string(writer
,
1710 mi_lttng_element_snapshot_session_name
,
1711 current_session_name
);
1716 /* Close snapshot element */
1717 ret
= mi_lttng_writer_close_element(writer
);
1724 int mi_lttng_snapshot_add_output(struct mi_writer
*writer
,
1725 const char *current_session_name
, const char *n_ptr
,
1726 struct lttng_snapshot_output
*output
)
1730 /* Open element snapshot */
1731 ret
= mi_lttng_writer_open_element(writer
,
1732 mi_lttng_element_command_snapshot
);
1737 /* Snapshot output id */
1738 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
1739 mi_lttng_element_id
, output
->id
);
1744 /* Snapshot output names */
1745 ret
= mi_lttng_writer_write_element_string(writer
,
1746 config_element_name
, n_ptr
);
1751 /* Destination of the output (ctrl_url)*/
1752 ret
= mi_lttng_writer_write_element_string(writer
,
1753 mi_lttng_element_snapshot_ctrl_url
, output
->ctrl_url
);
1758 /* Snapshot added for session "current_session_name"*/
1759 ret
= mi_lttng_writer_write_element_string(writer
,
1760 mi_lttng_element_snapshot_session_name
, current_session_name
);
1765 /* total size of all stream combined */
1766 ret
= mi_lttng_writer_write_element_unsigned_int(writer
,
1767 mi_lttng_element_snapshot_max_size
, output
->max_size
);
1772 /* Close snapshot element */
1773 ret
= mi_lttng_writer_close_element(writer
);
1780 int mi_lttng_snapshot_record(struct mi_writer
*writer
,
1781 const char *current_session_name
, const char *url
,
1782 const char *cmdline_ctrl_url
, const char *cmdline_data_url
)
1786 /* Open element snapshot */
1787 ret
= mi_lttng_writer_open_element(writer
,
1788 mi_lttng_element_command_snapshot
);
1794 * If a valid an URL was given, serialize it,
1795 * else take the command line data and ctrl urls*/
1797 /* Destination of the output (ctrl_url)*/
1798 ret
= mi_lttng_writer_write_element_string(writer
,
1799 mi_lttng_element_snapshot_ctrl_url
, url
);
1803 } else if (cmdline_ctrl_url
) {
1804 /* Destination of the output (ctrl_url)*/
1805 ret
= mi_lttng_writer_write_element_string(writer
,
1806 mi_lttng_element_snapshot_ctrl_url
, cmdline_ctrl_url
);
1811 /* Destination of the output (data_url) */
1812 ret
= mi_lttng_writer_write_element_string(writer
,
1813 mi_lttng_element_snapshot_data_url
, cmdline_data_url
);
1819 /* Close record_snapshot element */
1820 ret
= mi_lttng_writer_close_element(writer
);