2 * Babeltrace trace converter - parameter parsing
4 * Copyright 2016 Philippe Proulx <pproulx@efficios.com>
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
32 #include <babeltrace/babeltrace.h>
33 #include <babeltrace/values.h>
36 #include "babeltrace-cfg.h"
39 * Error printf() macro which prepends "Error: " the first time it's
40 * called. This gives a nicer feel than having a bunch of error prefixes
41 * (since the following lines usually describe the error and possible
42 * solutions), or the error prefix just at the end.
44 #define printf_err(fmt, args...) \
46 if (is_first_error) { \
47 fprintf(stderr, "Error: "); \
48 is_first_error = false; \
50 fprintf(stderr, fmt, ##args); \
53 static bool is_first_error
= true;
55 /* INI-style parsing FSM states */
56 enum ini_parsing_fsm_state
{
57 /* Expect a map key (identifier) */
60 /* Expect an equal character ('=') */
66 /* Expect a negative number value */
67 INI_EXPECT_VALUE_NUMBER_NEG
,
69 /* Expect a comma character (',') */
73 /* INI-style parsing state variables */
74 struct ini_parsing_state
{
75 /* Lexical scanner (owned by this) */
78 /* Output map value object being filled (owned by this) */
79 struct bt_value
*params
;
81 /* Next expected FSM state */
82 enum ini_parsing_fsm_state expecting
;
84 /* Last decoded map key (owned by this) */
87 /* Complete INI-style string to parse (not owned by this) */
90 /* Error buffer (not owned by this) */
94 /* Offset option with "is set" boolean */
100 /* Legacy "ctf"/"lttng-live" format options */
101 struct ctf_legacy_opts
{
102 struct offset_opt offset_s
;
103 struct offset_opt offset_ns
;
104 bool stream_intersection
;
107 /* Legacy "text" format options */
108 struct text_legacy_opts
{
110 * output, dbg_info_dir, dbg_info_target_prefix, names,
111 * and fields are owned by this.
114 GString
*dbg_info_dir
;
115 GString
*dbg_info_target_prefix
;
116 struct bt_value
*names
;
117 struct bt_value
*fields
;
125 bool dbg_info_full_path
;
128 /* Legacy input format format */
129 enum legacy_input_format
{
130 LEGACY_INPUT_FORMAT_NONE
= 0,
131 LEGACY_INPUT_FORMAT_CTF
,
132 LEGACY_INPUT_FORMAT_LTTNG_LIVE
,
135 /* Legacy output format format */
136 enum legacy_output_format
{
137 LEGACY_OUTPUT_FORMAT_NONE
= 0,
138 LEGACY_OUTPUT_FORMAT_TEXT
,
139 LEGACY_OUTPUT_FORMAT_CTF_METADATA
,
140 LEGACY_OUTPUT_FORMAT_DUMMY
,
144 * Prints the "out of memory" error.
147 void print_err_oom(void)
149 printf_err("Out of memory\n");
153 * Prints duplicate legacy output format error.
156 void print_err_dup_legacy_output(void)
158 printf_err("More than one legacy output format specified\n");
162 * Prints duplicate legacy input format error.
165 void print_err_dup_legacy_input(void)
167 printf_err("More than one legacy input format specified\n");
171 * Checks if any of the "text" legacy options is set.
174 bool text_legacy_opts_is_any_set(struct text_legacy_opts
*opts
)
176 return (opts
->output
&& opts
->output
->len
> 0) ||
177 (opts
->dbg_info_dir
&& opts
->dbg_info_dir
->len
> 0) ||
178 (opts
->dbg_info_target_prefix
&&
179 opts
->dbg_info_target_prefix
->len
> 0) ||
180 bt_value_array_size(opts
->names
) > 0 ||
181 bt_value_array_size(opts
->fields
) > 0 ||
182 opts
->no_delta
|| opts
->clock_cycles
|| opts
->clock_seconds
||
183 opts
->clock_date
|| opts
->clock_gmt
||
184 opts
->dbg_info_full_path
;
188 * Checks if any of the "ctf" legacy options is set.
191 bool ctf_legacy_opts_is_any_set(struct ctf_legacy_opts
*opts
)
193 return opts
->offset_s
.is_set
|| opts
->offset_ns
.is_set
||
194 opts
->stream_intersection
;
198 * Appends an "expecting token" error to the INI-style parsing state's
202 void ini_append_error_expecting(struct ini_parsing_state
*state
,
203 GScanner
*scanner
, const char *expecting
)
208 g_string_append_printf(state
->ini_error
, "Expecting %s:\n", expecting
);
210 /* Only print error if there's one line */
211 if (strchr(state
->arg
, '\n') != NULL
|| strlen(state
->arg
) == 0) {
215 g_string_append_printf(state
->ini_error
, "\n %s\n", state
->arg
);
216 pos
= g_scanner_cur_position(scanner
) + 4;
218 if (!g_scanner_eof(scanner
)) {
222 for (i
= 0; i
< pos
; ++i
) {
223 g_string_append_printf(state
->ini_error
, " ");
226 g_string_append_printf(state
->ini_error
, "^\n\n");
230 int ini_handle_state(struct ini_parsing_state
*state
)
233 GTokenType token_type
;
234 struct bt_value
*value
= NULL
;
236 token_type
= g_scanner_get_next_token(state
->scanner
);
237 if (token_type
== G_TOKEN_EOF
) {
238 if (state
->expecting
!= INI_EXPECT_COMMA
) {
239 switch (state
->expecting
) {
240 case INI_EXPECT_EQUAL
:
241 ini_append_error_expecting(state
,
242 state
->scanner
, "'='");
244 case INI_EXPECT_VALUE
:
245 case INI_EXPECT_VALUE_NUMBER_NEG
:
246 ini_append_error_expecting(state
,
247 state
->scanner
, "value");
249 case INI_EXPECT_MAP_KEY
:
250 ini_append_error_expecting(state
,
251 state
->scanner
, "unquoted map key");
264 switch (state
->expecting
) {
265 case INI_EXPECT_MAP_KEY
:
266 if (token_type
!= G_TOKEN_IDENTIFIER
) {
267 ini_append_error_expecting(state
, state
->scanner
,
272 free(state
->last_map_key
);
273 state
->last_map_key
=
274 strdup(state
->scanner
->value
.v_identifier
);
275 if (!state
->last_map_key
) {
276 g_string_append(state
->ini_error
,
281 if (bt_value_map_has_key(state
->params
, state
->last_map_key
)) {
282 g_string_append_printf(state
->ini_error
,
283 "Duplicate parameter key: \"%s\"\n",
284 state
->last_map_key
);
288 state
->expecting
= INI_EXPECT_EQUAL
;
290 case INI_EXPECT_EQUAL
:
291 if (token_type
!= G_TOKEN_CHAR
) {
292 ini_append_error_expecting(state
,
293 state
->scanner
, "'='");
297 if (state
->scanner
->value
.v_char
!= '=') {
298 ini_append_error_expecting(state
,
299 state
->scanner
, "'='");
303 state
->expecting
= INI_EXPECT_VALUE
;
305 case INI_EXPECT_VALUE
:
307 switch (token_type
) {
309 if (state
->scanner
->value
.v_char
== '-') {
310 /* Negative number */
312 INI_EXPECT_VALUE_NUMBER_NEG
;
315 ini_append_error_expecting(state
,
316 state
->scanner
, "value");
322 /* Positive integer */
323 uint64_t int_val
= state
->scanner
->value
.v_int64
;
325 if (int_val
> (1ULL << 63) - 1) {
326 g_string_append_printf(state
->ini_error
,
327 "Integer value %" PRIu64
" is outside the range of a 64-bit signed integer\n",
332 value
= bt_value_integer_create_init(
337 /* Positive floating point number */
338 value
= bt_value_float_create_init(
339 state
->scanner
->value
.v_float
);
343 value
= bt_value_string_create_init(
344 state
->scanner
->value
.v_string
);
346 case G_TOKEN_IDENTIFIER
:
349 * Using symbols would be appropriate here,
350 * but said symbols are allowed as map key,
351 * so it's easier to consider everything an
354 * If one of the known symbols is not
355 * recognized here, then fall back to creating
358 const char *id
= state
->scanner
->value
.v_identifier
;
360 if (!strcmp(id
, "null") || !strcmp(id
, "NULL") ||
361 !strcmp(id
, "nul")) {
362 value
= bt_value_null
;
363 } else if (!strcmp(id
, "true") || !strcmp(id
, "TRUE") ||
364 !strcmp(id
, "yes") ||
365 !strcmp(id
, "YES")) {
366 value
= bt_value_bool_create_init(true);
367 } else if (!strcmp(id
, "false") ||
368 !strcmp(id
, "FALSE") ||
371 value
= bt_value_bool_create_init(false);
373 value
= bt_value_string_create_init(id
);
378 /* Unset value variable will trigger the error */
383 ini_append_error_expecting(state
,
384 state
->scanner
, "value");
388 state
->expecting
= INI_EXPECT_COMMA
;
391 case INI_EXPECT_VALUE_NUMBER_NEG
:
393 switch (token_type
) {
396 /* Negative integer */
397 uint64_t int_val
= state
->scanner
->value
.v_int64
;
399 if (int_val
> (1ULL << 63) - 1) {
400 g_string_append_printf(state
->ini_error
,
401 "Integer value -%" PRIu64
" is outside the range of a 64-bit signed integer\n",
406 value
= bt_value_integer_create_init(
407 -((int64_t) int_val
));
411 /* Negative floating point number */
412 value
= bt_value_float_create_init(
413 -state
->scanner
->value
.v_float
);
416 /* Unset value variable will trigger the error */
421 ini_append_error_expecting(state
,
422 state
->scanner
, "value");
426 state
->expecting
= INI_EXPECT_COMMA
;
429 case INI_EXPECT_COMMA
:
430 if (token_type
!= G_TOKEN_CHAR
) {
431 ini_append_error_expecting(state
,
432 state
->scanner
, "','");
436 if (state
->scanner
->value
.v_char
!= ',') {
437 ini_append_error_expecting(state
,
438 state
->scanner
, "','");
442 state
->expecting
= INI_EXPECT_MAP_KEY
;
454 if (bt_value_map_insert(state
->params
,
455 state
->last_map_key
, value
)) {
456 /* Only override return value on error */
467 * Converts an INI-style argument to an equivalent map value object.
469 * Return value is owned by the caller.
472 struct bt_value
*bt_value_from_ini(const char *arg
, GString
*ini_error
)
474 /* Lexical scanner configuration */
475 GScannerConfig scanner_config
= {
476 /* Skip whitespaces */
477 .cset_skip_characters
= " \t\n",
479 /* Identifier syntax is: [a-zA-Z_][a-zA-Z0-9_.:-]* */
480 .cset_identifier_first
=
484 .cset_identifier_nth
=
489 /* "hello" and "Hello" two different keys */
490 .case_sensitive
= TRUE
,
493 .cpair_comment_single
= NULL
,
494 .skip_comment_multi
= TRUE
,
495 .skip_comment_single
= TRUE
,
496 .scan_comment_multi
= FALSE
,
499 * Do scan identifiers, including 1-char identifiers,
500 * but NULL is a normal identifier.
502 .scan_identifier
= TRUE
,
503 .scan_identifier_1char
= TRUE
,
504 .scan_identifier_NULL
= FALSE
,
507 * No specific symbols: null and boolean "symbols" are
508 * scanned as plain identifiers.
510 .scan_symbols
= FALSE
,
511 .symbol_2_token
= FALSE
,
512 .scope_0_fallback
= FALSE
,
515 * Scan "0b"-, "0"-, and "0x"-prefixed integers, but not
516 * integers prefixed with "$".
522 .scan_hex_dollar
= FALSE
,
524 /* Convert scanned numbers to integer tokens */
525 .numbers_2_int
= TRUE
,
527 /* Support both integers and floating-point numbers */
528 .int_2_float
= FALSE
,
530 /* Scan integers as 64-bit signed integers */
533 /* Only scan double-quoted strings */
534 .scan_string_sq
= FALSE
,
535 .scan_string_dq
= TRUE
,
537 /* Do not converter identifiers to string tokens */
538 .identifier_2_string
= FALSE
,
540 /* Scan characters as G_TOKEN_CHAR token */
541 .char_2_token
= FALSE
,
543 struct ini_parsing_state state
= {
546 .expecting
= INI_EXPECT_MAP_KEY
,
548 .ini_error
= ini_error
,
551 state
.params
= bt_value_map_create();
556 state
.scanner
= g_scanner_new(&scanner_config
);
557 if (!state
.scanner
) {
561 /* Let the scan begin */
562 g_scanner_input_text(state
.scanner
, arg
, strlen(arg
));
565 int ret
= ini_handle_state(&state
);
570 } else if (ret
> 0) {
579 BT_PUT(state
.params
);
583 g_scanner_destroy(state
.scanner
);
586 free(state
.last_map_key
);
591 * Returns the parameters map value object from a command-line
592 * source/sink option's argument. arg is the full argument, including
593 * the plugin/component names, the optional colon, and the optional
596 * Return value is owned by the caller.
599 struct bt_value
*bt_value_from_arg(const char *arg
)
601 struct bt_value
*params
= NULL
;
603 const char *params_string
;
604 GString
*ini_error
= NULL
;
606 /* Isolate parameters */
607 colon
= strchr(arg
, ':');
609 /* No colon: empty parameters */
610 params
= bt_value_map_create();
614 params_string
= colon
+ 1;
615 ini_error
= g_string_new(NULL
);
621 /* Try INI-style parsing */
622 params
= bt_value_from_ini(params_string
, ini_error
);
624 printf_err("%s", ini_error
->str
);
630 g_string_free(ini_error
, TRUE
);
636 * Returns the plugin and component names from a command-line
637 * source/sink option's argument. arg is the full argument, including
638 * the plugin/component names, the optional colon, and the optional
641 * On success, both *plugin and *component are not NULL. *plugin
642 * and *component are owned by the caller.
645 void plugin_component_names_from_arg(const char *arg
, char **plugin
,
651 size_t component_len
;
656 dot
= strchr(arg
, '.');
657 if (!dot
|| dot
== arg
) {
661 colon
= strchr(dot
, ':');
666 colon
= arg
+ strlen(arg
);
669 plugin_len
= dot
- arg
;
670 component_len
= colon
- dot
- 1;
671 if (plugin_len
== 0 || component_len
== 0) {
675 *plugin
= malloc(plugin_len
+ 1);
681 (*plugin
)[plugin_len
] = '\0';
682 memcpy(*plugin
, arg
, plugin_len
);
683 *component
= malloc(component_len
+ 1);
689 (*component
)[component_len
] = '\0';
690 memcpy(*component
, dot
+ 1, component_len
);
697 * Prints the Babeltrace version.
700 void print_version(void)
702 puts("Babeltrace " VERSION
);
706 * Prints the legacy, Babeltrace 1.x command usage. Those options are
707 * still compatible in Babeltrace 2.x, but it is recommended to use
708 * the more generic plugin/component parameters instead of those
709 * hard-coded option names.
712 void print_legacy_usage(FILE *fp
)
714 fprintf(fp
, "Usage: babeltrace [OPTIONS] INPUT...\n");
716 fprintf(fp
, "The following options are compatible with the Babeltrace 1.x options:\n");
718 fprintf(fp
, " --help-legacy Show this help\n");
719 fprintf(fp
, " -V, --version Show version\n");
720 fprintf(fp
, " --clock-force-correlate Assume that clocks are inherently correlated\n");
721 fprintf(fp
, " across traces\n");
722 fprintf(fp
, " -d, --debug Enable debug mode\n");
723 fprintf(fp
, " -i, --input-format=FORMAT Input trace format (default: ctf)\n");
724 fprintf(fp
, " -l, --list List available formats\n");
725 fprintf(fp
, " -o, --output-format=FORMAT Output trace format (default: text)\n");
726 fprintf(fp
, " -v, --verbose Enable verbose output\n");
728 fprintf(fp
, " Available input formats: ctf, lttng-live, ctf-metadata\n");
729 fprintf(fp
, " Available output formats: text, dummy\n");
731 fprintf(fp
, "Input formats specific options:\n");
733 fprintf(fp
, " INPUT... Input trace file(s), directory(ies), or URLs\n");
734 fprintf(fp
, " --clock-offset=SEC Set clock offset to SEC seconds\n");
735 fprintf(fp
, " --clock-offset-ns=NS Set clock offset to NS nanoseconds\n");
736 fprintf(fp
, " --stream-intersection Only process events when all streams are active\n");
738 fprintf(fp
, "text output format specific options:\n");
740 fprintf(fp
, " --clock-cycles Print timestamps in clock cycles\n");
741 fprintf(fp
, " --clock-date Print timestamp dates\n");
742 fprintf(fp
, " --clock-gmt Print timestamps in GMT time zone\n");
743 fprintf(fp
, " (default: local time zone)\n");
744 fprintf(fp
, " --clock-seconds Print the timestamps as [SEC.NS]\n");
745 fprintf(fp
, " (default format: [HH:MM:SS.NS])\n");
746 fprintf(fp
, " --debug-info-dir=DIR Search for debug info in directory DIR\n");
747 fprintf(fp
, " (default: \"/usr/lib/debug\")\n");
748 fprintf(fp
, " --debug-info-full-path Show full debug info source and binary paths\n");
749 fprintf(fp
, " --debug-info-target-prefix=DIR Use directory DIR as a prefix when looking\n");
750 fprintf(fp
, " up executables during debug info analysis\n");
751 fprintf(fp
, " (default: \"/usr/lib/debug\")\n");
752 fprintf(fp
, " -f, --fields=NAME[,NAME]... Print additional fields:\n");
753 fprintf(fp
, " all, trace, trace:hostname, trace:domain,\n");
754 fprintf(fp
, " trace:procname, trace:vpid, loglevel, emf,\n");
755 fprintf(fp
, " callsite\n");
756 fprintf(fp
, " (default: trace:hostname, trace:procname,\n");
757 fprintf(fp
, " trace:vpid)\n");
758 fprintf(fp
, " -n, --names=NAME[,NAME]... Print field names:\n");
759 fprintf(fp
, " payload (or arg or args)\n");
760 fprintf(fp
, " none, all, scope, header, context (or ctx)\n");
761 fprintf(fp
, " (default: payload, context)\n");
762 fprintf(fp
, " --no-delta Do not print time delta between consecutive\n");
763 fprintf(fp
, " events\n");
764 fprintf(fp
, " -w, --output=PATH Write output to PATH (default: standard output)\n");
768 * Prints the Babeltrace 2.x usage.
771 void print_usage(FILE *fp
)
773 fprintf(fp
, "Usage: babeltrace [OPTIONS]\n");
775 fprintf(fp
, " -h --help Show this help\n");
776 fprintf(fp
, " --help-legacy Show Babeltrace 1.x legacy options\n");
777 fprintf(fp
, " -d, --debug Enable debug mode\n");
778 fprintf(fp
, " -l, --list List available plugins and their components\n");
779 fprintf(fp
, " -p, --plugin-path=PATH[:PATH]... Set paths from which dynamic plugins can be\n");
780 fprintf(fp
, " loaded to PATH\n");
781 fprintf(fp
, " -i, --source=SOURCE Add source plugin/component SOURCE and its\n");
782 fprintf(fp
, " parameters to the active sources (may be\n");
783 fprintf(fp
, " repeated; see the exact format below)\n");
784 fprintf(fp
, " -o, --sink=SINK Add sink plugin/component SINK and its\n");
785 fprintf(fp
, " parameters to the active sinks (may be\n");
786 fprintf(fp
, " repeated; see the exact format below)\n");
787 fprintf(fp
, " -v, --verbose Enable verbose output\n");
788 fprintf(fp
, " -V, --version Show version\n");
790 fprintf(fp
, "SOURCE/SINK argument format:\n");
792 fprintf(fp
, " One of:\n");
794 fprintf(fp
, " PLUGIN.COMPONENT\n");
795 fprintf(fp
, " Load component COMPONENT from plugin PLUGIN with its default parameters.\n");
797 fprintf(fp
, " PLUGIN.COMPONENT:PARAM=VALUE[,PARAM=VALUE]...\n");
798 fprintf(fp
, " Load component COMPONENT from plugin PLUGIN with the specified parameters.\n");
800 fprintf(fp
, " The parameter string is a comma-separated list of PARAM=VALUE assignments,\n");
801 fprintf(fp
, " where PARAM is the parameter name (C identifier plus [:.-] characters), and\n");
802 fprintf(fp
, " VALUE can be one of:\n");
804 fprintf(fp
, " * \"null\", \"nul\", \"NULL\": null value (no double quotes)\n");
805 fprintf(fp
, " * \"true\", \"TRUE\", \"yes\", \"YES\": true boolean value (no double quotes)\n");
806 fprintf(fp
, " * \"false\", \"FALSE\", \"no\", \"NO\": false boolean value (no double quotes)\n");
807 fprintf(fp
, " * Binary (\"0b\" prefix), octal (\"0\" prefix), decimal, or\n");
808 fprintf(fp
, " hexadecimal (\"0x\" prefix) signed 64-bit integer\n");
809 fprintf(fp
, " * Double precision floating point number (scientific notation is accepted)\n");
810 fprintf(fp
, " * Unquoted string with no special characters, and not matching any of\n");
811 fprintf(fp
, " the null and boolean value symbols above\n");
812 fprintf(fp
, " * Double-quoted string (accepts escape characters)\n");
814 fprintf(fp
, " Example:\n");
816 fprintf(fp
, " plugin.comp:many=null, fresh=yes, condition=false, squirrel=-782329,\n");
817 fprintf(fp
, " observe=3.14, simple=beef, needs-quotes=\"some string\",\n");
818 fprintf(fp
, " escape.chars-are:allowed=\"this is a \\\" double quote\"\n");
822 * Destroys a component configuration.
825 void bt_config_component_destroy(struct bt_object
*obj
)
827 struct bt_config_component
*bt_config_component
=
828 container_of(obj
, struct bt_config_component
, base
);
834 if (bt_config_component
->plugin_name
) {
835 g_string_free(bt_config_component
->plugin_name
, TRUE
);
838 if (bt_config_component
->component_name
) {
839 g_string_free(bt_config_component
->component_name
, TRUE
);
842 BT_PUT(bt_config_component
->params
);
843 g_free(bt_config_component
);
850 * Creates a component configuration using the given plugin name,
851 * component name, and parameters. plugin_name and component_name
852 * are copied (belong to the return value), and a reference to
853 * params is acquired.
855 * Return value is owned by the caller.
858 struct bt_config_component
*bt_config_component_create(const char *plugin_name
,
859 const char *component_name
, struct bt_value
*params
)
861 struct bt_config_component
*cfg_component
= NULL
;
863 cfg_component
= g_new0(struct bt_config_component
, 1);
864 if (!cfg_component
) {
869 bt_object_init(cfg_component
, bt_config_component_destroy
);
870 cfg_component
->plugin_name
= g_string_new(plugin_name
);
871 if (!cfg_component
->plugin_name
) {
876 cfg_component
->component_name
= g_string_new(component_name
);
877 if (!cfg_component
->component_name
) {
882 cfg_component
->params
= bt_get(params
);
886 BT_PUT(cfg_component
);
889 return cfg_component
;
893 * Creates a component configuration from a command-line source/sink
894 * option's argument. arg is the full argument, including
895 * the plugin/component names, the optional colon, and the optional
899 struct bt_config_component
*bt_config_component_from_arg(const char *arg
)
901 struct bt_config_component
*bt_config_component
= NULL
;
903 char *component_name
;
904 struct bt_value
*params
= NULL
;
906 plugin_component_names_from_arg(arg
, &plugin_name
, &component_name
);
907 if (!plugin_name
|| !component_name
) {
908 printf_err("Cannot get plugin or component name\n");
912 params
= bt_value_from_arg(arg
);
914 printf_err("Cannot parse parameters\n");
918 bt_config_component
= bt_config_component_create(plugin_name
,
919 component_name
, params
);
920 if (!bt_config_component
) {
927 BT_PUT(bt_config_component
);
931 free(component_name
);
933 return bt_config_component
;
937 * Destroys a configuration.
940 void bt_config_destroy(struct bt_object
*obj
)
942 struct bt_config
*bt_config
=
943 container_of(obj
, struct bt_config
, base
);
949 if (bt_config
->sources
) {
950 g_ptr_array_free(bt_config
->sources
, TRUE
);
953 if (bt_config
->sinks
) {
954 g_ptr_array_free(bt_config
->sinks
, TRUE
);
957 BT_PUT(bt_config
->plugin_paths
);
965 * Extracts the various paths from the string arg, delimited by ':',
966 * and converts them to an array value object.
968 * Returned array value object is empty if arg is empty.
970 * Return value is owned by the caller.
973 struct bt_value
*plugin_paths_from_arg(const char *arg
)
975 struct bt_value
*plugin_paths
;
976 const char *at
= arg
;
977 const char *end
= arg
+ strlen(arg
);
979 plugin_paths
= bt_value_array_create();
988 const char *next_colon
;
990 next_colon
= strchr(at
, ':');
991 if (next_colon
== at
) {
993 * Empty path: try next character (supported
994 * to conform to the typical parsing of $PATH).
998 } else if (!next_colon
) {
999 /* No more colon: use the remaining */
1000 next_colon
= arg
+ strlen(arg
);
1003 path
= g_string_new(NULL
);
1009 g_string_append_len(path
, at
, next_colon
- at
);
1010 at
= next_colon
+ 1;
1011 ret
= bt_value_array_append_string(plugin_paths
, path
->str
);
1012 g_string_free(path
, TRUE
);
1022 BT_PUT(plugin_paths
);
1025 return plugin_paths
;
1029 * Creates a simple lexical scanner for parsing comma-delimited names
1032 * Return value is owned by the caller.
1035 GScanner
*create_csv_identifiers_scanner(void)
1037 GScannerConfig scanner_config
= {
1038 .cset_skip_characters
= " \t\n",
1039 .cset_identifier_first
= G_CSET_a_2_z G_CSET_A_2_Z
"_",
1040 .cset_identifier_nth
= G_CSET_a_2_z G_CSET_A_2_Z
":_-",
1041 .case_sensitive
= TRUE
,
1042 .cpair_comment_single
= NULL
,
1043 .skip_comment_multi
= TRUE
,
1044 .skip_comment_single
= TRUE
,
1045 .scan_comment_multi
= FALSE
,
1046 .scan_identifier
= TRUE
,
1047 .scan_identifier_1char
= TRUE
,
1048 .scan_identifier_NULL
= FALSE
,
1049 .scan_symbols
= FALSE
,
1050 .symbol_2_token
= FALSE
,
1051 .scope_0_fallback
= FALSE
,
1052 .scan_binary
= FALSE
,
1053 .scan_octal
= FALSE
,
1054 .scan_float
= FALSE
,
1056 .scan_hex_dollar
= FALSE
,
1057 .numbers_2_int
= FALSE
,
1058 .int_2_float
= FALSE
,
1059 .store_int64
= FALSE
,
1060 .scan_string_sq
= FALSE
,
1061 .scan_string_dq
= FALSE
,
1062 .identifier_2_string
= FALSE
,
1063 .char_2_token
= TRUE
,
1066 return g_scanner_new(&scanner_config
);
1070 * Inserts a string (if exists and not empty) or null to a map value
1074 enum bt_value_status
map_insert_string_or_null(struct bt_value
*map
,
1075 const char *key
, GString
*string
)
1077 enum bt_value_status ret
;
1079 if (string
&& string
->len
> 0) {
1080 ret
= bt_value_map_insert_string(map
, key
, string
->str
);
1082 ret
= bt_value_map_insert(map
, key
, bt_value_null
);
1088 * Converts a comma-delimited list of known names (--names option) to
1089 * an array value object containing those names as string value objects.
1091 * Return value is owned by the caller.
1094 struct bt_value
*names_from_arg(const char *arg
)
1096 GScanner
*scanner
= NULL
;
1097 struct bt_value
*names
= NULL
;
1098 bool found_all
= false, found_none
= false, found_item
= false;
1100 names
= bt_value_array_create();
1106 scanner
= create_csv_identifiers_scanner();
1112 g_scanner_input_text(scanner
, arg
, strlen(arg
));
1115 GTokenType token_type
= g_scanner_get_next_token(scanner
);
1117 switch (token_type
) {
1118 case G_TOKEN_IDENTIFIER
:
1120 const char *identifier
= scanner
->value
.v_identifier
;
1122 if (!strcmp(identifier
, "payload") ||
1123 !strcmp(identifier
, "args") ||
1124 !strcmp(identifier
, "arg")) {
1126 if (bt_value_array_append_string(names
,
1130 } else if (!strcmp(identifier
, "context") ||
1131 !strcmp(identifier
, "ctx")) {
1133 if (bt_value_array_append_string(names
,
1137 } else if (!strcmp(identifier
, "scope") ||
1138 !strcmp(identifier
, "header")) {
1140 if (bt_value_array_append_string(names
,
1144 } else if (!strcmp(identifier
, "all")) {
1146 if (bt_value_array_append_string(names
,
1150 } else if (!strcmp(identifier
, "none")) {
1152 if (bt_value_array_append_string(names
,
1157 printf_err("Unknown field name: \"%s\"\n",
1173 if (found_none
&& found_all
) {
1174 printf_err("Only either \"all\" or \"none\" can be specified in the list given to the \"--names\" option, but not both.\n");
1178 * Legacy behavior is to clear the defaults (show none) when at
1179 * least one item is specified.
1181 if (found_item
&& !found_none
&& !found_all
) {
1182 if (bt_value_array_append_string(names
, "none")) {
1187 g_scanner_destroy(scanner
);
1194 g_scanner_destroy(scanner
);
1201 * Converts a comma-delimited list of known fields (--fields option) to
1202 * an array value object containing those fields as string
1205 * Return value is owned by the caller.
1208 struct bt_value
*fields_from_arg(const char *arg
)
1210 GScanner
*scanner
= NULL
;
1211 struct bt_value
*fields
;
1213 fields
= bt_value_array_create();
1219 scanner
= create_csv_identifiers_scanner();
1225 g_scanner_input_text(scanner
, arg
, strlen(arg
));
1228 GTokenType token_type
= g_scanner_get_next_token(scanner
);
1230 switch (token_type
) {
1231 case G_TOKEN_IDENTIFIER
:
1233 const char *identifier
= scanner
->value
.v_identifier
;
1235 if (!strcmp(identifier
, "trace") ||
1236 !strcmp(identifier
, "trace:hostname") ||
1237 !strcmp(identifier
, "trace:domain") ||
1238 !strcmp(identifier
, "trace:procname") ||
1239 !strcmp(identifier
, "trace:vpid") ||
1240 !strcmp(identifier
, "loglevel") ||
1241 !strcmp(identifier
, "emf") ||
1242 !strcmp(identifier
, "callsite") ||
1243 !strcmp(identifier
, "all")) {
1244 if (bt_value_array_append_string(fields
,
1249 printf_err("Unknown field name: \"%s\"\n",
1271 g_scanner_destroy(scanner
);
1277 * Inserts the equivalent "prefix-name" true boolean value objects into
1278 * map_obj where the names are in array_obj.
1281 int insert_flat_names_fields_from_array(struct bt_value
*map_obj
,
1282 struct bt_value
*array_obj
, const char *prefix
)
1286 GString
*tmpstr
= NULL
, *default_value
= NULL
;
1289 * array_obj may be NULL if no CLI options were specified to
1290 * trigger its creation.
1296 tmpstr
= g_string_new(NULL
);
1303 default_value
= g_string_new(NULL
);
1304 if (!default_value
) {
1310 for (i
= 0; i
< bt_value_array_size(array_obj
); i
++) {
1311 struct bt_value
*str_obj
= bt_value_array_get(array_obj
, i
);
1313 bool is_default
= false;
1316 printf_err("Unexpected error\n");
1321 ret
= bt_value_string_get(str_obj
, &suffix
);
1324 printf_err("Unexpected error\n");
1328 g_string_assign(tmpstr
, prefix
);
1329 g_string_append(tmpstr
, "-");
1331 /* Special-case for "all" and "none". */
1332 if (!strcmp(suffix
, "all")) {
1334 g_string_assign(default_value
, "show");
1335 } else if (!strcmp(suffix
, "none")) {
1337 g_string_assign(default_value
, "hide");
1340 g_string_append(tmpstr
, "default");
1341 ret
= map_insert_string_or_null(map_obj
,
1349 g_string_append(tmpstr
, suffix
);
1350 ret
= bt_value_map_insert_bool(map_obj
, tmpstr
->str
,
1360 if (default_value
) {
1361 g_string_free(default_value
, TRUE
);
1364 g_string_free(tmpstr
, TRUE
);
1371 * Returns the parameters (map value object) corresponding to the
1372 * legacy text format options.
1374 * Return value is owned by the caller.
1377 struct bt_value
*params_from_text_legacy_opts(
1378 struct text_legacy_opts
*text_legacy_opts
)
1380 struct bt_value
*params
;
1382 params
= bt_value_map_create();
1388 if (map_insert_string_or_null(params
, "output-path",
1389 text_legacy_opts
->output
)) {
1394 if (map_insert_string_or_null(params
, "debug-info-dir",
1395 text_legacy_opts
->dbg_info_dir
)) {
1400 if (map_insert_string_or_null(params
, "debug-info-target-prefix",
1401 text_legacy_opts
->dbg_info_target_prefix
)) {
1406 if (bt_value_map_insert_bool(params
, "debug-info-full-path",
1407 text_legacy_opts
->dbg_info_full_path
)) {
1412 if (bt_value_map_insert_bool(params
, "no-delta",
1413 text_legacy_opts
->no_delta
)) {
1418 if (bt_value_map_insert_bool(params
, "clock-cycles",
1419 text_legacy_opts
->clock_cycles
)) {
1424 if (bt_value_map_insert_bool(params
, "clock-seconds",
1425 text_legacy_opts
->clock_seconds
)) {
1430 if (bt_value_map_insert_bool(params
, "clock-date",
1431 text_legacy_opts
->clock_date
)) {
1436 if (bt_value_map_insert_bool(params
, "clock-gmt",
1437 text_legacy_opts
->clock_gmt
)) {
1442 if (insert_flat_names_fields_from_array(params
,
1443 text_legacy_opts
->names
, "name")) {
1447 if (insert_flat_names_fields_from_array(params
,
1448 text_legacy_opts
->fields
, "field")) {
1462 int append_sinks_from_legacy_opts(GPtrArray
*sinks
,
1463 enum legacy_output_format legacy_output_format
,
1464 struct text_legacy_opts
*text_legacy_opts
)
1467 struct bt_value
*params
= NULL
;
1468 const char *plugin_name
;
1469 const char *component_name
;
1470 struct bt_config_component
*bt_config_component
= NULL
;
1472 switch (legacy_output_format
) {
1473 case LEGACY_OUTPUT_FORMAT_TEXT
:
1474 plugin_name
= "text";
1475 component_name
= "text";
1477 case LEGACY_OUTPUT_FORMAT_CTF_METADATA
:
1478 plugin_name
= "ctf";
1479 component_name
= "metadata-text";
1481 case LEGACY_OUTPUT_FORMAT_DUMMY
:
1482 plugin_name
= "dummy";
1483 component_name
= "dummy";
1490 if (legacy_output_format
== LEGACY_OUTPUT_FORMAT_TEXT
) {
1491 /* Legacy "text" output format has parameters */
1492 params
= params_from_text_legacy_opts(text_legacy_opts
);
1498 * Legacy "dummy" and "ctf-metadata" output formats do
1499 * not have parameters.
1501 params
= bt_value_map_create();
1508 /* Create a component configuration */
1509 bt_config_component
= bt_config_component_create(plugin_name
,
1510 component_name
, params
);
1511 if (!bt_config_component
) {
1515 /* Move created component configuration to the array */
1516 g_ptr_array_add(sinks
, bt_config_component
);
1530 * Returns the parameters (map value object) corresponding to the
1531 * given legacy CTF format options.
1533 * Return value is owned by the caller.
1536 struct bt_value
*params_from_ctf_legacy_opts(
1537 struct ctf_legacy_opts
*ctf_legacy_opts
)
1539 struct bt_value
*params
;
1541 params
= bt_value_map_create();
1547 if (bt_value_map_insert_integer(params
, "offset-s",
1548 ctf_legacy_opts
->offset_s
.value
)) {
1553 if (bt_value_map_insert_integer(params
, "offset-ns",
1554 ctf_legacy_opts
->offset_ns
.value
)) {
1559 if (bt_value_map_insert_bool(params
, "stream-intersection",
1560 ctf_legacy_opts
->stream_intersection
)) {
1575 int append_sources_from_legacy_opts(GPtrArray
*sources
,
1576 enum legacy_input_format legacy_input_format
,
1577 struct ctf_legacy_opts
*ctf_legacy_opts
,
1578 struct bt_value
*legacy_input_paths
)
1582 struct bt_value
*base_params
;
1583 struct bt_value
*params
= NULL
;
1584 struct bt_value
*input_path
= NULL
;
1585 struct bt_value
*input_path_copy
= NULL
;
1586 const char *input_key
;
1587 const char *component_name
;
1589 switch (legacy_input_format
) {
1590 case LEGACY_INPUT_FORMAT_CTF
:
1592 component_name
= "fs";
1594 case LEGACY_INPUT_FORMAT_LTTNG_LIVE
:
1596 component_name
= "lttng-live";
1603 base_params
= params_from_ctf_legacy_opts(ctf_legacy_opts
);
1608 for (i
= 0; i
< bt_value_array_size(legacy_input_paths
); i
++) {
1609 struct bt_config_component
*bt_config_component
= NULL
;
1611 /* Copy base parameters as current parameters */
1612 params
= bt_value_copy(base_params
);
1617 /* Get current input path string value object */
1618 input_path
= bt_value_array_get(legacy_input_paths
, i
);
1623 /* Copy current input path value object */
1624 input_path_copy
= bt_value_copy(input_path
);
1625 if (!input_path_copy
) {
1629 /* Insert input path value object into current parameters */
1630 ret
= bt_value_map_insert(params
, input_key
, input_path_copy
);
1635 /* Create a component configuration */
1636 bt_config_component
= bt_config_component_create("ctf",
1637 component_name
, params
);
1638 if (!bt_config_component
) {
1642 /* Move created component configuration to the array */
1643 g_ptr_array_add(sources
, bt_config_component
);
1645 /* Put current stuff */
1647 BT_PUT(input_path_copy
);
1657 BT_PUT(base_params
);
1660 BT_PUT(input_path_copy
);
1665 * Escapes a string for the shell. The string is escaped knowing that
1666 * it's a parameter string value (double-quoted), and that it will be
1667 * entered between single quotes in the shell.
1669 * Return value is owned by the caller.
1672 char *str_shell_escape(const char *input
)
1675 const char *at
= input
;
1676 GString
*str
= g_string_new(NULL
);
1682 while (*at
!= '\0') {
1685 g_string_append(str
, "\\\\");
1688 g_string_append(str
, "\\\"");
1691 g_string_append(str
, "'\"'\"'");
1694 g_string_append(str
, "\\n");
1697 g_string_append(str
, "\\t");
1700 g_string_append_c(str
, *at
);
1710 g_string_free(str
, FALSE
);
1717 int append_prefixed_flag_params(GString
*str
, struct bt_value
*flags
,
1727 for (i
= 0; i
< bt_value_array_size(flags
); i
++) {
1728 struct bt_value
*value
= bt_value_array_get(flags
, i
);
1736 if (bt_value_string_get(value
, &flag
)) {
1742 g_string_append_printf(str
, ",%s-%s=true", prefix
, flag
);
1751 * Appends a boolean parameter string.
1754 void g_string_append_bool_param(GString
*str
, const char *name
, bool value
)
1756 g_string_append_printf(str
, ",%s=%s", name
, value
? "true" : "false");
1760 * Appends a path parameter string, or null if it's empty.
1763 int g_string_append_string_path_param(GString
*str
, const char *name
,
1768 if (path
->len
> 0) {
1769 char *escaped_path
= str_shell_escape(path
->str
);
1771 if (!escaped_path
) {
1776 g_string_append_printf(str
, "%s=\"%s\"", name
, escaped_path
);
1779 g_string_append_printf(str
, "%s=null", name
);
1792 * Prints the non-legacy sink options equivalent to the specified
1793 * legacy output format options.
1796 void print_output_legacy_to_sinks(
1797 enum legacy_output_format legacy_output_format
,
1798 struct text_legacy_opts
*text_legacy_opts
)
1800 const char *input_format
;
1801 GString
*str
= NULL
;
1803 str
= g_string_new(" ");
1809 switch (legacy_output_format
) {
1810 case LEGACY_OUTPUT_FORMAT_TEXT
:
1811 input_format
= "text";
1813 case LEGACY_OUTPUT_FORMAT_CTF_METADATA
:
1814 input_format
= "ctf-metadata";
1816 case LEGACY_OUTPUT_FORMAT_DUMMY
:
1817 input_format
= "dummy";
1823 printf_err("Both \"%s\" legacy output format and non-legacy sink(s) specified.\n\n",
1825 printf_err("Specify the following non-legacy sink instead of the legacy \"%s\"\noutput format options:\n\n",
1827 g_string_append(str
, "-o ");
1829 switch (legacy_output_format
) {
1830 case LEGACY_OUTPUT_FORMAT_TEXT
:
1831 g_string_append(str
, "text.text");
1833 case LEGACY_OUTPUT_FORMAT_CTF_METADATA
:
1834 g_string_append(str
, "ctf.metadata-text");
1836 case LEGACY_OUTPUT_FORMAT_DUMMY
:
1837 g_string_append(str
, "dummy.dummy");
1843 if (legacy_output_format
== LEGACY_OUTPUT_FORMAT_TEXT
&&
1844 text_legacy_opts_is_any_set(text_legacy_opts
)) {
1847 g_string_append(str
, ":'");
1849 if (g_string_append_string_path_param(str
, "output-path",
1850 text_legacy_opts
->output
)) {
1854 g_string_append(str
, ",");
1856 if (g_string_append_string_path_param(str
, "debug-info-dir",
1857 text_legacy_opts
->dbg_info_dir
)) {
1861 g_string_append(str
, ",");
1863 if (g_string_append_string_path_param(str
,
1864 "debug-info-target-prefix",
1865 text_legacy_opts
->dbg_info_target_prefix
)) {
1869 g_string_append_bool_param(str
, "no-delta",
1870 text_legacy_opts
->no_delta
);
1871 g_string_append_bool_param(str
, "clock-cycles",
1872 text_legacy_opts
->clock_cycles
);
1873 g_string_append_bool_param(str
, "clock-seconds",
1874 text_legacy_opts
->clock_seconds
);
1875 g_string_append_bool_param(str
, "clock-date",
1876 text_legacy_opts
->clock_date
);
1877 g_string_append_bool_param(str
, "clock-gmt",
1878 text_legacy_opts
->clock_gmt
);
1879 ret
= append_prefixed_flag_params(str
, text_legacy_opts
->names
,
1885 ret
= append_prefixed_flag_params(str
, text_legacy_opts
->fields
,
1891 /* Remove last comma and close single quote */
1892 g_string_append(str
, "'");
1895 printf_err("%s\n\n", str
->str
);
1899 g_string_free(str
, TRUE
);
1905 * Prints the non-legacy source options equivalent to the specified
1906 * legacy input format options.
1909 void print_input_legacy_to_sources(enum legacy_input_format legacy_input_format
,
1910 struct bt_value
*legacy_input_paths
,
1911 struct ctf_legacy_opts
*ctf_legacy_opts
)
1913 const char *input_format
;
1914 GString
*str
= NULL
;
1917 str
= g_string_new(" ");
1923 switch (legacy_input_format
) {
1924 case LEGACY_INPUT_FORMAT_CTF
:
1925 input_format
= "ctf";
1927 case LEGACY_INPUT_FORMAT_LTTNG_LIVE
:
1928 input_format
= "lttng-live";
1934 printf_err("Both \"%s\" legacy input format and non-legacy source(s) specified.\n\n",
1936 printf_err("Specify the following non-legacy source(s) instead of the legacy \"%s\"\ninput format options and positional arguments:\n\n",
1939 for (i
= 0; i
< bt_value_array_size(legacy_input_paths
); i
++) {
1940 struct bt_value
*input_value
=
1941 bt_value_array_get(legacy_input_paths
, i
);
1942 const char *input
= NULL
;
1943 char *escaped_input
;
1946 assert(input_value
);
1947 ret
= bt_value_string_get(input_value
, &input
);
1948 BT_PUT(input_value
);
1949 assert(!ret
&& input
);
1950 escaped_input
= str_shell_escape(input
);
1951 if (!escaped_input
) {
1956 g_string_append(str
, "-i ctf.");
1958 switch (legacy_input_format
) {
1959 case LEGACY_INPUT_FORMAT_CTF
:
1960 g_string_append(str
, "fs:'path=\"");
1962 case LEGACY_INPUT_FORMAT_LTTNG_LIVE
:
1963 g_string_append(str
, "lttng-live:'url=\"");
1969 g_string_append(str
, escaped_input
);
1970 g_string_append(str
, "\"");
1971 g_string_append_printf(str
, ",offset-s=%" PRId64
,
1972 ctf_legacy_opts
->offset_s
.value
);
1973 g_string_append_printf(str
, ",offset-ns=%" PRId64
,
1974 ctf_legacy_opts
->offset_ns
.value
);
1975 g_string_append_bool_param(str
, "stream-intersection",
1976 ctf_legacy_opts
->stream_intersection
);
1977 g_string_append(str
, "' ");
1978 g_free(escaped_input
);
1981 printf_err("%s\n\n", str
->str
);
1985 g_string_free(str
, TRUE
);
1991 * Validates a given configuration, with optional legacy input and
1992 * output formats options. Prints useful error messages if anything
1995 * Returns true when the configuration is valid.
1998 bool validate_cfg(struct bt_config
*cfg
,
1999 enum legacy_input_format
*legacy_input_format
,
2000 enum legacy_output_format
*legacy_output_format
,
2001 struct bt_value
*legacy_input_paths
,
2002 struct ctf_legacy_opts
*ctf_legacy_opts
,
2003 struct text_legacy_opts
*text_legacy_opts
)
2005 bool legacy_input
= false;
2006 bool legacy_output
= false;
2008 /* Determine if the input and output should be legacy-style */
2009 if (*legacy_input_format
!= LEGACY_INPUT_FORMAT_NONE
||
2010 cfg
->sources
->len
== 0 ||
2011 !bt_value_array_is_empty(legacy_input_paths
) ||
2012 ctf_legacy_opts_is_any_set(ctf_legacy_opts
)) {
2013 legacy_input
= true;
2016 if (*legacy_output_format
!= LEGACY_OUTPUT_FORMAT_NONE
||
2017 cfg
->sinks
->len
== 0 ||
2018 text_legacy_opts_is_any_set(text_legacy_opts
)) {
2019 legacy_output
= true;
2023 /* If no legacy input format was specified, default to CTF */
2024 if (*legacy_input_format
== LEGACY_INPUT_FORMAT_NONE
) {
2025 *legacy_input_format
= LEGACY_INPUT_FORMAT_CTF
;
2028 /* Make sure at least one input path exists */
2029 if (bt_value_array_is_empty(legacy_input_paths
)) {
2030 switch (*legacy_input_format
) {
2031 case LEGACY_INPUT_FORMAT_CTF
:
2032 printf_err("No input path specified for legacy \"ctf\" input format\n");
2034 case LEGACY_INPUT_FORMAT_LTTNG_LIVE
:
2035 printf_err("No URL specified for legacy \"lttng-live\" input format\n");
2043 /* Make sure no non-legacy sources are specified */
2044 if (cfg
->sources
->len
!= 0) {
2045 print_input_legacy_to_sources(*legacy_input_format
,
2046 legacy_input_paths
, ctf_legacy_opts
);
2051 if (legacy_output
) {
2053 * If no legacy output format was specified, default to
2056 if (*legacy_output_format
== LEGACY_OUTPUT_FORMAT_NONE
) {
2057 *legacy_output_format
= LEGACY_OUTPUT_FORMAT_TEXT
;
2061 * If any "text" option was specified, the output must be
2064 if (text_legacy_opts_is_any_set(text_legacy_opts
) &&
2065 *legacy_output_format
!=
2066 LEGACY_OUTPUT_FORMAT_TEXT
) {
2067 printf_err("Options for legacy \"text\" output format specified with a different legacy output format\n");
2071 /* Make sure no non-legacy sinks are specified */
2072 if (cfg
->sinks
->len
!= 0) {
2073 print_output_legacy_to_sinks(*legacy_output_format
,
2080 * If the output is the legacy "ctf-metadata" format, then the
2081 * input should be the legacy "ctf" input format.
2083 if (*legacy_output_format
== LEGACY_OUTPUT_FORMAT_CTF_METADATA
&&
2084 *legacy_input_format
!= LEGACY_INPUT_FORMAT_CTF
) {
2085 printf_err("Legacy \"ctf-metadata\" output format requires using legacy \"ctf\" input format\n");
2096 * Parses a 64-bit signed integer.
2098 * Returns a negative value if anything goes wrong.
2101 int parse_int64(const char *arg
, int64_t *val
)
2106 *val
= strtoll(arg
, &endptr
, 0);
2107 if (*endptr
!= '\0' || arg
== endptr
|| errno
!= 0) {
2119 OPT_CLOCK_FORCE_CORRELATE
,
2122 OPT_CLOCK_OFFSET_NS
,
2126 OPT_DEBUG_INFO_FULL_PATH
,
2127 OPT_DEBUG_INFO_TARGET_PREFIX
,
2140 OPT_STREAM_INTERSECTION
,
2145 /* popt long option descriptions */
2146 static struct poptOption long_options
[] = {
2147 /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
2148 { "clock-cycles", '\0', POPT_ARG_NONE
, NULL
, OPT_CLOCK_CYCLES
, NULL
, NULL
},
2149 { "clock-date", '\0', POPT_ARG_NONE
, NULL
, OPT_CLOCK_DATE
, NULL
, NULL
},
2150 { "clock-force-correlate", '\0', POPT_ARG_NONE
, NULL
, OPT_CLOCK_FORCE_CORRELATE
, NULL
, NULL
},
2151 { "clock-gmt", '\0', POPT_ARG_NONE
, NULL
, OPT_CLOCK_GMT
, NULL
, NULL
},
2152 { "clock-offset", '\0', POPT_ARG_STRING
, NULL
, OPT_CLOCK_OFFSET
, NULL
, NULL
},
2153 { "clock-offset-ns", '\0', POPT_ARG_STRING
, NULL
, OPT_CLOCK_OFFSET_NS
, NULL
, NULL
},
2154 { "clock-seconds", '\0', POPT_ARG_NONE
, NULL
, OPT_CLOCK_SECONDS
, NULL
, NULL
},
2155 { "debug", 'd', POPT_ARG_NONE
, NULL
, OPT_DEBUG
, NULL
, NULL
},
2156 { "debug-info-dir", 0, POPT_ARG_STRING
, NULL
, OPT_DEBUG_INFO_DIR
, NULL
, NULL
},
2157 { "debug-info-full-path", 0, POPT_ARG_NONE
, NULL
, OPT_DEBUG_INFO_FULL_PATH
, NULL
, NULL
},
2158 { "debug-info-target-prefix", 0, POPT_ARG_STRING
, NULL
, OPT_DEBUG_INFO_TARGET_PREFIX
, NULL
, NULL
},
2159 { "fields", 'f', POPT_ARG_STRING
, NULL
, OPT_FIELDS
, NULL
, NULL
},
2160 { "help", 'h', POPT_ARG_NONE
, NULL
, OPT_HELP
, NULL
, NULL
},
2161 { "help-legacy", '\0', POPT_ARG_NONE
, NULL
, OPT_HELP_LEGACY
, NULL
, NULL
},
2162 { "input-format", 'i', POPT_ARG_STRING
, NULL
, OPT_INPUT_FORMAT
, NULL
, NULL
},
2163 { "list", 'l', POPT_ARG_NONE
, NULL
, OPT_LIST
, NULL
, NULL
},
2164 { "names", 'n', POPT_ARG_STRING
, NULL
, OPT_NAMES
, NULL
, NULL
},
2165 { "no-delta", '\0', POPT_ARG_NONE
, NULL
, OPT_NO_DELTA
, NULL
, NULL
},
2166 { "output", 'w', POPT_ARG_STRING
, NULL
, OPT_OUTPUT_PATH
, NULL
, NULL
},
2167 { "output-format", 'o', POPT_ARG_STRING
, NULL
, OPT_OUTPUT_FORMAT
, NULL
, NULL
},
2168 { "plugin-path", 'p', POPT_ARG_STRING
, NULL
, OPT_PLUGIN_PATH
, NULL
, NULL
},
2169 { "sink", '\0', POPT_ARG_STRING
, NULL
, OPT_SINK
, NULL
, NULL
},
2170 { "source", '\0', POPT_ARG_STRING
, NULL
, OPT_SOURCE
, NULL
, NULL
},
2171 { "stream-intersection", '\0', POPT_ARG_NONE
, NULL
, OPT_STREAM_INTERSECTION
, NULL
, NULL
},
2172 { "verbose", 'v', POPT_ARG_NONE
, NULL
, OPT_VERBOSE
, NULL
, NULL
},
2173 { "version", 'V', POPT_ARG_NONE
, NULL
, OPT_VERSION
, NULL
, NULL
},
2174 { NULL
, 0, 0, NULL
, 0, NULL
, NULL
},
2178 * Sets the value of a given legacy offset option and marks it as set.
2180 static void set_offset_value(struct offset_opt
*offset_opt
, int64_t value
)
2182 offset_opt
->value
= value
;
2183 offset_opt
->is_set
= true;
2187 * Returns a Babeltrace configuration, out of command-line arguments,
2188 * containing everything that is needed to instanciate specific
2189 * components with given parameters.
2191 * *exit_code is set to the appropriate exit code to use as far as this
2194 * Return value is NULL on error, otherwise it's owned by the caller.
2196 struct bt_config
*bt_config_from_args(int argc
, char *argv
[], int *exit_code
)
2198 struct bt_config
*cfg
= NULL
;
2199 poptContext pc
= NULL
;
2201 struct ctf_legacy_opts ctf_legacy_opts
= { 0 };
2202 struct text_legacy_opts text_legacy_opts
= { 0 };
2203 enum legacy_input_format legacy_input_format
= LEGACY_INPUT_FORMAT_NONE
;
2204 enum legacy_output_format legacy_output_format
=
2205 LEGACY_OUTPUT_FORMAT_NONE
;
2206 struct bt_value
*legacy_input_paths
= NULL
;
2212 print_usage(stdout
);
2216 text_legacy_opts
.output
= g_string_new(NULL
);
2217 if (!text_legacy_opts
.output
) {
2222 text_legacy_opts
.dbg_info_dir
= g_string_new(NULL
);
2223 if (!text_legacy_opts
.dbg_info_dir
) {
2228 text_legacy_opts
.dbg_info_target_prefix
= g_string_new(NULL
);
2229 if (!text_legacy_opts
.dbg_info_target_prefix
) {
2235 cfg
= g_new0(struct bt_config
, 1);
2241 bt_object_init(cfg
, bt_config_destroy
);
2242 cfg
->sources
= g_ptr_array_new_with_free_func((GDestroyNotify
) bt_put
);
2243 if (!cfg
->sources
) {
2248 cfg
->sinks
= g_ptr_array_new_with_free_func((GDestroyNotify
) bt_put
);
2254 legacy_input_paths
= bt_value_array_create();
2255 if (!legacy_input_paths
) {
2261 pc
= poptGetContext(NULL
, argc
, (const char **) argv
, long_options
, 0);
2263 printf_err("Cannot get popt context\n");
2267 poptReadDefaultConfig(pc
, 0);
2269 while ((opt
= poptGetNextOpt(pc
)) > 0) {
2270 arg
= poptGetOptArg(pc
);
2273 case OPT_PLUGIN_PATH
:
2274 if (cfg
->plugin_paths
) {
2275 printf_err("Duplicate --plugin-path option\n");
2279 cfg
->plugin_paths
= plugin_paths_from_arg(arg
);
2280 if (!cfg
->plugin_paths
) {
2281 printf_err("Invalid --plugin-path option's argument\n");
2285 case OPT_OUTPUT_PATH
:
2286 if (text_legacy_opts
.output
->len
> 0) {
2287 printf_err("Duplicate --output option\n");
2291 g_string_assign(text_legacy_opts
.output
, arg
);
2293 case OPT_DEBUG_INFO_DIR
:
2294 if (text_legacy_opts
.dbg_info_dir
->len
> 0) {
2295 printf_err("Duplicate --debug-info-dir option\n");
2299 g_string_assign(text_legacy_opts
.dbg_info_dir
, arg
);
2301 case OPT_DEBUG_INFO_TARGET_PREFIX
:
2302 if (text_legacy_opts
.dbg_info_target_prefix
->len
> 0) {
2303 printf_err("Duplicate --debug-info-target-prefix option\n");
2307 g_string_assign(text_legacy_opts
.dbg_info_target_prefix
, arg
);
2309 case OPT_INPUT_FORMAT
:
2312 struct bt_config_component
*bt_config_component
;
2314 if (opt
== OPT_INPUT_FORMAT
) {
2315 if (!strcmp(arg
, "ctf")) {
2316 /* Legacy CTF input format */
2317 if (legacy_input_format
) {
2318 print_err_dup_legacy_input();
2322 legacy_input_format
=
2323 LEGACY_INPUT_FORMAT_CTF
;
2325 } else if (!strcmp(arg
, "lttng-live")) {
2326 /* Legacy LTTng-live input format */
2327 if (legacy_input_format
) {
2328 print_err_dup_legacy_input();
2332 legacy_input_format
=
2333 LEGACY_INPUT_FORMAT_LTTNG_LIVE
;
2338 /* Non-legacy: try to create a component config */
2339 bt_config_component
= bt_config_component_from_arg(arg
);
2340 if (!bt_config_component
) {
2341 printf_err("Invalid source component format:\n %s\n",
2346 g_ptr_array_add(cfg
->sources
, bt_config_component
);
2349 case OPT_OUTPUT_FORMAT
:
2352 struct bt_config_component
*bt_config_component
;
2354 if (opt
== OPT_OUTPUT_FORMAT
) {
2355 if (!strcmp(arg
, "text")) {
2356 /* Legacy CTF-text output format */
2357 if (legacy_output_format
) {
2358 print_err_dup_legacy_output();
2362 legacy_output_format
=
2363 LEGACY_OUTPUT_FORMAT_TEXT
;
2365 } else if (!strcmp(arg
, "dummy")) {
2366 /* Legacy dummy output format */
2367 if (legacy_output_format
) {
2368 print_err_dup_legacy_output();
2372 legacy_output_format
=
2373 LEGACY_OUTPUT_FORMAT_DUMMY
;
2375 } else if (!strcmp(arg
, "ctf-metadata")) {
2376 /* Legacy CTF-metadata output format */
2377 if (legacy_output_format
) {
2378 print_err_dup_legacy_output();
2382 legacy_output_format
=
2383 LEGACY_OUTPUT_FORMAT_CTF_METADATA
;
2388 /* Non-legacy: try to create a component config */
2389 bt_config_component
= bt_config_component_from_arg(arg
);
2390 if (!bt_config_component
) {
2391 printf_err("Invalid sink component format:\n %s\n",
2396 g_ptr_array_add(cfg
->sinks
, bt_config_component
);
2400 if (text_legacy_opts
.names
) {
2401 printf_err("Duplicate --names option\n");
2405 text_legacy_opts
.names
= names_from_arg(arg
);
2406 if (!text_legacy_opts
.names
) {
2407 printf_err("Invalid --names option's argument\n");
2412 if (text_legacy_opts
.fields
) {
2413 printf_err("Duplicate --fields option\n");
2417 text_legacy_opts
.fields
= fields_from_arg(arg
);
2418 if (!text_legacy_opts
.fields
) {
2419 printf_err("Invalid --fields option's argument\n");
2424 text_legacy_opts
.no_delta
= true;
2426 case OPT_CLOCK_CYCLES
:
2427 text_legacy_opts
.clock_cycles
= true;
2429 case OPT_CLOCK_SECONDS
:
2430 text_legacy_opts
.clock_seconds
= true;
2432 case OPT_CLOCK_DATE
:
2433 text_legacy_opts
.clock_date
= true;
2436 text_legacy_opts
.clock_gmt
= true;
2438 case OPT_DEBUG_INFO_FULL_PATH
:
2439 text_legacy_opts
.dbg_info_full_path
= true;
2441 case OPT_CLOCK_OFFSET
:
2445 if (ctf_legacy_opts
.offset_s
.is_set
) {
2446 printf_err("Duplicate --clock-offset option\n");
2450 if (parse_int64(arg
, &val
)) {
2451 printf_err("Invalid --clock-offset option's argument\n");
2455 set_offset_value(&ctf_legacy_opts
.offset_s
, val
);
2458 case OPT_CLOCK_OFFSET_NS
:
2462 if (ctf_legacy_opts
.offset_ns
.is_set
) {
2463 printf_err("Duplicate --clock-offset-ns option\n");
2467 if (parse_int64(arg
, &val
)) {
2468 printf_err("Invalid --clock-offset-ns option's argument\n");
2472 set_offset_value(&ctf_legacy_opts
.offset_ns
, val
);
2475 case OPT_STREAM_INTERSECTION
:
2476 ctf_legacy_opts
.stream_intersection
= true;
2478 case OPT_CLOCK_FORCE_CORRELATE
:
2479 cfg
->force_correlate
= true;
2483 print_usage(stdout
);
2485 case OPT_HELP_LEGACY
:
2487 print_legacy_usage(stdout
);
2494 cfg
->do_list
= true;
2497 cfg
->verbose
= true;
2503 printf_err("Unknown command-line option specified (option code %d)\n",
2512 /* Check for option parsing error */
2514 printf_err("While parsing command-line options, at option %s: %s\n",
2515 poptBadOption(pc
, 0), poptStrerror(opt
));
2519 /* Consume leftover arguments as legacy input paths */
2521 const char *input_path
= poptGetArg(pc
);
2527 if (bt_value_array_append_string(legacy_input_paths
,
2534 /* Validate legacy/non-legacy options */
2535 if (!validate_cfg(cfg
, &legacy_input_format
, &legacy_output_format
,
2536 legacy_input_paths
, &ctf_legacy_opts
,
2537 &text_legacy_opts
)) {
2538 printf_err("Command-line options form an invalid configuration\n");
2543 * If there's a legacy input format, convert it to source
2544 * component configurations.
2546 if (legacy_input_format
) {
2547 if (append_sources_from_legacy_opts(cfg
->sources
,
2548 legacy_input_format
, &ctf_legacy_opts
,
2549 legacy_input_paths
)) {
2550 printf_err("Cannot convert legacy input format options to source(s)\n");
2556 * If there's a legacy output format, convert it to sink
2557 * component configurations.
2559 if (legacy_output_format
) {
2560 if (append_sinks_from_legacy_opts(cfg
->sinks
,
2561 legacy_output_format
, &text_legacy_opts
)) {
2562 printf_err("Cannot convert legacy output format options to sink(s)\n");
2576 poptFreeContext(pc
);
2579 if (text_legacy_opts
.output
) {
2580 g_string_free(text_legacy_opts
.output
, TRUE
);
2583 if (text_legacy_opts
.dbg_info_dir
) {
2584 g_string_free(text_legacy_opts
.dbg_info_dir
, TRUE
);
2587 if (text_legacy_opts
.dbg_info_target_prefix
) {
2588 g_string_free(text_legacy_opts
.dbg_info_target_prefix
, TRUE
);
2592 BT_PUT(text_legacy_opts
.names
);
2593 BT_PUT(text_legacy_opts
.fields
);
2594 BT_PUT(legacy_input_paths
);