Fix CLI to work with multiple ports and dynamically added ports
authorPhilippe Proulx <eeppeliteloop@gmail.com>
Mon, 8 May 2017 17:04:40 +0000 (13:04 -0400)
committerJérémie Galarneau <jeremie.galarneau@efficios.com>
Sun, 28 May 2017 16:57:42 +0000 (12:57 -0400)
This patch makes the CLI actually connect component ports within the
application's graph before running it.

On the command line, you specify the connections like you used to,
except that the ports are not specific ports anymore: they are globbing
patterns (only the `*` special character is supported as of this
version) which specify: when a new upstream port matches the left part
of the connection argument (specific component and port name globbing
pattern), connect it to the first port that matches the right part
(specific component and port name globbing pattern). For example:

    src.*meow*:sink.master-*

would make babeltrace(1) connect all the ports of the component instance
`src` of which the names match `*meow*` to the next available port
of the instance `sink` of which the name matches `master-*`.

This mechanism allows to connect specific ports together, or to connect
group of ports or any ports using wildcards.

The code for the globbing pattern matching was grabbed from the
LTTng-UST project and I'm one of the copyright holders anyway.

This patch also adds a --retry-duration option to the `connect` and
`run` commands to specify how many microseconds the program should
wait when the graph returns BT_GRAPH_STATUS_AGAIN (do not wait when 0).
The default duration is 100 ms.

Some files are renamed to match what they really are. The concept of a
Babeltrace configuration (`bt_config`) is beyond the command-line
arguments: it could eventually be read from a configuration file, etc.
babeltrace-cfg-cli-args.c is a module which can create a Babeltrace
configuration out of command-line arguments.

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>
16 files changed:
cli/Makefile.am
cli/babeltrace-cfg-cli-args-connect.c [new file with mode: 0644]
cli/babeltrace-cfg-cli-args-connect.h [new file with mode: 0644]
cli/babeltrace-cfg-cli-args-default.c [new file with mode: 0644]
cli/babeltrace-cfg-cli-args-default.h [new file with mode: 0644]
cli/babeltrace-cfg-cli-args.c [new file with mode: 0644]
cli/babeltrace-cfg-cli-args.h [new file with mode: 0644]
cli/babeltrace-cfg-connect.c [deleted file]
cli/babeltrace-cfg-connect.h [deleted file]
cli/babeltrace-cfg.c
cli/babeltrace-cfg.h
cli/babeltrace.c
cli/default-cfg.c [deleted file]
cli/default-cfg.h [deleted file]
common/common.c
include/babeltrace/common-internal.h

index e8a06b5b9eadefa2f25226a71f673c2bf9f45a20..68cf9508777166509fec10cc424917b314134b20 100644 (file)
@@ -1,6 +1,6 @@
 PLUGINS_PATH = $(abs_top_builddir)/plugins
 AM_CFLAGS = $(PACKAGE_CFLAGS) -I$(top_srcdir)/include \
-               -DCONFIG_IN_TREE_PLUGIN_PATH=\"$(PLUGINS_PATH)/ctf:$(PLUGINS_PATH)/text:$(PLUGINS_PATH)/muxer:$(PLUGINS_PATH)/writer:$(PLUGINS_PATH)/utils\"
+               -DCONFIG_IN_TREE_PLUGIN_PATH=\"$(PLUGINS_PATH)/ctf:$(PLUGINS_PATH)/lttng-utils:$(PLUGINS_PATH)/text:$(PLUGINS_PATH)/writer:$(PLUGINS_PATH)/utils\"
 AM_LDFLAGS = -lpopt
 
 bin_PROGRAMS = babeltrace.bin
@@ -11,10 +11,12 @@ babeltrace_bin_SOURCES = \
        babeltrace.c \
        babeltrace-cfg.c \
        babeltrace-cfg.h \
-       default-cfg.h \
-       default-cfg.c \
-       babeltrace-cfg-connect.h \
-       babeltrace-cfg-connect.c
+       babeltrace-cfg-cli-args.c \
+       babeltrace-cfg-cli-args.h \
+       babeltrace-cfg-cli-args-connect.c \
+       babeltrace-cfg-cli-args-connect.h \
+       babeltrace-cfg-cli-args-default.h \
+       babeltrace-cfg-cli-args-default.c
 
 # -Wl,--no-as-needed is needed for recent gold linker who seems to think
 # it knows better and considers libraries with constructors having
@@ -34,7 +36,7 @@ babeltrace_bin_LDADD += -lrpcrt4 -lintl -liconv -lole32 -lpopt -lpthread
 endif
 
 # Only used for in-tree execution and tests
-babeltrace_SOURCES =   $(babeltrace_bin_SOURCES)
-babeltrace_LDFLAGS =   $(babeltrace_bin_LDFLAGS)
+babeltrace_SOURCES = $(babeltrace_bin_SOURCES)
+babeltrace_LDFLAGS = $(babeltrace_bin_LDFLAGS)
 babeltrace_LDADD =     $(babeltrace_bin_LDADD)
 babeltrace_CFLAGS =    $(AM_CFLAGS) -DBT_SET_DEFAULT_IN_TREE_CONFIGURATION
diff --git a/cli/babeltrace-cfg-cli-args-connect.c b/cli/babeltrace-cfg-cli-args-connect.c
new file mode 100644 (file)
index 0000000..503e46a
--- /dev/null
@@ -0,0 +1,721 @@
+/*
+ * Copyright 2017 Philippe Proulx <pproulx@efficios.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+#include <babeltrace/values.h>
+#include <babeltrace/common-internal.h>
+#include "babeltrace-cfg.h"
+#include "babeltrace-cfg-cli-args-connect.h"
+
+static bool all_named_and_printable_in_array(GPtrArray *comps)
+{
+       size_t i;
+       bool all_named_and_printable = true;
+
+       for (i = 0; i < comps->len; i++) {
+               struct bt_config_component *comp = g_ptr_array_index(comps, i);
+
+               if (comp->instance_name->len == 0) {
+                       all_named_and_printable = false;
+                       goto end;
+               }
+
+               if (!bt_common_string_is_printable(comp->instance_name->str)) {
+                       all_named_and_printable = false;
+                       goto end;
+               }
+       }
+
+end:
+       return all_named_and_printable;
+}
+
+static bool all_named_and_printable(struct bt_config *cfg)
+{
+       return all_named_and_printable_in_array(cfg->cmd_data.run.sources) &&
+               all_named_and_printable_in_array(cfg->cmd_data.run.filters) &&
+               all_named_and_printable_in_array(cfg->cmd_data.run.sinks);
+}
+
+static struct bt_config_connection *bt_config_connection_create(const char *arg)
+{
+       struct bt_config_connection *cfg_connection;
+
+       cfg_connection = g_new0(struct bt_config_connection, 1);
+       if (!cfg_connection) {
+               goto error;
+       }
+
+       cfg_connection->upstream_comp_name = g_string_new(NULL);
+       if (!cfg_connection->upstream_comp_name) {
+               goto error;
+       }
+
+       cfg_connection->downstream_comp_name = g_string_new(NULL);
+       if (!cfg_connection->downstream_comp_name) {
+               goto error;
+       }
+
+       cfg_connection->upstream_port_glob = g_string_new("*");
+       if (!cfg_connection->upstream_port_glob) {
+               goto error;
+       }
+
+       cfg_connection->downstream_port_glob = g_string_new("*");
+       if (!cfg_connection->downstream_port_glob) {
+               goto error;
+       }
+
+       cfg_connection->arg = g_string_new(arg);
+       if (!cfg_connection->arg) {
+               goto error;
+       }
+
+       goto end;
+
+error:
+       g_free(cfg_connection);
+       cfg_connection = NULL;
+
+end:
+       return cfg_connection;
+}
+
+static bool validate_port_glob(const char *port_glob)
+{
+       bool is_valid = true;
+       const char *ch = port_glob;
+
+       assert(port_glob);
+
+       while (*ch != '\0') {
+               switch (*ch) {
+               case '\\':
+                       switch (ch[1]) {
+                       case '\0':
+                               goto end;
+                       default:
+                               ch += 2;
+                               continue;
+                       }
+               case '?':
+               case '[':
+                       /*
+                        * This is reserved for future use, to support
+                        * full globbing patterns. Those characters must
+                        * be escaped with `\`.
+                        */
+                       is_valid = false;
+                       goto end;
+               default:
+                       ch++;
+                       break;
+               }
+       }
+
+end:
+       return is_valid;
+}
+
+static int normalize_glob_pattern(GString *glob_pattern_gs)
+{
+       int ret = 0;
+       char *glob_pattern = strdup(glob_pattern_gs->str);
+
+       if (!glob_pattern) {
+               ret = -1;
+               goto end;
+       }
+
+       bt_common_normalize_star_glob_pattern(glob_pattern);
+       g_string_assign(glob_pattern_gs, glob_pattern);
+       free(glob_pattern);
+
+end:
+       return ret;
+}
+
+static struct bt_config_connection *cfg_connection_from_arg(const char *arg)
+{
+       const char *at = arg;
+       size_t end_pos;
+       struct bt_config_connection *cfg_conn = NULL;
+       GString *gs = NULL;
+       enum {
+               UPSTREAM_NAME,
+               DOWNSTREAM_NAME,
+               UPSTREAM_PORT_GLOB,
+               DOWNSTREAM_PORT_GLOB,
+       } state = UPSTREAM_NAME;
+
+       if (!bt_common_string_is_printable(arg)) {
+               goto error;
+       }
+
+       cfg_conn = bt_config_connection_create(arg);
+       if (!cfg_conn) {
+               goto error;
+       }
+
+       while (true) {
+               switch (state) {
+               case UPSTREAM_NAME:
+                       gs = bt_common_string_until(at, ".:\\", ".:", &end_pos);
+                       if (!gs || gs->len == 0) {
+                               goto error;
+                       }
+
+                       g_string_free(cfg_conn->upstream_comp_name, TRUE);
+                       cfg_conn->upstream_comp_name = gs;
+                       gs = NULL;
+
+                       if (at[end_pos] == ':') {
+                               state = DOWNSTREAM_NAME;
+                       } else if (at[end_pos] == '.') {
+                               state = UPSTREAM_PORT_GLOB;
+                       } else {
+                               goto error;
+                       }
+
+                       at += end_pos + 1;
+                       break;
+               case DOWNSTREAM_NAME:
+                       gs = bt_common_string_until(at, ".:\\", ".:", &end_pos);
+                       if (!gs || gs->len == 0) {
+                               goto error;
+                       }
+
+                       g_string_free(cfg_conn->downstream_comp_name, TRUE);
+                       cfg_conn->downstream_comp_name = gs;
+                       gs = NULL;
+
+                       if (at[end_pos] == '.') {
+                               state = DOWNSTREAM_PORT_GLOB;
+                       } else if (at[end_pos] == '\0') {
+                               goto end;
+                       } else {
+                               goto error;
+                       }
+
+                       at += end_pos + 1;
+                       break;
+               case UPSTREAM_PORT_GLOB:
+                       gs = bt_common_string_until(at, ".:", ".:", &end_pos);
+                       if (!gs || gs->len == 0) {
+                               goto error;
+                       }
+
+                       if (!validate_port_glob(gs->str)) {
+                               goto error;
+                       }
+
+                       if (normalize_glob_pattern(gs)) {
+                               goto error;
+                       }
+
+                       g_string_free(cfg_conn->upstream_port_glob, TRUE);
+                       cfg_conn->upstream_port_glob = gs;
+                       gs = NULL;
+
+                       if (at[end_pos] == ':') {
+                               state = DOWNSTREAM_NAME;
+                       } else {
+                               goto error;
+                       }
+
+                       at += end_pos + 1;
+                       break;
+               case DOWNSTREAM_PORT_GLOB:
+                       gs = bt_common_string_until(at, ".:", ".:", &end_pos);
+                       if (!gs || gs->len == 0) {
+                               goto error;
+                       }
+
+                       if (!validate_port_glob(gs->str)) {
+                               goto error;
+                       }
+
+                       if (normalize_glob_pattern(gs)) {
+                               goto error;
+                       }
+
+                       g_string_free(cfg_conn->downstream_port_glob, TRUE);
+                       cfg_conn->downstream_port_glob = gs;
+                       gs = NULL;
+
+                       if (at[end_pos] == '\0') {
+                               goto end;
+                       } else {
+                               goto error;
+                       }
+                       break;
+               default:
+                       assert(false);
+               }
+       }
+
+error:
+       bt_config_connection_destroy(cfg_conn);
+       cfg_conn = NULL;
+
+end:
+       if (gs) {
+               g_string_free(gs, TRUE);
+       }
+
+       return cfg_conn;
+}
+
+static struct bt_config_component *find_component_in_array(GPtrArray *comps,
+               const char *name)
+{
+       size_t i;
+       struct bt_config_component *found_comp = NULL;
+
+       for (i = 0; i < comps->len; i++) {
+               struct bt_config_component *comp = g_ptr_array_index(comps, i);
+
+               if (strcmp(name, comp->instance_name->str) == 0) {
+                       found_comp = bt_get(comp);
+                       goto end;
+               }
+       }
+
+end:
+       return found_comp;
+}
+
+static struct bt_config_component *find_component(struct bt_config *cfg,
+               const char *name)
+{
+       struct bt_config_component *comp;
+
+       comp = find_component_in_array(cfg->cmd_data.run.sources, name);
+       if (comp) {
+               goto end;
+       }
+
+       comp = find_component_in_array(cfg->cmd_data.run.filters, name);
+       if (comp) {
+               goto end;
+       }
+
+       comp = find_component_in_array(cfg->cmd_data.run.sinks, name);
+       if (comp) {
+               goto end;
+       }
+
+end:
+       return comp;
+}
+
+static int validate_all_endpoints_exist(struct bt_config *cfg, char *error_buf,
+               size_t error_buf_size)
+{
+       size_t i;
+       int ret = 0;
+
+       for (i = 0; i < cfg->cmd_data.run.connections->len; i++) {
+               struct bt_config_connection *connection =
+                       g_ptr_array_index(cfg->cmd_data.run.connections, i);
+               struct bt_config_component *comp;
+
+               comp = find_component(cfg, connection->upstream_comp_name->str);
+               bt_put(comp);
+               if (!comp) {
+                       snprintf(error_buf, error_buf_size,
+                               "Invalid connection: cannot find upstream component `%s`:\n    %s\n",
+                               connection->upstream_comp_name->str,
+                               connection->arg->str);
+                       ret = -1;
+                       goto end;
+               }
+
+               comp = find_component(cfg, connection->downstream_comp_name->str);
+               bt_put(comp);
+               if (!comp) {
+                       snprintf(error_buf, error_buf_size,
+                               "Invalid connection: cannot find downstream component `%s`:\n    %s\n",
+                               connection->downstream_comp_name->str,
+                               connection->arg->str);
+                       ret = -1;
+                       goto end;
+               }
+       }
+
+end:
+       return ret;
+}
+
+static int validate_connection_directions(struct bt_config *cfg,
+               char *error_buf, size_t error_buf_size)
+{
+       size_t i;
+       int ret = 0;
+       struct bt_config_component *src_comp = NULL;
+       struct bt_config_component *dst_comp = NULL;
+
+       for (i = 0; i < cfg->cmd_data.run.connections->len; i++) {
+               struct bt_config_connection *connection =
+                       g_ptr_array_index(cfg->cmd_data.run.connections, i);
+
+               src_comp = find_component(cfg,
+                       connection->upstream_comp_name->str);
+               assert(src_comp);
+               dst_comp = find_component(cfg,
+                       connection->downstream_comp_name->str);
+               assert(dst_comp);
+
+               if (src_comp->type == BT_COMPONENT_CLASS_TYPE_SOURCE) {
+                       if (dst_comp->type != BT_COMPONENT_CLASS_TYPE_FILTER &&
+                                       dst_comp->type != BT_COMPONENT_CLASS_TYPE_SINK) {
+                               snprintf(error_buf, error_buf_size,
+                                       "Invalid connection: source component `%s` not connected to filter or sink component:\n    %s\n",
+                                       connection->upstream_comp_name->str,
+                                       connection->arg->str);
+                               ret = -1;
+                               goto end;
+                       }
+               } else if (src_comp->type == BT_COMPONENT_CLASS_TYPE_FILTER) {
+                       if (dst_comp->type != BT_COMPONENT_CLASS_TYPE_FILTER &&
+                                       dst_comp->type != BT_COMPONENT_CLASS_TYPE_SINK) {
+                               snprintf(error_buf, error_buf_size,
+                                       "Invalid connection: filter component `%s` not connected to filter or sink component:\n    %s\n",
+                                       connection->upstream_comp_name->str,
+                                       connection->arg->str);
+                               ret = -1;
+                               goto end;
+                       }
+               } else {
+                       snprintf(error_buf, error_buf_size,
+                               "Invalid connection: cannot connect sink component `%s` to component `%s`:\n    %s\n",
+                               connection->upstream_comp_name->str,
+                               connection->downstream_comp_name->str,
+                               connection->arg->str);
+                       ret = -1;
+                       goto end;
+               }
+
+               BT_PUT(src_comp);
+               BT_PUT(dst_comp);
+       }
+
+end:
+       bt_put(src_comp);
+       bt_put(dst_comp);
+       return ret;
+}
+
+static int validate_no_cycles_rec(struct bt_config *cfg, GPtrArray *path,
+               char *error_buf, size_t error_buf_size)
+{
+       int ret = 0;
+       size_t conn_i;
+       const char *src_comp_name;
+
+       assert(path && path->len > 0);
+       src_comp_name = g_ptr_array_index(path, path->len - 1);
+
+       for (conn_i = 0; conn_i < cfg->cmd_data.run.connections->len; conn_i++) {
+               struct bt_config_connection *conn =
+                       g_ptr_array_index(cfg->cmd_data.run.connections, conn_i);
+
+               if (strcmp(conn->upstream_comp_name->str, src_comp_name) == 0) {
+                       size_t path_i;
+
+                       for (path_i = 0; path_i < path->len; path_i++) {
+                               const char *comp_name =
+                                       g_ptr_array_index(path, path_i);
+
+                               if (strcmp(comp_name, conn->downstream_comp_name->str) == 0) {
+                                       snprintf(error_buf, error_buf_size,
+                                               "Invalid connection: connection forms a cycle:\n    %s\n",
+                                               conn->arg->str);
+                                       ret = -1;
+                                       goto end;
+                               }
+                       }
+
+                       g_ptr_array_add(path, conn->downstream_comp_name->str);
+                       ret = validate_no_cycles_rec(cfg, path, error_buf,
+                                       error_buf_size);
+                       if (ret) {
+                               goto end;
+                       }
+
+                       g_ptr_array_remove_index(path, path->len - 1);
+               }
+       }
+
+end:
+       return ret;
+}
+
+static int validate_no_cycles(struct bt_config *cfg, char *error_buf,
+               size_t error_buf_size)
+{
+       size_t i;
+       int ret = 0;
+       GPtrArray *path;
+
+       path = g_ptr_array_new();
+       if (!path) {
+               ret = -1;
+               goto end;
+       }
+
+       g_ptr_array_add(path, NULL);
+
+       for (i = 0; i < cfg->cmd_data.run.connections->len; i++) {
+               struct bt_config_connection *conn =
+                       g_ptr_array_index(cfg->cmd_data.run.connections, i);
+
+               g_ptr_array_index(path, 0) = conn->upstream_comp_name->str;
+               ret = validate_no_cycles_rec(cfg, path,
+                       error_buf, error_buf_size);
+               if (ret) {
+                       goto end;
+               }
+       }
+
+end:
+       if (path) {
+               g_ptr_array_free(path, TRUE);
+       }
+
+       return ret;
+}
+
+static int validate_all_components_connected_in_array(GPtrArray *comps,
+               struct bt_value *connected_components,
+               char *error_buf, size_t error_buf_size)
+{
+       int ret = 0;
+       size_t i;
+
+       for (i = 0; i < comps->len; i++) {
+               struct bt_config_component *comp = g_ptr_array_index(comps, i);
+
+               if (!bt_value_map_has_key(connected_components,
+                               comp->instance_name->str)) {
+                       snprintf(error_buf, error_buf_size,
+                               "Component `%s` is not connected\n",
+                               comp->instance_name->str);
+                       ret = -1;
+                       goto end;
+               }
+       }
+
+end:
+       return ret;
+}
+
+static int validate_all_components_connected(struct bt_config *cfg,
+               char *error_buf, size_t error_buf_size)
+{
+       size_t i;
+       int ret = 0;
+       struct bt_value *connected_components = bt_value_map_create();
+
+       if (!connected_components) {
+               ret = -1;
+               goto end;
+       }
+
+       for (i = 0; i < cfg->cmd_data.run.connections->len; i++) {
+               struct bt_config_connection *connection =
+                       g_ptr_array_index(cfg->cmd_data.run.connections, i);
+
+               ret = bt_value_map_insert(connected_components,
+                       connection->upstream_comp_name->str, bt_value_null);
+               if (ret) {
+                       goto end;
+               }
+
+               ret = bt_value_map_insert(connected_components,
+                       connection->downstream_comp_name->str, bt_value_null);
+               if (ret) {
+                       goto end;
+               }
+       }
+
+       ret = validate_all_components_connected_in_array(
+               cfg->cmd_data.run.sources, connected_components,
+               error_buf, error_buf_size);
+       if (ret) {
+               goto end;
+       }
+
+       ret = validate_all_components_connected_in_array(
+               cfg->cmd_data.run.filters, connected_components,
+               error_buf, error_buf_size);
+       if (ret) {
+               goto end;
+       }
+
+       ret = validate_all_components_connected_in_array(
+               cfg->cmd_data.run.sinks, connected_components,
+               error_buf, error_buf_size);
+       if (ret) {
+               goto end;
+       }
+
+end:
+       bt_put(connected_components);
+       return ret;
+}
+
+static int validate_no_duplicate_connection(struct bt_config *cfg,
+               char *error_buf, size_t error_buf_size)
+{
+       size_t i;
+       int ret = 0;
+       struct bt_value *flat_connection_names = bt_value_map_create();
+       GString *flat_connection_name = NULL;
+
+       if (!flat_connection_names) {
+               ret = -1;
+               goto end;
+       }
+
+       flat_connection_name = g_string_new(NULL);
+       if (!flat_connection_name) {
+               ret = -1;
+               goto end;
+       }
+
+       for (i = 0; i < cfg->cmd_data.run.connections->len; i++) {
+               struct bt_config_connection *connection =
+                       g_ptr_array_index(cfg->cmd_data.run.connections, i);
+
+               g_string_printf(flat_connection_name, "%s\x01%s\x01%s\x01%s",
+                       connection->upstream_comp_name->str,
+                       connection->upstream_port_glob->str,
+                       connection->downstream_comp_name->str,
+                       connection->downstream_port_glob->str);
+
+               if (bt_value_map_has_key(flat_connection_names,
+                               flat_connection_name->str)) {
+                       snprintf(error_buf, error_buf_size,
+                               "Duplicate connection:\n    %s\n",
+                               connection->arg->str);
+                       ret = -1;
+                       goto end;
+               }
+
+               ret = bt_value_map_insert(flat_connection_names,
+                       flat_connection_name->str, bt_value_null);
+               if (ret) {
+                       goto end;
+               }
+       }
+
+end:
+       bt_put(flat_connection_names);
+
+       if (flat_connection_name) {
+               g_string_free(flat_connection_name, TRUE);
+       }
+
+       return ret;
+}
+
+static int validate_connections(struct bt_config *cfg, char *error_buf,
+               size_t error_buf_size)
+{
+       int ret;
+
+       ret = validate_all_endpoints_exist(cfg, error_buf, error_buf_size);
+       if (ret) {
+               goto end;
+       }
+
+       ret = validate_connection_directions(cfg, error_buf, error_buf_size);
+       if (ret) {
+               goto end;
+       }
+
+       ret = validate_all_components_connected(cfg, error_buf, error_buf_size);
+       if (ret) {
+               goto end;
+       }
+
+       ret = validate_no_duplicate_connection(cfg, error_buf, error_buf_size);
+       if (ret) {
+               goto end;
+       }
+
+       ret = validate_no_cycles(cfg, error_buf, error_buf_size);
+       if (ret) {
+               goto end;
+       }
+
+end:
+       return ret;
+}
+
+int bt_config_cli_args_create_connections(struct bt_config *cfg,
+               struct bt_value *connection_args,
+               char *error_buf, size_t error_buf_size)
+{
+       int ret;
+       size_t i;
+
+       if (!all_named_and_printable(cfg)) {
+               snprintf(error_buf, error_buf_size,
+                       "One or more components are unnamed (use --name) or contain a non-printable character\n");
+               goto error;
+       }
+
+       for (i = 0; i < bt_value_array_size(connection_args); i++) {
+               struct bt_value *arg_value =
+                       bt_value_array_get(connection_args, i);
+               const char *arg;
+               struct bt_config_connection *cfg_connection;
+
+               ret = bt_value_string_get(arg_value, &arg);
+               BT_PUT(arg_value);
+               assert(ret == 0);
+               cfg_connection = cfg_connection_from_arg(arg);
+               if (!cfg_connection) {
+                       snprintf(error_buf, error_buf_size, "Cannot parse --connect option's argument:\n    %s\n",
+                               arg);
+                       goto error;
+               }
+
+               g_ptr_array_add(cfg->cmd_data.run.connections,
+                       cfg_connection);
+       }
+
+
+       ret = validate_connections(cfg, error_buf, error_buf_size);
+       if (ret) {
+               goto error;
+       }
+
+       goto end;
+
+error:
+       ret = -1;
+
+end:
+       return ret;
+}
diff --git a/cli/babeltrace-cfg-cli-args-connect.h b/cli/babeltrace-cfg-cli-args-connect.h
new file mode 100644 (file)
index 0000000..de13866
--- /dev/null
@@ -0,0 +1,36 @@
+#ifndef CLI_BABELTRACE_CFG_CLI_ARGS_CONNECT_H
+#define CLI_BABELTRACE_CFG_CLI_ARGS_CONNECT_H
+
+/*
+ * Copyright 2017 Philippe Proulx <pproulx@efficios.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+#include <stdlib.h>
+#include <stdint.h>
+#include <babeltrace/values.h>
+#include <glib.h>
+#include "babeltrace-cfg.h"
+
+int bt_config_cli_args_create_connections(struct bt_config *cfg,
+               struct bt_value *connection_args,
+               char *error_buf, size_t error_buf_size);
+
+#endif /* CLI_BABELTRACE_CFG_CLI_ARGS_CONNECT_H */
diff --git a/cli/babeltrace-cfg-cli-args-default.c b/cli/babeltrace-cfg-cli-args-default.c
new file mode 100644 (file)
index 0000000..0617b59
--- /dev/null
@@ -0,0 +1,71 @@
+/*
+ * Copyright 2016 - Jérémie Galarneau <jeremie.galarneau@efficios.com>
+ * Copyright 2017 - Philippe Proulx <pproulx@efficios.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+#include <babeltrace/values.h>
+#include "babeltrace-cfg.h"
+#include "babeltrace-cfg-cli-args.h"
+#include "babeltrace-cfg-cli-args-default.h"
+
+#ifdef BT_SET_DEFAULT_IN_TREE_CONFIGURATION
+
+struct bt_config *bt_config_cli_args_create_with_default(int argc,
+               const char *argv[], int *retcode)
+{
+       struct bt_value *initial_plugin_paths;
+       struct bt_config *cfg = NULL;
+       int ret;
+
+       initial_plugin_paths = bt_value_array_create();
+       if (!initial_plugin_paths) {
+               goto error;
+       }
+
+       ret = bt_config_append_plugin_paths(initial_plugin_paths,
+               CONFIG_IN_TREE_PLUGIN_PATH);
+       if (ret) {
+               goto error;
+       }
+
+       cfg = bt_config_cli_args_create(argc, argv, retcode, true, true,
+               BT_ENABLE_DEBUG_INFO == 0, initial_plugin_paths);
+       goto end;
+
+error:
+       *retcode = 1;
+       BT_PUT(cfg);
+
+end:
+       bt_put(initial_plugin_paths);
+       return cfg;
+}
+
+#else /* BT_SET_DEFAULT_IN_TREE_CONFIGURATION */
+
+struct bt_config *bt_config_cli_args_create_with_default(int argc,
+               const char *argv[], int *retcode)
+{
+       return bt_config_cli_args_create(argc, argv, retcode, false, false,
+               BT_ENABLE_DEBUG_INFO == 0, NULL);
+}
+
+#endif /* BT_SET_DEFAULT_IN_TREE_CONFIGURATION */
diff --git a/cli/babeltrace-cfg-cli-args-default.h b/cli/babeltrace-cfg-cli-args-default.h
new file mode 100644 (file)
index 0000000..e62b140
--- /dev/null
@@ -0,0 +1,33 @@
+#ifndef CLI_BABELTRACE_CFG_CLI_ARGS_DEFAULT_H
+#define CLI_BABELTRACE_CFG_CLI_ARGS_DEFAULT_H
+
+/*
+ * Babeltrace Trace Converter - Default Configuration
+ *
+ * Copyright 2016 Jérémie Galarneau <jeremie.galarneau@efficios.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+#include "babeltrace-cfg.h"
+
+struct bt_config *bt_config_cli_args_create_with_default(int argc,
+               const char *argv[], int *retcode);
+
+#endif /* CLI_BABELTRACE_CFG_CLI_ARGS_DEFAULT_H */
diff --git a/cli/babeltrace-cfg-cli-args.c b/cli/babeltrace-cfg-cli-args.c
new file mode 100644 (file)
index 0000000..ae43510
--- /dev/null
@@ -0,0 +1,4777 @@
+/*
+ * Babeltrace trace converter - parameter parsing
+ *
+ * Copyright 2016 Philippe Proulx <pproulx@efficios.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+#include <errno.h>
+#include <stdlib.h>
+#include <string.h>
+#include <assert.h>
+#include <stdio.h>
+#include <stdbool.h>
+#include <inttypes.h>
+#include <babeltrace/babeltrace.h>
+#include <babeltrace/common-internal.h>
+#include <babeltrace/values.h>
+#include <popt.h>
+#include <glib.h>
+#include <sys/types.h>
+#include <pwd.h>
+#include "babeltrace-cfg.h"
+#include "babeltrace-cfg-cli-args.h"
+#include "babeltrace-cfg-cli-args-connect.h"
+
+/*
+ * Error printf() macro which prepends "Error: " the first time it's
+ * called. This gives a nicer feel than having a bunch of error prefixes
+ * (since the following lines usually describe the error and possible
+ * solutions), or the error prefix just at the end.
+ */
+#define printf_err(fmt, args...)                                       \
+       do {                                                            \
+               if (is_first_error) {                                   \
+                       fprintf(stderr, "Command line error: ");        \
+                       is_first_error = false;                         \
+               }                                                       \
+               fprintf(stderr, fmt, ##args);                           \
+       } while (0)
+
+static bool is_first_error = true;
+
+/* INI-style parsing FSM states */
+enum ini_parsing_fsm_state {
+       /* Expect a map key (identifier) */
+       INI_EXPECT_MAP_KEY,
+
+       /* Expect an equal character ('=') */
+       INI_EXPECT_EQUAL,
+
+       /* Expect a value */
+       INI_EXPECT_VALUE,
+
+       /* Expect a negative number value */
+       INI_EXPECT_VALUE_NUMBER_NEG,
+
+       /* Expect a comma character (',') */
+       INI_EXPECT_COMMA,
+};
+
+/* INI-style parsing state variables */
+struct ini_parsing_state {
+       /* Lexical scanner (owned by this) */
+       GScanner *scanner;
+
+       /* Output map value object being filled (owned by this) */
+       struct bt_value *params;
+
+       /* Next expected FSM state */
+       enum ini_parsing_fsm_state expecting;
+
+       /* Last decoded map key (owned by this) */
+       char *last_map_key;
+
+       /* Complete INI-style string to parse (not owned by this) */
+       const char *arg;
+
+       /* Error buffer (not owned by this) */
+       GString *ini_error;
+};
+
+/* Offset option with "is set" boolean */
+struct offset_opt {
+       int64_t value;
+       bool is_set;
+};
+
+/* Legacy "ctf"/"lttng-live" format options */
+struct ctf_legacy_opts {
+       struct offset_opt offset_s;
+       struct offset_opt offset_ns;
+       bool stream_intersection;
+};
+
+/* Legacy "text" format options */
+struct text_legacy_opts {
+       /*
+        * output, dbg_info_dir, dbg_info_target_prefix, names,
+        * and fields are owned by this.
+        */
+       GString *output;
+       GString *dbg_info_dir;
+       GString *dbg_info_target_prefix;
+       struct bt_value *names;
+       struct bt_value *fields;
+
+       /* Flags */
+       bool no_delta;
+       bool clock_cycles;
+       bool clock_seconds;
+       bool clock_date;
+       bool clock_gmt;
+       bool dbg_info_full_path;
+       bool verbose;
+};
+
+/* Legacy input format format */
+enum legacy_input_format {
+       LEGACY_INPUT_FORMAT_NONE = 0,
+       LEGACY_INPUT_FORMAT_CTF,
+       LEGACY_INPUT_FORMAT_LTTNG_LIVE,
+};
+
+/* Legacy output format format */
+enum legacy_output_format {
+       LEGACY_OUTPUT_FORMAT_NONE = 0,
+       LEGACY_OUTPUT_FORMAT_TEXT,
+       LEGACY_OUTPUT_FORMAT_DUMMY,
+};
+
+/*
+ * Prints the "out of memory" error.
+ */
+static
+void print_err_oom(void)
+{
+       printf_err("Out of memory\n");
+}
+
+/*
+ * Appends an "expecting token" error to the INI-style parsing state's
+ * error buffer.
+ */
+static
+void ini_append_error_expecting(struct ini_parsing_state *state,
+               GScanner *scanner, const char *expecting)
+{
+       size_t i;
+       size_t pos;
+
+       g_string_append_printf(state->ini_error, "Expecting %s:\n", expecting);
+
+       /* Only print error if there's one line */
+       if (strchr(state->arg, '\n') != NULL || strlen(state->arg) == 0) {
+               return;
+       }
+
+       g_string_append_printf(state->ini_error, "\n    %s\n", state->arg);
+       pos = g_scanner_cur_position(scanner) + 4;
+
+       if (!g_scanner_eof(scanner)) {
+               pos--;
+       }
+
+       for (i = 0; i < pos; ++i) {
+               g_string_append_printf(state->ini_error, " ");
+       }
+
+       g_string_append_printf(state->ini_error, "^\n\n");
+}
+
+static
+int ini_handle_state(struct ini_parsing_state *state)
+{
+       int ret = 0;
+       GTokenType token_type;
+       struct bt_value *value = NULL;
+
+       token_type = g_scanner_get_next_token(state->scanner);
+       if (token_type == G_TOKEN_EOF) {
+               if (state->expecting != INI_EXPECT_COMMA) {
+                       switch (state->expecting) {
+                       case INI_EXPECT_EQUAL:
+                               ini_append_error_expecting(state,
+                                       state->scanner, "'='");
+                               break;
+                       case INI_EXPECT_VALUE:
+                       case INI_EXPECT_VALUE_NUMBER_NEG:
+                               ini_append_error_expecting(state,
+                                       state->scanner, "value");
+                               break;
+                       case INI_EXPECT_MAP_KEY:
+                               ini_append_error_expecting(state,
+                                       state->scanner, "unquoted map key");
+                               break;
+                       default:
+                               break;
+                       }
+                       goto error;
+               }
+
+               /* We're done! */
+               ret = 1;
+               goto success;
+       }
+
+       switch (state->expecting) {
+       case INI_EXPECT_MAP_KEY:
+               if (token_type != G_TOKEN_IDENTIFIER) {
+                       ini_append_error_expecting(state, state->scanner,
+                               "unquoted map key");
+                       goto error;
+               }
+
+               free(state->last_map_key);
+               state->last_map_key =
+                       strdup(state->scanner->value.v_identifier);
+               if (!state->last_map_key) {
+                       g_string_append(state->ini_error,
+                               "Out of memory\n");
+                       goto error;
+               }
+
+               if (bt_value_map_has_key(state->params, state->last_map_key)) {
+                       g_string_append_printf(state->ini_error,
+                               "Duplicate parameter key: `%s`\n",
+                               state->last_map_key);
+                       goto error;
+               }
+
+               state->expecting = INI_EXPECT_EQUAL;
+               goto success;
+       case INI_EXPECT_EQUAL:
+               if (token_type != G_TOKEN_CHAR) {
+                       ini_append_error_expecting(state,
+                               state->scanner, "'='");
+                       goto error;
+               }
+
+               if (state->scanner->value.v_char != '=') {
+                       ini_append_error_expecting(state,
+                               state->scanner, "'='");
+                       goto error;
+               }
+
+               state->expecting = INI_EXPECT_VALUE;
+               goto success;
+       case INI_EXPECT_VALUE:
+       {
+               switch (token_type) {
+               case G_TOKEN_CHAR:
+                       if (state->scanner->value.v_char == '-') {
+                               /* Negative number */
+                               state->expecting =
+                                       INI_EXPECT_VALUE_NUMBER_NEG;
+                               goto success;
+                       } else {
+                               ini_append_error_expecting(state,
+                                       state->scanner, "value");
+                               goto error;
+                       }
+                       break;
+               case G_TOKEN_INT:
+               {
+                       /* Positive integer */
+                       uint64_t int_val = state->scanner->value.v_int64;
+
+                       if (int_val > (1ULL << 63) - 1) {
+                               g_string_append_printf(state->ini_error,
+                                       "Integer value %" PRIu64 " is outside the range of a 64-bit signed integer\n",
+                                       int_val);
+                               goto error;
+                       }
+
+                       value = bt_value_integer_create_init(
+                               (int64_t) int_val);
+                       break;
+               }
+               case G_TOKEN_FLOAT:
+                       /* Positive floating point number */
+                       value = bt_value_float_create_init(
+                               state->scanner->value.v_float);
+                       break;
+               case G_TOKEN_STRING:
+                       /* Quoted string */
+                       value = bt_value_string_create_init(
+                               state->scanner->value.v_string);
+                       break;
+               case G_TOKEN_IDENTIFIER:
+               {
+                       /*
+                        * Using symbols would be appropriate here,
+                        * but said symbols are allowed as map key,
+                        * so it's easier to consider everything an
+                        * identifier.
+                        *
+                        * If one of the known symbols is not
+                        * recognized here, then fall back to creating
+                        * a string value.
+                        */
+                       const char *id = state->scanner->value.v_identifier;
+
+                       if (!strcmp(id, "null") || !strcmp(id, "NULL") ||
+                                       !strcmp(id, "nul")) {
+                               value = bt_value_null;
+                       } else if (!strcmp(id, "true") || !strcmp(id, "TRUE") ||
+                                       !strcmp(id, "yes") ||
+                                       !strcmp(id, "YES")) {
+                               value = bt_value_bool_create_init(true);
+                       } else if (!strcmp(id, "false") ||
+                                       !strcmp(id, "FALSE") ||
+                                       !strcmp(id, "no") ||
+                                       !strcmp(id, "NO")) {
+                               value = bt_value_bool_create_init(false);
+                       } else {
+                               value = bt_value_string_create_init(id);
+                       }
+                       break;
+               }
+               default:
+                       /* Unset value variable will trigger the error */
+                       break;
+               }
+
+               if (!value) {
+                       ini_append_error_expecting(state,
+                               state->scanner, "value");
+                       goto error;
+               }
+
+               state->expecting = INI_EXPECT_COMMA;
+               goto success;
+       }
+       case INI_EXPECT_VALUE_NUMBER_NEG:
+       {
+               switch (token_type) {
+               case G_TOKEN_INT:
+               {
+                       /* Negative integer */
+                       uint64_t int_val = state->scanner->value.v_int64;
+
+                       if (int_val > (1ULL << 63) - 1) {
+                               g_string_append_printf(state->ini_error,
+                                       "Integer value -%" PRIu64 " is outside the range of a 64-bit signed integer\n",
+                                       int_val);
+                               goto error;
+                       }
+
+                       value = bt_value_integer_create_init(
+                               -((int64_t) int_val));
+                       break;
+               }
+               case G_TOKEN_FLOAT:
+                       /* Negative floating point number */
+                       value = bt_value_float_create_init(
+                               -state->scanner->value.v_float);
+                       break;
+               default:
+                       /* Unset value variable will trigger the error */
+                       break;
+               }
+
+               if (!value) {
+                       ini_append_error_expecting(state,
+                               state->scanner, "value");
+                       goto error;
+               }
+
+               state->expecting = INI_EXPECT_COMMA;
+               goto success;
+       }
+       case INI_EXPECT_COMMA:
+               if (token_type != G_TOKEN_CHAR) {
+                       ini_append_error_expecting(state,
+                               state->scanner, "','");
+                       goto error;
+               }
+
+               if (state->scanner->value.v_char != ',') {
+                       ini_append_error_expecting(state,
+                               state->scanner, "','");
+                       goto error;
+               }
+
+               state->expecting = INI_EXPECT_MAP_KEY;
+               goto success;
+       default:
+               assert(false);
+       }
+
+error:
+       ret = -1;
+       goto end;
+
+success:
+       if (value) {
+               if (bt_value_map_insert(state->params,
+                               state->last_map_key, value)) {
+                       /* Only override return value on error */
+                       ret = -1;
+               }
+       }
+
+end:
+       BT_PUT(value);
+       return ret;
+}
+
+/*
+ * Converts an INI-style argument to an equivalent map value object.
+ *
+ * Return value is owned by the caller.
+ */
+static
+struct bt_value *bt_value_from_ini(const char *arg, GString *ini_error)
+{
+       /* Lexical scanner configuration */
+       GScannerConfig scanner_config = {
+               /* Skip whitespaces */
+               .cset_skip_characters = " \t\n",
+
+               /* Identifier syntax is: [a-zA-Z_][a-zA-Z0-9_.:-]* */
+               .cset_identifier_first =
+                       G_CSET_a_2_z
+                       "_"
+                       G_CSET_A_2_Z,
+               .cset_identifier_nth =
+                       G_CSET_a_2_z
+                       "_0123456789-.:"
+                       G_CSET_A_2_Z,
+
+               /* "hello" and "Hello" two different keys */
+               .case_sensitive = TRUE,
+
+               /* No comments */
+               .cpair_comment_single = NULL,
+               .skip_comment_multi = TRUE,
+               .skip_comment_single = TRUE,
+               .scan_comment_multi = FALSE,
+
+               /*
+                * Do scan identifiers, including 1-char identifiers,
+                * but NULL is a normal identifier.
+                */
+               .scan_identifier = TRUE,
+               .scan_identifier_1char = TRUE,
+               .scan_identifier_NULL = FALSE,
+
+               /*
+                * No specific symbols: null and boolean "symbols" are
+                * scanned as plain identifiers.
+                */
+               .scan_symbols = FALSE,
+               .symbol_2_token = FALSE,
+               .scope_0_fallback = FALSE,
+
+               /*
+                * Scan "0b"-, "0"-, and "0x"-prefixed integers, but not
+                * integers prefixed with "$".
+                */
+               .scan_binary = TRUE,
+               .scan_octal = TRUE,
+               .scan_float = TRUE,
+               .scan_hex = TRUE,
+               .scan_hex_dollar = FALSE,
+
+               /* Convert scanned numbers to integer tokens */
+               .numbers_2_int = TRUE,
+
+               /* Support both integers and floating-point numbers */
+               .int_2_float = FALSE,
+
+               /* Scan integers as 64-bit signed integers */
+               .store_int64 = TRUE,
+
+               /* Only scan double-quoted strings */
+               .scan_string_sq = FALSE,
+               .scan_string_dq = TRUE,
+
+               /* Do not converter identifiers to string tokens */
+               .identifier_2_string = FALSE,
+
+               /* Scan characters as G_TOKEN_CHAR token */
+               .char_2_token = FALSE,
+       };
+       struct ini_parsing_state state = {
+               .scanner = NULL,
+               .params = NULL,
+               .expecting = INI_EXPECT_MAP_KEY,
+               .arg = arg,
+               .ini_error = ini_error,
+       };
+
+       state.params = bt_value_map_create();
+       if (!state.params) {
+               goto error;
+       }
+
+       state.scanner = g_scanner_new(&scanner_config);
+       if (!state.scanner) {
+               goto error;
+       }
+
+       /* Let the scan begin */
+       g_scanner_input_text(state.scanner, arg, strlen(arg));
+
+       while (true) {
+               int ret = ini_handle_state(&state);
+
+               if (ret < 0) {
+                       /* Error */
+                       goto error;
+               } else if (ret > 0) {
+                       /* Done */
+                       break;
+               }
+       }
+
+       goto end;
+
+error:
+       BT_PUT(state.params);
+
+end:
+       if (state.scanner) {
+               g_scanner_destroy(state.scanner);
+       }
+
+       free(state.last_map_key);
+       return state.params;
+}
+
+/*
+ * Returns the parameters map value object from a command-line
+ * parameter option's argument.
+ *
+ * Return value is owned by the caller.
+ */
+static
+struct bt_value *bt_value_from_arg(const char *arg)
+{
+       struct bt_value *params = NULL;
+       GString *ini_error = NULL;
+
+       ini_error = g_string_new(NULL);
+       if (!ini_error) {
+               print_err_oom();
+               goto end;
+       }
+
+       /* Try INI-style parsing */
+       params = bt_value_from_ini(arg, ini_error);
+       if (!params) {
+               printf_err("%s", ini_error->str);
+               goto end;
+       }
+
+end:
+       if (ini_error) {
+               g_string_free(ini_error, TRUE);
+       }
+       return params;
+}
+
+/*
+ * Returns the plugin and component class names, and the instance name,
+ * from a command-line source/filter/sink option's argument. arg must
+ * have the following format:
+ *
+ *     [NAME:]PLUGIN.CLS
+ *
+ * where NAME is the optional component name, PLUGIN is the plugin name,
+ * and CLS is the component class name.
+ *
+ * On success, both *plugin and *component are not NULL. *plugin
+ * and *component are owned by the caller. On success, *name can be NULL
+ * if no component name was found.
+ */
+static
+void plugin_comp_cls_names(const char *arg, char **name, char **plugin,
+               char **comp_cls)
+{
+       const char *at = arg;
+       GString *gs_name = NULL;
+       GString *gs_plugin = NULL;
+       GString *gs_comp_cls = NULL;
+       size_t end_pos;
+
+       assert(arg);
+       assert(plugin);
+       assert(comp_cls);
+
+       if (!bt_common_string_is_printable(arg)) {
+               printf_err("Argument contains a non-printable character\n");
+               goto error;
+       }
+
+       /* Parse the component name */
+       gs_name = bt_common_string_until(at, ".:\\", ":", &end_pos);
+       if (!gs_name) {
+               goto error;
+       }
+
+       if (arg[end_pos] == ':') {
+               at += end_pos + 1;
+       } else {
+               /* No name */
+               g_string_assign(gs_name, "");
+       }
+
+       /* Parse the plugin name */
+       gs_plugin = bt_common_string_until(at, ".:\\", ".", &end_pos);
+       if (!gs_plugin || gs_plugin->len == 0 || at[end_pos] == '\0') {
+               goto error;
+       }
+
+       at += end_pos + 1;
+
+       /* Parse the component class name */
+       gs_comp_cls = bt_common_string_until(at, ".:\\", ".", &end_pos);
+       if (!gs_comp_cls || gs_comp_cls->len == 0) {
+               goto error;
+       }
+
+       if (at[end_pos] != '\0') {
+               /* Found a non-escaped `.` */
+               goto error;
+       }
+
+       if (name) {
+               if (gs_name->len == 0) {
+                       *name = NULL;
+                       g_string_free(gs_name, TRUE);
+               } else {
+                       *name = gs_name->str;
+                       g_string_free(gs_name, FALSE);
+               }
+       } else {
+               g_string_free(gs_name, TRUE);
+       }
+
+       *plugin = gs_plugin->str;
+       *comp_cls = gs_comp_cls->str;
+       g_string_free(gs_plugin, FALSE);
+       g_string_free(gs_comp_cls, FALSE);
+       gs_name = NULL;
+       gs_plugin = NULL;
+       gs_comp_cls = NULL;
+       goto end;
+
+error:
+       if (gs_name) {
+               g_string_free(gs_name, TRUE);
+       }
+
+       if (gs_plugin) {
+               g_string_free(gs_plugin, TRUE);
+       }
+
+       if (gs_comp_cls) {
+               g_string_free(gs_comp_cls, TRUE);
+       }
+
+       if (name) {
+               *name = NULL;
+       }
+
+       *plugin = NULL;
+       *comp_cls = NULL;
+
+end:
+       return;
+}
+
+/*
+ * Prints the Babeltrace version.
+ */
+static
+void print_version(void)
+{
+       puts("Babeltrace " VERSION);
+}
+
+/*
+ * Destroys a component configuration.
+ */
+static
+void bt_config_component_destroy(struct bt_object *obj)
+{
+       struct bt_config_component *bt_config_component =
+               container_of(obj, struct bt_config_component, base);
+
+       if (!obj) {
+               goto end;
+       }
+
+       if (bt_config_component->plugin_name) {
+               g_string_free(bt_config_component->plugin_name, TRUE);
+       }
+
+       if (bt_config_component->comp_cls_name) {
+               g_string_free(bt_config_component->comp_cls_name, TRUE);
+       }
+
+       if (bt_config_component->instance_name) {
+               g_string_free(bt_config_component->instance_name, TRUE);
+       }
+
+       BT_PUT(bt_config_component->params);
+       g_free(bt_config_component);
+
+end:
+       return;
+}
+
+/*
+ * Creates a component configuration using the given plugin name and
+ * component name. `plugin_name` and `comp_cls_name` are copied (belong
+ * to the return value).
+ *
+ * Return value is owned by the caller.
+ */
+static
+struct bt_config_component *bt_config_component_create(
+               enum bt_component_class_type type,
+               const char *plugin_name, const char *comp_cls_name)
+{
+       struct bt_config_component *cfg_component = NULL;
+
+       cfg_component = g_new0(struct bt_config_component, 1);
+       if (!cfg_component) {
+               print_err_oom();
+               goto error;
+       }
+
+       bt_object_init(cfg_component, bt_config_component_destroy);
+       cfg_component->type = type;
+       cfg_component->plugin_name = g_string_new(plugin_name);
+       if (!cfg_component->plugin_name) {
+               print_err_oom();
+               goto error;
+       }
+
+       cfg_component->comp_cls_name = g_string_new(comp_cls_name);
+       if (!cfg_component->comp_cls_name) {
+               print_err_oom();
+               goto error;
+       }
+
+       cfg_component->instance_name = g_string_new(NULL);
+       if (!cfg_component->instance_name) {
+               print_err_oom();
+               goto error;
+       }
+
+       /* Start with empty parameters */
+       cfg_component->params = bt_value_map_create();
+       if (!cfg_component->params) {
+               print_err_oom();
+               goto error;
+       }
+
+       goto end;
+
+error:
+       BT_PUT(cfg_component);
+
+end:
+       return cfg_component;
+}
+
+/*
+ * Creates a component configuration from a command-line source/sink
+ * option's argument.
+ */
+static
+struct bt_config_component *bt_config_component_from_arg(
+               enum bt_component_class_type type, const char *arg)
+{
+       struct bt_config_component *cfg_comp = NULL;
+       char *name = NULL;
+       char *plugin_name = NULL;
+       char *comp_cls_name = NULL;
+
+       plugin_comp_cls_names(arg, &name, &plugin_name, &comp_cls_name);
+       if (!plugin_name || !comp_cls_name) {
+               printf_err("Cannot get plugin or component class name\n");
+               goto error;
+       }
+
+       cfg_comp = bt_config_component_create(type, plugin_name, comp_cls_name);
+       if (!cfg_comp) {
+               goto error;
+       }
+
+       if (name) {
+               g_string_assign(cfg_comp->instance_name, name);
+       }
+
+       goto end;
+
+error:
+       BT_PUT(cfg_comp);
+
+end:
+       g_free(name);
+       g_free(plugin_name);
+       g_free(comp_cls_name);
+       return cfg_comp;
+}
+
+/*
+ * Destroys a configuration.
+ */
+static
+void bt_config_destroy(struct bt_object *obj)
+{
+       struct bt_config *cfg =
+               container_of(obj, struct bt_config, base);
+
+       if (!obj) {
+               goto end;
+       }
+
+       BT_PUT(cfg->plugin_paths);
+
+       switch (cfg->command) {
+       case BT_CONFIG_COMMAND_RUN:
+               if (cfg->cmd_data.run.sources) {
+                       g_ptr_array_free(cfg->cmd_data.run.sources, TRUE);
+               }
+
+               if (cfg->cmd_data.run.filters) {
+                       g_ptr_array_free(cfg->cmd_data.run.filters, TRUE);
+               }
+
+               if (cfg->cmd_data.run.sinks) {
+                       g_ptr_array_free(cfg->cmd_data.run.sinks, TRUE);
+               }
+
+               if (cfg->cmd_data.run.connections) {
+                       g_ptr_array_free(cfg->cmd_data.run.connections,
+                               TRUE);
+               }
+               break;
+       case BT_CONFIG_COMMAND_LIST_PLUGINS:
+               break;
+       case BT_CONFIG_COMMAND_HELP:
+               BT_PUT(cfg->cmd_data.help.cfg_component);
+               break;
+       case BT_CONFIG_COMMAND_QUERY:
+               BT_PUT(cfg->cmd_data.query.cfg_component);
+
+               if (cfg->cmd_data.query.object) {
+                       g_string_free(cfg->cmd_data.query.object, TRUE);
+               }
+               break;
+       case BT_CONFIG_COMMAND_PRINT_CTF_METADATA:
+               if (cfg->cmd_data.print_ctf_metadata.path) {
+                       g_string_free(cfg->cmd_data.print_ctf_metadata.path,
+                               TRUE);
+               }
+               break;
+       case BT_CONFIG_COMMAND_PRINT_LTTNG_LIVE_SESSIONS:
+               if (cfg->cmd_data.print_lttng_live_sessions.url) {
+                       g_string_free(
+                               cfg->cmd_data.print_lttng_live_sessions.url,
+                               TRUE);
+               }
+               break;
+       default:
+               assert(false);
+       }
+
+       g_free(cfg);
+
+end:
+       return;
+}
+
+static
+void destroy_glist_of_gstring(GList *list)
+{
+       if (!list) {
+               return;
+       }
+
+       GList *at;
+
+       for (at = list; at != NULL; at = g_list_next(at)) {
+               g_string_free(at->data, TRUE);
+       }
+
+       g_list_free(list);
+}
+
+/*
+ * Creates a simple lexical scanner for parsing comma-delimited names
+ * and fields.
+ *
+ * Return value is owned by the caller.
+ */
+static
+GScanner *create_csv_identifiers_scanner(void)
+{
+       GScanner *scanner;
+       GScannerConfig scanner_config = {
+               .cset_skip_characters = " \t\n",
+               .cset_identifier_first = G_CSET_a_2_z G_CSET_A_2_Z "_",
+               .cset_identifier_nth = G_CSET_a_2_z G_CSET_A_2_Z ":_-",
+               .case_sensitive = TRUE,
+               .cpair_comment_single = NULL,
+               .skip_comment_multi = TRUE,
+               .skip_comment_single = TRUE,
+               .scan_comment_multi = FALSE,
+               .scan_identifier = TRUE,
+               .scan_identifier_1char = TRUE,
+               .scan_identifier_NULL = FALSE,
+               .scan_symbols = FALSE,
+               .symbol_2_token = FALSE,
+               .scope_0_fallback = FALSE,
+               .scan_binary = FALSE,
+               .scan_octal = FALSE,
+               .scan_float = FALSE,
+               .scan_hex = FALSE,
+               .scan_hex_dollar = FALSE,
+               .numbers_2_int = FALSE,
+               .int_2_float = FALSE,
+               .store_int64 = FALSE,
+               .scan_string_sq = FALSE,
+               .scan_string_dq = FALSE,
+               .identifier_2_string = FALSE,
+               .char_2_token = TRUE,
+       };
+
+       scanner = g_scanner_new(&scanner_config);
+       if (!scanner) {
+               print_err_oom();
+       }
+
+       return scanner;
+}
+
+/*
+ * Converts a comma-delimited list of known names (--names option) to
+ * an array value object containing those names as string value objects.
+ *
+ * Return value is owned by the caller.
+ */
+static
+struct bt_value *names_from_arg(const char *arg)
+{
+       GScanner *scanner = NULL;
+       struct bt_value *names = NULL;
+       bool found_all = false, found_none = false, found_item = false;
+
+       names = bt_value_array_create();
+       if (!names) {
+               print_err_oom();
+               goto error;
+       }
+
+       scanner = create_csv_identifiers_scanner();
+       if (!scanner) {
+               goto error;
+       }
+
+       g_scanner_input_text(scanner, arg, strlen(arg));
+
+       while (true) {
+               GTokenType token_type = g_scanner_get_next_token(scanner);
+
+               switch (token_type) {
+               case G_TOKEN_IDENTIFIER:
+               {
+                       const char *identifier = scanner->value.v_identifier;
+
+                       if (!strcmp(identifier, "payload") ||
+                                       !strcmp(identifier, "args") ||
+                                       !strcmp(identifier, "arg")) {
+                               found_item = true;
+                               if (bt_value_array_append_string(names,
+                                               "payload")) {
+                                       goto error;
+                               }
+                       } else if (!strcmp(identifier, "context") ||
+                                       !strcmp(identifier, "ctx")) {
+                               found_item = true;
+                               if (bt_value_array_append_string(names,
+                                               "context")) {
+                                       goto error;
+                               }
+                       } else if (!strcmp(identifier, "scope") ||
+                                       !strcmp(identifier, "header")) {
+                               found_item = true;
+                               if (bt_value_array_append_string(names,
+                                               identifier)) {
+                                       goto error;
+                               }
+                       } else if (!strcmp(identifier, "all")) {
+                               found_all = true;
+                               if (bt_value_array_append_string(names,
+                                               identifier)) {
+                                       goto error;
+                               }
+                       } else if (!strcmp(identifier, "none")) {
+                               found_none = true;
+                               if (bt_value_array_append_string(names,
+                                               identifier)) {
+                                       goto error;
+                               }
+                       } else {
+                               printf_err("Unknown name: `%s`\n",
+                                       identifier);
+                               goto error;
+                       }
+                       break;
+               }
+               case G_TOKEN_COMMA:
+                       continue;
+               case G_TOKEN_EOF:
+                       goto end;
+               default:
+                       goto error;
+               }
+       }
+
+end:
+       if (found_none && found_all) {
+               printf_err("Only either `all` or `none` can be specified in the list given to the --names option, but not both.\n");
+               goto error;
+       }
+       /*
+        * Legacy behavior is to clear the defaults (show none) when at
+        * least one item is specified.
+        */
+       if (found_item && !found_none && !found_all) {
+               if (bt_value_array_append_string(names, "none")) {
+                       goto error;
+               }
+       }
+       if (scanner) {
+               g_scanner_destroy(scanner);
+       }
+       return names;
+
+error:
+       BT_PUT(names);
+       if (scanner) {
+               g_scanner_destroy(scanner);
+       }
+       return names;
+}
+
+/*
+ * Converts a comma-delimited list of known fields (--fields option) to
+ * an array value object containing those fields as string
+ * value objects.
+ *
+ * Return value is owned by the caller.
+ */
+static
+struct bt_value *fields_from_arg(const char *arg)
+{
+       GScanner *scanner = NULL;
+       struct bt_value *fields;
+
+       fields = bt_value_array_create();
+       if (!fields) {
+               print_err_oom();
+               goto error;
+       }
+
+       scanner = create_csv_identifiers_scanner();
+       if (!scanner) {
+               goto error;
+       }
+
+       g_scanner_input_text(scanner, arg, strlen(arg));
+
+       while (true) {
+               GTokenType token_type = g_scanner_get_next_token(scanner);
+
+               switch (token_type) {
+               case G_TOKEN_IDENTIFIER:
+               {
+                       const char *identifier = scanner->value.v_identifier;
+
+                       if (!strcmp(identifier, "trace") ||
+                                       !strcmp(identifier, "trace:hostname") ||
+                                       !strcmp(identifier, "trace:domain") ||
+                                       !strcmp(identifier, "trace:procname") ||
+                                       !strcmp(identifier, "trace:vpid") ||
+                                       !strcmp(identifier, "loglevel") ||
+                                       !strcmp(identifier, "emf") ||
+                                       !strcmp(identifier, "callsite") ||
+                                       !strcmp(identifier, "all")) {
+                               if (bt_value_array_append_string(fields,
+                                               identifier)) {
+                                       goto error;
+                               }
+                       } else {
+                               printf_err("Unknown field: `%s`\n",
+                                       identifier);
+                               goto error;
+                       }
+                       break;
+               }
+               case G_TOKEN_COMMA:
+                       continue;
+               case G_TOKEN_EOF:
+                       goto end;
+               default:
+                       goto error;
+               }
+       }
+
+       goto end;
+
+error:
+       BT_PUT(fields);
+
+end:
+       if (scanner) {
+               g_scanner_destroy(scanner);
+       }
+       return fields;
+}
+
+static
+void append_param_arg(GString *params_arg, const char *key, const char *value)
+{
+       assert(params_arg);
+       assert(key);
+       assert(value);
+
+       if (params_arg->len != 0) {
+               g_string_append_c(params_arg, ',');
+       }
+
+       g_string_append(params_arg, key);
+       g_string_append_c(params_arg, '=');
+       g_string_append(params_arg, value);
+}
+
+/*
+ * Inserts the equivalent "prefix-NAME=yes" strings into params_arg
+ * where the names are in names_array.
+ */
+static
+int insert_flat_params_from_array(GString *params_arg,
+               struct bt_value *names_array, const char *prefix)
+{
+       int ret = 0;
+       int i;
+       GString *tmpstr = NULL, *default_value = NULL;
+       bool default_set = false, non_default_set = false;
+
+       /*
+        * names_array may be NULL if no CLI options were specified to
+        * trigger its creation.
+        */
+       if (!names_array) {
+               goto end;
+       }
+
+       tmpstr = g_string_new(NULL);
+       if (!tmpstr) {
+               print_err_oom();
+               ret = -1;
+               goto end;
+       }
+
+       default_value = g_string_new(NULL);
+       if (!default_value) {
+               print_err_oom();
+               ret = -1;
+               goto end;
+       }
+
+       for (i = 0; i < bt_value_array_size(names_array); i++) {
+               struct bt_value *str_obj = bt_value_array_get(names_array, i);
+               const char *suffix;
+               bool is_default = false;
+
+               if (!str_obj) {
+                       printf_err("Unexpected error\n");
+                       ret = -1;
+                       goto end;
+               }
+
+               ret = bt_value_string_get(str_obj, &suffix);
+               BT_PUT(str_obj);
+               if (ret) {
+                       printf_err("Unexpected error\n");
+                       goto end;
+               }
+
+               g_string_assign(tmpstr, prefix);
+               g_string_append(tmpstr, "-");
+
+               /* Special-case for "all" and "none". */
+               if (!strcmp(suffix, "all")) {
+                       is_default = true;
+                       g_string_assign(default_value, "show");
+               } else if (!strcmp(suffix, "none")) {
+                       is_default = true;
+                       g_string_assign(default_value, "hide");
+               }
+               if (is_default) {
+                       default_set = true;
+                       g_string_append(tmpstr, "default");
+                       append_param_arg(params_arg, tmpstr->str,
+                               default_value->str);
+               } else {
+                       non_default_set = true;
+                       g_string_append(tmpstr, suffix);
+                       append_param_arg(params_arg, tmpstr->str, "yes");
+               }
+       }
+
+       /* Implicit field-default=hide if any non-default option is set. */
+       if (non_default_set && !default_set) {
+               g_string_assign(tmpstr, prefix);
+               g_string_append(tmpstr, "-default");
+               g_string_assign(default_value, "hide");
+               append_param_arg(params_arg, tmpstr->str, default_value->str);
+       }
+
+end:
+       if (default_value) {
+               g_string_free(default_value, TRUE);
+       }
+
+       if (tmpstr) {
+               g_string_free(tmpstr, TRUE);
+       }
+
+       return ret;
+}
+
+/* popt options */
+enum {
+       OPT_NONE = 0,
+       OPT_BASE_PARAMS,
+       OPT_BEGIN,
+       OPT_CLOCK_CYCLES,
+       OPT_CLOCK_DATE,
+       OPT_CLOCK_FORCE_CORRELATE,
+       OPT_CLOCK_GMT,
+       OPT_CLOCK_OFFSET,
+       OPT_CLOCK_OFFSET_NS,
+       OPT_CLOCK_SECONDS,
+       OPT_COLOR,
+       OPT_CONNECT,
+       OPT_DEBUG,
+       OPT_DEBUG_INFO_DIR,
+       OPT_DEBUG_INFO_FULL_PATH,
+       OPT_DEBUG_INFO_TARGET_PREFIX,
+       OPT_END,
+       OPT_FIELDS,
+       OPT_FILTER,
+       OPT_HELP,
+       OPT_INPUT_FORMAT,
+       OPT_KEY,
+       OPT_LIST,
+       OPT_NAME,
+       OPT_NAMES,
+       OPT_NO_DEBUG_INFO,
+       OPT_NO_DELTA,
+       OPT_OMIT_HOME_PLUGIN_PATH,
+       OPT_OMIT_SYSTEM_PLUGIN_PATH,
+       OPT_OUTPUT_FORMAT,
+       OPT_OUTPUT,
+       OPT_PARAMS,
+       OPT_PATH,
+       OPT_PLUGIN_PATH,
+       OPT_RESET_BASE_PARAMS,
+       OPT_RETRY_DURATION,
+       OPT_RUN_ARGS,
+       OPT_RUN_ARGS_0,
+       OPT_SINK,
+       OPT_SOURCE,
+       OPT_STREAM_INTERSECTION,
+       OPT_TIMERANGE,
+       OPT_URL,
+       OPT_VALUE,
+       OPT_VERBOSE,
+};
+
+enum bt_config_component_dest {
+       BT_CONFIG_COMPONENT_DEST_SOURCE,
+       BT_CONFIG_COMPONENT_DEST_FILTER,
+       BT_CONFIG_COMPONENT_DEST_SINK,
+};
+
+/*
+ * Adds a configuration component to the appropriate configuration
+ * array depending on the destination.
+ */
+static
+void add_run_cfg_comp(struct bt_config *cfg,
+               struct bt_config_component *cfg_comp,
+               enum bt_config_component_dest dest)
+{
+       bt_get(cfg_comp);
+
+       switch (dest) {
+       case BT_CONFIG_COMPONENT_DEST_SOURCE:
+               g_ptr_array_add(cfg->cmd_data.run.sources, cfg_comp);
+               break;
+       case BT_CONFIG_COMPONENT_DEST_FILTER:
+               g_ptr_array_add(cfg->cmd_data.run.filters, cfg_comp);
+               break;
+       case BT_CONFIG_COMPONENT_DEST_SINK:
+               g_ptr_array_add(cfg->cmd_data.run.sinks, cfg_comp);
+               break;
+       default:
+               assert(false);
+       }
+}
+
+static
+int add_run_cfg_comp_check_name(struct bt_config *cfg,
+               struct bt_config_component *cfg_comp,
+               enum bt_config_component_dest dest,
+               struct bt_value *instance_names)
+{
+       int ret = 0;
+
+       if (cfg_comp->instance_name->len == 0) {
+               printf_err("Found an unnamed component\n");
+               ret = -1;
+               goto end;
+       }
+
+       if (bt_value_map_has_key(instance_names, cfg_comp->instance_name->str)) {
+               printf_err("Duplicate component instance name:\n    %s\n",
+                       cfg_comp->instance_name->str);
+               ret = -1;
+               goto end;
+       }
+
+       if (bt_value_map_insert(instance_names,
+                       cfg_comp->instance_name->str, bt_value_null)) {
+               print_err_oom();
+               ret = -1;
+               goto end;
+       }
+
+       add_run_cfg_comp(cfg, cfg_comp, dest);
+
+end:
+       return ret;
+}
+
+static
+int append_env_var_plugin_paths(struct bt_value *plugin_paths)
+{
+       int ret = 0;
+       const char *envvar;
+
+       if (bt_common_is_setuid_setgid()) {
+               printf_debug("Skipping non-system plugin paths for setuid/setgid binary\n");
+               goto end;
+       }
+
+       envvar = getenv("BABELTRACE_PLUGIN_PATH");
+       if (!envvar) {
+               goto end;
+       }
+
+       ret = bt_config_append_plugin_paths(plugin_paths, envvar);
+
+end:
+       if (ret) {
+               printf_err("Cannot append plugin paths from BABELTRACE_PLUGIN_PATH\n");
+       }
+
+       return ret;
+}
+
+static
+int append_home_and_system_plugin_paths(struct bt_value *plugin_paths,
+               bool omit_system_plugin_path, bool omit_home_plugin_path)
+{
+       int ret;
+
+       if (!omit_home_plugin_path) {
+               if (bt_common_is_setuid_setgid()) {
+                       printf_debug("Skipping non-system plugin paths for setuid/setgid binary\n");
+               } else {
+                       char *home_plugin_dir =
+                               bt_common_get_home_plugin_path();
+
+                       if (home_plugin_dir) {
+                               ret = bt_config_append_plugin_paths(
+                                       plugin_paths, home_plugin_dir);
+                               free(home_plugin_dir);
+
+                               if (ret) {
+                                       printf_err("Invalid home plugin path\n");
+                                       goto error;
+                               }
+                       }
+               }
+       }
+
+       if (!omit_system_plugin_path) {
+               if (bt_config_append_plugin_paths(plugin_paths,
+                               bt_common_get_system_plugin_path())) {
+                       printf_err("Invalid system plugin path\n");
+                       goto error;
+               }
+       }
+       return 0;
+error:
+       printf_err("Cannot append home and system plugin paths\n");
+       return -1;
+}
+
+static
+int append_home_and_system_plugin_paths_cfg(struct bt_config *cfg)
+{
+       return append_home_and_system_plugin_paths(cfg->plugin_paths,
+               cfg->omit_system_plugin_path, cfg->omit_home_plugin_path);
+}
+
+static
+struct bt_config *bt_config_base_create(enum bt_config_command command,
+               struct bt_value *initial_plugin_paths, bool needs_plugins)
+{
+       struct bt_config *cfg;
+
+       /* Create config */
+       cfg = g_new0(struct bt_config, 1);
+       if (!cfg) {
+               print_err_oom();
+               goto error;
+       }
+
+       bt_object_init(cfg, bt_config_destroy);
+       cfg->command = command;
+       cfg->command_needs_plugins = needs_plugins;
+
+       if (initial_plugin_paths) {
+               cfg->plugin_paths = bt_get(initial_plugin_paths);
+       } else {
+               cfg->plugin_paths = bt_value_array_create();
+               if (!cfg->plugin_paths) {
+                       print_err_oom();
+                       goto error;
+               }
+       }
+
+       goto end;
+
+error:
+       BT_PUT(cfg);
+
+end:
+       return cfg;
+}
+
+static
+struct bt_config *bt_config_run_create(
+               struct bt_value *initial_plugin_paths)
+{
+       struct bt_config *cfg;
+
+       /* Create config */
+       cfg = bt_config_base_create(BT_CONFIG_COMMAND_RUN,
+               initial_plugin_paths, true);
+       if (!cfg) {
+               goto error;
+       }
+
+       cfg->cmd_data.run.sources = g_ptr_array_new_with_free_func(
+               (GDestroyNotify) bt_put);
+       if (!cfg->cmd_data.run.sources) {
+               print_err_oom();
+               goto error;
+       }
+
+       cfg->cmd_data.run.filters = g_ptr_array_new_with_free_func(
+               (GDestroyNotify) bt_put);
+       if (!cfg->cmd_data.run.filters) {
+               print_err_oom();
+               goto error;
+       }
+
+       cfg->cmd_data.run.sinks = g_ptr_array_new_with_free_func(
+               (GDestroyNotify) bt_put);
+       if (!cfg->cmd_data.run.sinks) {
+               print_err_oom();
+               goto error;
+       }
+
+       cfg->cmd_data.run.connections = g_ptr_array_new_with_free_func(
+               (GDestroyNotify) bt_config_connection_destroy);
+       if (!cfg->cmd_data.run.connections) {
+               print_err_oom();
+               goto error;
+       }
+
+       goto end;
+
+error:
+       BT_PUT(cfg);
+
+end:
+       return cfg;
+}
+
+static
+struct bt_config *bt_config_list_plugins_create(
+               struct bt_value *initial_plugin_paths)
+{
+       struct bt_config *cfg;
+
+       /* Create config */
+       cfg = bt_config_base_create(BT_CONFIG_COMMAND_LIST_PLUGINS,
+               initial_plugin_paths, true);
+       if (!cfg) {
+               goto error;
+       }
+
+       goto end;
+
+error:
+       BT_PUT(cfg);
+
+end:
+       return cfg;
+}
+
+static
+struct bt_config *bt_config_help_create(
+               struct bt_value *initial_plugin_paths)
+{
+       struct bt_config *cfg;
+
+       /* Create config */
+       cfg = bt_config_base_create(BT_CONFIG_COMMAND_HELP,
+               initial_plugin_paths, true);
+       if (!cfg) {
+               goto error;
+       }
+
+       cfg->cmd_data.help.cfg_component =
+               bt_config_component_create(BT_COMPONENT_CLASS_TYPE_UNKNOWN,
+                       NULL, NULL);
+       if (!cfg->cmd_data.help.cfg_component) {
+               goto error;
+       }
+
+       goto end;
+
+error:
+       BT_PUT(cfg);
+
+end:
+       return cfg;
+}
+
+static
+struct bt_config *bt_config_query_create(
+               struct bt_value *initial_plugin_paths)
+{
+       struct bt_config *cfg;
+
+       /* Create config */
+       cfg = bt_config_base_create(BT_CONFIG_COMMAND_QUERY,
+               initial_plugin_paths, true);
+       if (!cfg) {
+               goto error;
+       }
+
+       cfg->cmd_data.query.object = g_string_new(NULL);
+       if (!cfg->cmd_data.query.object) {
+               print_err_oom();
+               goto error;
+       }
+
+       goto end;
+
+error:
+       BT_PUT(cfg);
+
+end:
+       return cfg;
+}
+
+static
+struct bt_config *bt_config_print_ctf_metadata_create(
+               struct bt_value *initial_plugin_paths)
+{
+       struct bt_config *cfg;
+
+       /* Create config */
+       cfg = bt_config_base_create(BT_CONFIG_COMMAND_PRINT_CTF_METADATA,
+               initial_plugin_paths, true);
+       if (!cfg) {
+               goto error;
+       }
+
+       cfg->cmd_data.print_ctf_metadata.path = g_string_new(NULL);
+       if (!cfg->cmd_data.print_ctf_metadata.path) {
+               print_err_oom();
+               goto error;
+       }
+
+       goto end;
+
+error:
+       BT_PUT(cfg);
+
+end:
+       return cfg;
+}
+
+static
+struct bt_config *bt_config_print_lttng_live_sessions_create(
+               struct bt_value *initial_plugin_paths)
+{
+       struct bt_config *cfg;
+
+       /* Create config */
+       cfg = bt_config_base_create(BT_CONFIG_COMMAND_PRINT_LTTNG_LIVE_SESSIONS,
+               initial_plugin_paths, true);
+       if (!cfg) {
+               goto error;
+       }
+
+       cfg->cmd_data.print_lttng_live_sessions.url = g_string_new(NULL);
+       if (!cfg->cmd_data.print_lttng_live_sessions.url) {
+               print_err_oom();
+               goto error;
+       }
+
+       goto end;
+
+error:
+       BT_PUT(cfg);
+
+end:
+       return cfg;
+}
+
+static
+int bt_config_append_plugin_paths_check_setuid_setgid(
+               struct bt_value *plugin_paths, const char *arg)
+{
+       int ret = 0;
+
+       if (bt_common_is_setuid_setgid()) {
+               printf_debug("Skipping non-system plugin paths for setuid/setgid binary\n");
+               goto end;
+       }
+
+       if (bt_config_append_plugin_paths(plugin_paths, arg)) {
+               printf_err("Invalid --plugin-path option's argument:\n    %s\n",
+                       arg);
+               ret = -1;
+               goto end;
+       }
+
+end:
+       return ret;
+}
+
+/*
+ * Prints the expected format for a --params option.
+ */
+static
+void print_expected_params_format(FILE *fp)
+{
+       fprintf(fp, "Expected format of PARAMS\n");
+       fprintf(fp, "-------------------------\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "    PARAM=VALUE[,PARAM=VALUE]...\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "The parameter string is a comma-separated list of PARAM=VALUE assignments,\n");
+       fprintf(fp, "where PARAM is the parameter name (C identifier plus the [:.-] characters),\n");
+       fprintf(fp, "and VALUE can be one of:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "* `null`, `nul`, `NULL`: null value (no backticks).\n");
+       fprintf(fp, "* `true`, `TRUE`, `yes`, `YES`: true boolean value (no backticks).\n");
+       fprintf(fp, "* `false`, `FALSE`, `no`, `NO`: false boolean value (no backticks).\n");
+       fprintf(fp, "* Binary (`0b` prefix), octal (`0` prefix), decimal, or hexadecimal\n");
+       fprintf(fp, "  (`0x` prefix) signed 64-bit integer.\n");
+       fprintf(fp, "* Double precision floating point number (scientific notation is accepted).\n");
+       fprintf(fp, "* Unquoted string with no special characters, and not matching any of\n");
+       fprintf(fp, "  the null and boolean value symbols above.\n");
+       fprintf(fp, "* Double-quoted string (accepts escape characters).\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "You can put whitespaces allowed around individual `=` and `,` symbols.\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Example:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "    many=null, fresh=yes, condition=false, squirrel=-782329,\n");
+       fprintf(fp, "    observe=3.14, simple=beef, needs-quotes=\"some string\",\n");
+       fprintf(fp, "    escape.chars-are:allowed=\"this is a \\\" double quote\"\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "IMPORTANT: Make sure to single-quote the whole argument when you run\n");
+       fprintf(fp, "babeltrace from a shell.\n");
+}
+
+
+/*
+ * Prints the help command usage.
+ */
+static
+void print_help_usage(FILE *fp)
+{
+       fprintf(fp, "Usage: babeltrace [GENERAL OPTIONS] help [OPTIONS] PLUGIN\n");
+       fprintf(fp, "       babeltrace [GENERAL OPTIONS] help [OPTIONS] --source=PLUGIN.CLS\n");
+       fprintf(fp, "       babeltrace [GENERAL OPTIONS] help [OPTIONS] --filter=PLUGIN.CLS\n");
+       fprintf(fp, "       babeltrace [GENERAL OPTIONS] help [OPTIONS] --sink=PLUGIN.CLS\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Options:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "  -f, --filter=PLUGIN.CLS           Get help for the filter component class\n");
+       fprintf(fp, "                                    CLS found in the plugin PLUGIN\n");
+       fprintf(fp, "      --omit-home-plugin-path       Omit home plugins from plugin search path\n");
+       fprintf(fp, "                                    (~/.local/lib/babeltrace/plugins)\n");
+       fprintf(fp, "      --omit-system-plugin-path     Omit system plugins from plugin search path\n");
+       fprintf(fp, "      --plugin-path=PATH[:PATH]...  Add PATH to the list of paths from which\n");
+       fprintf(fp, "                                    dynamic plugins can be loaded\n");
+       fprintf(fp, "  -S, --sink=PLUGIN.CLS             Get help for the sink component class\n");
+       fprintf(fp, "                                    CLS found in the plugin PLUGIN\n");
+       fprintf(fp, "  -s, --source=PLUGIN.CLS           Get help for the source component class\n");
+       fprintf(fp, "                                    CLS found in the plugin PLUGIN\n");
+       fprintf(fp, "  -h  --help                        Show this help and quit\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "See `babeltrace --help` for the list of general options.\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Use `babeltrace list-plugins` to show the list of available plugins.\n");
+}
+
+static
+struct poptOption help_long_options[] = {
+       /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
+       { "filter", 'f', POPT_ARG_STRING, NULL, OPT_FILTER, NULL, NULL },
+       { "help", 'h', POPT_ARG_NONE, NULL, OPT_HELP, NULL, NULL },
+       { "omit-home-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_HOME_PLUGIN_PATH, NULL, NULL },
+       { "omit-system-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_SYSTEM_PLUGIN_PATH, NULL, NULL },
+       { "plugin-path", '\0', POPT_ARG_STRING, NULL, OPT_PLUGIN_PATH, NULL, NULL },
+       { "sink", 'S', POPT_ARG_STRING, NULL, OPT_SINK, NULL, NULL },
+       { "source", 's', POPT_ARG_STRING, NULL, OPT_SOURCE, NULL, NULL },
+       { NULL, 0, '\0', NULL, 0, NULL, NULL },
+};
+
+/*
+ * Creates a Babeltrace config object from the arguments of a help
+ * command.
+ *
+ * *retcode is set to the appropriate exit code to use.
+ */
+static
+struct bt_config *bt_config_help_from_args(int argc, const char *argv[],
+               int *retcode, bool force_omit_system_plugin_path,
+               bool force_omit_home_plugin_path,
+               struct bt_value *initial_plugin_paths)
+{
+       poptContext pc = NULL;
+       char *arg = NULL;
+       int opt;
+       int ret;
+       struct bt_config *cfg = NULL;
+       const char *leftover;
+       char *plugin_name = NULL, *comp_cls_name = NULL;
+       char *plug_comp_cls_names = NULL;
+
+       *retcode = 0;
+       cfg = bt_config_help_create(initial_plugin_paths);
+       if (!cfg) {
+               goto error;
+       }
+
+       cfg->omit_system_plugin_path = force_omit_system_plugin_path;
+       cfg->omit_home_plugin_path = force_omit_home_plugin_path;
+       ret = append_env_var_plugin_paths(cfg->plugin_paths);
+       if (ret) {
+               goto error;
+       }
+
+       /* Parse options */
+       pc = poptGetContext(NULL, argc, (const char **) argv,
+               help_long_options, 0);
+       if (!pc) {
+               printf_err("Cannot get popt context\n");
+               goto error;
+       }
+
+       poptReadDefaultConfig(pc, 0);
+
+       while ((opt = poptGetNextOpt(pc)) > 0) {
+               arg = poptGetOptArg(pc);
+
+               switch (opt) {
+               case OPT_PLUGIN_PATH:
+                       if (bt_config_append_plugin_paths_check_setuid_setgid(
+                                       cfg->plugin_paths, arg)) {
+                               goto error;
+                       }
+                       break;
+               case OPT_OMIT_SYSTEM_PLUGIN_PATH:
+                       cfg->omit_system_plugin_path = true;
+                       break;
+               case OPT_OMIT_HOME_PLUGIN_PATH:
+                       cfg->omit_home_plugin_path = true;
+                       break;
+               case OPT_SOURCE:
+               case OPT_FILTER:
+               case OPT_SINK:
+                       if (cfg->cmd_data.help.cfg_component->type !=
+                                       BT_COMPONENT_CLASS_TYPE_UNKNOWN) {
+                               printf_err("Cannot specify more than one plugin and component class:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       switch (opt) {
+                       case OPT_SOURCE:
+                               cfg->cmd_data.help.cfg_component->type =
+                                       BT_COMPONENT_CLASS_TYPE_SOURCE;
+                               break;
+                       case OPT_FILTER:
+                               cfg->cmd_data.help.cfg_component->type =
+                                       BT_COMPONENT_CLASS_TYPE_FILTER;
+                               break;
+                       case OPT_SINK:
+                               cfg->cmd_data.help.cfg_component->type =
+                                       BT_COMPONENT_CLASS_TYPE_SINK;
+                               break;
+                       default:
+                               assert(false);
+                       }
+                       plug_comp_cls_names = strdup(arg);
+                       if (!plug_comp_cls_names) {
+                               print_err_oom();
+                               goto error;
+                       }
+                       break;
+               case OPT_HELP:
+                       print_help_usage(stdout);
+                       *retcode = -1;
+                       BT_PUT(cfg);
+                       goto end;
+               default:
+                       printf_err("Unknown command-line option specified (option code %d)\n",
+                               opt);
+                       goto error;
+               }
+
+               free(arg);
+               arg = NULL;
+       }
+
+       /* Check for option parsing error */
+       if (opt < -1) {
+               printf_err("While parsing command-line options, at option %s: %s\n",
+                       poptBadOption(pc, 0), poptStrerror(opt));
+               goto error;
+       }
+
+       leftover = poptGetArg(pc);
+       if (leftover) {
+               if (cfg->cmd_data.help.cfg_component->type !=
+                                       BT_COMPONENT_CLASS_TYPE_UNKNOWN) {
+                       printf_err("Cannot specify plugin name and --source/--filter/--sink component class:\n    %s\n",
+                               leftover);
+                       goto error;
+               }
+
+               g_string_assign(cfg->cmd_data.help.cfg_component->plugin_name,
+                       leftover);
+       } else {
+               if (cfg->cmd_data.help.cfg_component->type ==
+                                       BT_COMPONENT_CLASS_TYPE_UNKNOWN) {
+                       print_help_usage(stdout);
+                       *retcode = -1;
+                       BT_PUT(cfg);
+                       goto end;
+               }
+
+               plugin_comp_cls_names(plug_comp_cls_names, NULL,
+                       &plugin_name, &comp_cls_name);
+               if (plugin_name && comp_cls_name) {
+                       g_string_assign(cfg->cmd_data.help.cfg_component->plugin_name,
+                               plugin_name);
+                       g_string_assign(cfg->cmd_data.help.cfg_component->comp_cls_name,
+                               comp_cls_name);
+               } else {
+                       printf_err("Invalid --source/--filter/--sink option's argument:\n    %s\n",
+                               plug_comp_cls_names);
+                       goto error;
+               }
+       }
+
+       if (append_home_and_system_plugin_paths_cfg(cfg)) {
+               goto error;
+       }
+
+       goto end;
+
+error:
+       *retcode = 1;
+       BT_PUT(cfg);
+
+end:
+       free(plug_comp_cls_names);
+       g_free(plugin_name);
+       g_free(comp_cls_name);
+
+       if (pc) {
+               poptFreeContext(pc);
+       }
+
+       free(arg);
+       return cfg;
+}
+
+/*
+ * Prints the help command usage.
+ */
+static
+void print_query_usage(FILE *fp)
+{
+       fprintf(fp, "Usage: babeltrace [GEN OPTS] query [OPTS] OBJECT --source=PLUGIN.CLS\n");
+       fprintf(fp, "       babeltrace [GEN OPTS] query [OPTS] OBJECT --filter=PLUGIN.CLS\n");
+       fprintf(fp, "       babeltrace [GEN OPTS] query [OPTS] OBJECT --sink=PLUGIN.CLS\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Options:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "  -f. --filter=PLUGIN.CLS           Query object from the filter component\n");
+       fprintf(fp, "                                    class CLS found in the plugin PLUGIN\n");
+       fprintf(fp, "      --omit-home-plugin-path       Omit home plugins from plugin search path\n");
+       fprintf(fp, "                                    (~/.local/lib/babeltrace/plugins)\n");
+       fprintf(fp, "      --omit-system-plugin-path     Omit system plugins from plugin search path\n");
+       fprintf(fp, "  -p, --params=PARAMS               Set the query parameters to PARAMS\n");
+       fprintf(fp, "                                    (see the expected format of PARAMS below)\n");
+       fprintf(fp, "      --plugin-path=PATH[:PATH]...  Add PATH to the list of paths from which\n");
+       fprintf(fp, "                                    dynamic plugins can be loaded\n");
+       fprintf(fp, "  -S, --sink=PLUGIN.CLS             Query object from the sink component class\n");
+       fprintf(fp, "                                    CLS found in the plugin PLUGIN\n");
+       fprintf(fp, "  -s, --source=PLUGIN.CLS           Query object from the source component\n");
+       fprintf(fp, "                                    class CLS found in the plugin PLUGIN\n");
+       fprintf(fp, "  -h  --help                        Show this help and quit\n");
+       fprintf(fp, "\n\n");
+       print_expected_params_format(fp);
+}
+
+static
+struct poptOption query_long_options[] = {
+       /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
+       { "filter", 'f', POPT_ARG_STRING, NULL, OPT_FILTER, NULL, NULL },
+       { "help", 'h', POPT_ARG_NONE, NULL, OPT_HELP, NULL, NULL },
+       { "omit-home-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_HOME_PLUGIN_PATH, NULL, NULL },
+       { "omit-system-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_SYSTEM_PLUGIN_PATH, NULL, NULL },
+       { "params", 'p', POPT_ARG_STRING, NULL, OPT_PARAMS, NULL, NULL },
+       { "plugin-path", '\0', POPT_ARG_STRING, NULL, OPT_PLUGIN_PATH, NULL, NULL },
+       { "sink", 'S', POPT_ARG_STRING, NULL, OPT_SINK, NULL, NULL },
+       { "source", 's', POPT_ARG_STRING, NULL, OPT_SOURCE, NULL, NULL },
+       { NULL, 0, '\0', NULL, 0, NULL, NULL },
+};
+
+/*
+ * Creates a Babeltrace config object from the arguments of a query
+ * command.
+ *
+ * *retcode is set to the appropriate exit code to use.
+ */
+static
+struct bt_config *bt_config_query_from_args(int argc, const char *argv[],
+               int *retcode, bool force_omit_system_plugin_path,
+               bool force_omit_home_plugin_path,
+               struct bt_value *initial_plugin_paths)
+{
+       poptContext pc = NULL;
+       char *arg = NULL;
+       int opt;
+       int ret;
+       struct bt_config *cfg = NULL;
+       const char *leftover;
+       struct bt_value *params = bt_value_null;
+
+       *retcode = 0;
+       cfg = bt_config_query_create(initial_plugin_paths);
+       if (!cfg) {
+               goto error;
+       }
+
+       cfg->omit_system_plugin_path = force_omit_system_plugin_path;
+       cfg->omit_home_plugin_path = force_omit_home_plugin_path;
+       ret = append_env_var_plugin_paths(cfg->plugin_paths);
+       if (ret) {
+               goto error;
+       }
+
+       /* Parse options */
+       pc = poptGetContext(NULL, argc, (const char **) argv,
+               query_long_options, 0);
+       if (!pc) {
+               printf_err("Cannot get popt context\n");
+               goto error;
+       }
+
+       poptReadDefaultConfig(pc, 0);
+
+       while ((opt = poptGetNextOpt(pc)) > 0) {
+               arg = poptGetOptArg(pc);
+
+               switch (opt) {
+               case OPT_PLUGIN_PATH:
+                       if (bt_config_append_plugin_paths_check_setuid_setgid(
+                                       cfg->plugin_paths, arg)) {
+                               goto error;
+                       }
+                       break;
+               case OPT_OMIT_SYSTEM_PLUGIN_PATH:
+                       cfg->omit_system_plugin_path = true;
+                       break;
+               case OPT_OMIT_HOME_PLUGIN_PATH:
+                       cfg->omit_home_plugin_path = true;
+                       break;
+               case OPT_SOURCE:
+               case OPT_FILTER:
+               case OPT_SINK:
+               {
+                       enum bt_component_class_type type;
+
+                       if (cfg->cmd_data.query.cfg_component) {
+                               printf_err("Cannot specify more than one plugin and component class:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       switch (opt) {
+                       case OPT_SOURCE:
+                               type = BT_COMPONENT_CLASS_TYPE_SOURCE;
+                               break;
+                       case OPT_FILTER:
+                               type = BT_COMPONENT_CLASS_TYPE_FILTER;
+                               break;
+                       case OPT_SINK:
+                               type = BT_COMPONENT_CLASS_TYPE_SINK;
+                               break;
+                       default:
+                               assert(false);
+                       }
+
+                       cfg->cmd_data.query.cfg_component =
+                               bt_config_component_from_arg(type, arg);
+                       if (!cfg->cmd_data.query.cfg_component) {
+                               printf_err("Invalid format for --source/--filter/--sink option's argument:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       /* Default parameters: null */
+                       bt_put(cfg->cmd_data.query.cfg_component->params);
+                       cfg->cmd_data.query.cfg_component->params =
+                               bt_value_null;
+                       break;
+               }
+               case OPT_PARAMS:
+               {
+                       params = bt_value_from_arg(arg);
+                       if (!params) {
+                               printf_err("Invalid format for --params option's argument:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+                       break;
+               }
+               case OPT_HELP:
+                       print_query_usage(stdout);
+                       *retcode = -1;
+                       BT_PUT(cfg);
+                       goto end;
+               default:
+                       printf_err("Unknown command-line option specified (option code %d)\n",
+                               opt);
+                       goto error;
+               }
+
+               free(arg);
+               arg = NULL;
+       }
+
+       if (!cfg->cmd_data.query.cfg_component) {
+               printf_err("No target component class specified with --source/--filter/--sink option\n");
+               goto error;
+       }
+
+       assert(params);
+       BT_MOVE(cfg->cmd_data.query.cfg_component->params, params);
+
+       /* Check for option parsing error */
+       if (opt < -1) {
+               printf_err("While parsing command-line options, at option %s: %s\n",
+                       poptBadOption(pc, 0), poptStrerror(opt));
+               goto error;
+       }
+
+       /*
+        * We need exactly one leftover argument which is the
+        * mandatory object.
+        */
+       leftover = poptGetArg(pc);
+       if (leftover) {
+               if (strlen(leftover) == 0) {
+                       printf_err("Invalid empty object\n");
+                       goto error;
+               }
+
+               g_string_assign(cfg->cmd_data.query.object, leftover);
+       } else {
+               print_query_usage(stdout);
+               *retcode = -1;
+               BT_PUT(cfg);
+               goto end;
+       }
+
+       leftover = poptGetArg(pc);
+       if (leftover) {
+               printf_err("Unexpected argument: %s\n", leftover);
+               goto error;
+       }
+
+       if (append_home_and_system_plugin_paths_cfg(cfg)) {
+               goto error;
+       }
+
+       goto end;
+
+error:
+       *retcode = 1;
+       BT_PUT(cfg);
+
+end:
+       if (pc) {
+               poptFreeContext(pc);
+       }
+
+       BT_PUT(params);
+       free(arg);
+       return cfg;
+}
+
+/*
+ * Prints the list-plugins command usage.
+ */
+static
+void print_list_plugins_usage(FILE *fp)
+{
+       fprintf(fp, "Usage: babeltrace [GENERAL OPTIONS] list-plugins [OPTIONS]\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Options:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "      --omit-home-plugin-path       Omit home plugins from plugin search path\n");
+       fprintf(fp, "                                    (~/.local/lib/babeltrace/plugins)\n");
+       fprintf(fp, "      --omit-system-plugin-path     Omit system plugins from plugin search path\n");
+       fprintf(fp, "      --plugin-path=PATH[:PATH]...  Add PATH to the list of paths from which\n");
+       fprintf(fp, "                                    dynamic plugins can be loaded\n");
+       fprintf(fp, "  -h  --help                        Show this help and quit\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "See `babeltrace --help` for the list of general options.\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Use `babeltrace help` to get help for a specific plugin or component class.\n");
+}
+
+static
+struct poptOption list_plugins_long_options[] = {
+       /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
+       { "help", 'h', POPT_ARG_NONE, NULL, OPT_HELP, NULL, NULL },
+       { "omit-home-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_HOME_PLUGIN_PATH, NULL, NULL },
+       { "omit-system-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_SYSTEM_PLUGIN_PATH, NULL, NULL },
+       { "plugin-path", '\0', POPT_ARG_STRING, NULL, OPT_PLUGIN_PATH, NULL, NULL },
+       { NULL, 0, '\0', NULL, 0, NULL, NULL },
+};
+
+/*
+ * Creates a Babeltrace config object from the arguments of a
+ * list-plugins command.
+ *
+ * *retcode is set to the appropriate exit code to use.
+ */
+static
+struct bt_config *bt_config_list_plugins_from_args(int argc, const char *argv[],
+               int *retcode, bool force_omit_system_plugin_path,
+               bool force_omit_home_plugin_path,
+               struct bt_value *initial_plugin_paths)
+{
+       poptContext pc = NULL;
+       char *arg = NULL;
+       int opt;
+       int ret;
+       struct bt_config *cfg = NULL;
+       const char *leftover;
+
+       *retcode = 0;
+       cfg = bt_config_list_plugins_create(initial_plugin_paths);
+       if (!cfg) {
+               goto error;
+       }
+
+       cfg->omit_system_plugin_path = force_omit_system_plugin_path;
+       cfg->omit_home_plugin_path = force_omit_home_plugin_path;
+       ret = append_env_var_plugin_paths(cfg->plugin_paths);
+       if (ret) {
+               goto error;
+       }
+
+       /* Parse options */
+       pc = poptGetContext(NULL, argc, (const char **) argv,
+               list_plugins_long_options, 0);
+       if (!pc) {
+               printf_err("Cannot get popt context\n");
+               goto error;
+       }
+
+       poptReadDefaultConfig(pc, 0);
+
+       while ((opt = poptGetNextOpt(pc)) > 0) {
+               arg = poptGetOptArg(pc);
+
+               switch (opt) {
+               case OPT_PLUGIN_PATH:
+                       if (bt_config_append_plugin_paths_check_setuid_setgid(
+                                       cfg->plugin_paths, arg)) {
+                               goto error;
+                       }
+                       break;
+               case OPT_OMIT_SYSTEM_PLUGIN_PATH:
+                       cfg->omit_system_plugin_path = true;
+                       break;
+               case OPT_OMIT_HOME_PLUGIN_PATH:
+                       cfg->omit_home_plugin_path = true;
+                       break;
+               case OPT_HELP:
+                       print_list_plugins_usage(stdout);
+                       *retcode = -1;
+                       BT_PUT(cfg);
+                       goto end;
+               default:
+                       printf_err("Unknown command-line option specified (option code %d)\n",
+                               opt);
+                       goto error;
+               }
+
+               free(arg);
+               arg = NULL;
+       }
+
+       /* Check for option parsing error */
+       if (opt < -1) {
+               printf_err("While parsing command-line options, at option %s: %s\n",
+                       poptBadOption(pc, 0), poptStrerror(opt));
+               goto error;
+       }
+
+       leftover = poptGetArg(pc);
+       if (leftover) {
+               printf_err("Unexpected argument: %s\n", leftover);
+               goto error;
+       }
+
+       if (append_home_and_system_plugin_paths_cfg(cfg)) {
+               goto error;
+       }
+
+       goto end;
+
+error:
+       *retcode = 1;
+       BT_PUT(cfg);
+
+end:
+       if (pc) {
+               poptFreeContext(pc);
+       }
+
+       free(arg);
+       return cfg;
+}
+
+/*
+ * Prints the run command usage.
+ */
+static
+void print_run_usage(FILE *fp)
+{
+       fprintf(fp, "Usage: babeltrace [GENERAL OPTIONS] run [OPTIONS]\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Options:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "  -b, --base-params=PARAMS          Set PARAMS as the current base parameters\n");
+       fprintf(fp, "                                    for all the following components until\n");
+       fprintf(fp, "                                    --reset-base-params is encountered\n");
+       fprintf(fp, "                                    (see the expected format of PARAMS below)\n");
+       fprintf(fp, "  -c, --connect=CONNECTION          Connect two created components (see the\n");
+       fprintf(fp, "                                    expected format of CONNECTION below)\n");
+       fprintf(fp, "  -f, --filter=[NAME:]PLUGIN.CLS    Instantiate a filter component from plugin\n");
+       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
+       fprintf(fp, "                                    the current component, and if NAME is\n");
+       fprintf(fp, "                                    given, set its instance name to NAME\n");
+       fprintf(fp, "      --key=KEY                     Set the current initialization string\n");
+       fprintf(fp, "                                    parameter key to KEY (see --value)\n");
+       fprintf(fp, "  -n, --name=NAME                   Set the name of the current component\n");
+       fprintf(fp, "                                    to NAME (must be unique amongst all the\n");
+       fprintf(fp, "                                    names of the created components)\n");
+       fprintf(fp, "      --omit-home-plugin-path       Omit home plugins from plugin search path\n");
+       fprintf(fp, "                                    (~/.local/lib/babeltrace/plugins)\n");
+       fprintf(fp, "      --omit-system-plugin-path     Omit system plugins from plugin search path\n");
+       fprintf(fp, "  -p, --params=PARAMS               Add initialization parameters PARAMS to the\n");
+       fprintf(fp, "                                    current component (see the expected format\n");
+       fprintf(fp, "                                    of PARAMS below)\n");
+       fprintf(fp, "      --plugin-path=PATH[:PATH]...  Add PATH to the list of paths from which\n");
+       fprintf(fp, "                                    dynamic plugins can be loaded\n");
+       fprintf(fp, "  -r, --reset-base-params           Reset the current base parameters to an\n");
+       fprintf(fp, "                                    empty map\n");
+       fprintf(fp, "      --retry-duration=DUR          When babeltrace(1) needs to retry to run\n");
+       fprintf(fp, "                                    the graph later, retry in DUR µs\n");
+       fprintf(fp, "                                    (default: 100000)\n");
+       fprintf(fp, "  -S, --sink=[NAME:]PLUGIN.CLS      Instantiate a sink component from plugin\n");
+       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
+       fprintf(fp, "                                    the current component, and if NAME is\n");
+       fprintf(fp, "                                    given, set its instance name to NAME\n");
+       fprintf(fp, "  -s, --source=[NAME:]PLUGIN.CLS    Instantiate a source component from plugin\n");
+       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
+       fprintf(fp, "                                    the current component, and if NAME is\n");
+       fprintf(fp, "                                    given, set its instance name to NAME\n");
+       fprintf(fp, "      --value=VAL                   Add a string initialization parameter to\n");
+       fprintf(fp, "                                    the current component with a name given by\n");
+       fprintf(fp, "                                    the last argument of the --key option and a\n");
+       fprintf(fp, "                                    value set to VAL\n");
+       fprintf(fp, "  -h  --help                        Show this help and quit\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "See `babeltrace --help` for the list of general options.\n");
+       fprintf(fp, "\n\n");
+       fprintf(fp, "Expected format of CONNECTION\n");
+       fprintf(fp, "-----------------------------\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "    UPSTREAM[.UPSTREAM-PORT]:DOWNSTREAM[.DOWNSTREAM-PORT]\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "UPSTREAM and DOWNSTREAM are names of the upstream and downstream\n");
+       fprintf(fp, "components to connect together. You must escape the following characters\n\n");
+       fprintf(fp, "with `\\`: `\\`, `.`, and `:`. You can set the name of the current\n");
+       fprintf(fp, "component with the --name option.\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "UPSTREAM-PORT and DOWNSTREAM-PORT are optional globbing patterns to\n");
+       fprintf(fp, "identify the upstream and downstream ports to use for the connection.\n");
+       fprintf(fp, "When the port is not specified, `*` is used.\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "When a component named UPSTREAM has an available port which matches the\n");
+       fprintf(fp, "UPSTREAM-PORT globbing pattern, it is connected to the first port which\n");
+       fprintf(fp, "matches the DOWNSTREAM-PORT globbing pattern of the component named\n");
+       fprintf(fp, "DOWNSTREAM.\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "The only special character in UPSTREAM-PORT and DOWNSTREAM-PORT is `*`\n");
+       fprintf(fp, "which matches anything. You must escape the following characters\n");
+       fprintf(fp, "with `\\`: `\\`, `*`, `?`, `[`, `.`, and `:`.\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "You can connect a source component to a filter or sink component. You\n");
+       fprintf(fp, "can connect a filter component to a sink component.\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Examples:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "    my-src:my-sink\n");
+       fprintf(fp, "    ctf-fs.*stream*:utils-muxer:*\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "IMPORTANT: Make sure to single-quote the whole argument when you run\n");
+       fprintf(fp, "babeltrace from a shell.\n");
+       fprintf(fp, "\n\n");
+       print_expected_params_format(fp);
+}
+
+/*
+ * Creates a Babeltrace config object from the arguments of a run
+ * command.
+ *
+ * *retcode is set to the appropriate exit code to use.
+ */
+static
+struct bt_config *bt_config_run_from_args(int argc, const char *argv[],
+               int *retcode, bool force_omit_system_plugin_path,
+               bool force_omit_home_plugin_path,
+               struct bt_value *initial_plugin_paths)
+{
+       poptContext pc = NULL;
+       char *arg = NULL;
+       struct bt_config_component *cur_cfg_comp = NULL;
+       enum bt_config_component_dest cur_cfg_comp_dest;
+       struct bt_value *cur_base_params = NULL;
+       int opt, ret = 0;
+       struct bt_config *cfg = NULL;
+       struct bt_value *instance_names = NULL;
+       struct bt_value *connection_args = NULL;
+       GString *cur_param_key = NULL;
+       char error_buf[256] = { 0 };
+       long long retry_duration = -1;
+       struct poptOption run_long_options[] = {
+               { "base-params", 'b', POPT_ARG_STRING, NULL, OPT_BASE_PARAMS, NULL, NULL },
+               { "connect", 'c', POPT_ARG_STRING, NULL, OPT_CONNECT, NULL, NULL },
+               { "filter", 'f', POPT_ARG_STRING, NULL, OPT_FILTER, NULL, NULL },
+               { "help", 'h', POPT_ARG_NONE, NULL, OPT_HELP, NULL, NULL },
+               { "key", '\0', POPT_ARG_STRING, NULL, OPT_KEY, NULL, NULL },
+               { "name", 'n', POPT_ARG_STRING, NULL, OPT_NAME, NULL, NULL },
+               { "omit-home-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_HOME_PLUGIN_PATH, NULL, NULL },
+               { "omit-system-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_SYSTEM_PLUGIN_PATH, NULL, NULL },
+               { "params", 'p', POPT_ARG_STRING, NULL, OPT_PARAMS, NULL, NULL },
+               { "plugin-path", '\0', POPT_ARG_STRING, NULL, OPT_PLUGIN_PATH, NULL, NULL },
+               { "reset-base-params", 'r', POPT_ARG_NONE, NULL, OPT_RESET_BASE_PARAMS, NULL, NULL },
+               { "retry-duration", '\0', POPT_ARG_LONGLONG, &retry_duration, OPT_RETRY_DURATION, NULL, NULL },
+               { "sink", 'S', POPT_ARG_STRING, NULL, OPT_SINK, NULL, NULL },
+               { "source", 's', POPT_ARG_STRING, NULL, OPT_SOURCE, NULL, NULL },
+               { "value", '\0', POPT_ARG_STRING, NULL, OPT_VALUE, NULL, NULL },
+               { NULL, 0, '\0', NULL, 0, NULL, NULL },
+       };
+
+       *retcode = 0;
+       cur_param_key = g_string_new(NULL);
+       if (!cur_param_key) {
+               print_err_oom();
+               goto error;
+       }
+
+       if (argc <= 1) {
+               print_run_usage(stdout);
+               *retcode = -1;
+               goto end;
+       }
+
+       cfg = bt_config_run_create(initial_plugin_paths);
+       if (!cfg) {
+               goto error;
+       }
+
+       cfg->cmd_data.run.retry_duration_us = 100000;
+       cfg->omit_system_plugin_path = force_omit_system_plugin_path;
+       cfg->omit_home_plugin_path = force_omit_home_plugin_path;
+       cur_base_params = bt_value_map_create();
+       if (!cur_base_params) {
+               print_err_oom();
+               goto error;
+       }
+
+       instance_names = bt_value_map_create();
+       if (!instance_names) {
+               print_err_oom();
+               goto error;
+       }
+
+       connection_args = bt_value_array_create();
+       if (!connection_args) {
+               print_err_oom();
+               goto error;
+       }
+
+       ret = append_env_var_plugin_paths(cfg->plugin_paths);
+       if (ret) {
+               goto error;
+       }
+
+       /* Parse options */
+       pc = poptGetContext(NULL, argc, (const char **) argv,
+               run_long_options, 0);
+       if (!pc) {
+               printf_err("Cannot get popt context\n");
+               goto error;
+       }
+
+       poptReadDefaultConfig(pc, 0);
+
+       while ((opt = poptGetNextOpt(pc)) > 0) {
+               arg = poptGetOptArg(pc);
+
+               switch (opt) {
+               case OPT_PLUGIN_PATH:
+                       if (bt_config_append_plugin_paths_check_setuid_setgid(
+                                       cfg->plugin_paths, arg)) {
+                               goto error;
+                       }
+                       break;
+               case OPT_OMIT_SYSTEM_PLUGIN_PATH:
+                       cfg->omit_system_plugin_path = true;
+                       break;
+               case OPT_OMIT_HOME_PLUGIN_PATH:
+                       cfg->omit_home_plugin_path = true;
+                       break;
+               case OPT_SOURCE:
+               case OPT_FILTER:
+               case OPT_SINK:
+               {
+                       enum bt_component_class_type new_comp_type;
+                       enum bt_config_component_dest new_dest;
+                       const char *opt_name;
+
+                       switch (opt) {
+                       case OPT_SOURCE:
+                               new_comp_type = BT_COMPONENT_CLASS_TYPE_SOURCE;
+                               new_dest = BT_CONFIG_COMPONENT_DEST_SOURCE;
+                               opt_name = "--source";
+                               break;
+                       case OPT_FILTER:
+                               new_comp_type = BT_COMPONENT_CLASS_TYPE_FILTER;
+                               new_dest = BT_CONFIG_COMPONENT_DEST_FILTER;
+                               opt_name = "--filter";
+                               break;
+                       case OPT_SINK:
+                               new_comp_type = BT_COMPONENT_CLASS_TYPE_SINK;
+                               new_dest = BT_CONFIG_COMPONENT_DEST_SINK;
+                               opt_name = "--sink";
+                               break;
+                       default:
+                               assert(false);
+                       }
+
+                       if (cur_cfg_comp) {
+                               ret = add_run_cfg_comp_check_name(cfg,
+                                       cur_cfg_comp, cur_cfg_comp_dest,
+                                       instance_names);
+                               BT_PUT(cur_cfg_comp);
+                               if (ret) {
+                                       goto error;
+                               }
+                       }
+
+                       cur_cfg_comp = bt_config_component_from_arg(
+                               new_comp_type, arg);
+                       if (!cur_cfg_comp) {
+                               printf_err("Invalid format for %s option's argument:\n    %s\n",
+                                       opt_name, arg);
+                               goto error;
+                       }
+
+                       assert(cur_base_params);
+                       bt_put(cur_cfg_comp->params);
+                       cur_cfg_comp->params = bt_value_copy(cur_base_params);
+                       if (!cur_cfg_comp->params) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       cur_cfg_comp_dest = new_dest;
+                       break;
+               }
+               case OPT_PARAMS:
+               {
+                       struct bt_value *params;
+                       struct bt_value *params_to_set;
+
+                       if (!cur_cfg_comp) {
+                               printf_err("Cannot add parameters to unavailable component:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       params = bt_value_from_arg(arg);
+                       if (!params) {
+                               printf_err("Invalid format for --params option's argument:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       params_to_set = bt_value_map_extend(cur_cfg_comp->params,
+                               params);
+                       BT_PUT(params);
+                       if (!params_to_set) {
+                               printf_err("Cannot extend current component parameters with --params option's argument:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       BT_MOVE(cur_cfg_comp->params, params_to_set);
+                       break;
+               }
+               case OPT_KEY:
+                       if (strlen(arg) == 0) {
+                               printf_err("Cannot set an empty string as the current parameter key\n");
+                               goto error;
+                       }
+
+                       g_string_assign(cur_param_key, arg);
+                       break;
+               case OPT_VALUE:
+                       if (!cur_cfg_comp) {
+                               printf_err("Cannot set a parameter's value of unavailable component:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       if (cur_param_key->len == 0) {
+                               printf_err("--value option specified without preceding --key option:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       if (bt_value_map_insert_string(cur_cfg_comp->params,
+                                       cur_param_key->str, arg)) {
+                               print_err_oom();
+                               goto error;
+                       }
+                       break;
+               case OPT_NAME:
+                       if (!cur_cfg_comp) {
+                               printf_err("Cannot set the name of unavailable component:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       g_string_assign(cur_cfg_comp->instance_name, arg);
+                       break;
+               case OPT_BASE_PARAMS:
+               {
+                       struct bt_value *params = bt_value_from_arg(arg);
+
+                       if (!params) {
+                               printf_err("Invalid format for --base-params option's argument:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       BT_MOVE(cur_base_params, params);
+                       break;
+               }
+               case OPT_RESET_BASE_PARAMS:
+                       BT_PUT(cur_base_params);
+                       cur_base_params = bt_value_map_create();
+                       if (!cur_base_params) {
+                               print_err_oom();
+                               goto error;
+                       }
+                       break;
+               case OPT_CONNECT:
+                       if (bt_value_array_append_string(connection_args,
+                                       arg)) {
+                               print_err_oom();
+                               goto error;
+                       }
+                       break;
+               case OPT_RETRY_DURATION:
+                       if (retry_duration < 0) {
+                               printf_err("--retry-duration option's argument must be positive or 0: %lld\n",
+                                       retry_duration);
+                               goto error;
+                       }
+
+                       cfg->cmd_data.run.retry_duration_us =
+                               (uint64_t) retry_duration;
+                       break;
+               case OPT_HELP:
+                       print_run_usage(stdout);
+                       *retcode = -1;
+                       BT_PUT(cfg);
+                       goto end;
+               default:
+                       printf_err("Unknown command-line option specified (option code %d)\n",
+                               opt);
+                       goto error;
+               }
+
+               free(arg);
+               arg = NULL;
+       }
+
+       /* Check for option parsing error */
+       if (opt < -1) {
+               printf_err("While parsing command-line options, at option %s: %s\n",
+                       poptBadOption(pc, 0), poptStrerror(opt));
+               goto error;
+       }
+
+       /* This command does not accept leftover arguments */
+       if (poptPeekArg(pc)) {
+               printf_err("Unexpected argument: %s\n", poptPeekArg(pc));
+               goto error;
+       }
+
+       /* Add current component */
+       if (cur_cfg_comp) {
+               ret = add_run_cfg_comp_check_name(cfg, cur_cfg_comp,
+                       cur_cfg_comp_dest, instance_names);
+               BT_PUT(cur_cfg_comp);
+               if (ret) {
+                       goto error;
+               }
+       }
+
+       if (cfg->cmd_data.run.sources->len == 0) {
+               printf_err("Incomplete graph: no source component\n");
+               goto error;
+       }
+
+       if (cfg->cmd_data.run.sinks->len == 0) {
+               printf_err("Incomplete graph: no sink component\n");
+               goto error;
+       }
+
+       if (append_home_and_system_plugin_paths_cfg(cfg)) {
+               goto error;
+       }
+
+       ret = bt_config_cli_args_create_connections(cfg, connection_args,
+               error_buf, 256);
+       if (ret) {
+               printf_err("Cannot creation connections:\n%s", error_buf);
+               goto error;
+       }
+
+       goto end;
+
+error:
+       *retcode = 1;
+       BT_PUT(cfg);
+
+end:
+       if (pc) {
+               poptFreeContext(pc);
+       }
+
+       if (cur_param_key) {
+               g_string_free(cur_param_key, TRUE);
+       }
+
+       free(arg);
+       BT_PUT(cur_cfg_comp);
+       BT_PUT(cur_base_params);
+       BT_PUT(instance_names);
+       BT_PUT(connection_args);
+       return cfg;
+}
+
+static
+struct bt_config *bt_config_run_from_args_array(struct bt_value *run_args,
+               int *retcode, bool force_omit_system_plugin_path,
+               bool force_omit_home_plugin_path,
+               struct bt_value *initial_plugin_paths)
+{
+       struct bt_config *cfg = NULL;
+       const char **argv;
+       size_t i;
+       const size_t argc = bt_value_array_size(run_args) + 1;
+
+       argv = calloc(argc, sizeof(*argv));
+       if (!argv) {
+               print_err_oom();
+               goto end;
+       }
+
+       argv[0] = "run";
+
+       for (i = 0; i < bt_value_array_size(run_args); i++) {
+               int ret;
+               struct bt_value *arg_value = bt_value_array_get(run_args, i);
+               const char *arg;
+
+               assert(arg_value);
+               ret = bt_value_string_get(arg_value, &arg);
+               assert(ret == 0);
+               assert(arg);
+               argv[i + 1] = arg;
+               bt_put(arg_value);
+       }
+
+       cfg = bt_config_run_from_args(argc, argv, retcode,
+               force_omit_system_plugin_path, force_omit_home_plugin_path,
+               initial_plugin_paths);
+
+end:
+       free(argv);
+       return cfg;
+}
+
+/*
+ * Prints the convert command usage.
+ */
+static
+void print_convert_usage(FILE *fp)
+{
+       fprintf(fp, "Usage: babeltrace [GENERAL OPTIONS] [convert] [OPTIONS] [PATH/URL]\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Options:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "      --filter=[NAME:]PLUGIN.CLS    Instantiate a filter component from plugin\n");
+       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
+       fprintf(fp, "                                    the current component, and if NAME is\n");
+       fprintf(fp, "                                    given, set its instance name to NAME\n");
+       fprintf(fp, "      --name=NAME                   Set the name of the current component\n");
+       fprintf(fp, "                                    to NAME (must be unique amongst all the\n");
+       fprintf(fp, "                                    names of the created components)\n");
+       fprintf(fp, "      --omit-home-plugin-path       Omit home plugins from plugin search path\n");
+       fprintf(fp, "                                    (~/.local/lib/babeltrace/plugins)\n");
+       fprintf(fp, "      --omit-system-plugin-path     Omit system plugins from plugin search path\n");
+       fprintf(fp, "  -p, --params=PARAMS               Add initialization parameters PARAMS to the\n");
+       fprintf(fp, "                                    current component (see the expected format\n");
+       fprintf(fp, "                                    of PARAMS below)\n");
+       fprintf(fp, "  -P, --path=PATH                   Set the `path` string parameter of the\n");
+       fprintf(fp, "                                    current component to PATH\n");
+       fprintf(fp, "      --plugin-path=PATH[:PATH]...  Add PATH to the list of paths from which\n");
+       fprintf(fp, "      --retry-duration=DUR          When babeltrace(1) needs to retry to run\n");
+       fprintf(fp, "                                    the graph later, retry in DUR µs\n");
+       fprintf(fp, "                                    (default: 100000)\n");
+       fprintf(fp, "                                    dynamic plugins can be loaded\n");
+       fprintf(fp, "      --run-args                    Print the equivalent arguments for the\n");
+       fprintf(fp, "                                    `run` command to the standard output,\n");
+       fprintf(fp, "                                    formatted for a shell, and quit\n");
+       fprintf(fp, "      --run-args-0                  Print the equivalent arguments for the\n");
+       fprintf(fp, "                                    `run` command to the standard output,\n");
+       fprintf(fp, "                                    formatted for `xargs -0`, and quit\n");
+       fprintf(fp, "      --sink=[NAME:]PLUGIN.CLS      Instantiate a sink component from plugin\n");
+       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
+       fprintf(fp, "                                    the current component, and if NAME is\n");
+       fprintf(fp, "                                    given, set its instance name to NAME\n");
+       fprintf(fp, "      --source=[NAME:]PLUGIN.CLS    Instantiate a source component from plugin\n");
+       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
+       fprintf(fp, "                                    the current component, and if NAME is\n");
+       fprintf(fp, "                                    given, set its instance name to NAME\n");
+       fprintf(fp, "  -u, --url=URL                     Set the `url` string parameter of the\n");
+       fprintf(fp, "                                    current component to URL\n");
+       fprintf(fp, "  -h  --help                        Show this help and quit\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Implicit `ctf.fs` source component options:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "      --clock-offset=SEC            Set clock offset to SEC seconds\n");
+       fprintf(fp, "      --clock-offset-ns=NS          Set clock offset to NS ns\n");
+       fprintf(fp, "      --stream-intersection         Only process events when all streams\n");
+       fprintf(fp, "                                    are active\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Implicit `text.text` sink component options:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "      --clock-cycles                Print timestamps in clock cycles\n");
+       fprintf(fp, "      --clock-date                  Print timestamp dates\n");
+       fprintf(fp, "      --clock-gmt                   Print and parse timestamps in the GMT\n");
+       fprintf(fp, "                                    time zone instead of the local time zone\n");
+       fprintf(fp, "      --clock-seconds               Print the timestamps as `SEC.NS` instead\n");
+       fprintf(fp, "                                    of `hh:mm:ss.nnnnnnnnn`\n");
+       fprintf(fp, "      --color=(never | auto | always)\n");
+       fprintf(fp, "                                    Never, automatically, or always emit\n");
+       fprintf(fp, "                                    console color codes\n");
+       fprintf(fp, "  -f, --fields=FIELD[,FIELD]...     Print additional fields; FIELD can be:\n");
+       fprintf(fp, "                                      `all`, `trace`, `trace:hostname`,\n");
+       fprintf(fp, "                                      `trace:domain`, `trace:procname`,\n");
+       fprintf(fp, "                                      `trace:vpid`, `loglevel`, `emf`\n");
+       fprintf(fp, "  -n, --names=NAME[,NAME]...        Print field names; NAME can be:\n");
+       fprintf(fp, "                                      `payload` (or `arg` or `args`), `none`,\n");
+       fprintf(fp, "                                      `all`, `scope`, `header`, `context`\n");
+       fprintf(fp, "                                      (or `ctx`)\n");
+       fprintf(fp, "      --no-delta                    Do not print time delta between\n");
+       fprintf(fp, "                                    consecutive events\n");
+       fprintf(fp, "  -w, --output=PATH                 Write output text to PATH instead of\n");
+       fprintf(fp, "                                    the standard output\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Implicit `utils.muxer` filter component options:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "      --clock-force-correlate       Assume that clocks are inherently\n");
+       fprintf(fp, "                                    correlated across traces\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Implicit `utils.trimmer` filter component options:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "  -b, --begin=BEGIN                 Set the beginning time of the conversion\n");
+       fprintf(fp, "                                    time range to BEGIN (see the format of\n");
+       fprintf(fp, "                                    BEGIN below)\n");
+       fprintf(fp, "  -e, --end=END                     Set the end time of the conversion time\n");
+       fprintf(fp, "                                    range to END (see the format of END below)\n");
+       fprintf(fp, "  -t, --timerange=TIMERANGE         Set conversion time range to TIMERANGE:\n");
+       fprintf(fp, "                                    BEGIN,END or [BEGIN,END] (literally `[` and\n");
+       fprintf(fp, "                                    `]`) (see the format of BEGIN/END below)\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Implicit `lttng-utils.debug-info` filter component options:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "      --debug-info-dir=DIR          Search for debug info in directory DIR\n");
+       fprintf(fp, "                                    instead of `/usr/lib/debug`\n");
+       fprintf(fp, "      --debug-info-full-path        Show full debug info source and\n");
+       fprintf(fp, "                                    binary paths instead of just names\n");
+       fprintf(fp, "      --debug-info-target-prefix=DIR\n");
+       fprintf(fp, "                                    Use directory DIR as a prefix when\n");
+       fprintf(fp, "                                    looking up executables during debug\n");
+       fprintf(fp, "                                    info analysis\n");
+       fprintf(fp, "      --no-debug-info               Do not create an implicit\n");
+       fprintf(fp, "                                    `lttng-utils.debug-info` filter component\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Legacy options that still work:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "  -i, --input-format=(ctf | lttng-live)\n");
+       fprintf(fp, "                                    `ctf`:\n");
+       fprintf(fp, "                                      Create an implicit `ctf.fs` source\n");
+       fprintf(fp, "                                      component\n");
+       fprintf(fp, "                                    `lttng-live`:\n");
+       fprintf(fp, "                                      Create an implicit `ctf.lttng-live`\n");
+       fprintf(fp, "                                      source component\n");
+       fprintf(fp, "  -o, --output-format=(text | dummy | ctf-metadata)\n");
+       fprintf(fp, "                                    `text`:\n");
+       fprintf(fp, "                                      Create an implicit `text.text` sink\n");
+       fprintf(fp, "                                      component\n");
+       fprintf(fp, "                                    `dummy`:\n");
+       fprintf(fp, "                                      Create an implicit `utils.dummy` sink\n");
+       fprintf(fp, "                                      component\n");
+       fprintf(fp, "                                    `ctf-metadata`:\n");
+       fprintf(fp, "                                      Query the `ctf.fs` component class for\n");
+       fprintf(fp, "                                      metadata text and quit\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "See `babeltrace --help` for the list of general options.\n");
+       fprintf(fp, "\n\n");
+       fprintf(fp, "Format of BEGIN and END\n");
+       fprintf(fp, "-----------------------\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "    [YYYY-MM-DD [hh:mm:]]ss[.nnnnnnnnn]\n");
+       fprintf(fp, "\n\n");
+       print_expected_params_format(fp);
+}
+
+static
+struct poptOption convert_long_options[] = {
+       /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
+       { "begin", 'b', POPT_ARG_STRING, NULL, OPT_BEGIN, NULL, NULL },
+       { "clock-cycles", '\0', POPT_ARG_NONE, NULL, OPT_CLOCK_CYCLES, NULL, NULL },
+       { "clock-date", '\0', POPT_ARG_NONE, NULL, OPT_CLOCK_DATE, NULL, NULL },
+       { "clock-force-correlate", '\0', POPT_ARG_NONE, NULL, OPT_CLOCK_FORCE_CORRELATE, NULL, NULL },
+       { "clock-gmt", '\0', POPT_ARG_NONE, NULL, OPT_CLOCK_GMT, NULL, NULL },
+       { "clock-offset", '\0', POPT_ARG_STRING, NULL, OPT_CLOCK_OFFSET, NULL, NULL },
+       { "clock-offset-ns", '\0', POPT_ARG_STRING, NULL, OPT_CLOCK_OFFSET_NS, NULL, NULL },
+       { "clock-seconds", '\0', POPT_ARG_NONE, NULL, OPT_CLOCK_SECONDS, NULL, NULL },
+       { "color", '\0', POPT_ARG_STRING, NULL, OPT_COLOR, NULL, NULL },
+       { "debug", 'd', POPT_ARG_NONE, NULL, OPT_DEBUG, NULL, NULL },
+       { "debug-info-dir", 0, POPT_ARG_STRING, NULL, OPT_DEBUG_INFO_DIR, NULL, NULL },
+       { "debug-info-full-path", 0, POPT_ARG_NONE, NULL, OPT_DEBUG_INFO_FULL_PATH, NULL, NULL },
+       { "debug-info-target-prefix", 0, POPT_ARG_STRING, NULL, OPT_DEBUG_INFO_TARGET_PREFIX, NULL, NULL },
+       { "end", 'e', POPT_ARG_STRING, NULL, OPT_END, NULL, NULL },
+       { "fields", 'f', POPT_ARG_STRING, NULL, OPT_FIELDS, NULL, NULL },
+       { "filter", '\0', POPT_ARG_STRING, NULL, OPT_FILTER, NULL, NULL },
+       { "help", 'h', POPT_ARG_NONE, NULL, OPT_HELP, NULL, NULL },
+       { "input-format", 'i', POPT_ARG_STRING, NULL, OPT_INPUT_FORMAT, NULL, NULL },
+       { "name", '\0', POPT_ARG_STRING, NULL, OPT_NAME, NULL, NULL },
+       { "names", 'n', POPT_ARG_STRING, NULL, OPT_NAMES, NULL, NULL },
+       { "no-debug-info", '\0', POPT_ARG_NONE, NULL, OPT_NO_DEBUG_INFO, NULL, NULL },
+       { "no-delta", '\0', POPT_ARG_NONE, NULL, OPT_NO_DELTA, NULL, NULL },
+       { "omit-home-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_HOME_PLUGIN_PATH, NULL, NULL },
+       { "omit-system-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_SYSTEM_PLUGIN_PATH, NULL, NULL },
+       { "output", 'w', POPT_ARG_STRING, NULL, OPT_OUTPUT, NULL, NULL },
+       { "output-format", 'o', POPT_ARG_STRING, NULL, OPT_OUTPUT_FORMAT, NULL, NULL },
+       { "params", 'p', POPT_ARG_STRING, NULL, OPT_PARAMS, NULL, NULL },
+       { "path", 'P', POPT_ARG_STRING, NULL, OPT_PATH, NULL, NULL },
+       { "plugin-path", '\0', POPT_ARG_STRING, NULL, OPT_PLUGIN_PATH, NULL, NULL },
+       { "retry-duration", '\0', POPT_ARG_STRING, NULL, OPT_RETRY_DURATION, NULL, NULL },
+       { "run-args", '\0', POPT_ARG_NONE, NULL, OPT_RUN_ARGS, NULL, NULL },
+       { "run-args-0", '\0', POPT_ARG_NONE, NULL, OPT_RUN_ARGS_0, NULL, NULL },
+       { "sink", '\0', POPT_ARG_STRING, NULL, OPT_SINK, NULL, NULL },
+       { "source", '\0', POPT_ARG_STRING, NULL, OPT_SOURCE, NULL, NULL },
+       { "stream-intersection", '\0', POPT_ARG_NONE, NULL, OPT_STREAM_INTERSECTION, NULL, NULL },
+       { "timerange", '\0', POPT_ARG_STRING, NULL, OPT_TIMERANGE, NULL, NULL },
+       { "url", 'u', POPT_ARG_STRING, NULL, OPT_URL, NULL, NULL },
+       { "verbose", 'v', POPT_ARG_NONE, NULL, OPT_VERBOSE, NULL, NULL },
+       { NULL, 0, '\0', NULL, 0, NULL, NULL },
+};
+
+static
+GString *get_component_auto_name(const char *prefix,
+               struct bt_value *existing_names)
+{
+       unsigned int i = 0;
+       GString *auto_name = g_string_new(NULL);
+
+       if (!auto_name) {
+               print_err_oom();
+               goto end;
+       }
+
+       if (!bt_value_map_has_key(existing_names, prefix)) {
+               g_string_assign(auto_name, prefix);
+               goto end;
+       }
+
+       do {
+               g_string_printf(auto_name, "%s-%d", prefix, i);
+               i++;
+       } while (bt_value_map_has_key(existing_names, auto_name->str));
+
+end:
+       return auto_name;
+}
+
+struct implicit_component_args {
+       bool exists;
+       GString *plugin_comp_cls_arg;
+       GString *name_arg;
+       GString *params_arg;
+       struct bt_value *extra_args;
+};
+
+static
+int assign_name_to_implicit_component(struct implicit_component_args *args,
+               const char *prefix, struct bt_value *existing_names,
+               GList **comp_names, bool append_to_comp_names)
+{
+       int ret = 0;
+       GString *name = NULL;
+
+       if (!args->exists) {
+               goto end;
+       }
+
+       name = get_component_auto_name(prefix, existing_names);
+
+       if (!name) {
+               ret = -1;
+               goto end;
+       }
+
+       g_string_assign(args->name_arg, name->str);
+
+       if (bt_value_map_insert(existing_names, name->str,
+                       bt_value_null)) {
+               print_err_oom();
+               ret = -1;
+               goto end;
+       }
+
+       if (append_to_comp_names) {
+               *comp_names = g_list_append(*comp_names, name);
+               name = NULL;
+       }
+
+end:
+       if (name) {
+               g_string_free(name, TRUE);
+       }
+
+       return ret;
+}
+
+static
+int append_run_args_for_implicit_component(
+               enum bt_component_class_type type,
+               struct implicit_component_args *impl_args,
+               struct bt_value *run_args)
+{
+       int ret = 0;
+       size_t i;
+
+       if (!impl_args->exists) {
+               goto end;
+       }
+
+       switch (type) {
+       case BT_COMPONENT_CLASS_TYPE_SOURCE:
+               if (bt_value_array_append_string(run_args, "--source")) {
+                       print_err_oom();
+                       goto error;
+               }
+               break;
+       case BT_COMPONENT_CLASS_TYPE_FILTER:
+               if (bt_value_array_append_string(run_args, "--filter")) {
+                       print_err_oom();
+                       goto error;
+               }
+               break;
+       case BT_COMPONENT_CLASS_TYPE_SINK:
+               if (bt_value_array_append_string(run_args, "--sink")) {
+                       print_err_oom();
+                       goto error;
+               }
+               break;
+       default:
+               assert(false);
+       }
+
+       if (bt_value_array_append_string(run_args,
+                       impl_args->plugin_comp_cls_arg->str)) {
+               print_err_oom();
+               goto error;
+       }
+
+       if (bt_value_array_append_string(run_args, "--name")) {
+               print_err_oom();
+               goto error;
+       }
+
+       if (bt_value_array_append_string(run_args, impl_args->name_arg->str)) {
+               print_err_oom();
+               goto error;
+       }
+
+       if (impl_args->params_arg->len > 0) {
+               if (bt_value_array_append_string(run_args, "--params")) {
+                       print_err_oom();
+                       goto error;
+               }
+
+               if (bt_value_array_append_string(run_args,
+                               impl_args->params_arg->str)) {
+                       print_err_oom();
+                       goto error;
+               }
+       }
+
+       for (i = 0; i < bt_value_array_size(impl_args->extra_args); i++) {
+               struct bt_value *elem;
+               const char *arg;
+
+               elem = bt_value_array_get(impl_args->extra_args, i);
+               if (!elem) {
+                       goto error;
+               }
+
+               assert(bt_value_is_string(elem));
+               if (bt_value_string_get(elem, &arg)) {
+                       goto error;
+               }
+
+               ret = bt_value_array_append_string(run_args, arg);
+               bt_put(elem);
+               if (ret) {
+                       print_err_oom();
+                       goto error;
+               }
+       }
+
+       goto end;
+
+error:
+       ret = -1;
+
+end:
+       return ret;
+}
+
+static
+void destroy_implicit_component_args(struct implicit_component_args *args)
+{
+       assert(args);
+
+       if (args->plugin_comp_cls_arg) {
+               g_string_free(args->plugin_comp_cls_arg, TRUE);
+       }
+
+       if (args->name_arg) {
+               g_string_free(args->name_arg, TRUE);
+       }
+
+       if (args->params_arg) {
+               g_string_free(args->params_arg, TRUE);
+       }
+
+       bt_put(args->extra_args);
+}
+
+static
+int init_implicit_component_args(struct implicit_component_args *args,
+               const char *plugin_comp_cls_arg, bool exists)
+{
+       int ret = 0;
+
+       args->exists = exists;
+       args->plugin_comp_cls_arg = g_string_new(plugin_comp_cls_arg);
+       args->name_arg = g_string_new(NULL);
+       args->params_arg = g_string_new(NULL);
+       args->extra_args = bt_value_array_create();
+
+       if (!args->plugin_comp_cls_arg || !args->name_arg ||
+                       !args->params_arg || !args->extra_args) {
+               ret = -1;
+               destroy_implicit_component_args(args);
+               print_err_oom();
+               goto end;
+       }
+
+end:
+       return ret;
+}
+
+static
+void append_implicit_component_param(struct implicit_component_args *args,
+       const char *key, const char *value)
+{
+       assert(args);
+       assert(key);
+       assert(value);
+       append_param_arg(args->params_arg, key, value);
+}
+
+static
+int append_implicit_component_extra_arg(struct implicit_component_args *args,
+               const char *key, const char *value)
+{
+       int ret = 0;
+
+       assert(args);
+       assert(key);
+       assert(value);
+
+       if (bt_value_array_append_string(args->extra_args, "--key")) {
+               print_err_oom();
+               ret = -1;
+               goto end;
+       }
+
+       if (bt_value_array_append_string(args->extra_args, key)) {
+               print_err_oom();
+               ret = -1;
+               goto end;
+       }
+
+       if (bt_value_array_append_string(args->extra_args, "--value")) {
+               print_err_oom();
+               ret = -1;
+               goto end;
+       }
+
+       if (bt_value_array_append_string(args->extra_args, value)) {
+               print_err_oom();
+               ret = -1;
+               goto end;
+       }
+
+end:
+       return ret;
+}
+
+static
+int convert_append_name_param(enum bt_config_component_dest dest,
+               GString *cur_name, GString *cur_name_prefix,
+               struct bt_value *run_args, struct bt_value *all_names,
+               GList **source_names, GList **filter_names,
+               GList **sink_names)
+{
+       int ret = 0;
+
+       if (cur_name_prefix->len > 0) {
+               /* We're after a --source/--filter/--sink */
+               GString *name = NULL;
+               bool append_name_opt = false;
+
+               if (cur_name->len == 0) {
+                       /*
+                        * No explicit name was provided for the user
+                        * component.
+                        */
+                       name = get_component_auto_name(
+                               cur_name_prefix->str,
+                               all_names);
+                       append_name_opt = true;
+               } else {
+                       /*
+                        * An explicit name was provided for the user
+                        * component.
+                        */
+                       if (bt_value_map_has_key(all_names,
+                                       cur_name->str)) {
+                               printf_err("Duplicate component instance name:\n    %s\n",
+                                       cur_name->str);
+                               goto error;
+                       }
+
+                       name = g_string_new(cur_name->str);
+               }
+
+               if (!name) {
+                       print_err_oom();
+                       goto error;
+               }
+
+               /*
+                * Remember this name globally, for the uniqueness of
+                * all component names.
+                */
+               if (bt_value_map_insert(all_names, name->str, bt_value_null)) {
+                       print_err_oom();
+                       goto error;
+               }
+
+               /*
+                * Append the --name option if necessary.
+                */
+               if (append_name_opt) {
+                       if (bt_value_array_append_string(run_args, "--name")) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, name->str)) {
+                               print_err_oom();
+                               goto error;
+                       }
+               }
+
+               /*
+                * Remember this name specifically for the type of the
+                * component. This is to create connection arguments.
+                */
+               switch (dest) {
+               case BT_CONFIG_COMPONENT_DEST_SOURCE:
+                       *source_names = g_list_append(*source_names, name);
+                       break;
+               case BT_CONFIG_COMPONENT_DEST_FILTER:
+                       *filter_names = g_list_append(*filter_names, name);
+                       break;
+               case BT_CONFIG_COMPONENT_DEST_SINK:
+                       *sink_names = g_list_append(*sink_names, name);
+                       break;
+               default:
+                       assert(false);
+               }
+
+               g_string_assign(cur_name_prefix, "");
+       }
+
+       goto end;
+
+error:
+       ret = -1;
+
+end:
+       return ret;
+}
+
+/*
+ * Escapes `.`, `:`, and `\` of `input` with `\`.
+ */
+static
+GString *escape_dot_colon(const char *input)
+{
+       GString *output = g_string_new(NULL);
+       const char *ch;
+
+       if (!output) {
+               print_err_oom();
+               goto end;
+       }
+
+       for (ch = input; *ch != '\0'; ch++) {
+               if (*ch == '\\' || *ch == '.' || *ch == ':') {
+                       g_string_append_c(output, '\\');
+               }
+
+               g_string_append_c(output, *ch);
+       }
+
+end:
+       return output;
+}
+
+/*
+ * Appends a --connect option to a list of arguments. `upstream_name`
+ * and `downstream_name` are escaped with escape_dot_colon() in this
+ * function.
+ */
+static
+int append_connect_arg(struct bt_value *run_args,
+               const char *upstream_name, const char *downstream_name)
+{
+       int ret = 0;
+       GString *e_upstream_name = escape_dot_colon(upstream_name);
+       GString *e_downstream_name = escape_dot_colon(downstream_name);
+       GString *arg = g_string_new(NULL);
+
+       if (!e_upstream_name || !e_downstream_name || !arg) {
+               print_err_oom();
+               ret = -1;
+               goto end;
+       }
+
+       ret = bt_value_array_append_string(run_args, "--connect");
+       if (ret) {
+               print_err_oom();
+               ret = -1;
+               goto end;
+       }
+
+       g_string_append(arg, e_upstream_name->str);
+       g_string_append_c(arg, ':');
+       g_string_append(arg, e_downstream_name->str);
+       ret = bt_value_array_append_string(run_args, arg->str);
+       if (ret) {
+               print_err_oom();
+               ret = -1;
+               goto end;
+       }
+
+end:
+       if (arg) {
+               g_string_free(arg, TRUE);
+       }
+
+       if (e_upstream_name) {
+               g_string_free(e_upstream_name, TRUE);
+       }
+
+       if (e_downstream_name) {
+               g_string_free(e_downstream_name, TRUE);
+       }
+
+       return ret;
+}
+
+/*
+ * Appends the run command's --connect options for the convert command.
+ */
+static
+int convert_auto_connect(struct bt_value *run_args,
+               GList *source_names, GList *filter_names,
+               GList *sink_names)
+{
+       int ret = 0;
+       GList *source_at = source_names;
+       GList *filter_at = filter_names;
+       GList *filter_prev;
+       GList *sink_at = sink_names;
+
+       assert(source_names);
+       assert(filter_names);
+       assert(sink_names);
+
+       /* Connect all sources to the first filter */
+       for (source_at = source_names; source_at != NULL; source_at = g_list_next(source_at)) {
+               GString *source_name = source_at->data;
+               GString *filter_name = filter_at->data;
+
+               ret = append_connect_arg(run_args, source_name->str,
+                       filter_name->str);
+               if (ret) {
+                       goto error;
+               }
+       }
+
+       filter_prev = filter_at;
+       filter_at = g_list_next(filter_at);
+
+       /* Connect remaining filters */
+       for (; filter_at != NULL; filter_prev = filter_at, filter_at = g_list_next(filter_at)) {
+               GString *filter_name = filter_at->data;
+               GString *filter_prev_name = filter_prev->data;
+
+               ret = append_connect_arg(run_args, filter_prev_name->str,
+                       filter_name->str);
+               if (ret) {
+                       goto error;
+               }
+       }
+
+       /* Connect last filter to all sinks */
+       for (sink_at = sink_names; sink_at != NULL; sink_at = g_list_next(sink_at)) {
+               GString *filter_name = filter_prev->data;
+               GString *sink_name = sink_at->data;
+
+               ret = append_connect_arg(run_args, filter_name->str,
+                       sink_name->str);
+               if (ret) {
+                       goto error;
+               }
+       }
+
+       goto end;
+
+error:
+       ret = -1;
+
+end:
+       return ret;
+}
+
+static
+int split_timerange(const char *arg, char **begin, char **end)
+{
+       int ret = 0;
+       const char *ch = arg;
+       size_t end_pos;
+       GString *g_begin = NULL;
+       GString *g_end = NULL;
+
+       assert(arg);
+
+       if (*ch == '[') {
+               ch++;
+       }
+
+       g_begin = bt_common_string_until(ch, "", ",", &end_pos);
+       if (!g_begin || ch[end_pos] != ',' || g_begin->len == 0) {
+               goto error;
+       }
+
+       ch += end_pos + 1;
+
+       g_end = bt_common_string_until(ch, "", "]", &end_pos);
+       if (!g_end || g_end->len == 0) {
+               goto error;
+       }
+
+       assert(begin);
+       assert(end);
+       *begin = g_begin->str;
+       *end = g_end->str;
+       g_string_free(g_begin, FALSE);
+       g_string_free(g_end, FALSE);
+       g_begin = NULL;
+       g_end = NULL;
+       goto end;
+
+error:
+       ret = -1;
+
+end:
+       if (g_begin) {
+               g_string_free(g_begin, TRUE);
+       }
+
+       if (g_end) {
+               g_string_free(g_end, TRUE);
+       }
+
+       return ret;
+}
+
+static
+int g_list_prepend_gstring(GList **list, const char *string)
+{
+       int ret = 0;
+       GString *gs = g_string_new(string);
+
+       assert(list);
+
+       if (!gs) {
+               print_err_oom();
+               goto end;
+       }
+
+       *list = g_list_prepend(*list, gs);
+
+end:
+       return ret;
+}
+
+/*
+ * Creates a Babeltrace config object from the arguments of a convert
+ * command.
+ *
+ * *retcode is set to the appropriate exit code to use.
+ */
+static
+struct bt_config *bt_config_convert_from_args(int argc, const char *argv[],
+               int *retcode, bool force_omit_system_plugin_path,
+               bool force_omit_home_plugin_path, bool force_no_debug_info,
+               struct bt_value *initial_plugin_paths)
+{
+       poptContext pc = NULL;
+       char *arg = NULL;
+       enum bt_config_component_dest cur_comp_dest;
+       int opt, ret = 0;
+       struct bt_config *cfg = NULL;
+       bool got_verbose_opt = false;
+       bool got_debug_opt = false;
+       bool got_input_format_opt = false;
+       bool got_output_format_opt = false;
+       bool trimmer_has_begin = false;
+       bool trimmer_has_end = false;
+       GString *cur_name = NULL;
+       GString *cur_name_prefix = NULL;
+       const char *leftover = NULL;
+       bool print_run_args = false;
+       bool print_run_args_0 = false;
+       bool print_ctf_metadata = false;
+       struct bt_value *run_args = NULL;
+       struct bt_value *all_names = NULL;
+       GList *source_names = NULL;
+       GList *filter_names = NULL;
+       GList *sink_names = NULL;
+       struct implicit_component_args implicit_ctf_args = { 0 };
+       struct implicit_component_args implicit_lttng_live_args = { 0 };
+       struct implicit_component_args implicit_dummy_args = { 0 };
+       struct implicit_component_args implicit_text_args = { 0 };
+       struct implicit_component_args implicit_debug_info_args = { 0 };
+       struct implicit_component_args implicit_muxer_args = { 0 };
+       struct implicit_component_args implicit_trimmer_args = { 0 };
+       struct bt_value *plugin_paths = bt_get(initial_plugin_paths);
+       char error_buf[256] = { 0 };
+       size_t i;
+       struct bt_common_lttng_live_url_parts lttng_live_url_parts = { 0 };
+
+       *retcode = 0;
+
+       if (argc <= 1) {
+               print_convert_usage(stdout);
+               *retcode = -1;
+               goto end;
+       }
+
+       if (init_implicit_component_args(&implicit_ctf_args, "ctf.fs", false)) {
+               goto error;
+       }
+
+       if (init_implicit_component_args(&implicit_lttng_live_args,
+                       "ctf.lttng-live", false)) {
+               goto error;
+       }
+
+       if (init_implicit_component_args(&implicit_text_args, "text.pretty",
+                       false)) {
+               goto error;
+       }
+
+       if (init_implicit_component_args(&implicit_dummy_args, "utils.dummy",
+                       false)) {
+               goto error;
+       }
+
+       if (init_implicit_component_args(&implicit_debug_info_args,
+                       "lttng-utils.debug-info", !force_no_debug_info)) {
+               goto error;
+       }
+
+       if (init_implicit_component_args(&implicit_muxer_args, "utils.muxer",
+                       true)) {
+               goto error;
+       }
+
+       if (init_implicit_component_args(&implicit_trimmer_args,
+                       "utils.trimmer", false)) {
+               goto error;
+       }
+
+       all_names = bt_value_map_create();
+       if (!all_names) {
+               print_err_oom();
+               goto error;
+       }
+
+       run_args = bt_value_array_create();
+       if (!run_args) {
+               print_err_oom();
+               goto error;
+       }
+
+       cur_name = g_string_new(NULL);
+       if (!cur_name) {
+               print_err_oom();
+               goto error;
+       }
+
+       cur_name_prefix = g_string_new(NULL);
+       if (!cur_name_prefix) {
+               print_err_oom();
+               goto error;
+       }
+
+       ret = append_env_var_plugin_paths(plugin_paths);
+       if (ret) {
+               goto error;
+       }
+
+       /*
+        * First pass: collect all arguments which need to be passed
+        * as is to the run command. This pass can also add --name
+        * arguments if needed to automatically name unnamed component
+        * instances. Also it does the following transformations:
+        *
+        *     --path=PATH -> --key path --value PATH
+        *     --url=URL   -> --key url --value URL
+        *
+        * Also it appends the plugin paths of --plugin-path to
+        * `plugin_paths`.
+        */
+       pc = poptGetContext(NULL, argc, (const char **) argv,
+               convert_long_options, 0);
+       if (!pc) {
+               printf_err("Cannot get popt context\n");
+               goto error;
+       }
+
+       poptReadDefaultConfig(pc, 0);
+
+       while ((opt = poptGetNextOpt(pc)) > 0) {
+               char *name = NULL;
+               char *plugin_name = NULL;
+               char *comp_cls_name = NULL;
+
+               arg = poptGetOptArg(pc);
+
+               switch (opt) {
+               case OPT_SOURCE:
+               case OPT_FILTER:
+               case OPT_SINK:
+                       /* Append current component's name if needed */
+                       ret = convert_append_name_param(cur_comp_dest, cur_name,
+                               cur_name_prefix, run_args, all_names,
+                               &source_names, &filter_names, &sink_names);
+                       if (ret) {
+                               goto error;
+                       }
+
+                       /* Parse the argument */
+                       plugin_comp_cls_names(arg, &name, &plugin_name,
+                               &comp_cls_name);
+                       if (!plugin_name || !comp_cls_name) {
+                               printf_err("Invalid format for --source/--filter/--sink option's argument:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       if (name) {
+                               g_string_assign(cur_name, name);
+                       } else {
+                               g_string_assign(cur_name, "");
+                       }
+
+                       switch (opt) {
+                       case OPT_SOURCE:
+                               cur_comp_dest =
+                                       BT_CONFIG_COMPONENT_DEST_SOURCE;
+                               if (bt_value_array_append_string(run_args,
+                                               "--source")) {
+                                       print_err_oom();
+                                       goto error;
+                               }
+                               break;
+                       case OPT_FILTER:
+                               cur_comp_dest =
+                                       BT_CONFIG_COMPONENT_DEST_FILTER;
+                               if (bt_value_array_append_string(run_args,
+                                               "--filter")) {
+                                       print_err_oom();
+                                       goto error;
+                               }
+                               break;
+                       case OPT_SINK:
+                               cur_comp_dest =
+                                       BT_CONFIG_COMPONENT_DEST_SINK;
+                               if (bt_value_array_append_string(run_args,
+                                               "--sink")) {
+                                       print_err_oom();
+                                       goto error;
+                               }
+                               break;
+                       default:
+                               assert(false);
+                       }
+
+                       if (bt_value_array_append_string(run_args, arg)) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       g_string_assign(cur_name_prefix, "");
+                       g_string_append(cur_name_prefix, plugin_name);
+                       g_string_append_c(cur_name_prefix, '.');
+                       g_string_append(cur_name_prefix, comp_cls_name);
+                       free(name);
+                       free(plugin_name);
+                       free(comp_cls_name);
+                       name = NULL;
+                       plugin_name = NULL;
+                       comp_cls_name = NULL;
+                       break;
+               case OPT_PARAMS:
+                       if (cur_name_prefix->len == 0) {
+                               printf_err("No current component of which to set parameters:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args,
+                                       "--params")) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, arg)) {
+                               print_err_oom();
+                               goto error;
+                       }
+                       break;
+               case OPT_PATH:
+                       if (cur_name_prefix->len == 0) {
+                               printf_err("No current component of which to set `path` parameter:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, "--key")) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, "path")) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, "--value")) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, arg)) {
+                               print_err_oom();
+                               goto error;
+                       }
+                       break;
+               case OPT_URL:
+                       if (cur_name_prefix->len == 0) {
+                               printf_err("No current component of which to set `url` parameter:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, "--key")) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, "url")) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, "--value")) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, arg)) {
+                               print_err_oom();
+                               goto error;
+                       }
+                       break;
+               case OPT_NAME:
+                       if (cur_name_prefix->len == 0) {
+                               printf_err("No current component to name:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, "--name")) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, arg)) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       g_string_assign(cur_name, arg);
+                       break;
+               case OPT_OMIT_HOME_PLUGIN_PATH:
+                       force_omit_home_plugin_path = true;
+
+                       if (bt_value_array_append_string(run_args,
+                                       "--omit-home-plugin-path")) {
+                               print_err_oom();
+                               goto error;
+                       }
+                       break;
+               case OPT_RETRY_DURATION:
+                       if (bt_value_array_append_string(run_args,
+                                       "--retry-duration")) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, arg)) {
+                               print_err_oom();
+                               goto error;
+                       }
+                       break;
+               case OPT_OMIT_SYSTEM_PLUGIN_PATH:
+                       force_omit_system_plugin_path = true;
+
+                       if (bt_value_array_append_string(run_args,
+                                       "--omit-system-plugin-path")) {
+                               print_err_oom();
+                               goto error;
+                       }
+                       break;
+               case OPT_PLUGIN_PATH:
+                       if (bt_config_append_plugin_paths_check_setuid_setgid(
+                                       plugin_paths, arg)) {
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args,
+                                       "--plugin-path")) {
+                               print_err_oom();
+                               goto error;
+                       }
+
+                       if (bt_value_array_append_string(run_args, arg)) {
+                               print_err_oom();
+                               goto error;
+                       }
+                       break;
+               case OPT_HELP:
+                       print_convert_usage(stdout);
+                       *retcode = -1;
+                       BT_PUT(cfg);
+                       goto end;
+               case OPT_BEGIN:
+               case OPT_CLOCK_CYCLES:
+               case OPT_CLOCK_DATE:
+               case OPT_CLOCK_FORCE_CORRELATE:
+               case OPT_CLOCK_GMT:
+               case OPT_CLOCK_OFFSET:
+               case OPT_CLOCK_OFFSET_NS:
+               case OPT_CLOCK_SECONDS:
+               case OPT_COLOR:
+               case OPT_DEBUG:
+               case OPT_DEBUG_INFO_DIR:
+               case OPT_DEBUG_INFO_FULL_PATH:
+               case OPT_DEBUG_INFO_TARGET_PREFIX:
+               case OPT_END:
+               case OPT_FIELDS:
+               case OPT_INPUT_FORMAT:
+               case OPT_NAMES:
+               case OPT_NO_DEBUG_INFO:
+               case OPT_NO_DELTA:
+               case OPT_OUTPUT_FORMAT:
+               case OPT_OUTPUT:
+               case OPT_RUN_ARGS:
+               case OPT_RUN_ARGS_0:
+               case OPT_STREAM_INTERSECTION:
+               case OPT_TIMERANGE:
+               case OPT_VERBOSE:
+                       /* Ignore in this pass */
+                       break;
+               default:
+                       printf_err("Unknown command-line option specified (option code %d)\n",
+                               opt);
+                       goto error;
+               }
+
+               free(arg);
+               arg = NULL;
+       }
+
+       /* Append current component's name if needed */
+       ret = convert_append_name_param(cur_comp_dest, cur_name,
+               cur_name_prefix, run_args, all_names, &source_names,
+               &filter_names, &sink_names);
+       if (ret) {
+               goto error;
+       }
+
+       /* Check for option parsing error */
+       if (opt < -1) {
+               printf_err("While parsing command-line options, at option %s: %s\n",
+                       poptBadOption(pc, 0), poptStrerror(opt));
+               goto error;
+       }
+
+       poptFreeContext(pc);
+       free(arg);
+       arg = NULL;
+
+       /*
+        * Second pass: transform the convert-specific options and
+        * arguments into implicit component instances for the run
+        * command.
+        */
+       pc = poptGetContext(NULL, argc, (const char **) argv,
+               convert_long_options, 0);
+       if (!pc) {
+               printf_err("Cannot get popt context\n");
+               goto error;
+       }
+
+       poptReadDefaultConfig(pc, 0);
+
+       while ((opt = poptGetNextOpt(pc)) > 0) {
+               arg = poptGetOptArg(pc);
+
+               switch (opt) {
+               case OPT_BEGIN:
+                       if (trimmer_has_begin) {
+                               printf("At --begin option: --begin or --timerange option already specified\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       trimmer_has_begin = true;
+                       ret = append_implicit_component_extra_arg(
+                               &implicit_trimmer_args, "begin", arg);
+                       implicit_trimmer_args.exists = true;
+                       if (ret) {
+                               goto error;
+                       }
+                       break;
+               case OPT_END:
+                       if (trimmer_has_end) {
+                               printf("At --end option: --end or --timerange option already specified\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       trimmer_has_end = true;
+                       ret = append_implicit_component_extra_arg(
+                               &implicit_trimmer_args, "end", arg);
+                       implicit_trimmer_args.exists = true;
+                       if (ret) {
+                               goto error;
+                       }
+                       break;
+               case OPT_TIMERANGE:
+               {
+                       char *begin;
+                       char *end;
+
+                       if (trimmer_has_begin || trimmer_has_end) {
+                               printf("At --timerange option: --begin, --end, or --timerange option already specified\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       ret = split_timerange(arg, &begin, &end);
+                       if (ret) {
+                               printf_err("Invalid --timerange option's argument: expecting BEGIN,END or [BEGIN,END]:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+
+                       ret = append_implicit_component_extra_arg(
+                               &implicit_trimmer_args, "begin", begin);
+                       ret |= append_implicit_component_extra_arg(
+                               &implicit_trimmer_args, "end", end);
+                       implicit_trimmer_args.exists = true;
+                       free(begin);
+                       free(end);
+                       if (ret) {
+                               goto error;
+                       }
+                       break;
+               }
+               case OPT_CLOCK_CYCLES:
+                       append_implicit_component_param(
+                               &implicit_text_args, "clock-cycles", "yes");
+                       implicit_text_args.exists = true;
+                       break;
+               case OPT_CLOCK_DATE:
+                       append_implicit_component_param(
+                               &implicit_text_args, "clock-date", "yes");
+                       implicit_text_args.exists = true;
+                       break;
+               case OPT_CLOCK_FORCE_CORRELATE:
+                       append_implicit_component_param(
+                               &implicit_muxer_args, "force-correlate", "yes");
+                       break;
+               case OPT_CLOCK_GMT:
+                       append_implicit_component_param(
+                               &implicit_text_args, "clock-gmt", "yes");
+                       implicit_text_args.exists = true;
+                       break;
+               case OPT_CLOCK_OFFSET:
+                       ret = append_implicit_component_extra_arg(
+                               &implicit_ctf_args, "clock-offset-cycles", arg);
+                       implicit_ctf_args.exists = true;
+                       if (ret) {
+                               goto error;
+                       }
+                       break;
+               case OPT_CLOCK_OFFSET_NS:
+                       ret = append_implicit_component_extra_arg(
+                               &implicit_ctf_args, "clock-offset-ns", arg);
+                       implicit_ctf_args.exists = true;
+                       if (ret) {
+                               goto error;
+                       }
+                       break;
+               case OPT_CLOCK_SECONDS:
+                       append_implicit_component_param(
+                               &implicit_text_args, "clock-seconds", "yes");
+                       implicit_text_args.exists = true;
+                       break;
+               case OPT_COLOR:
+                       ret = append_implicit_component_extra_arg(
+                               &implicit_text_args, "color", arg);
+                       implicit_text_args.exists = true;
+                       if (ret) {
+                               goto error;
+                       }
+                       break;
+               case OPT_NO_DEBUG_INFO:
+                       implicit_debug_info_args.exists = false;
+                       break;
+               case OPT_DEBUG_INFO_DIR:
+                       ret = append_implicit_component_extra_arg(
+                               &implicit_debug_info_args, "dir", arg);
+                       if (ret) {
+                               goto error;
+                       }
+                       break;
+               case OPT_DEBUG_INFO_FULL_PATH:
+                       append_implicit_component_param(
+                               &implicit_debug_info_args, "full-path", "yes");
+                       break;
+               case OPT_DEBUG_INFO_TARGET_PREFIX:
+                       ret = append_implicit_component_extra_arg(
+                               &implicit_debug_info_args,
+                               "target-prefix", arg);
+                       if (ret) {
+                               goto error;
+                       }
+                       break;
+               case OPT_FIELDS:
+               {
+                       struct bt_value *fields = fields_from_arg(arg);
+
+                       if (!fields) {
+                               goto error;
+                       }
+
+                       ret = insert_flat_params_from_array(
+                               implicit_text_args.params_arg,
+                               fields, "field");
+                       bt_put(fields);
+                       if (ret) {
+                               goto error;
+                       }
+                       break;
+               }
+               case OPT_NAMES:
+               {
+                       struct bt_value *names = names_from_arg(arg);
+
+                       if (!names) {
+                               goto error;
+                       }
+
+                       ret = insert_flat_params_from_array(
+                               implicit_text_args.params_arg,
+                               names, "name");
+                       bt_put(names);
+                       if (ret) {
+                               goto error;
+                       }
+                       break;
+               }
+               case OPT_NO_DELTA:
+                       append_implicit_component_param(
+                               &implicit_text_args, "no-delta", "yes");
+                       implicit_text_args.exists = true;
+                       break;
+               case OPT_INPUT_FORMAT:
+                       if (got_input_format_opt) {
+                               printf_err("Duplicate --input-format option\n");
+                               goto error;
+                       }
+
+                       got_input_format_opt = true;
+
+                       if (strcmp(arg, "ctf") == 0) {
+                               implicit_ctf_args.exists = true;
+                       } else if (strcmp(arg, "lttng-live") == 0) {
+                               implicit_lttng_live_args.exists = true;
+                       } else {
+                               printf_err("Unknown legacy input format:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+                       break;
+               case OPT_OUTPUT_FORMAT:
+                       if (got_output_format_opt) {
+                               printf_err("Duplicate --output-format option\n");
+                               goto error;
+                       }
+
+                       got_output_format_opt = true;
+
+                       if (strcmp(arg, "text") == 0) {
+                               implicit_text_args.exists = true;
+                       } else if (strcmp(arg, "dummy") == 0) {
+                               implicit_dummy_args.exists = true;
+                       } else if (strcmp(arg, "ctf-metadata") == 0) {
+                               print_ctf_metadata = true;
+                       } else {
+                               printf_err("Unknown legacy output format:\n    %s\n",
+                                       arg);
+                               goto error;
+                       }
+                       break;
+               case OPT_OUTPUT:
+                       ret = append_implicit_component_extra_arg(
+                               &implicit_text_args, "path", arg);
+                       implicit_text_args.exists = true;
+                       if (ret) {
+                               goto error;
+                       }
+                       break;
+               case OPT_RUN_ARGS:
+                       if (print_run_args_0) {
+                               printf_err("Cannot specify --run-args and --run-args-0\n");
+                               goto error;
+                       }
+
+                       print_run_args = true;
+                       break;
+               case OPT_RUN_ARGS_0:
+                       if (print_run_args) {
+                               printf_err("Cannot specify --run-args and --run-args-0\n");
+                               goto error;
+                       }
+
+                       print_run_args_0 = true;
+                       break;
+               case OPT_STREAM_INTERSECTION:
+                       append_implicit_component_param(&implicit_ctf_args,
+                               "stream-intersection", "yes");
+                       implicit_ctf_args.exists = true;
+                       break;
+               case OPT_VERBOSE:
+                       if (got_verbose_opt) {
+                               printf_err("Duplicate -v/--verbose option\n");
+                               goto error;
+                       }
+
+                       append_implicit_component_param(&implicit_text_args,
+                               "verbose", "yes");
+                       implicit_text_args.exists = true;
+                       got_verbose_opt = true;
+                       break;
+               case OPT_DEBUG:
+                       got_debug_opt = true;
+                       break;
+               }
+
+               free(arg);
+               arg = NULL;
+       }
+
+       /* Check for option parsing error */
+       if (opt < -1) {
+               printf_err("While parsing command-line options, at option %s: %s\n",
+                       poptBadOption(pc, 0), poptStrerror(opt));
+               goto error;
+       }
+
+       /*
+        * Append home and system plugin paths now that we possibly got
+        * --plugin-path.
+        */
+       if (append_home_and_system_plugin_paths(plugin_paths,
+                       force_omit_system_plugin_path,
+                       force_omit_home_plugin_path)) {
+               goto error;
+       }
+
+       /* Consume leftover argument */
+       leftover = poptGetArg(pc);
+
+       if (poptPeekArg(pc)) {
+               printf_err("Unexpected argument:\n    %s\n",
+                       poptPeekArg(pc));
+               goto error;
+       }
+
+       /* Print CTF metadata or print LTTng live sessions */
+       if (print_ctf_metadata) {
+               if (!leftover) {
+                       printf_err("--output-format=ctf-metadata specified without a path\n");
+                       goto error;
+               }
+
+               cfg = bt_config_print_ctf_metadata_create(plugin_paths);
+               if (!cfg) {
+                       goto error;
+               }
+
+               cfg->debug = got_debug_opt;
+               cfg->verbose = got_verbose_opt;
+               g_string_assign(cfg->cmd_data.print_ctf_metadata.path,
+                       leftover);
+               goto end;
+       }
+
+       /*
+        * If -o dummy was not specified, and if there are no explicit
+        * sink components, then use an implicit `text.text` sink.
+        */
+       if (!implicit_dummy_args.exists && !sink_names) {
+               implicit_text_args.exists = true;
+       }
+
+       /* Decide where the leftover argument goes */
+       if (leftover) {
+               if (implicit_lttng_live_args.exists) {
+                       lttng_live_url_parts =
+                               bt_common_parse_lttng_live_url(leftover,
+                                       error_buf, 256);
+                       if (!lttng_live_url_parts.proto) {
+                               printf_err("Invalid LTTng live URL format: %s\n",
+                                       error_buf);
+                               goto error;
+                       }
+
+                       if (!lttng_live_url_parts.session_name) {
+                               /* Print LTTng live sessions */
+                               cfg = bt_config_print_lttng_live_sessions_create(
+                                       plugin_paths);
+                               if (!cfg) {
+                                       goto error;
+                               }
+
+                               cfg->debug = got_debug_opt;
+                               cfg->verbose = got_verbose_opt;
+                               g_string_assign(cfg->cmd_data.print_lttng_live_sessions.url,
+                                       leftover);
+                               goto end;
+                       }
+
+                       ret = append_implicit_component_extra_arg(
+                               &implicit_lttng_live_args, "url", leftover);
+                       if (ret) {
+                               goto error;
+                       }
+               } else {
+                       ret = append_implicit_component_extra_arg(
+                               &implicit_ctf_args, "path", leftover);
+                       implicit_ctf_args.exists = true;
+                       if (ret) {
+                               goto error;
+                       }
+               }
+       }
+
+       /*
+        * Ensure mutual exclusion between implicit `ctf.fs` and
+        * `ctf.lttng-live` sources.
+        */
+       if (implicit_ctf_args.exists && implicit_lttng_live_args.exists) {
+               printf_err("Cannot create both implicit `%s` and `%s` source components\n",
+                       implicit_ctf_args.plugin_comp_cls_arg->str,
+                       implicit_lttng_live_args.plugin_comp_cls_arg->str);
+               goto error;
+       }
+
+       /*
+        * If the implicit `ctf.fs` or `ctf.lttng-live` source exists,
+        * make sure there's a leftover (which is the path or URL).
+        */
+       if (implicit_ctf_args.exists && !leftover) {
+               printf_err("Missing path for implicit `%s` source component\n",
+                       implicit_ctf_args.plugin_comp_cls_arg->str);
+               goto error;
+       }
+
+       if (implicit_lttng_live_args.exists && !leftover) {
+               printf_err("Missing URL for implicit `%s` source component\n",
+                       implicit_lttng_live_args.plugin_comp_cls_arg->str);
+               goto error;
+       }
+
+       /* Assign names to implicit components */
+       ret = assign_name_to_implicit_component(&implicit_ctf_args,
+               "ctf-fs", all_names, &source_names, true);
+       if (ret) {
+               goto error;
+       }
+
+       ret = assign_name_to_implicit_component(&implicit_lttng_live_args,
+               "lttng-live", all_names, &source_names, true);
+       if (ret) {
+               goto error;
+       }
+
+       ret = assign_name_to_implicit_component(&implicit_text_args,
+               "pretty", all_names, &sink_names, true);
+       if (ret) {
+               goto error;
+       }
+
+       ret = assign_name_to_implicit_component(&implicit_dummy_args,
+               "dummy", all_names, &sink_names, true);
+       if (ret) {
+               goto error;
+       }
+
+       ret = assign_name_to_implicit_component(&implicit_muxer_args,
+               "muxer", all_names, NULL, false);
+       if (ret) {
+               goto error;
+       }
+
+       ret = assign_name_to_implicit_component(&implicit_trimmer_args,
+               "trimmer", all_names, NULL, false);
+       if (ret) {
+               goto error;
+       }
+
+       ret = assign_name_to_implicit_component(&implicit_debug_info_args,
+               "debug-info", all_names, NULL, false);
+       if (ret) {
+               goto error;
+       }
+
+       /* Make sure there's at least one source and one sink */
+       if (!source_names) {
+               printf_err("No source component\n");
+               goto error;
+       }
+
+       if (!sink_names) {
+               printf_err("No sink component\n");
+               goto error;
+       }
+
+       /*
+        * Prepend the muxer, the trimmer, and the debug info to the
+        * filter chain so that we have:
+        *
+        *     sources -> muxer -> [trimmer] -> [debug info] ->
+        *                [user filters] -> sinks
+        */
+       if (implicit_debug_info_args.exists) {
+               if (g_list_prepend_gstring(&filter_names,
+                               implicit_debug_info_args.name_arg->str)) {
+                       goto error;
+               }
+       }
+
+       if (implicit_trimmer_args.exists) {
+               if (g_list_prepend_gstring(&filter_names,
+                               implicit_trimmer_args.name_arg->str)) {
+                       goto error;
+               }
+       }
+
+       if (g_list_prepend_gstring(&filter_names,
+                       implicit_muxer_args.name_arg->str)) {
+               goto error;
+       }
+
+       /*
+        * Append the equivalent run arguments for the implicit
+        * components.
+        */
+       ret = append_run_args_for_implicit_component(
+               BT_COMPONENT_CLASS_TYPE_SOURCE, &implicit_ctf_args, run_args);
+       if (ret) {
+               goto error;
+       }
+
+       ret = append_run_args_for_implicit_component(
+               BT_COMPONENT_CLASS_TYPE_SOURCE, &implicit_lttng_live_args,
+               run_args);
+       if (ret) {
+               goto error;
+       }
+
+       ret = append_run_args_for_implicit_component(
+               BT_COMPONENT_CLASS_TYPE_SINK, &implicit_text_args, run_args);
+       if (ret) {
+               goto error;
+       }
+
+       ret = append_run_args_for_implicit_component(
+               BT_COMPONENT_CLASS_TYPE_SINK, &implicit_dummy_args, run_args);
+       if (ret) {
+               goto error;
+       }
+
+       ret = append_run_args_for_implicit_component(
+               BT_COMPONENT_CLASS_TYPE_FILTER, &implicit_muxer_args, run_args);
+       if (ret) {
+               goto error;
+       }
+
+       ret = append_run_args_for_implicit_component(
+               BT_COMPONENT_CLASS_TYPE_FILTER, &implicit_trimmer_args,
+               run_args);
+       if (ret) {
+               goto error;
+       }
+
+       ret = append_run_args_for_implicit_component(
+               BT_COMPONENT_CLASS_TYPE_FILTER, &implicit_debug_info_args,
+               run_args);
+       if (ret) {
+               goto error;
+       }
+
+       /* Auto-connect components */
+       ret = convert_auto_connect(run_args, source_names, filter_names,
+                       sink_names);
+       if (ret) {
+               printf_err("Cannot auto-connect components\n");
+               goto error;
+       }
+
+       /*
+        * We have all the run command arguments now. Depending on
+        * --run-args, we pass this to the run command or print them
+        * here.
+        */
+       if (print_run_args || print_run_args_0) {
+               for (i = 0; i < bt_value_array_size(run_args); i++) {
+                       struct bt_value *arg_value =
+                               bt_value_array_get(run_args, i);
+                       const char *arg;
+                       GString *quoted = NULL;
+                       const char *arg_to_print;
+
+                       assert(arg_value);
+                       ret = bt_value_string_get(arg_value, &arg);
+                       assert(ret == 0);
+                       BT_PUT(arg_value);
+
+                       if (print_run_args) {
+                               quoted = bt_common_shell_quote(arg, true);
+                               if (!quoted) {
+                                       goto error;
+                               }
+
+                               arg_to_print = quoted->str;
+                       } else {
+                               arg_to_print = arg;
+                       }
+
+                       printf("%s", arg_to_print);
+
+                       if (quoted) {
+                               g_string_free(quoted, TRUE);
+                       }
+
+                       if (i < bt_value_array_size(run_args) - 1) {
+                               if (print_run_args) {
+                                       putchar(' ');
+                               } else {
+                                       putchar('\0');
+                               }
+                       }
+               }
+
+               *retcode = -1;
+               BT_PUT(cfg);
+               goto end;
+       }
+
+       cfg = bt_config_run_from_args_array(run_args, retcode,
+               force_omit_system_plugin_path, force_omit_home_plugin_path,
+               initial_plugin_paths);
+       goto end;
+
+error:
+       *retcode = 1;
+       BT_PUT(cfg);
+
+end:
+       if (pc) {
+               poptFreeContext(pc);
+       }
+
+       free(arg);
+
+       if (cur_name) {
+               g_string_free(cur_name, TRUE);
+       }
+
+       if (cur_name_prefix) {
+               g_string_free(cur_name_prefix, TRUE);
+       }
+
+       bt_put(run_args);
+       bt_put(all_names);
+       destroy_glist_of_gstring(source_names);
+       destroy_glist_of_gstring(filter_names);
+       destroy_glist_of_gstring(sink_names);
+       destroy_implicit_component_args(&implicit_ctf_args);
+       destroy_implicit_component_args(&implicit_lttng_live_args);
+       destroy_implicit_component_args(&implicit_dummy_args);
+       destroy_implicit_component_args(&implicit_text_args);
+       destroy_implicit_component_args(&implicit_debug_info_args);
+       destroy_implicit_component_args(&implicit_muxer_args);
+       destroy_implicit_component_args(&implicit_trimmer_args);
+       bt_put(plugin_paths);
+       bt_common_destroy_lttng_live_url_parts(&lttng_live_url_parts);
+       return cfg;
+}
+
+/*
+ * Prints the Babeltrace 2.x general usage.
+ */
+static
+void print_gen_usage(FILE *fp)
+{
+       fprintf(fp, "Usage: babeltrace [GENERAL OPTIONS] [COMMAND] [COMMAND ARGUMENTS]\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "General options:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "  -d, --debug        Turn on debug mode\n");
+       fprintf(fp, "  -h  --help         Show this help and quit\n");
+       fprintf(fp, "  -v, --verbose      Turn on verbose mode\n");
+       fprintf(fp, "  -V, --version      Show version and quit\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Available commands:\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "    convert       Convert and trim traces (default)\n");
+       fprintf(fp, "    help          Get help for a plugin or a component class\n");
+       fprintf(fp, "    list-plugins  List available plugins and their content\n");
+       fprintf(fp, "    query         Query objects from a component class\n");
+       fprintf(fp, "    run           Build a processing graph and run it\n");
+       fprintf(fp, "\n");
+       fprintf(fp, "Use `babeltrace COMMAND --help` to show the help of COMMAND.\n");
+}
+
+struct bt_config *bt_config_cli_args_create(int argc, const char *argv[],
+               int *retcode, bool force_omit_system_plugin_path,
+               bool force_omit_home_plugin_path, bool force_no_debug_info,
+               struct bt_value *initial_plugin_paths)
+{
+       struct bt_config *config = NULL;
+       bool verbose = false;
+       bool debug = false;
+       int i;
+       const char **command_argv = NULL;
+       int command_argc = -1;
+       const char *command_name = NULL;
+
+       enum command_type {
+               COMMAND_TYPE_NONE = -1,
+               COMMAND_TYPE_RUN = 0,
+               COMMAND_TYPE_CONVERT,
+               COMMAND_TYPE_LIST_PLUGINS,
+               COMMAND_TYPE_HELP,
+               COMMAND_TYPE_QUERY,
+       } command_type = COMMAND_TYPE_NONE;
+
+       *retcode = -1;
+
+       if (!initial_plugin_paths) {
+               initial_plugin_paths = bt_value_array_create();
+               if (!initial_plugin_paths) {
+                       *retcode = 1;
+                       goto end;
+               }
+       } else {
+               bt_get(initial_plugin_paths);
+       }
+
+       if (argc <= 1) {
+               print_gen_usage(stdout);
+               goto end;
+       }
+
+       for (i = 1; i < argc; i++) {
+               const char *cur_arg = argv[i];
+
+               if (strcmp(cur_arg, "-d") == 0 ||
+                               strcmp(cur_arg, "--debug") == 0) {
+                       debug = true;
+               } else if (strcmp(cur_arg, "-v") == 0 ||
+                               strcmp(cur_arg, "--verbose") == 0) {
+                       verbose = true;
+               } else if (strcmp(cur_arg, "-V") == 0 ||
+                               strcmp(cur_arg, "--version") == 0) {
+                       print_version();
+                       goto end;
+               } else if (strcmp(cur_arg, "-h") == 0 ||
+                               strcmp(cur_arg, "--help") == 0) {
+                       print_gen_usage(stdout);
+                       goto end;
+               } else {
+                       bool has_command = true;
+
+                       /*
+                        * First unknown argument: is it a known command
+                        * name?
+                        */
+                       if (strcmp(cur_arg, "convert") == 0) {
+                               command_type = COMMAND_TYPE_CONVERT;
+                       } else if (strcmp(cur_arg, "list-plugins") == 0) {
+                               command_type = COMMAND_TYPE_LIST_PLUGINS;
+                       } else if (strcmp(cur_arg, "help") == 0) {
+                               command_type = COMMAND_TYPE_HELP;
+                       } else if (strcmp(cur_arg, "query") == 0) {
+                               command_type = COMMAND_TYPE_QUERY;
+                       } else if (strcmp(cur_arg, "run") == 0) {
+                               command_type = COMMAND_TYPE_RUN;
+                       } else {
+                               /*
+                                * Unknown argument, but not a known
+                                * command name: assume the whole
+                                * arguments are for the default convert
+                                * command.
+                                */
+                               command_type = COMMAND_TYPE_CONVERT;
+                               command_argv = argv;
+                               command_argc = argc;
+                               has_command = false;
+                       }
+
+                       if (has_command) {
+                               command_argv = &argv[i];
+                               command_argc = argc - i;
+                               command_name = cur_arg;
+                       }
+                       break;
+               }
+       }
+
+       if (command_type == COMMAND_TYPE_NONE) {
+               /*
+                * We only got non-help, non-version general options
+                * like --verbose and --debug, without any other
+                * arguments, so we can't do anything useful: print the
+                * usage and quit.
+                */
+               print_gen_usage(stdout);
+               goto end;
+       }
+
+       assert(command_argv);
+       assert(command_argc >= 0);
+
+       switch (command_type) {
+       case COMMAND_TYPE_RUN:
+               config = bt_config_run_from_args(command_argc, command_argv,
+                       retcode, force_omit_system_plugin_path,
+                       force_omit_home_plugin_path, initial_plugin_paths);
+               break;
+       case COMMAND_TYPE_CONVERT:
+               config = bt_config_convert_from_args(command_argc, command_argv,
+                       retcode, force_omit_system_plugin_path,
+                       force_omit_home_plugin_path, force_no_debug_info,
+                       initial_plugin_paths);
+               break;
+       case COMMAND_TYPE_LIST_PLUGINS:
+               config = bt_config_list_plugins_from_args(command_argc,
+                       command_argv, retcode, force_omit_system_plugin_path,
+                       force_omit_home_plugin_path, initial_plugin_paths);
+               break;
+       case COMMAND_TYPE_HELP:
+               config = bt_config_help_from_args(command_argc,
+                       command_argv, retcode, force_omit_system_plugin_path,
+                       force_omit_home_plugin_path, initial_plugin_paths);
+               break;
+       case COMMAND_TYPE_QUERY:
+               config = bt_config_query_from_args(command_argc,
+                       command_argv, retcode, force_omit_system_plugin_path,
+                       force_omit_home_plugin_path, initial_plugin_paths);
+               break;
+       default:
+               assert(false);
+       }
+
+       if (config) {
+               if (verbose) {
+                       config->verbose = true;
+               }
+
+               if (debug) {
+                       config->debug = true;
+               }
+
+               config->command_name = command_name;
+       }
+
+end:
+       bt_put(initial_plugin_paths);
+       return config;
+}
diff --git a/cli/babeltrace-cfg-cli-args.h b/cli/babeltrace-cfg-cli-args.h
new file mode 100644 (file)
index 0000000..b5eb3b2
--- /dev/null
@@ -0,0 +1,42 @@
+#ifndef CLI_BABELTRACE_CFG_CLI_ARGS_H
+#define CLI_BABELTRACE_CFG_CLI_ARGS_H
+
+/*
+ * Copyright 2016-2017 Philippe Proulx <pproulx@efficios.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+#include <stdlib.h>
+#include <stdint.h>
+#include <babeltrace/values.h>
+#include <babeltrace/ref.h>
+#include <babeltrace/object-internal.h>
+#include <babeltrace/compiler-internal.h>
+#include <babeltrace/graph/component-class.h>
+#include <glib.h>
+
+#include "babeltrace-cfg.h"
+
+struct bt_config *bt_config_cli_args_create(int argc, const char *argv[],
+               int *retcode, bool force_omit_system_plugin_path,
+               bool force_omit_home_plugin_path, bool force_no_debug_info,
+               struct bt_value *initial_plugin_paths);
+
+#endif /* CLI_BABELTRACE_CFG_CLI_ARGS_H */
diff --git a/cli/babeltrace-cfg-connect.c b/cli/babeltrace-cfg-connect.c
deleted file mode 100644 (file)
index e1de064..0000000
+++ /dev/null
@@ -1,680 +0,0 @@
-/*
- * Copyright 2017 Philippe Proulx <pproulx@efficios.com>
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-#include <babeltrace/values.h>
-#include <babeltrace/common-internal.h>
-#include "babeltrace-cfg.h"
-#include "babeltrace-cfg-connect.h"
-
-static bool all_named_and_printable_in_array(GPtrArray *comps)
-{
-       size_t i;
-       bool all_named_and_printable = true;
-
-       for (i = 0; i < comps->len; i++) {
-               struct bt_config_component *comp = g_ptr_array_index(comps, i);
-
-               if (comp->instance_name->len == 0) {
-                       all_named_and_printable = false;
-                       goto end;
-               }
-
-               if (!bt_common_string_is_printable(comp->instance_name->str)) {
-                       all_named_and_printable = false;
-                       goto end;
-               }
-       }
-
-end:
-       return all_named_and_printable;
-}
-
-static bool all_named_and_printable(struct bt_config *cfg)
-{
-       return all_named_and_printable_in_array(cfg->cmd_data.run.sources) &&
-               all_named_and_printable_in_array(cfg->cmd_data.run.filters) &&
-               all_named_and_printable_in_array(cfg->cmd_data.run.sinks);
-}
-
-void bt_config_connection_destroy(struct bt_config_connection *connection)
-{
-       if (!connection) {
-               return;
-       }
-
-       if (connection->src_instance_name) {
-               g_string_free(connection->src_instance_name, TRUE);
-       }
-
-       if (connection->dst_instance_name) {
-               g_string_free(connection->dst_instance_name, TRUE);
-       }
-
-       if (connection->src_port_name) {
-               g_string_free(connection->src_port_name, TRUE);
-       }
-
-       if (connection->dst_port_name) {
-               g_string_free(connection->dst_port_name, TRUE);
-       }
-
-       if (connection->arg) {
-               g_string_free(connection->arg, TRUE);
-       }
-
-       g_free(connection);
-}
-
-static struct bt_config_connection *bt_config_connection_create(const char *arg)
-{
-       struct bt_config_connection *cfg_connection;
-
-       cfg_connection = g_new0(struct bt_config_connection, 1);
-       if (!cfg_connection) {
-               goto error;
-       }
-
-       cfg_connection->src_instance_name = g_string_new(NULL);
-       if (!cfg_connection->src_instance_name) {
-               goto error;
-       }
-
-       cfg_connection->dst_instance_name = g_string_new(NULL);
-       if (!cfg_connection->dst_instance_name) {
-               goto error;
-       }
-
-       cfg_connection->src_port_name = g_string_new(NULL);
-       if (!cfg_connection->src_port_name) {
-               goto error;
-       }
-
-       cfg_connection->dst_port_name = g_string_new(NULL);
-       if (!cfg_connection->dst_port_name) {
-               goto error;
-       }
-
-       cfg_connection->arg = g_string_new(arg);
-       if (!cfg_connection->arg) {
-               goto error;
-       }
-
-       goto end;
-
-error:
-       g_free(cfg_connection);
-       cfg_connection = NULL;
-
-end:
-       return cfg_connection;
-}
-
-static struct bt_config_connection *cfg_connection_from_arg(const char *arg)
-{
-       const char *at = arg;
-       size_t end_pos;
-       struct bt_config_connection *cfg_conn = NULL;
-       GString *gs = NULL;
-       enum {
-               SRC_NAME,
-               DST_NAME,
-               SRC_PORT_NAME,
-               DST_PORT_NAME,
-       } state = SRC_NAME;
-
-       if (!bt_common_string_is_printable(arg)) {
-               goto error;
-       }
-
-       cfg_conn = bt_config_connection_create(arg);
-       if (!cfg_conn) {
-               goto error;
-       }
-
-       while (true) {
-               switch (state) {
-               case SRC_NAME:
-                       gs = bt_common_string_until(at, ".:\\", ".:", &end_pos);
-                       if (!gs || gs->len == 0) {
-                               goto error;
-                       }
-
-                       g_string_free(cfg_conn->src_instance_name, TRUE);
-                       cfg_conn->src_instance_name = gs;
-                       gs = NULL;
-
-                       if (at[end_pos] == ':') {
-                               state = DST_NAME;
-                       } else if (at[end_pos] == '.') {
-                               state = SRC_PORT_NAME;
-                       } else {
-                               goto error;
-                       }
-
-                       at += end_pos + 1;
-                       break;
-               case DST_NAME:
-                       gs = bt_common_string_until(at, ".:\\", ".:", &end_pos);
-                       if (!gs || gs->len == 0) {
-                               goto error;
-                       }
-
-                       g_string_free(cfg_conn->dst_instance_name, TRUE);
-                       cfg_conn->dst_instance_name = gs;
-                       gs = NULL;
-
-                       if (at[end_pos] == '.') {
-                               state = DST_PORT_NAME;
-                       } else if (at[end_pos] == '\0') {
-                               goto end;
-                       } else {
-                               goto error;
-                       }
-
-                       at += end_pos + 1;
-                       break;
-               case SRC_PORT_NAME:
-                       gs = bt_common_string_until(at, ".:\\", ".:", &end_pos);
-                       if (!gs || gs->len == 0) {
-                               goto error;
-                       }
-
-                       g_string_free(cfg_conn->src_port_name, TRUE);
-                       cfg_conn->src_port_name = gs;
-                       gs = NULL;
-
-                       if (at[end_pos] == ':') {
-                               state = DST_NAME;
-                       } else {
-                               goto error;
-                       }
-
-                       at += end_pos + 1;
-                       break;
-               case DST_PORT_NAME:
-                       gs = bt_common_string_until(at, ".:\\", ".:", &end_pos);
-                       if (!gs || gs->len == 0) {
-                               goto error;
-                       }
-
-                       g_string_free(cfg_conn->dst_port_name, TRUE);
-                       cfg_conn->dst_port_name = gs;
-                       gs = NULL;
-
-                       if (at[end_pos] == '\0') {
-                               goto end;
-                       } else {
-                               goto error;
-                       }
-                       break;
-               default:
-                       assert(false);
-               }
-       }
-
-error:
-       bt_config_connection_destroy(cfg_conn);
-       cfg_conn = NULL;
-
-end:
-       if (gs) {
-               g_string_free(gs, TRUE);
-       }
-
-       return cfg_conn;
-}
-
-static struct bt_config_component *find_component_in_array(GPtrArray *comps,
-               const char *name)
-{
-       size_t i;
-       struct bt_config_component *found_comp = NULL;
-
-       for (i = 0; i < comps->len; i++) {
-               struct bt_config_component *comp = g_ptr_array_index(comps, i);
-
-               if (strcmp(name, comp->instance_name->str) == 0) {
-                       found_comp = bt_get(comp);
-                       goto end;
-               }
-       }
-
-end:
-       return found_comp;
-}
-
-static struct bt_config_component *find_component(struct bt_config *cfg,
-               const char *name)
-{
-       struct bt_config_component *comp;
-
-       comp = find_component_in_array(cfg->cmd_data.run.sources, name);
-       if (comp) {
-               goto end;
-       }
-
-       comp = find_component_in_array(cfg->cmd_data.run.filters, name);
-       if (comp) {
-               goto end;
-       }
-
-       comp = find_component_in_array(cfg->cmd_data.run.sinks, name);
-       if (comp) {
-               goto end;
-       }
-
-end:
-       return comp;
-}
-
-static int validate_all_endpoints_exist(struct bt_config *cfg, char *error_buf,
-               size_t error_buf_size)
-{
-       size_t i;
-       int ret = 0;
-
-       for (i = 0; i < cfg->cmd_data.run.connections->len; i++) {
-               struct bt_config_connection *connection =
-                       g_ptr_array_index(cfg->cmd_data.run.connections, i);
-               struct bt_config_component *comp;
-
-               comp = find_component(cfg, connection->src_instance_name->str);
-               bt_put(comp);
-               if (!comp) {
-                       snprintf(error_buf, error_buf_size,
-                               "Invalid connection: cannot find upstream component `%s`:\n    %s\n",
-                               connection->src_instance_name->str,
-                               connection->arg->str);
-                       ret = -1;
-                       goto end;
-               }
-
-               comp = find_component(cfg, connection->dst_instance_name->str);
-               bt_put(comp);
-               if (!comp) {
-                       snprintf(error_buf, error_buf_size,
-                               "Invalid connection: cannot find downstream component `%s`:\n    %s\n",
-                               connection->dst_instance_name->str,
-                               connection->arg->str);
-                       ret = -1;
-                       goto end;
-               }
-       }
-
-end:
-       return ret;
-}
-
-static int validate_connection_directions(struct bt_config *cfg,
-               char *error_buf, size_t error_buf_size)
-{
-       size_t i;
-       int ret = 0;
-       struct bt_config_component *src_comp = NULL;
-       struct bt_config_component *dst_comp = NULL;
-
-       for (i = 0; i < cfg->cmd_data.run.connections->len; i++) {
-               struct bt_config_connection *connection =
-                       g_ptr_array_index(cfg->cmd_data.run.connections, i);
-
-               src_comp = find_component(cfg,
-                       connection->src_instance_name->str);
-               assert(src_comp);
-               dst_comp = find_component(cfg,
-                       connection->dst_instance_name->str);
-               assert(dst_comp);
-
-               if (src_comp->type == BT_COMPONENT_CLASS_TYPE_SOURCE) {
-                       if (dst_comp->type != BT_COMPONENT_CLASS_TYPE_FILTER &&
-                                       dst_comp->type != BT_COMPONENT_CLASS_TYPE_SINK) {
-                               snprintf(error_buf, error_buf_size,
-                                       "Invalid connection: source component `%s` not connected to filter or sink component:\n    %s\n",
-                                       connection->src_instance_name->str,
-                                       connection->arg->str);
-                               ret = -1;
-                               goto end;
-                       }
-               } else if (src_comp->type == BT_COMPONENT_CLASS_TYPE_FILTER) {
-                       if (dst_comp->type != BT_COMPONENT_CLASS_TYPE_FILTER &&
-                                       dst_comp->type != BT_COMPONENT_CLASS_TYPE_SINK) {
-                               snprintf(error_buf, error_buf_size,
-                                       "Invalid connection: filter component `%s` not connected to filter or sink component:\n    %s\n",
-                                       connection->src_instance_name->str,
-                                       connection->arg->str);
-                               ret = -1;
-                               goto end;
-                       }
-               } else {
-                       snprintf(error_buf, error_buf_size,
-                               "Invalid connection: cannot connect sink component `%s` to component `%s`:\n    %s\n",
-                               connection->src_instance_name->str,
-                               connection->dst_instance_name->str,
-                               connection->arg->str);
-                       ret = -1;
-                       goto end;
-               }
-
-               BT_PUT(src_comp);
-               BT_PUT(dst_comp);
-       }
-
-end:
-       bt_put(src_comp);
-       bt_put(dst_comp);
-       return ret;
-}
-
-static int validate_no_cycles_rec(struct bt_config *cfg, GPtrArray *path,
-               char *error_buf, size_t error_buf_size)
-{
-       int ret = 0;
-       size_t conn_i;
-       const char *src_comp_name;
-
-       assert(path && path->len > 0);
-       src_comp_name = g_ptr_array_index(path, path->len - 1);
-
-       for (conn_i = 0; conn_i < cfg->cmd_data.run.connections->len; conn_i++) {
-               struct bt_config_connection *conn =
-                       g_ptr_array_index(cfg->cmd_data.run.connections, conn_i);
-
-               if (strcmp(conn->src_instance_name->str, src_comp_name) == 0) {
-                       size_t path_i;
-
-                       for (path_i = 0; path_i < path->len; path_i++) {
-                               const char *comp_name =
-                                       g_ptr_array_index(path, path_i);
-
-                               if (strcmp(comp_name, conn->dst_instance_name->str) == 0) {
-                                       snprintf(error_buf, error_buf_size,
-                                               "Invalid connection: connection forms a cycle:\n    %s\n",
-                                               conn->arg->str);
-                                       ret = -1;
-                                       goto end;
-                               }
-                       }
-
-                       g_ptr_array_add(path, conn->dst_instance_name->str);
-                       ret = validate_no_cycles_rec(cfg, path, error_buf,
-                                       error_buf_size);
-                       if (ret) {
-                               goto end;
-                       }
-
-                       g_ptr_array_remove_index(path, path->len - 1);
-               }
-       }
-
-end:
-       return ret;
-}
-
-static int validate_no_cycles(struct bt_config *cfg, char *error_buf,
-               size_t error_buf_size)
-{
-       size_t i;
-       int ret = 0;
-       GPtrArray *path;
-
-       path = g_ptr_array_new();
-       if (!path) {
-               ret = -1;
-               goto end;
-       }
-
-       g_ptr_array_add(path, NULL);
-
-       for (i = 0; i < cfg->cmd_data.run.connections->len; i++) {
-               struct bt_config_connection *conn =
-                       g_ptr_array_index(cfg->cmd_data.run.connections, i);
-
-               g_ptr_array_index(path, 0) = conn->src_instance_name->str;
-               ret = validate_no_cycles_rec(cfg, path,
-                       error_buf, error_buf_size);
-               if (ret) {
-                       goto end;
-               }
-       }
-
-end:
-       if (path) {
-               g_ptr_array_free(path, TRUE);
-       }
-
-       return ret;
-}
-
-static int validate_all_components_connected_in_array(GPtrArray *comps,
-               struct bt_value *connected_components,
-               char *error_buf, size_t error_buf_size)
-{
-       int ret = 0;
-       size_t i;
-
-       for (i = 0; i < comps->len; i++) {
-               struct bt_config_component *comp = g_ptr_array_index(comps, i);
-
-               if (!bt_value_map_has_key(connected_components,
-                               comp->instance_name->str)) {
-                       snprintf(error_buf, error_buf_size,
-                               "Component `%s` is not connected\n",
-                               comp->instance_name->str);
-                       ret = -1;
-                       goto end;
-               }
-       }
-
-end:
-       return ret;
-}
-
-static int validate_all_components_connected(struct bt_config *cfg,
-               char *error_buf, size_t error_buf_size)
-{
-       size_t i;
-       int ret = 0;
-       struct bt_value *connected_components = bt_value_map_create();
-
-       if (!connected_components) {
-               ret = -1;
-               goto end;
-       }
-
-       for (i = 0; i < cfg->cmd_data.run.connections->len; i++) {
-               struct bt_config_connection *connection =
-                       g_ptr_array_index(cfg->cmd_data.run.connections, i);
-
-               ret = bt_value_map_insert(connected_components,
-                       connection->src_instance_name->str, bt_value_null);
-               if (ret) {
-                       goto end;
-               }
-
-               ret = bt_value_map_insert(connected_components,
-                       connection->dst_instance_name->str, bt_value_null);
-               if (ret) {
-                       goto end;
-               }
-       }
-
-       ret = validate_all_components_connected_in_array(
-               cfg->cmd_data.run.sources, connected_components,
-               error_buf, error_buf_size);
-       if (ret) {
-               goto end;
-       }
-
-       ret = validate_all_components_connected_in_array(
-               cfg->cmd_data.run.filters, connected_components,
-               error_buf, error_buf_size);
-       if (ret) {
-               goto end;
-       }
-
-       ret = validate_all_components_connected_in_array(
-               cfg->cmd_data.run.sinks, connected_components,
-               error_buf, error_buf_size);
-       if (ret) {
-               goto end;
-       }
-
-end:
-       bt_put(connected_components);
-       return ret;
-}
-
-static int validate_no_duplicate_connection(struct bt_config *cfg,
-               char *error_buf, size_t error_buf_size)
-{
-       size_t i;
-       int ret = 0;
-       struct bt_value *flat_connection_names = bt_value_map_create();
-       GString *flat_connection_name = NULL;
-
-       if (!flat_connection_names) {
-               ret = -1;
-               goto end;
-       }
-
-       flat_connection_name = g_string_new(NULL);
-       if (!flat_connection_name) {
-               ret = -1;
-               goto end;
-       }
-
-       for (i = 0; i < cfg->cmd_data.run.connections->len; i++) {
-               struct bt_config_connection *connection =
-                       g_ptr_array_index(cfg->cmd_data.run.connections, i);
-
-               g_string_printf(flat_connection_name, "%s\x01%s\x01%s\x01%s",
-                       connection->src_instance_name->str,
-                       connection->src_port_name->str,
-                       connection->dst_instance_name->str,
-                       connection->dst_port_name->str);
-
-               if (bt_value_map_has_key(flat_connection_names,
-                               flat_connection_name->str)) {
-                       snprintf(error_buf, error_buf_size,
-                               "Duplicate connection:\n    %s\n",
-                               connection->arg->str);
-                       ret = -1;
-                       goto end;
-               }
-
-               ret = bt_value_map_insert(flat_connection_names,
-                       flat_connection_name->str, bt_value_null);
-               if (ret) {
-                       goto end;
-               }
-       }
-
-end:
-       bt_put(flat_connection_names);
-
-       if (flat_connection_name) {
-               g_string_free(flat_connection_name, TRUE);
-       }
-
-       return ret;
-}
-
-static int validate_connections(struct bt_config *cfg, char *error_buf,
-               size_t error_buf_size)
-{
-       int ret;
-
-       ret = validate_all_endpoints_exist(cfg, error_buf, error_buf_size);
-       if (ret) {
-               goto end;
-       }
-
-       ret = validate_connection_directions(cfg, error_buf, error_buf_size);
-       if (ret) {
-               goto end;
-       }
-
-       ret = validate_all_components_connected(cfg, error_buf, error_buf_size);
-       if (ret) {
-               goto end;
-       }
-
-       ret = validate_no_duplicate_connection(cfg, error_buf, error_buf_size);
-       if (ret) {
-               goto end;
-       }
-
-       ret = validate_no_cycles(cfg, error_buf, error_buf_size);
-       if (ret) {
-               goto end;
-       }
-
-end:
-       return ret;
-}
-
-int bt_config_create_connections(struct bt_config *cfg,
-               struct bt_value *connection_args,
-               char *error_buf, size_t error_buf_size)
-{
-       int ret;
-       size_t i;
-
-       if (!all_named_and_printable(cfg)) {
-               snprintf(error_buf, error_buf_size,
-                       "One or more components are unnamed (use --name) or contain a non-printable character\n");
-               goto error;
-       }
-
-       for (i = 0; i < bt_value_array_size(connection_args); i++) {
-               struct bt_value *arg_value =
-                       bt_value_array_get(connection_args, i);
-               const char *arg;
-               struct bt_config_connection *cfg_connection;
-
-               ret = bt_value_string_get(arg_value, &arg);
-               BT_PUT(arg_value);
-               assert(ret == 0);
-               cfg_connection = cfg_connection_from_arg(arg);
-               if (!cfg_connection) {
-                       snprintf(error_buf, error_buf_size, "Cannot parse --connect option's argument:\n    %s\n",
-                               arg);
-                       goto error;
-               }
-
-               g_ptr_array_add(cfg->cmd_data.run.connections,
-                       cfg_connection);
-       }
-
-
-       ret = validate_connections(cfg, error_buf, error_buf_size);
-       if (ret) {
-               goto error;
-       }
-
-       goto end;
-
-error:
-       ret = -1;
-
-end:
-       return ret;
-}
diff --git a/cli/babeltrace-cfg-connect.h b/cli/babeltrace-cfg-connect.h
deleted file mode 100644 (file)
index 98f9d04..0000000
+++ /dev/null
@@ -1,46 +0,0 @@
-#ifndef BABELTRACE_CONNECT_H
-#define BABELTRACE_CONNECT_H
-
-/*
- * Copyright 2017 Philippe Proulx <pproulx@efficios.com>
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-#include <stdlib.h>
-#include <stdint.h>
-#include <babeltrace/values.h>
-#include <glib.h>
-#include "babeltrace-cfg.h"
-
-struct bt_config_connection {
-       GString *src_instance_name;
-       GString *dst_instance_name;
-       GString *src_port_name;
-       GString *dst_port_name;
-       GString *arg;
-};
-
-int bt_config_create_connections(struct bt_config *cfg,
-               struct bt_value *connection_args,
-               char *error_buf, size_t error_buf_size);
-
-void bt_config_connection_destroy(struct bt_config_connection *connection);
-
-#endif /* BABELTRACE_CONNECT_H */
index 304a06d9d3e7a64822d0da6115f170fd3de896c0..021cca490b92cc22baa1b33465c28033885eceaa 100644 (file)
  * SOFTWARE.
  */
 
-#include <errno.h>
-#include <stdlib.h>
-#include <string.h>
-#include <assert.h>
-#include <stdio.h>
-#include <stdbool.h>
-#include <inttypes.h>
-#include <babeltrace/babeltrace.h>
 #include <babeltrace/common-internal.h>
 #include <babeltrace/values.h>
-#include <popt.h>
 #include <glib.h>
-#include <sys/types.h>
-#include <pwd.h>
 #include "babeltrace-cfg.h"
-#include "babeltrace-cfg-connect.h"
 
-/*
- * Error printf() macro which prepends "Error: " the first time it's
- * called. This gives a nicer feel than having a bunch of error prefixes
- * (since the following lines usually describe the error and possible
- * solutions), or the error prefix just at the end.
- */
-#define printf_err(fmt, args...)                                       \
-       do {                                                            \
-               if (is_first_error) {                                   \
-                       fprintf(stderr, "Command line error: ");        \
-                       is_first_error = false;                         \
-               }                                                       \
-               fprintf(stderr, fmt, ##args);                           \
-       } while (0)
-
-static bool is_first_error = true;
-
-/* INI-style parsing FSM states */
-enum ini_parsing_fsm_state {
-       /* Expect a map key (identifier) */
-       INI_EXPECT_MAP_KEY,
-
-       /* Expect an equal character ('=') */
-       INI_EXPECT_EQUAL,
-
-       /* Expect a value */
-       INI_EXPECT_VALUE,
-
-       /* Expect a negative number value */
-       INI_EXPECT_VALUE_NUMBER_NEG,
-
-       /* Expect a comma character (',') */
-       INI_EXPECT_COMMA,
-};
-
-/* INI-style parsing state variables */
-struct ini_parsing_state {
-       /* Lexical scanner (owned by this) */
-       GScanner *scanner;
-
-       /* Output map value object being filled (owned by this) */
-       struct bt_value *params;
-
-       /* Next expected FSM state */
-       enum ini_parsing_fsm_state expecting;
-
-       /* Last decoded map key (owned by this) */
-       char *last_map_key;
-
-       /* Complete INI-style string to parse (not owned by this) */
-       const char *arg;
-
-       /* Error buffer (not owned by this) */
-       GString *ini_error;
-};
-
-/* Offset option with "is set" boolean */
-struct offset_opt {
-       int64_t value;
-       bool is_set;
-};
-
-/* Legacy "ctf"/"lttng-live" format options */
-struct ctf_legacy_opts {
-       struct offset_opt offset_s;
-       struct offset_opt offset_ns;
-       bool stream_intersection;
-};
-
-/* Legacy "text" format options */
-struct text_legacy_opts {
-       /*
-        * output, dbg_info_dir, dbg_info_target_prefix, names,
-        * and fields are owned by this.
-        */
-       GString *output;
-       GString *dbg_info_dir;
-       GString *dbg_info_target_prefix;
-       struct bt_value *names;
-       struct bt_value *fields;
-
-       /* Flags */
-       bool no_delta;
-       bool clock_cycles;
-       bool clock_seconds;
-       bool clock_date;
-       bool clock_gmt;
-       bool dbg_info_full_path;
-       bool verbose;
-};
-
-/* Legacy input format format */
-enum legacy_input_format {
-       LEGACY_INPUT_FORMAT_NONE = 0,
-       LEGACY_INPUT_FORMAT_CTF,
-       LEGACY_INPUT_FORMAT_LTTNG_LIVE,
-};
-
-/* Legacy output format format */
-enum legacy_output_format {
-       LEGACY_OUTPUT_FORMAT_NONE = 0,
-       LEGACY_OUTPUT_FORMAT_TEXT,
-       LEGACY_OUTPUT_FORMAT_DUMMY,
-};
-
-/*
- * Prints the "out of memory" error.
- */
-static
-void print_err_oom(void)
-{
-       printf_err("Out of memory\n");
-}
-
-/*
- * Appends an "expecting token" error to the INI-style parsing state's
- * error buffer.
- */
-static
-void ini_append_error_expecting(struct ini_parsing_state *state,
-               GScanner *scanner, const char *expecting)
-{
-       size_t i;
-       size_t pos;
-
-       g_string_append_printf(state->ini_error, "Expecting %s:\n", expecting);
-
-       /* Only print error if there's one line */
-       if (strchr(state->arg, '\n') != NULL || strlen(state->arg) == 0) {
-               return;
-       }
-
-       g_string_append_printf(state->ini_error, "\n    %s\n", state->arg);
-       pos = g_scanner_cur_position(scanner) + 4;
-
-       if (!g_scanner_eof(scanner)) {
-               pos--;
-       }
-
-       for (i = 0; i < pos; ++i) {
-               g_string_append_printf(state->ini_error, " ");
-       }
-
-       g_string_append_printf(state->ini_error, "^\n\n");
-}
-
-static
-int ini_handle_state(struct ini_parsing_state *state)
-{
-       int ret = 0;
-       GTokenType token_type;
-       struct bt_value *value = NULL;
-
-       token_type = g_scanner_get_next_token(state->scanner);
-       if (token_type == G_TOKEN_EOF) {
-               if (state->expecting != INI_EXPECT_COMMA) {
-                       switch (state->expecting) {
-                       case INI_EXPECT_EQUAL:
-                               ini_append_error_expecting(state,
-                                       state->scanner, "'='");
-                               break;
-                       case INI_EXPECT_VALUE:
-                       case INI_EXPECT_VALUE_NUMBER_NEG:
-                               ini_append_error_expecting(state,
-                                       state->scanner, "value");
-                               break;
-                       case INI_EXPECT_MAP_KEY:
-                               ini_append_error_expecting(state,
-                                       state->scanner, "unquoted map key");
-                               break;
-                       default:
-                               break;
-                       }
-                       goto error;
-               }
-
-               /* We're done! */
-               ret = 1;
-               goto success;
-       }
-
-       switch (state->expecting) {
-       case INI_EXPECT_MAP_KEY:
-               if (token_type != G_TOKEN_IDENTIFIER) {
-                       ini_append_error_expecting(state, state->scanner,
-                               "unquoted map key");
-                       goto error;
-               }
-
-               free(state->last_map_key);
-               state->last_map_key =
-                       strdup(state->scanner->value.v_identifier);
-               if (!state->last_map_key) {
-                       g_string_append(state->ini_error,
-                               "Out of memory\n");
-                       goto error;
-               }
-
-               if (bt_value_map_has_key(state->params, state->last_map_key)) {
-                       g_string_append_printf(state->ini_error,
-                               "Duplicate parameter key: `%s`\n",
-                               state->last_map_key);
-                       goto error;
-               }
-
-               state->expecting = INI_EXPECT_EQUAL;
-               goto success;
-       case INI_EXPECT_EQUAL:
-               if (token_type != G_TOKEN_CHAR) {
-                       ini_append_error_expecting(state,
-                               state->scanner, "'='");
-                       goto error;
-               }
-
-               if (state->scanner->value.v_char != '=') {
-                       ini_append_error_expecting(state,
-                               state->scanner, "'='");
-                       goto error;
-               }
-
-               state->expecting = INI_EXPECT_VALUE;
-               goto success;
-       case INI_EXPECT_VALUE:
-       {
-               switch (token_type) {
-               case G_TOKEN_CHAR:
-                       if (state->scanner->value.v_char == '-') {
-                               /* Negative number */
-                               state->expecting =
-                                       INI_EXPECT_VALUE_NUMBER_NEG;
-                               goto success;
-                       } else {
-                               ini_append_error_expecting(state,
-                                       state->scanner, "value");
-                               goto error;
-                       }
-                       break;
-               case G_TOKEN_INT:
-               {
-                       /* Positive integer */
-                       uint64_t int_val = state->scanner->value.v_int64;
-
-                       if (int_val > (1ULL << 63) - 1) {
-                               g_string_append_printf(state->ini_error,
-                                       "Integer value %" PRIu64 " is outside the range of a 64-bit signed integer\n",
-                                       int_val);
-                               goto error;
-                       }
-
-                       value = bt_value_integer_create_init(
-                               (int64_t) int_val);
-                       break;
-               }
-               case G_TOKEN_FLOAT:
-                       /* Positive floating point number */
-                       value = bt_value_float_create_init(
-                               state->scanner->value.v_float);
-                       break;
-               case G_TOKEN_STRING:
-                       /* Quoted string */
-                       value = bt_value_string_create_init(
-                               state->scanner->value.v_string);
-                       break;
-               case G_TOKEN_IDENTIFIER:
-               {
-                       /*
-                        * Using symbols would be appropriate here,
-                        * but said symbols are allowed as map key,
-                        * so it's easier to consider everything an
-                        * identifier.
-                        *
-                        * If one of the known symbols is not
-                        * recognized here, then fall back to creating
-                        * a string value.
-                        */
-                       const char *id = state->scanner->value.v_identifier;
-
-                       if (!strcmp(id, "null") || !strcmp(id, "NULL") ||
-                                       !strcmp(id, "nul")) {
-                               value = bt_value_null;
-                       } else if (!strcmp(id, "true") || !strcmp(id, "TRUE") ||
-                                       !strcmp(id, "yes") ||
-                                       !strcmp(id, "YES")) {
-                               value = bt_value_bool_create_init(true);
-                       } else if (!strcmp(id, "false") ||
-                                       !strcmp(id, "FALSE") ||
-                                       !strcmp(id, "no") ||
-                                       !strcmp(id, "NO")) {
-                               value = bt_value_bool_create_init(false);
-                       } else {
-                               value = bt_value_string_create_init(id);
-                       }
-                       break;
-               }
-               default:
-                       /* Unset value variable will trigger the error */
-                       break;
-               }
-
-               if (!value) {
-                       ini_append_error_expecting(state,
-                               state->scanner, "value");
-                       goto error;
-               }
-
-               state->expecting = INI_EXPECT_COMMA;
-               goto success;
-       }
-       case INI_EXPECT_VALUE_NUMBER_NEG:
-       {
-               switch (token_type) {
-               case G_TOKEN_INT:
-               {
-                       /* Negative integer */
-                       uint64_t int_val = state->scanner->value.v_int64;
-
-                       if (int_val > (1ULL << 63) - 1) {
-                               g_string_append_printf(state->ini_error,
-                                       "Integer value -%" PRIu64 " is outside the range of a 64-bit signed integer\n",
-                                       int_val);
-                               goto error;
-                       }
-
-                       value = bt_value_integer_create_init(
-                               -((int64_t) int_val));
-                       break;
-               }
-               case G_TOKEN_FLOAT:
-                       /* Negative floating point number */
-                       value = bt_value_float_create_init(
-                               -state->scanner->value.v_float);
-                       break;
-               default:
-                       /* Unset value variable will trigger the error */
-                       break;
-               }
-
-               if (!value) {
-                       ini_append_error_expecting(state,
-                               state->scanner, "value");
-                       goto error;
-               }
-
-               state->expecting = INI_EXPECT_COMMA;
-               goto success;
-       }
-       case INI_EXPECT_COMMA:
-               if (token_type != G_TOKEN_CHAR) {
-                       ini_append_error_expecting(state,
-                               state->scanner, "','");
-                       goto error;
-               }
-
-               if (state->scanner->value.v_char != ',') {
-                       ini_append_error_expecting(state,
-                               state->scanner, "','");
-                       goto error;
-               }
-
-               state->expecting = INI_EXPECT_MAP_KEY;
-               goto success;
-       default:
-               assert(false);
-       }
-
-error:
-       ret = -1;
-       goto end;
-
-success:
-       if (value) {
-               if (bt_value_map_insert(state->params,
-                               state->last_map_key, value)) {
-                       /* Only override return value on error */
-                       ret = -1;
-               }
-       }
-
-end:
-       BT_PUT(value);
-       return ret;
-}
-
-/*
- * Converts an INI-style argument to an equivalent map value object.
- *
- * Return value is owned by the caller.
- */
-static
-struct bt_value *bt_value_from_ini(const char *arg, GString *ini_error)
-{
-       /* Lexical scanner configuration */
-       GScannerConfig scanner_config = {
-               /* Skip whitespaces */
-               .cset_skip_characters = " \t\n",
-
-               /* Identifier syntax is: [a-zA-Z_][a-zA-Z0-9_.:-]* */
-               .cset_identifier_first =
-                       G_CSET_a_2_z
-                       "_"
-                       G_CSET_A_2_Z,
-               .cset_identifier_nth =
-                       G_CSET_a_2_z
-                       "_0123456789-.:"
-                       G_CSET_A_2_Z,
-
-               /* "hello" and "Hello" two different keys */
-               .case_sensitive = TRUE,
-
-               /* No comments */
-               .cpair_comment_single = NULL,
-               .skip_comment_multi = TRUE,
-               .skip_comment_single = TRUE,
-               .scan_comment_multi = FALSE,
-
-               /*
-                * Do scan identifiers, including 1-char identifiers,
-                * but NULL is a normal identifier.
-                */
-               .scan_identifier = TRUE,
-               .scan_identifier_1char = TRUE,
-               .scan_identifier_NULL = FALSE,
-
-               /*
-                * No specific symbols: null and boolean "symbols" are
-                * scanned as plain identifiers.
-                */
-               .scan_symbols = FALSE,
-               .symbol_2_token = FALSE,
-               .scope_0_fallback = FALSE,
-
-               /*
-                * Scan "0b"-, "0"-, and "0x"-prefixed integers, but not
-                * integers prefixed with "$".
-                */
-               .scan_binary = TRUE,
-               .scan_octal = TRUE,
-               .scan_float = TRUE,
-               .scan_hex = TRUE,
-               .scan_hex_dollar = FALSE,
-
-               /* Convert scanned numbers to integer tokens */
-               .numbers_2_int = TRUE,
-
-               /* Support both integers and floating-point numbers */
-               .int_2_float = FALSE,
-
-               /* Scan integers as 64-bit signed integers */
-               .store_int64 = TRUE,
-
-               /* Only scan double-quoted strings */
-               .scan_string_sq = FALSE,
-               .scan_string_dq = TRUE,
-
-               /* Do not converter identifiers to string tokens */
-               .identifier_2_string = FALSE,
-
-               /* Scan characters as G_TOKEN_CHAR token */
-               .char_2_token = FALSE,
-       };
-       struct ini_parsing_state state = {
-               .scanner = NULL,
-               .params = NULL,
-               .expecting = INI_EXPECT_MAP_KEY,
-               .arg = arg,
-               .ini_error = ini_error,
-       };
-
-       state.params = bt_value_map_create();
-       if (!state.params) {
-               goto error;
-       }
-
-       state.scanner = g_scanner_new(&scanner_config);
-       if (!state.scanner) {
-               goto error;
-       }
-
-       /* Let the scan begin */
-       g_scanner_input_text(state.scanner, arg, strlen(arg));
-
-       while (true) {
-               int ret = ini_handle_state(&state);
-
-               if (ret < 0) {
-                       /* Error */
-                       goto error;
-               } else if (ret > 0) {
-                       /* Done */
-                       break;
-               }
-       }
-
-       goto end;
-
-error:
-       BT_PUT(state.params);
-
-end:
-       if (state.scanner) {
-               g_scanner_destroy(state.scanner);
-       }
-
-       free(state.last_map_key);
-       return state.params;
-}
-
-/*
- * Returns the parameters map value object from a command-line
- * parameter option's argument.
- *
- * Return value is owned by the caller.
- */
-static
-struct bt_value *bt_value_from_arg(const char *arg)
-{
-       struct bt_value *params = NULL;
-       GString *ini_error = NULL;
-
-       ini_error = g_string_new(NULL);
-       if (!ini_error) {
-               print_err_oom();
-               goto end;
-       }
-
-       /* Try INI-style parsing */
-       params = bt_value_from_ini(arg, ini_error);
-       if (!params) {
-               printf_err("%s", ini_error->str);
-               goto end;
-       }
-
-end:
-       if (ini_error) {
-               g_string_free(ini_error, TRUE);
-       }
-       return params;
-}
-
-/*
- * Returns the plugin and component class names, and the instance name,
- * from a command-line source/filter/sink option's argument. arg must
- * have the following format:
- *
- *     [NAME:]PLUGIN.CLS
- *
- * where NAME is the optional component name, PLUGIN is the plugin name,
- * and CLS is the component class name.
- *
- * On success, both *plugin and *component are not NULL. *plugin
- * and *component are owned by the caller. On success, *name can be NULL
- * if no component name was found.
- */
-static
-void plugin_comp_cls_names(const char *arg, char **name, char **plugin,
-               char **comp_cls)
-{
-       const char *at = arg;
-       GString *gs_name = NULL;
-       GString *gs_plugin = NULL;
-       GString *gs_comp_cls = NULL;
-       size_t end_pos;
-
-       assert(arg);
-       assert(plugin);
-       assert(comp_cls);
-
-       if (!bt_common_string_is_printable(arg)) {
-               printf_err("Argument contains a non-printable character\n");
-               goto error;
-       }
-
-       /* Parse the component name */
-       gs_name = bt_common_string_until(at, ".:\\", ":", &end_pos);
-       if (!gs_name) {
-               goto error;
-       }
-
-       if (arg[end_pos] == ':') {
-               at += end_pos + 1;
-       } else {
-               /* No name */
-               g_string_assign(gs_name, "");
-       }
-
-       /* Parse the plugin name */
-       gs_plugin = bt_common_string_until(at, ".:\\", ".", &end_pos);
-       if (!gs_plugin || gs_plugin->len == 0 || at[end_pos] == '\0') {
-               goto error;
-       }
-
-       at += end_pos + 1;
-
-       /* Parse the component class name */
-       gs_comp_cls = bt_common_string_until(at, ".:\\", ".", &end_pos);
-       if (!gs_comp_cls || gs_comp_cls->len == 0) {
-               goto error;
-       }
-
-       if (at[end_pos] != '\0') {
-               /* Found a non-escaped `.` */
-               goto error;
-       }
-
-       if (name) {
-               if (gs_name->len == 0) {
-                       *name = NULL;
-                       g_string_free(gs_name, TRUE);
-               } else {
-                       *name = gs_name->str;
-                       g_string_free(gs_name, FALSE);
-               }
-       } else {
-               g_string_free(gs_name, TRUE);
-       }
-
-       *plugin = gs_plugin->str;
-       *comp_cls = gs_comp_cls->str;
-       g_string_free(gs_plugin, FALSE);
-       g_string_free(gs_comp_cls, FALSE);
-       gs_name = NULL;
-       gs_plugin = NULL;
-       gs_comp_cls = NULL;
-       goto end;
-
-error:
-       if (gs_name) {
-               g_string_free(gs_name, TRUE);
-       }
-
-       if (gs_plugin) {
-               g_string_free(gs_plugin, TRUE);
-       }
-
-       if (gs_comp_cls) {
-               g_string_free(gs_comp_cls, TRUE);
-       }
-
-       if (name) {
-               *name = NULL;
-       }
-
-       *plugin = NULL;
-       *comp_cls = NULL;
-
-end:
-       return;
-}
-
-/*
- * Prints the Babeltrace version.
- */
-static
-void print_version(void)
-{
-       puts("Babeltrace " VERSION);
-}
-
-/*
- * Destroys a component configuration.
- */
-static
-void bt_config_component_destroy(struct bt_object *obj)
-{
-       struct bt_config_component *bt_config_component =
-               container_of(obj, struct bt_config_component, base);
-
-       if (!obj) {
-               goto end;
-       }
-
-       if (bt_config_component->plugin_name) {
-               g_string_free(bt_config_component->plugin_name, TRUE);
-       }
-
-       if (bt_config_component->comp_cls_name) {
-               g_string_free(bt_config_component->comp_cls_name, TRUE);
-       }
-
-       if (bt_config_component->instance_name) {
-               g_string_free(bt_config_component->instance_name, TRUE);
-       }
-
-       BT_PUT(bt_config_component->params);
-       g_free(bt_config_component);
-
-end:
-       return;
-}
-
-/*
- * Creates a component configuration using the given plugin name and
- * component name. `plugin_name` and `comp_cls_name` are copied (belong
- * to the return value).
- *
- * Return value is owned by the caller.
- */
-static
-struct bt_config_component *bt_config_component_create(
-               enum bt_component_class_type type,
-               const char *plugin_name, const char *comp_cls_name)
-{
-       struct bt_config_component *cfg_component = NULL;
-
-       cfg_component = g_new0(struct bt_config_component, 1);
-       if (!cfg_component) {
-               print_err_oom();
-               goto error;
-       }
-
-       bt_object_init(cfg_component, bt_config_component_destroy);
-       cfg_component->type = type;
-       cfg_component->plugin_name = g_string_new(plugin_name);
-       if (!cfg_component->plugin_name) {
-               print_err_oom();
-               goto error;
-       }
-
-       cfg_component->comp_cls_name = g_string_new(comp_cls_name);
-       if (!cfg_component->comp_cls_name) {
-               print_err_oom();
-               goto error;
-       }
-
-       cfg_component->instance_name = g_string_new(NULL);
-       if (!cfg_component->instance_name) {
-               print_err_oom();
-               goto error;
-       }
-
-       /* Start with empty parameters */
-       cfg_component->params = bt_value_map_create();
-       if (!cfg_component->params) {
-               print_err_oom();
-               goto error;
-       }
-
-       goto end;
-
-error:
-       BT_PUT(cfg_component);
-
-end:
-       return cfg_component;
-}
-
-/*
- * Creates a component configuration from a command-line source/sink
- * option's argument.
- */
-struct bt_config_component *bt_config_component_from_arg(
-               enum bt_component_class_type type, const char *arg)
-{
-       struct bt_config_component *cfg_comp = NULL;
-       char *name = NULL;
-       char *plugin_name = NULL;
-       char *comp_cls_name = NULL;
-
-       plugin_comp_cls_names(arg, &name, &plugin_name, &comp_cls_name);
-       if (!plugin_name || !comp_cls_name) {
-               printf_err("Cannot get plugin or component class name\n");
-               goto error;
-       }
-
-       cfg_comp = bt_config_component_create(type, plugin_name, comp_cls_name);
-       if (!cfg_comp) {
-               goto error;
-       }
-
-       if (name) {
-               g_string_assign(cfg_comp->instance_name, name);
-       }
-
-       goto end;
-
-error:
-       BT_PUT(cfg_comp);
-
-end:
-       g_free(name);
-       g_free(plugin_name);
-       g_free(comp_cls_name);
-       return cfg_comp;
-}
-
-/*
- * Destroys a configuration.
- */
 static
-void bt_config_destroy(struct bt_object *obj)
-{
-       struct bt_config *cfg =
-               container_of(obj, struct bt_config, base);
-
-       if (!obj) {
-               goto end;
-       }
-
-       BT_PUT(cfg->plugin_paths);
-
-       switch (cfg->command) {
-       case BT_CONFIG_COMMAND_RUN:
-               if (cfg->cmd_data.run.sources) {
-                       g_ptr_array_free(cfg->cmd_data.run.sources, TRUE);
-               }
-
-               if (cfg->cmd_data.run.filters) {
-                       g_ptr_array_free(cfg->cmd_data.run.filters, TRUE);
-               }
-
-               if (cfg->cmd_data.run.sinks) {
-                       g_ptr_array_free(cfg->cmd_data.run.sinks, TRUE);
-               }
-
-               if (cfg->cmd_data.run.connections) {
-                       g_ptr_array_free(cfg->cmd_data.run.connections,
-                               TRUE);
-               }
-               break;
-       case BT_CONFIG_COMMAND_LIST_PLUGINS:
-               break;
-       case BT_CONFIG_COMMAND_HELP:
-               BT_PUT(cfg->cmd_data.help.cfg_component);
-               break;
-       case BT_CONFIG_COMMAND_QUERY:
-               BT_PUT(cfg->cmd_data.query.cfg_component);
-
-               if (cfg->cmd_data.query.object) {
-                       g_string_free(cfg->cmd_data.query.object, TRUE);
-               }
-               break;
-       case BT_CONFIG_COMMAND_PRINT_CTF_METADATA:
-               if (cfg->cmd_data.print_ctf_metadata.path) {
-                       g_string_free(cfg->cmd_data.print_ctf_metadata.path,
-                               TRUE);
-               }
-               break;
-       case BT_CONFIG_COMMAND_PRINT_LTTNG_LIVE_SESSIONS:
-               if (cfg->cmd_data.print_lttng_live_sessions.url) {
-                       g_string_free(
-                               cfg->cmd_data.print_lttng_live_sessions.url,
-                               TRUE);
-               }
-               break;
-       default:
-               assert(false);
-       }
-
-       g_free(cfg);
-
-end:
-       return;
-}
-
-static void destroy_gstring(void *data)
+void destroy_gstring(void *data)
 {
        g_string_free(data, TRUE);
 }
 
-static void destroy_glist_of_gstring(GList *list)
-{
-       if (!list) {
-               return;
-       }
-
-       GList *at;
-
-       for (at = list; at != NULL; at = g_list_next(at)) {
-               g_string_free(at->data, TRUE);
-       }
-
-       g_list_free(list);
-}
-
 /*
  * Extracts the various paths from the string arg, delimited by ':',
  * and appends them to the array value object plugin_paths.
@@ -947,3792 +67,31 @@ end:
        return status;
 }
 
-/*
- * Creates a simple lexical scanner for parsing comma-delimited names
- * and fields.
- *
- * Return value is owned by the caller.
- */
-static
-GScanner *create_csv_identifiers_scanner(void)
+void bt_config_connection_destroy(struct bt_config_connection *connection)
 {
-       GScanner *scanner;
-       GScannerConfig scanner_config = {
-               .cset_skip_characters = " \t\n",
-               .cset_identifier_first = G_CSET_a_2_z G_CSET_A_2_Z "_",
-               .cset_identifier_nth = G_CSET_a_2_z G_CSET_A_2_Z ":_-",
-               .case_sensitive = TRUE,
-               .cpair_comment_single = NULL,
-               .skip_comment_multi = TRUE,
-               .skip_comment_single = TRUE,
-               .scan_comment_multi = FALSE,
-               .scan_identifier = TRUE,
-               .scan_identifier_1char = TRUE,
-               .scan_identifier_NULL = FALSE,
-               .scan_symbols = FALSE,
-               .symbol_2_token = FALSE,
-               .scope_0_fallback = FALSE,
-               .scan_binary = FALSE,
-               .scan_octal = FALSE,
-               .scan_float = FALSE,
-               .scan_hex = FALSE,
-               .scan_hex_dollar = FALSE,
-               .numbers_2_int = FALSE,
-               .int_2_float = FALSE,
-               .store_int64 = FALSE,
-               .scan_string_sq = FALSE,
-               .scan_string_dq = FALSE,
-               .identifier_2_string = FALSE,
-               .char_2_token = TRUE,
-       };
+       if (!connection) {
+               return;
+       }
 
-       scanner = g_scanner_new(&scanner_config);
-       if (!scanner) {
-               print_err_oom();
+       if (connection->upstream_comp_name) {
+               g_string_free(connection->upstream_comp_name, TRUE);
        }
 
-       return scanner;
-}
-
-/*
- * Converts a comma-delimited list of known names (--names option) to
- * an array value object containing those names as string value objects.
- *
- * Return value is owned by the caller.
- */
-static
-struct bt_value *names_from_arg(const char *arg)
-{
-       GScanner *scanner = NULL;
-       struct bt_value *names = NULL;
-       bool found_all = false, found_none = false, found_item = false;
-
-       names = bt_value_array_create();
-       if (!names) {
-               print_err_oom();
-               goto error;
-       }
-
-       scanner = create_csv_identifiers_scanner();
-       if (!scanner) {
-               goto error;
-       }
-
-       g_scanner_input_text(scanner, arg, strlen(arg));
-
-       while (true) {
-               GTokenType token_type = g_scanner_get_next_token(scanner);
-
-               switch (token_type) {
-               case G_TOKEN_IDENTIFIER:
-               {
-                       const char *identifier = scanner->value.v_identifier;
-
-                       if (!strcmp(identifier, "payload") ||
-                                       !strcmp(identifier, "args") ||
-                                       !strcmp(identifier, "arg")) {
-                               found_item = true;
-                               if (bt_value_array_append_string(names,
-                                               "payload")) {
-                                       goto error;
-                               }
-                       } else if (!strcmp(identifier, "context") ||
-                                       !strcmp(identifier, "ctx")) {
-                               found_item = true;
-                               if (bt_value_array_append_string(names,
-                                               "context")) {
-                                       goto error;
-                               }
-                       } else if (!strcmp(identifier, "scope") ||
-                                       !strcmp(identifier, "header")) {
-                               found_item = true;
-                               if (bt_value_array_append_string(names,
-                                               identifier)) {
-                                       goto error;
-                               }
-                       } else if (!strcmp(identifier, "all")) {
-                               found_all = true;
-                               if (bt_value_array_append_string(names,
-                                               identifier)) {
-                                       goto error;
-                               }
-                       } else if (!strcmp(identifier, "none")) {
-                               found_none = true;
-                               if (bt_value_array_append_string(names,
-                                               identifier)) {
-                                       goto error;
-                               }
-                       } else {
-                               printf_err("Unknown name: `%s`\n",
-                                       identifier);
-                               goto error;
-                       }
-                       break;
-               }
-               case G_TOKEN_COMMA:
-                       continue;
-               case G_TOKEN_EOF:
-                       goto end;
-               default:
-                       goto error;
-               }
-       }
-
-end:
-       if (found_none && found_all) {
-               printf_err("Only either `all` or `none` can be specified in the list given to the --names option, but not both.\n");
-               goto error;
-       }
-       /*
-        * Legacy behavior is to clear the defaults (show none) when at
-        * least one item is specified.
-        */
-       if (found_item && !found_none && !found_all) {
-               if (bt_value_array_append_string(names, "none")) {
-                       goto error;
-               }
-       }
-       if (scanner) {
-               g_scanner_destroy(scanner);
-       }
-       return names;
-
-error:
-       BT_PUT(names);
-       if (scanner) {
-               g_scanner_destroy(scanner);
-       }
-       return names;
-}
-
-/*
- * Converts a comma-delimited list of known fields (--fields option) to
- * an array value object containing those fields as string
- * value objects.
- *
- * Return value is owned by the caller.
- */
-static
-struct bt_value *fields_from_arg(const char *arg)
-{
-       GScanner *scanner = NULL;
-       struct bt_value *fields;
-
-       fields = bt_value_array_create();
-       if (!fields) {
-               print_err_oom();
-               goto error;
-       }
-
-       scanner = create_csv_identifiers_scanner();
-       if (!scanner) {
-               goto error;
-       }
-
-       g_scanner_input_text(scanner, arg, strlen(arg));
-
-       while (true) {
-               GTokenType token_type = g_scanner_get_next_token(scanner);
-
-               switch (token_type) {
-               case G_TOKEN_IDENTIFIER:
-               {
-                       const char *identifier = scanner->value.v_identifier;
-
-                       if (!strcmp(identifier, "trace") ||
-                                       !strcmp(identifier, "trace:hostname") ||
-                                       !strcmp(identifier, "trace:domain") ||
-                                       !strcmp(identifier, "trace:procname") ||
-                                       !strcmp(identifier, "trace:vpid") ||
-                                       !strcmp(identifier, "loglevel") ||
-                                       !strcmp(identifier, "emf") ||
-                                       !strcmp(identifier, "callsite") ||
-                                       !strcmp(identifier, "all")) {
-                               if (bt_value_array_append_string(fields,
-                                               identifier)) {
-                                       goto error;
-                               }
-                       } else {
-                               printf_err("Unknown field: `%s`\n",
-                                       identifier);
-                               goto error;
-                       }
-                       break;
-               }
-               case G_TOKEN_COMMA:
-                       continue;
-               case G_TOKEN_EOF:
-                       goto end;
-               default:
-                       goto error;
-               }
-       }
-
-       goto end;
-
-error:
-       BT_PUT(fields);
-
-end:
-       if (scanner) {
-               g_scanner_destroy(scanner);
-       }
-       return fields;
-}
-
-static
-void append_param_arg(GString *params_arg, const char *key, const char *value)
-{
-       assert(params_arg);
-       assert(key);
-       assert(value);
-
-       if (params_arg->len != 0) {
-               g_string_append_c(params_arg, ',');
-       }
-
-       g_string_append(params_arg, key);
-       g_string_append_c(params_arg, '=');
-       g_string_append(params_arg, value);
-}
-
-/*
- * Inserts the equivalent "prefix-NAME=yes" strings into params_arg
- * where the names are in names_array.
- */
-static
-int insert_flat_params_from_array(GString *params_arg,
-               struct bt_value *names_array, const char *prefix)
-{
-       int ret = 0;
-       int i;
-       GString *tmpstr = NULL, *default_value = NULL;
-       bool default_set = false, non_default_set = false;
-
-       /*
-        * names_array may be NULL if no CLI options were specified to
-        * trigger its creation.
-        */
-       if (!names_array) {
-               goto end;
-       }
-
-       tmpstr = g_string_new(NULL);
-       if (!tmpstr) {
-               print_err_oom();
-               ret = -1;
-               goto end;
-       }
-
-       default_value = g_string_new(NULL);
-       if (!default_value) {
-               print_err_oom();
-               ret = -1;
-               goto end;
-       }
-
-       for (i = 0; i < bt_value_array_size(names_array); i++) {
-               struct bt_value *str_obj = bt_value_array_get(names_array, i);
-               const char *suffix;
-               bool is_default = false;
-
-               if (!str_obj) {
-                       printf_err("Unexpected error\n");
-                       ret = -1;
-                       goto end;
-               }
-
-               ret = bt_value_string_get(str_obj, &suffix);
-               BT_PUT(str_obj);
-               if (ret) {
-                       printf_err("Unexpected error\n");
-                       goto end;
-               }
-
-               g_string_assign(tmpstr, prefix);
-               g_string_append(tmpstr, "-");
-
-               /* Special-case for "all" and "none". */
-               if (!strcmp(suffix, "all")) {
-                       is_default = true;
-                       g_string_assign(default_value, "show");
-               } else if (!strcmp(suffix, "none")) {
-                       is_default = true;
-                       g_string_assign(default_value, "hide");
-               }
-               if (is_default) {
-                       default_set = true;
-                       g_string_append(tmpstr, "default");
-                       append_param_arg(params_arg, tmpstr->str,
-                               default_value->str);
-               } else {
-                       non_default_set = true;
-                       g_string_append(tmpstr, suffix);
-                       append_param_arg(params_arg, tmpstr->str, "yes");
-               }
-       }
-
-       /* Implicit field-default=hide if any non-default option is set. */
-       if (non_default_set && !default_set) {
-               g_string_assign(tmpstr, prefix);
-               g_string_append(tmpstr, "-default");
-               g_string_assign(default_value, "hide");
-               append_param_arg(params_arg, tmpstr->str, default_value->str);
-       }
-
-end:
-       if (default_value) {
-               g_string_free(default_value, TRUE);
-       }
-
-       if (tmpstr) {
-               g_string_free(tmpstr, TRUE);
-       }
-
-       return ret;
-}
-
-/* popt options */
-enum {
-       OPT_NONE = 0,
-       OPT_BASE_PARAMS,
-       OPT_BEGIN,
-       OPT_CLOCK_CYCLES,
-       OPT_CLOCK_DATE,
-       OPT_CLOCK_FORCE_CORRELATE,
-       OPT_CLOCK_GMT,
-       OPT_CLOCK_OFFSET,
-       OPT_CLOCK_OFFSET_NS,
-       OPT_CLOCK_SECONDS,
-       OPT_COLOR,
-       OPT_CONNECT,
-       OPT_DEBUG,
-       OPT_DEBUG_INFO_DIR,
-       OPT_DEBUG_INFO_FULL_PATH,
-       OPT_DEBUG_INFO_TARGET_PREFIX,
-       OPT_END,
-       OPT_FIELDS,
-       OPT_FILTER,
-       OPT_HELP,
-       OPT_INPUT_FORMAT,
-       OPT_KEY,
-       OPT_LIST,
-       OPT_NAME,
-       OPT_NAMES,
-       OPT_NO_DEBUG_INFO,
-       OPT_NO_DELTA,
-       OPT_OMIT_HOME_PLUGIN_PATH,
-       OPT_OMIT_SYSTEM_PLUGIN_PATH,
-       OPT_OUTPUT_FORMAT,
-       OPT_OUTPUT,
-       OPT_PARAMS,
-       OPT_PATH,
-       OPT_PLUGIN_PATH,
-       OPT_RESET_BASE_PARAMS,
-       OPT_RUN_ARGS,
-       OPT_RUN_ARGS_0,
-       OPT_SINK,
-       OPT_SOURCE,
-       OPT_STREAM_INTERSECTION,
-       OPT_TIMERANGE,
-       OPT_URL,
-       OPT_VALUE,
-       OPT_VERBOSE,
-};
-
-enum bt_config_component_dest {
-       BT_CONFIG_COMPONENT_DEST_SOURCE,
-       BT_CONFIG_COMPONENT_DEST_FILTER,
-       BT_CONFIG_COMPONENT_DEST_SINK,
-};
-
-/*
- * Adds a configuration component to the appropriate configuration
- * array depending on the destination.
- */
-static void add_run_cfg_comp(struct bt_config *cfg,
-               struct bt_config_component *cfg_comp,
-               enum bt_config_component_dest dest)
-{
-       bt_get(cfg_comp);
-
-       switch (dest) {
-       case BT_CONFIG_COMPONENT_DEST_SOURCE:
-               g_ptr_array_add(cfg->cmd_data.run.sources, cfg_comp);
-               break;
-       case BT_CONFIG_COMPONENT_DEST_FILTER:
-               g_ptr_array_add(cfg->cmd_data.run.filters, cfg_comp);
-               break;
-       case BT_CONFIG_COMPONENT_DEST_SINK:
-               g_ptr_array_add(cfg->cmd_data.run.sinks, cfg_comp);
-               break;
-       default:
-               assert(false);
-       }
-}
-
-static int add_run_cfg_comp_check_name(struct bt_config *cfg,
-               struct bt_config_component *cfg_comp,
-               enum bt_config_component_dest dest,
-               struct bt_value *instance_names)
-{
-       int ret = 0;
-
-       if (cfg_comp->instance_name->len == 0) {
-               printf_err("Found an unnamed component\n");
-               ret = -1;
-               goto end;
-       }
-
-       if (bt_value_map_has_key(instance_names, cfg_comp->instance_name->str)) {
-               printf_err("Duplicate component instance name:\n    %s\n",
-                       cfg_comp->instance_name->str);
-               ret = -1;
-               goto end;
-       }
-
-       if (bt_value_map_insert(instance_names,
-                       cfg_comp->instance_name->str, bt_value_null)) {
-               print_err_oom();
-               ret = -1;
-               goto end;
-       }
-
-       add_run_cfg_comp(cfg, cfg_comp, dest);
-
-end:
-       return ret;
-}
-
-static int append_env_var_plugin_paths(struct bt_value *plugin_paths)
-{
-       int ret = 0;
-       const char *envvar;
-
-       if (bt_common_is_setuid_setgid()) {
-               printf_debug("Skipping non-system plugin paths for setuid/setgid binary\n");
-               goto end;
-       }
-
-       envvar = getenv("BABELTRACE_PLUGIN_PATH");
-       if (!envvar) {
-               goto end;
-       }
-
-       ret = bt_config_append_plugin_paths(plugin_paths, envvar);
-
-end:
-       if (ret) {
-               printf_err("Cannot append plugin paths from BABELTRACE_PLUGIN_PATH\n");
-       }
-
-       return ret;
-}
-
-static int append_home_and_system_plugin_paths(struct bt_value *plugin_paths,
-               bool omit_system_plugin_path, bool omit_home_plugin_path)
-{
-       int ret;
-
-       if (!omit_home_plugin_path) {
-               if (bt_common_is_setuid_setgid()) {
-                       printf_debug("Skipping non-system plugin paths for setuid/setgid binary\n");
-               } else {
-                       char *home_plugin_dir =
-                               bt_common_get_home_plugin_path();
-
-                       if (home_plugin_dir) {
-                               ret = bt_config_append_plugin_paths(
-                                       plugin_paths, home_plugin_dir);
-                               free(home_plugin_dir);
-
-                               if (ret) {
-                                       printf_err("Invalid home plugin path\n");
-                                       goto error;
-                               }
-                       }
-               }
-       }
-
-       if (!omit_system_plugin_path) {
-               if (bt_config_append_plugin_paths(plugin_paths,
-                               bt_common_get_system_plugin_path())) {
-                       printf_err("Invalid system plugin path\n");
-                       goto error;
-               }
-       }
-       return 0;
-error:
-       printf_err("Cannot append home and system plugin paths\n");
-       return -1;
-}
-
-static int append_home_and_system_plugin_paths_cfg(struct bt_config *cfg)
-{
-       return append_home_and_system_plugin_paths(cfg->plugin_paths,
-               cfg->omit_system_plugin_path, cfg->omit_home_plugin_path);
-}
-
-static struct bt_config *bt_config_base_create(enum bt_config_command command,
-               struct bt_value *initial_plugin_paths, bool needs_plugins)
-{
-       struct bt_config *cfg;
-
-       /* Create config */
-       cfg = g_new0(struct bt_config, 1);
-       if (!cfg) {
-               print_err_oom();
-               goto error;
-       }
-
-       bt_object_init(cfg, bt_config_destroy);
-       cfg->command = command;
-       cfg->command_needs_plugins = needs_plugins;
-
-       if (initial_plugin_paths) {
-               cfg->plugin_paths = bt_get(initial_plugin_paths);
-       } else {
-               cfg->plugin_paths = bt_value_array_create();
-               if (!cfg->plugin_paths) {
-                       print_err_oom();
-                       goto error;
-               }
-       }
-
-       goto end;
-
-error:
-       BT_PUT(cfg);
-
-end:
-       return cfg;
-}
-
-static struct bt_config *bt_config_run_create(
-               struct bt_value *initial_plugin_paths)
-{
-       struct bt_config *cfg;
-
-       /* Create config */
-       cfg = bt_config_base_create(BT_CONFIG_COMMAND_RUN,
-               initial_plugin_paths, true);
-       if (!cfg) {
-               goto error;
-       }
-
-       cfg->cmd_data.run.sources = g_ptr_array_new_with_free_func(
-               (GDestroyNotify) bt_put);
-       if (!cfg->cmd_data.run.sources) {
-               print_err_oom();
-               goto error;
-       }
-
-       cfg->cmd_data.run.filters = g_ptr_array_new_with_free_func(
-               (GDestroyNotify) bt_put);
-       if (!cfg->cmd_data.run.filters) {
-               print_err_oom();
-               goto error;
-       }
-
-       cfg->cmd_data.run.sinks = g_ptr_array_new_with_free_func(
-               (GDestroyNotify) bt_put);
-       if (!cfg->cmd_data.run.sinks) {
-               print_err_oom();
-               goto error;
-       }
-
-       cfg->cmd_data.run.connections = g_ptr_array_new_with_free_func(
-               (GDestroyNotify) bt_config_connection_destroy);
-       if (!cfg->cmd_data.run.connections) {
-               print_err_oom();
-               goto error;
-       }
-
-       goto end;
-
-error:
-       BT_PUT(cfg);
-
-end:
-       return cfg;
-}
-
-static struct bt_config *bt_config_list_plugins_create(
-               struct bt_value *initial_plugin_paths)
-{
-       struct bt_config *cfg;
-
-       /* Create config */
-       cfg = bt_config_base_create(BT_CONFIG_COMMAND_LIST_PLUGINS,
-               initial_plugin_paths, true);
-       if (!cfg) {
-               goto error;
-       }
-
-       goto end;
-
-error:
-       BT_PUT(cfg);
-
-end:
-       return cfg;
-}
-
-static struct bt_config *bt_config_help_create(
-               struct bt_value *initial_plugin_paths)
-{
-       struct bt_config *cfg;
-
-       /* Create config */
-       cfg = bt_config_base_create(BT_CONFIG_COMMAND_HELP,
-               initial_plugin_paths, true);
-       if (!cfg) {
-               goto error;
-       }
-
-       cfg->cmd_data.help.cfg_component =
-               bt_config_component_create(BT_COMPONENT_CLASS_TYPE_UNKNOWN,
-                       NULL, NULL);
-       if (!cfg->cmd_data.help.cfg_component) {
-               goto error;
-       }
-
-       goto end;
-
-error:
-       BT_PUT(cfg);
-
-end:
-       return cfg;
-}
-
-static struct bt_config *bt_config_query_create(
-               struct bt_value *initial_plugin_paths)
-{
-       struct bt_config *cfg;
-
-       /* Create config */
-       cfg = bt_config_base_create(BT_CONFIG_COMMAND_QUERY,
-               initial_plugin_paths, true);
-       if (!cfg) {
-               goto error;
-       }
-
-       cfg->cmd_data.query.object = g_string_new(NULL);
-       if (!cfg->cmd_data.query.object) {
-               print_err_oom();
-               goto error;
-       }
-
-       goto end;
-
-error:
-       BT_PUT(cfg);
-
-end:
-       return cfg;
-}
-
-static struct bt_config *bt_config_print_ctf_metadata_create(
-               struct bt_value *initial_plugin_paths)
-{
-       struct bt_config *cfg;
-
-       /* Create config */
-       cfg = bt_config_base_create(BT_CONFIG_COMMAND_PRINT_CTF_METADATA,
-               initial_plugin_paths, true);
-       if (!cfg) {
-               goto error;
-       }
-
-       cfg->cmd_data.print_ctf_metadata.path = g_string_new(NULL);
-       if (!cfg->cmd_data.print_ctf_metadata.path) {
-               print_err_oom();
-               goto error;
-       }
-
-       goto end;
-
-error:
-       BT_PUT(cfg);
-
-end:
-       return cfg;
-}
-
-static struct bt_config *bt_config_print_lttng_live_sessions_create(
-               struct bt_value *initial_plugin_paths)
-{
-       struct bt_config *cfg;
-
-       /* Create config */
-       cfg = bt_config_base_create(BT_CONFIG_COMMAND_PRINT_LTTNG_LIVE_SESSIONS,
-               initial_plugin_paths, true);
-       if (!cfg) {
-               goto error;
-       }
-
-       cfg->cmd_data.print_lttng_live_sessions.url = g_string_new(NULL);
-       if (!cfg->cmd_data.print_lttng_live_sessions.url) {
-               print_err_oom();
-               goto error;
-       }
-
-       goto end;
-
-error:
-       BT_PUT(cfg);
-
-end:
-       return cfg;
-}
-
-int bt_config_append_plugin_paths_check_setuid_setgid(
-               struct bt_value *plugin_paths, const char *arg)
-{
-       int ret = 0;
-
-       if (bt_common_is_setuid_setgid()) {
-               printf_debug("Skipping non-system plugin paths for setuid/setgid binary\n");
-               goto end;
-       }
-
-       if (bt_config_append_plugin_paths(plugin_paths, arg)) {
-               printf_err("Invalid --plugin-path option's argument:\n    %s\n",
-                       arg);
-               ret = -1;
-               goto end;
-       }
-
-end:
-       return ret;
-}
-
-/*
- * Prints the expected format for a --params option.
- */
-static
-void print_expected_params_format(FILE *fp)
-{
-       fprintf(fp, "Expected format of PARAMS\n");
-       fprintf(fp, "-------------------------\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "    PARAM=VALUE[,PARAM=VALUE]...\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "The parameter string is a comma-separated list of PARAM=VALUE assignments,\n");
-       fprintf(fp, "where PARAM is the parameter name (C identifier plus the [:.-] characters),\n");
-       fprintf(fp, "and VALUE can be one of:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "* `null`, `nul`, `NULL`: null value (no backticks).\n");
-       fprintf(fp, "* `true`, `TRUE`, `yes`, `YES`: true boolean value (no backticks).\n");
-       fprintf(fp, "* `false`, `FALSE`, `no`, `NO`: false boolean value (no backticks).\n");
-       fprintf(fp, "* Binary (`0b` prefix), octal (`0` prefix), decimal, or hexadecimal\n");
-       fprintf(fp, "  (`0x` prefix) signed 64-bit integer.\n");
-       fprintf(fp, "* Double precision floating point number (scientific notation is accepted).\n");
-       fprintf(fp, "* Unquoted string with no special characters, and not matching any of\n");
-       fprintf(fp, "  the null and boolean value symbols above.\n");
-       fprintf(fp, "* Double-quoted string (accepts escape characters).\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "You can put whitespaces allowed around individual `=` and `,` symbols.\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Example:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "    many=null, fresh=yes, condition=false, squirrel=-782329,\n");
-       fprintf(fp, "    observe=3.14, simple=beef, needs-quotes=\"some string\",\n");
-       fprintf(fp, "    escape.chars-are:allowed=\"this is a \\\" double quote\"\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "IMPORTANT: Make sure to single-quote the whole argument when you run babeltrace\n");
-       fprintf(fp, "from a shell.\n");
-}
-
-
-/*
- * Prints the help command usage.
- */
-static
-void print_help_usage(FILE *fp)
-{
-       fprintf(fp, "Usage: babeltrace [GENERAL OPTIONS] help [OPTIONS] PLUGIN\n");
-       fprintf(fp, "       babeltrace [GENERAL OPTIONS] help [OPTIONS] --source=PLUGIN.CLS\n");
-       fprintf(fp, "       babeltrace [GENERAL OPTIONS] help [OPTIONS] --filter=PLUGIN.CLS\n");
-       fprintf(fp, "       babeltrace [GENERAL OPTIONS] help [OPTIONS] --sink=PLUGIN.CLS\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Options:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "  -f, --filter=PLUGIN.CLS           Get help for the filter component class\n");
-       fprintf(fp, "                                    CLS found in the plugin PLUGIN\n");
-       fprintf(fp, "      --omit-home-plugin-path       Omit home plugins from plugin search path\n");
-       fprintf(fp, "                                    (~/.local/lib/babeltrace/plugins)\n");
-       fprintf(fp, "      --omit-system-plugin-path     Omit system plugins from plugin search path\n");
-       fprintf(fp, "      --plugin-path=PATH[:PATH]...  Add PATH to the list of paths from which\n");
-       fprintf(fp, "                                    dynamic plugins can be loaded\n");
-       fprintf(fp, "  -S, --sink=PLUGIN.CLS             Get help for the sink component class\n");
-       fprintf(fp, "                                    CLS found in the plugin PLUGIN\n");
-       fprintf(fp, "  -s, --source=PLUGIN.CLS           Get help for the source component class\n");
-       fprintf(fp, "                                    CLS found in the plugin PLUGIN\n");
-       fprintf(fp, "  -h  --help                        Show this help and quit\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "See `babeltrace --help` for the list of general options.\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Use `babeltrace list-plugins` to show the list of available plugins.\n");
-}
-
-static struct poptOption help_long_options[] = {
-       /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
-       { "filter", 'f', POPT_ARG_STRING, NULL, OPT_FILTER, NULL, NULL },
-       { "help", 'h', POPT_ARG_NONE, NULL, OPT_HELP, NULL, NULL },
-       { "omit-home-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_HOME_PLUGIN_PATH, NULL, NULL },
-       { "omit-system-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_SYSTEM_PLUGIN_PATH, NULL, NULL },
-       { "plugin-path", '\0', POPT_ARG_STRING, NULL, OPT_PLUGIN_PATH, NULL, NULL },
-       { "sink", 'S', POPT_ARG_STRING, NULL, OPT_SINK, NULL, NULL },
-       { "source", 's', POPT_ARG_STRING, NULL, OPT_SOURCE, NULL, NULL },
-       { NULL, 0, 0, NULL, 0, NULL, NULL },
-};
-
-/*
- * Creates a Babeltrace config object from the arguments of a help
- * command.
- *
- * *retcode is set to the appropriate exit code to use.
- */
-static
-struct bt_config *bt_config_help_from_args(int argc, const char *argv[],
-               int *retcode, bool omit_system_plugin_path,
-               bool omit_home_plugin_path,
-               struct bt_value *initial_plugin_paths)
-{
-       poptContext pc = NULL;
-       char *arg = NULL;
-       int opt;
-       int ret;
-       struct bt_config *cfg = NULL;
-       const char *leftover;
-       char *plugin_name = NULL, *comp_cls_name = NULL;
-       char *plug_comp_cls_names = NULL;
-
-       *retcode = 0;
-       cfg = bt_config_help_create(initial_plugin_paths);
-       if (!cfg) {
-               goto error;
-       }
-
-       cfg->omit_system_plugin_path = omit_system_plugin_path;
-       cfg->omit_home_plugin_path = omit_home_plugin_path;
-       ret = append_env_var_plugin_paths(cfg->plugin_paths);
-       if (ret) {
-               goto error;
-       }
-
-       /* Parse options */
-       pc = poptGetContext(NULL, argc, (const char **) argv,
-               help_long_options, 0);
-       if (!pc) {
-               printf_err("Cannot get popt context\n");
-               goto error;
-       }
-
-       poptReadDefaultConfig(pc, 0);
-
-       while ((opt = poptGetNextOpt(pc)) > 0) {
-               arg = poptGetOptArg(pc);
-
-               switch (opt) {
-               case OPT_PLUGIN_PATH:
-                       if (bt_config_append_plugin_paths_check_setuid_setgid(
-                                       cfg->plugin_paths, arg)) {
-                               goto error;
-                       }
-                       break;
-               case OPT_OMIT_SYSTEM_PLUGIN_PATH:
-                       cfg->omit_system_plugin_path = true;
-                       break;
-               case OPT_OMIT_HOME_PLUGIN_PATH:
-                       cfg->omit_home_plugin_path = true;
-                       break;
-               case OPT_SOURCE:
-               case OPT_FILTER:
-               case OPT_SINK:
-                       if (cfg->cmd_data.help.cfg_component->type !=
-                                       BT_COMPONENT_CLASS_TYPE_UNKNOWN) {
-                               printf_err("Cannot specify more than one plugin and component class:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       switch (opt) {
-                       case OPT_SOURCE:
-                               cfg->cmd_data.help.cfg_component->type =
-                                       BT_COMPONENT_CLASS_TYPE_SOURCE;
-                               break;
-                       case OPT_FILTER:
-                               cfg->cmd_data.help.cfg_component->type =
-                                       BT_COMPONENT_CLASS_TYPE_FILTER;
-                               break;
-                       case OPT_SINK:
-                               cfg->cmd_data.help.cfg_component->type =
-                                       BT_COMPONENT_CLASS_TYPE_SINK;
-                               break;
-                       default:
-                               assert(false);
-                       }
-                       plug_comp_cls_names = strdup(arg);
-                       if (!plug_comp_cls_names) {
-                               print_err_oom();
-                               goto error;
-                       }
-                       break;
-               case OPT_HELP:
-                       print_help_usage(stdout);
-                       *retcode = -1;
-                       BT_PUT(cfg);
-                       goto end;
-               default:
-                       printf_err("Unknown command-line option specified (option code %d)\n",
-                               opt);
-                       goto error;
-               }
-
-               free(arg);
-               arg = NULL;
-       }
-
-       /* Check for option parsing error */
-       if (opt < -1) {
-               printf_err("While parsing command-line options, at option %s: %s\n",
-                       poptBadOption(pc, 0), poptStrerror(opt));
-               goto error;
-       }
-
-       leftover = poptGetArg(pc);
-       if (leftover) {
-               if (cfg->cmd_data.help.cfg_component->type !=
-                                       BT_COMPONENT_CLASS_TYPE_UNKNOWN) {
-                       printf_err("Cannot specify plugin name and --source/--filter/--sink component class:\n    %s\n",
-                               leftover);
-                       goto error;
-               }
-
-               g_string_assign(cfg->cmd_data.help.cfg_component->plugin_name,
-                       leftover);
-       } else {
-               if (cfg->cmd_data.help.cfg_component->type ==
-                                       BT_COMPONENT_CLASS_TYPE_UNKNOWN) {
-                       print_help_usage(stdout);
-                       *retcode = -1;
-                       BT_PUT(cfg);
-                       goto end;
-               }
-
-               plugin_comp_cls_names(plug_comp_cls_names, NULL,
-                       &plugin_name, &comp_cls_name);
-               if (plugin_name && comp_cls_name) {
-                       g_string_assign(cfg->cmd_data.help.cfg_component->plugin_name,
-                               plugin_name);
-                       g_string_assign(cfg->cmd_data.help.cfg_component->comp_cls_name,
-                               comp_cls_name);
-               } else {
-                       printf_err("Invalid --source/--filter/--sink option's argument:\n    %s\n",
-                               plug_comp_cls_names);
-                       goto error;
-               }
-       }
-
-       if (append_home_and_system_plugin_paths_cfg(cfg)) {
-               goto error;
-       }
-
-       goto end;
-
-error:
-       *retcode = 1;
-       BT_PUT(cfg);
-
-end:
-       free(plug_comp_cls_names);
-       g_free(plugin_name);
-       g_free(comp_cls_name);
-
-       if (pc) {
-               poptFreeContext(pc);
-       }
-
-       free(arg);
-       return cfg;
-}
-
-/*
- * Prints the help command usage.
- */
-static
-void print_query_usage(FILE *fp)
-{
-       fprintf(fp, "Usage: babeltrace [GEN OPTS] query [OPTS] OBJECT --source=PLUGIN.CLS\n");
-       fprintf(fp, "       babeltrace [GEN OPTS] query [OPTS] OBJECT --filter=PLUGIN.CLS\n");
-       fprintf(fp, "       babeltrace [GEN OPTS] query [OPTS] OBJECT --sink=PLUGIN.CLS\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Options:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "  -f. --filter=PLUGIN.CLS           Query object from the filter component\n");
-       fprintf(fp, "                                    class CLS found in the plugin PLUGIN\n");
-       fprintf(fp, "      --omit-home-plugin-path       Omit home plugins from plugin search path\n");
-       fprintf(fp, "                                    (~/.local/lib/babeltrace/plugins)\n");
-       fprintf(fp, "      --omit-system-plugin-path     Omit system plugins from plugin search path\n");
-       fprintf(fp, "  -p, --params=PARAMS               Set the query parameters to PARAMS\n");
-       fprintf(fp, "                                    (see the expected format of PARAMS below)\n");
-       fprintf(fp, "      --plugin-path=PATH[:PATH]...  Add PATH to the list of paths from which\n");
-       fprintf(fp, "                                    dynamic plugins can be loaded\n");
-       fprintf(fp, "  -S, --sink=PLUGIN.CLS             Query object from the sink component class\n");
-       fprintf(fp, "                                    CLS found in the plugin PLUGIN\n");
-       fprintf(fp, "  -s, --source=PLUGIN.CLS           Query object from the source component\n");
-       fprintf(fp, "                                    class CLS found in the plugin PLUGIN\n");
-       fprintf(fp, "  -h  --help                        Show this help and quit\n");
-       fprintf(fp, "\n\n");
-       print_expected_params_format(fp);
-}
-
-static struct poptOption query_long_options[] = {
-       /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
-       { "filter", 'f', POPT_ARG_STRING, NULL, OPT_FILTER, NULL, NULL },
-       { "help", 'h', POPT_ARG_NONE, NULL, OPT_HELP, NULL, NULL },
-       { "omit-home-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_HOME_PLUGIN_PATH, NULL, NULL },
-       { "omit-system-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_SYSTEM_PLUGIN_PATH, NULL, NULL },
-       { "params", 'p', POPT_ARG_STRING, NULL, OPT_PARAMS, NULL, NULL },
-       { "plugin-path", '\0', POPT_ARG_STRING, NULL, OPT_PLUGIN_PATH, NULL, NULL },
-       { "sink", 'S', POPT_ARG_STRING, NULL, OPT_SINK, NULL, NULL },
-       { "source", 's', POPT_ARG_STRING, NULL, OPT_SOURCE, NULL, NULL },
-       { NULL, 0, 0, NULL, 0, NULL, NULL },
-};
-
-/*
- * Creates a Babeltrace config object from the arguments of a query
- * command.
- *
- * *retcode is set to the appropriate exit code to use.
- */
-static
-struct bt_config *bt_config_query_from_args(int argc, const char *argv[],
-               int *retcode, bool omit_system_plugin_path,
-               bool omit_home_plugin_path,
-               struct bt_value *initial_plugin_paths)
-{
-       poptContext pc = NULL;
-       char *arg = NULL;
-       int opt;
-       int ret;
-       struct bt_config *cfg = NULL;
-       const char *leftover;
-       struct bt_value *params = bt_value_null;
-
-       *retcode = 0;
-       cfg = bt_config_query_create(initial_plugin_paths);
-       if (!cfg) {
-               goto error;
-       }
-
-       cfg->omit_system_plugin_path =
-               omit_system_plugin_path;
-       cfg->omit_home_plugin_path = omit_home_plugin_path;
-       ret = append_env_var_plugin_paths(cfg->plugin_paths);
-       if (ret) {
-               goto error;
-       }
-
-       /* Parse options */
-       pc = poptGetContext(NULL, argc, (const char **) argv,
-               query_long_options, 0);
-       if (!pc) {
-               printf_err("Cannot get popt context\n");
-               goto error;
-       }
-
-       poptReadDefaultConfig(pc, 0);
-
-       while ((opt = poptGetNextOpt(pc)) > 0) {
-               arg = poptGetOptArg(pc);
-
-               switch (opt) {
-               case OPT_PLUGIN_PATH:
-                       if (bt_config_append_plugin_paths_check_setuid_setgid(
-                                       cfg->plugin_paths, arg)) {
-                               goto error;
-                       }
-                       break;
-               case OPT_OMIT_SYSTEM_PLUGIN_PATH:
-                       cfg->omit_system_plugin_path = true;
-                       break;
-               case OPT_OMIT_HOME_PLUGIN_PATH:
-                       cfg->omit_home_plugin_path = true;
-                       break;
-               case OPT_SOURCE:
-               case OPT_FILTER:
-               case OPT_SINK:
-               {
-                       enum bt_component_class_type type;
-
-                       if (cfg->cmd_data.query.cfg_component) {
-                               printf_err("Cannot specify more than one plugin and component class:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       switch (opt) {
-                       case OPT_SOURCE:
-                               type = BT_COMPONENT_CLASS_TYPE_SOURCE;
-                               break;
-                       case OPT_FILTER:
-                               type = BT_COMPONENT_CLASS_TYPE_FILTER;
-                               break;
-                       case OPT_SINK:
-                               type = BT_COMPONENT_CLASS_TYPE_SINK;
-                               break;
-                       default:
-                               assert(false);
-                       }
-
-                       cfg->cmd_data.query.cfg_component =
-                               bt_config_component_from_arg(type, arg);
-                       if (!cfg->cmd_data.query.cfg_component) {
-                               printf_err("Invalid format for --source/--filter/--sink option's argument:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       /* Default parameters: null */
-                       bt_put(cfg->cmd_data.query.cfg_component->params);
-                       cfg->cmd_data.query.cfg_component->params =
-                               bt_value_null;
-                       break;
-               }
-               case OPT_PARAMS:
-               {
-                       params = bt_value_from_arg(arg);
-                       if (!params) {
-                               printf_err("Invalid format for --params option's argument:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-                       break;
-               }
-               case OPT_HELP:
-                       print_query_usage(stdout);
-                       *retcode = -1;
-                       BT_PUT(cfg);
-                       goto end;
-               default:
-                       printf_err("Unknown command-line option specified (option code %d)\n",
-                               opt);
-                       goto error;
-               }
-
-               free(arg);
-               arg = NULL;
-       }
-
-       if (!cfg->cmd_data.query.cfg_component) {
-               printf_err("No target component class specified with --source/--filter/--sink option\n");
-               goto error;
-       }
-
-       assert(params);
-       BT_MOVE(cfg->cmd_data.query.cfg_component->params, params);
-
-       /* Check for option parsing error */
-       if (opt < -1) {
-               printf_err("While parsing command-line options, at option %s: %s\n",
-                       poptBadOption(pc, 0), poptStrerror(opt));
-               goto error;
-       }
-
-       /*
-        * We need exactly one leftover argument which is the
-        * mandatory object.
-        */
-       leftover = poptGetArg(pc);
-       if (leftover) {
-               if (strlen(leftover) == 0) {
-                       printf_err("Invalid empty object\n");
-                       goto error;
-               }
-
-               g_string_assign(cfg->cmd_data.query.object, leftover);
-       } else {
-               print_query_usage(stdout);
-               *retcode = -1;
-               BT_PUT(cfg);
-               goto end;
-       }
-
-       leftover = poptGetArg(pc);
-       if (leftover) {
-               printf_err("Unexpected argument: %s\n", leftover);
-               goto error;
-       }
-
-       if (append_home_and_system_plugin_paths_cfg(cfg)) {
-               goto error;
-       }
-
-       goto end;
-
-error:
-       *retcode = 1;
-       BT_PUT(cfg);
-
-end:
-       if (pc) {
-               poptFreeContext(pc);
-       }
-
-       BT_PUT(params);
-       free(arg);
-       return cfg;
-}
-
-/*
- * Prints the list-plugins command usage.
- */
-static
-void print_list_plugins_usage(FILE *fp)
-{
-       fprintf(fp, "Usage: babeltrace [GENERAL OPTIONS] list-plugins [OPTIONS]\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Options:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "      --omit-home-plugin-path       Omit home plugins from plugin search path\n");
-       fprintf(fp, "                                    (~/.local/lib/babeltrace/plugins)\n");
-       fprintf(fp, "      --omit-system-plugin-path     Omit system plugins from plugin search path\n");
-       fprintf(fp, "      --plugin-path=PATH[:PATH]...  Add PATH to the list of paths from which\n");
-       fprintf(fp, "                                    dynamic plugins can be loaded\n");
-       fprintf(fp, "  -h  --help                        Show this help and quit\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "See `babeltrace --help` for the list of general options.\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Use `babeltrace help` to get help for a specific plugin or component class.\n");
-}
-
-static struct poptOption list_plugins_long_options[] = {
-       /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
-       { "help", 'h', POPT_ARG_NONE, NULL, OPT_HELP, NULL, NULL },
-       { "omit-home-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_HOME_PLUGIN_PATH, NULL, NULL },
-       { "omit-system-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_SYSTEM_PLUGIN_PATH, NULL, NULL },
-       { "plugin-path", '\0', POPT_ARG_STRING, NULL, OPT_PLUGIN_PATH, NULL, NULL },
-       { NULL, 0, 0, NULL, 0, NULL, NULL },
-};
-
-/*
- * Creates a Babeltrace config object from the arguments of a
- * list-plugins command.
- *
- * *retcode is set to the appropriate exit code to use.
- */
-static
-struct bt_config *bt_config_list_plugins_from_args(int argc, const char *argv[],
-               int *retcode, bool omit_system_plugin_path,
-               bool omit_home_plugin_path,
-               struct bt_value *initial_plugin_paths)
-{
-       poptContext pc = NULL;
-       char *arg = NULL;
-       int opt;
-       int ret;
-       struct bt_config *cfg = NULL;
-       const char *leftover;
-
-       *retcode = 0;
-       cfg = bt_config_list_plugins_create(initial_plugin_paths);
-       if (!cfg) {
-               goto error;
-       }
-
-       cfg->omit_system_plugin_path = omit_system_plugin_path;
-       cfg->omit_home_plugin_path = omit_home_plugin_path;
-       ret = append_env_var_plugin_paths(cfg->plugin_paths);
-       if (ret) {
-               goto error;
-       }
-
-       /* Parse options */
-       pc = poptGetContext(NULL, argc, (const char **) argv,
-               list_plugins_long_options, 0);
-       if (!pc) {
-               printf_err("Cannot get popt context\n");
-               goto error;
-       }
-
-       poptReadDefaultConfig(pc, 0);
-
-       while ((opt = poptGetNextOpt(pc)) > 0) {
-               arg = poptGetOptArg(pc);
-
-               switch (opt) {
-               case OPT_PLUGIN_PATH:
-                       if (bt_config_append_plugin_paths_check_setuid_setgid(
-                                       cfg->plugin_paths, arg)) {
-                               goto error;
-                       }
-                       break;
-               case OPT_OMIT_SYSTEM_PLUGIN_PATH:
-                       cfg->omit_system_plugin_path = true;
-                       break;
-               case OPT_OMIT_HOME_PLUGIN_PATH:
-                       cfg->omit_home_plugin_path = true;
-                       break;
-               case OPT_HELP:
-                       print_list_plugins_usage(stdout);
-                       *retcode = -1;
-                       BT_PUT(cfg);
-                       goto end;
-               default:
-                       printf_err("Unknown command-line option specified (option code %d)\n",
-                               opt);
-                       goto error;
-               }
-
-               free(arg);
-               arg = NULL;
-       }
-
-       /* Check for option parsing error */
-       if (opt < -1) {
-               printf_err("While parsing command-line options, at option %s: %s\n",
-                       poptBadOption(pc, 0), poptStrerror(opt));
-               goto error;
-       }
-
-       leftover = poptGetArg(pc);
-       if (leftover) {
-               printf_err("Unexpected argument: %s\n", leftover);
-               goto error;
-       }
-
-       if (append_home_and_system_plugin_paths_cfg(cfg)) {
-               goto error;
-       }
-
-       goto end;
-
-error:
-       *retcode = 1;
-       BT_PUT(cfg);
-
-end:
-       if (pc) {
-               poptFreeContext(pc);
-       }
-
-       free(arg);
-       return cfg;
-}
-
-/*
- * Prints the run command usage.
- */
-static
-void print_run_usage(FILE *fp)
-{
-       fprintf(fp, "Usage: babeltrace [GENERAL OPTIONS] run [OPTIONS]\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Options:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "  -b, --base-params=PARAMS          Set PARAMS as the current base parameters\n");
-       fprintf(fp, "                                    for all the following components until\n");
-       fprintf(fp, "                                    --reset-base-params is encountered\n");
-       fprintf(fp, "                                    (see the expected format of PARAMS below)\n");
-       fprintf(fp, "  -c, --connect=CONNECTION          Connect two created components (see the\n");
-       fprintf(fp, "                                    expected format of CONNECTION below)\n");
-       fprintf(fp, "  -f, --filter=[NAME:]PLUGIN.CLS    Instantiate a filter component from plugin\n");
-       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
-       fprintf(fp, "                                    the current component, and if NAME is\n");
-       fprintf(fp, "                                    given, set its instance name to NAME\n");
-       fprintf(fp, "      --key=KEY                     Set the current initialization string\n");
-       fprintf(fp, "                                    parameter key to KEY (see --value)\n");
-       fprintf(fp, "  -n, --name=NAME                   Set the name of the current component\n");
-       fprintf(fp, "                                    to NAME (must be unique amongst all the\n");
-       fprintf(fp, "                                    names of the created components)\n");
-       fprintf(fp, "      --omit-home-plugin-path       Omit home plugins from plugin search path\n");
-       fprintf(fp, "                                    (~/.local/lib/babeltrace/plugins)\n");
-       fprintf(fp, "      --omit-system-plugin-path     Omit system plugins from plugin search path\n");
-       fprintf(fp, "  -p, --params=PARAMS               Add initialization parameters PARAMS to the\n");
-       fprintf(fp, "                                    current component (see the expected format\n");
-       fprintf(fp, "                                    of PARAMS below)\n");
-       fprintf(fp, "      --plugin-path=PATH[:PATH]...  Add PATH to the list of paths from which\n");
-       fprintf(fp, "                                    dynamic plugins can be loaded\n");
-       fprintf(fp, "  -r, --reset-base-params           Reset the current base parameters to an\n");
-       fprintf(fp, "                                    empty map\n");
-       fprintf(fp, "  -S, --sink=[NAME:]PLUGIN.CLS      Instantiate a sink component from plugin\n");
-       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
-       fprintf(fp, "                                    the current component, and if NAME is\n");
-       fprintf(fp, "                                    given, set its instance name to NAME\n");
-       fprintf(fp, "  -s, --source=[NAME:]PLUGIN.CLS    Instantiate a source component from plugin\n");
-       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
-       fprintf(fp, "                                    the current component, and if NAME is\n");
-       fprintf(fp, "                                    given, set its instance name to NAME\n");
-       fprintf(fp, "      --value=VAL                   Add a string initialization parameter to\n");
-       fprintf(fp, "                                    the current component with a name given by\n");
-       fprintf(fp, "                                    the last argument of the --key option and a\n");
-       fprintf(fp, "                                    value set to VAL\n");
-       fprintf(fp, "  -h  --help                        Show this help and quit\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "See `babeltrace --help` for the list of general options.\n");
-       fprintf(fp, "\n\n");
-       fprintf(fp, "Expected format of CONNECTION\n");
-       fprintf(fp, "-----------------------------\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "    UPSTREAM[.UPSTREAM-PORT]:DOWNSTREAM[.DOWNSTREAM-PORT]\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "UPSTREAM and DOWNSTREAM are the names of the upstream and downstream components\n");
-       fprintf(fp, "to connect together. You can set the name of the current component with the\n");
-       fprintf(fp, "--name option.\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "UPSTREAM-PORT and DOWNSTREAM-PORT are the optional upstream and downstream\n");
-       fprintf(fp, "ports to use for the connection. When the port is not specified, the default\n");
-       fprintf(fp, "port is used.\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "You can connect a source component to a filter or sink component. You\n");
-       fprintf(fp, "can connect a filter component to a sink component.\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Example:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "    my-filter.top10:json-out\n");
-       fprintf(fp, "\n\n");
-       print_expected_params_format(fp);
-}
-
-static struct poptOption run_long_options[] = {
-       /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
-       { "base-params", 'b', POPT_ARG_STRING, NULL, OPT_BASE_PARAMS, NULL, NULL },
-       { "connect", 'c', POPT_ARG_STRING, NULL, OPT_CONNECT, NULL, NULL },
-       { "filter", 'f', POPT_ARG_STRING, NULL, OPT_FILTER, NULL, NULL },
-       { "help", 'h', POPT_ARG_NONE, NULL, OPT_HELP, NULL, NULL },
-       { "key", '\0', POPT_ARG_STRING, NULL, OPT_KEY, NULL, NULL },
-       { "name", 'n', POPT_ARG_STRING, NULL, OPT_NAME, NULL, NULL },
-       { "omit-home-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_HOME_PLUGIN_PATH, NULL, NULL },
-       { "omit-system-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_SYSTEM_PLUGIN_PATH, NULL, NULL },
-       { "params", 'p', POPT_ARG_STRING, NULL, OPT_PARAMS, NULL, NULL },
-       { "plugin-path", '\0', POPT_ARG_STRING, NULL, OPT_PLUGIN_PATH, NULL, NULL },
-       { "reset-base-params", 'r', POPT_ARG_NONE, NULL, OPT_RESET_BASE_PARAMS, NULL, NULL },
-       { "sink", 'S', POPT_ARG_STRING, NULL, OPT_SINK, NULL, NULL },
-       { "source", 's', POPT_ARG_STRING, NULL, OPT_SOURCE, NULL, NULL },
-       { "value", '\0', POPT_ARG_STRING, NULL, OPT_VALUE, NULL, NULL },
-       { NULL, 0, 0, NULL, 0, NULL, NULL },
-};
-
-/*
- * Creates a Babeltrace config object from the arguments of a run
- * command.
- *
- * *retcode is set to the appropriate exit code to use.
- */
-static
-struct bt_config *bt_config_run_from_args(int argc, const char *argv[],
-               int *retcode, bool omit_system_plugin_path,
-               bool omit_home_plugin_path,
-               struct bt_value *initial_plugin_paths)
-{
-       poptContext pc = NULL;
-       char *arg = NULL;
-       struct bt_config_component *cur_cfg_comp = NULL;
-       enum bt_config_component_dest cur_cfg_comp_dest;
-       struct bt_value *cur_base_params = NULL;
-       int opt, ret = 0;
-       struct bt_config *cfg = NULL;
-       struct bt_value *instance_names = NULL;
-       struct bt_value *connection_args = NULL;
-       GString *cur_param_key = NULL;
-       char error_buf[256] = { 0 };
-
-       *retcode = 0;
-       cur_param_key = g_string_new(NULL);
-       if (!cur_param_key) {
-               print_err_oom();
-               goto error;
-       }
-
-       if (argc <= 1) {
-               print_run_usage(stdout);
-               *retcode = -1;
-               goto end;
-       }
-
-       cfg = bt_config_run_create(initial_plugin_paths);
-       if (!cfg) {
-               goto error;
-       }
-
-       cfg->omit_system_plugin_path = omit_system_plugin_path;
-       cfg->omit_home_plugin_path = omit_home_plugin_path;
-       cur_base_params = bt_value_map_create();
-       if (!cur_base_params) {
-               print_err_oom();
-               goto error;
-       }
-
-       instance_names = bt_value_map_create();
-       if (!instance_names) {
-               print_err_oom();
-               goto error;
-       }
-
-       connection_args = bt_value_array_create();
-       if (!connection_args) {
-               print_err_oom();
-               goto error;
-       }
-
-       ret = append_env_var_plugin_paths(cfg->plugin_paths);
-       if (ret) {
-               goto error;
-       }
-
-       /* Parse options */
-       pc = poptGetContext(NULL, argc, (const char **) argv,
-               run_long_options, 0);
-       if (!pc) {
-               printf_err("Cannot get popt context\n");
-               goto error;
-       }
-
-       poptReadDefaultConfig(pc, 0);
-
-       while ((opt = poptGetNextOpt(pc)) > 0) {
-               arg = poptGetOptArg(pc);
-
-               switch (opt) {
-               case OPT_PLUGIN_PATH:
-                       if (bt_config_append_plugin_paths_check_setuid_setgid(
-                                       cfg->plugin_paths, arg)) {
-                               goto error;
-                       }
-                       break;
-               case OPT_OMIT_SYSTEM_PLUGIN_PATH:
-                       cfg->omit_system_plugin_path = true;
-                       break;
-               case OPT_OMIT_HOME_PLUGIN_PATH:
-                       cfg->omit_home_plugin_path = true;
-                       break;
-               case OPT_SOURCE:
-               case OPT_FILTER:
-               case OPT_SINK:
-               {
-                       enum bt_component_class_type new_comp_type;
-                       enum bt_config_component_dest new_dest;
-                       const char *opt_name;
-
-                       switch (opt) {
-                       case OPT_SOURCE:
-                               new_comp_type = BT_COMPONENT_CLASS_TYPE_SOURCE;
-                               new_dest = BT_CONFIG_COMPONENT_DEST_SOURCE;
-                               opt_name = "--source";
-                               break;
-                       case OPT_FILTER:
-                               new_comp_type = BT_COMPONENT_CLASS_TYPE_FILTER;
-                               new_dest = BT_CONFIG_COMPONENT_DEST_FILTER;
-                               opt_name = "--filter";
-                               break;
-                       case OPT_SINK:
-                               new_comp_type = BT_COMPONENT_CLASS_TYPE_SINK;
-                               new_dest = BT_CONFIG_COMPONENT_DEST_SINK;
-                               opt_name = "--sink";
-                               break;
-                       default:
-                               assert(false);
-                       }
-
-                       if (cur_cfg_comp) {
-                               ret = add_run_cfg_comp_check_name(cfg,
-                                       cur_cfg_comp, cur_cfg_comp_dest,
-                                       instance_names);
-                               BT_PUT(cur_cfg_comp);
-                               if (ret) {
-                                       goto error;
-                               }
-                       }
-
-                       cur_cfg_comp = bt_config_component_from_arg(
-                               new_comp_type, arg);
-                       if (!cur_cfg_comp) {
-                               printf_err("Invalid format for %s option's argument:\n    %s\n",
-                                       opt_name, arg);
-                               goto error;
-                       }
-
-                       assert(cur_base_params);
-                       bt_put(cur_cfg_comp->params);
-                       cur_cfg_comp->params = bt_value_copy(cur_base_params);
-                       if (!cur_cfg_comp->params) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       cur_cfg_comp_dest = new_dest;
-                       break;
-               }
-               case OPT_PARAMS:
-               {
-                       struct bt_value *params;
-                       struct bt_value *params_to_set;
-
-                       if (!cur_cfg_comp) {
-                               printf_err("Cannot add parameters to unavailable component:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       params = bt_value_from_arg(arg);
-                       if (!params) {
-                               printf_err("Invalid format for --params option's argument:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       params_to_set = bt_value_map_extend(cur_cfg_comp->params,
-                               params);
-                       BT_PUT(params);
-                       if (!params_to_set) {
-                               printf_err("Cannot extend current component parameters with --params option's argument:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       BT_MOVE(cur_cfg_comp->params, params_to_set);
-                       break;
-               }
-               case OPT_KEY:
-                       if (strlen(arg) == 0) {
-                               printf_err("Cannot set an empty string as the current parameter key\n");
-                               goto error;
-                       }
-
-                       g_string_assign(cur_param_key, arg);
-                       break;
-               case OPT_VALUE:
-                       if (!cur_cfg_comp) {
-                               printf_err("Cannot set a parameter's value of unavailable component:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       if (cur_param_key->len == 0) {
-                               printf_err("--value option specified without preceding --key option:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       if (bt_value_map_insert_string(cur_cfg_comp->params,
-                                       cur_param_key->str, arg)) {
-                               print_err_oom();
-                               goto error;
-                       }
-                       break;
-               case OPT_NAME:
-                       if (!cur_cfg_comp) {
-                               printf_err("Cannot set the name of unavailable component:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       g_string_assign(cur_cfg_comp->instance_name, arg);
-                       break;
-               case OPT_BASE_PARAMS:
-               {
-                       struct bt_value *params = bt_value_from_arg(arg);
-
-                       if (!params) {
-                               printf_err("Invalid format for --base-params option's argument:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       BT_MOVE(cur_base_params, params);
-                       break;
-               }
-               case OPT_RESET_BASE_PARAMS:
-                       BT_PUT(cur_base_params);
-                       cur_base_params = bt_value_map_create();
-                       if (!cur_base_params) {
-                               print_err_oom();
-                               goto error;
-                       }
-                       break;
-               case OPT_CONNECT:
-                       if (bt_value_array_append_string(connection_args,
-                                       arg)) {
-                               print_err_oom();
-                               goto error;
-                       }
-                       break;
-               case OPT_HELP:
-                       print_run_usage(stdout);
-                       *retcode = -1;
-                       BT_PUT(cfg);
-                       goto end;
-               default:
-                       printf_err("Unknown command-line option specified (option code %d)\n",
-                               opt);
-                       goto error;
-               }
-
-               free(arg);
-               arg = NULL;
-       }
-
-       /* Check for option parsing error */
-       if (opt < -1) {
-               printf_err("While parsing command-line options, at option %s: %s\n",
-                       poptBadOption(pc, 0), poptStrerror(opt));
-               goto error;
-       }
-
-       /* This command does not accept leftover arguments */
-       if (poptPeekArg(pc)) {
-               printf_err("Unexpected argument: %s\n", poptPeekArg(pc));
-               goto error;
-       }
-
-       /* Add current component */
-       if (cur_cfg_comp) {
-               ret = add_run_cfg_comp_check_name(cfg, cur_cfg_comp,
-                       cur_cfg_comp_dest, instance_names);
-               BT_PUT(cur_cfg_comp);
-               if (ret) {
-                       goto error;
-               }
-       }
-
-       if (cfg->cmd_data.run.sources->len == 0) {
-               printf_err("Incomplete graph: no source component\n");
-               goto error;
-       }
-
-       if (cfg->cmd_data.run.sinks->len == 0) {
-               printf_err("Incomplete graph: no sink component\n");
-               goto error;
-       }
-
-       if (append_home_and_system_plugin_paths_cfg(cfg)) {
-               goto error;
-       }
-
-       ret = bt_config_create_connections(cfg, connection_args,
-               error_buf, 256);
-       if (ret) {
-               printf_err("Cannot creation connections:\n%s", error_buf);
-               goto error;
-       }
-
-       goto end;
-
-error:
-       *retcode = 1;
-       BT_PUT(cfg);
-
-end:
-       if (pc) {
-               poptFreeContext(pc);
-       }
-
-       if (cur_param_key) {
-               g_string_free(cur_param_key, TRUE);
-       }
-
-       free(arg);
-       BT_PUT(cur_cfg_comp);
-       BT_PUT(cur_base_params);
-       BT_PUT(instance_names);
-       BT_PUT(connection_args);
-       return cfg;
-}
-
-static
-struct bt_config *bt_config_run_from_args_array(struct bt_value *run_args,
-               int *retcode, bool omit_system_plugin_path,
-               bool omit_home_plugin_path,
-               struct bt_value *initial_plugin_paths)
-{
-       struct bt_config *cfg = NULL;
-       const char **argv;
-       size_t i;
-       const size_t argc = bt_value_array_size(run_args) + 1;
-
-       argv = calloc(argc, sizeof(*argv));
-       if (!argv) {
-               print_err_oom();
-               goto end;
-       }
-
-       argv[0] = "run";
-
-       for (i = 0; i < bt_value_array_size(run_args); i++) {
-               int ret;
-               struct bt_value *arg_value = bt_value_array_get(run_args, i);
-               const char *arg;
-
-               assert(arg_value);
-               ret = bt_value_string_get(arg_value, &arg);
-               assert(ret == 0);
-               assert(arg);
-               argv[i + 1] = arg;
-               bt_put(arg_value);
-       }
-
-       cfg = bt_config_run_from_args(argc, argv, retcode,
-               omit_system_plugin_path, omit_home_plugin_path,
-               initial_plugin_paths);
-
-end:
-       free(argv);
-       return cfg;
-}
-
-/*
- * Prints the convert command usage.
- */
-static
-void print_convert_usage(FILE *fp)
-{
-       fprintf(fp, "Usage: babeltrace [GENERAL OPTIONS] [convert] [OPTIONS] [PATH/URL]\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Options:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "      --filter=[NAME:]PLUGIN.CLS    Instantiate a filter component from plugin\n");
-       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
-       fprintf(fp, "                                    the current component, and if NAME is\n");
-       fprintf(fp, "                                    given, set its instance name to NAME\n");
-       fprintf(fp, "      --name=NAME                   Set the name of the current component\n");
-       fprintf(fp, "                                    to NAME (must be unique amongst all the\n");
-       fprintf(fp, "                                    names of the created components)\n");
-       fprintf(fp, "      --omit-home-plugin-path       Omit home plugins from plugin search path\n");
-       fprintf(fp, "                                    (~/.local/lib/babeltrace/plugins)\n");
-       fprintf(fp, "      --omit-system-plugin-path     Omit system plugins from plugin search path\n");
-       fprintf(fp, "  -p, --params=PARAMS               Add initialization parameters PARAMS to the\n");
-       fprintf(fp, "                                    current component (see the expected format\n");
-       fprintf(fp, "                                    of PARAMS below)\n");
-       fprintf(fp, "  -P, --path=PATH                   Set the `path` string parameter of the\n");
-       fprintf(fp, "                                    current component to PATH\n");
-       fprintf(fp, "      --plugin-path=PATH[:PATH]...  Add PATH to the list of paths from which\n");
-       fprintf(fp, "                                    dynamic plugins can be loaded\n");
-       fprintf(fp, "      --run-args                    Print the equivalent arguments for the\n");
-       fprintf(fp, "                                    `run` command to the standard output,\n");
-       fprintf(fp, "                                    formatted for a shell, and quit\n");
-       fprintf(fp, "      --run-args-0                  Print the equivalent arguments for the\n");
-       fprintf(fp, "                                    `run` command to the standard output,\n");
-       fprintf(fp, "                                    formatted for `xargs -0`, and quit\n");
-       fprintf(fp, "      --sink=[NAME:]PLUGIN.CLS      Instantiate a sink component from plugin\n");
-       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
-       fprintf(fp, "                                    the current component, and if NAME is\n");
-       fprintf(fp, "                                    given, set its instance name to NAME\n");
-       fprintf(fp, "      --source=[NAME:]PLUGIN.CLS    Instantiate a source component from plugin\n");
-       fprintf(fp, "                                    PLUGIN and component class CLS, set it as\n");
-       fprintf(fp, "                                    the current component, and if NAME is\n");
-       fprintf(fp, "                                    given, set its instance name to NAME\n");
-       fprintf(fp, "  -u, --url=URL                     Set the `url` string parameter of the\n");
-       fprintf(fp, "                                    current component to URL\n");
-       fprintf(fp, "  -h  --help                        Show this help and quit\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Implicit `ctf.fs` source component options:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "      --clock-offset=SEC            Set clock offset to SEC seconds\n");
-       fprintf(fp, "      --clock-offset-ns=NS          Set clock offset to NS ns\n");
-       fprintf(fp, "      --stream-intersection         Only process events when all streams\n");
-       fprintf(fp, "                                    are active\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Implicit `text.text` sink component options:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "      --clock-cycles                Print timestamps in clock cycles\n");
-       fprintf(fp, "      --clock-date                  Print timestamp dates\n");
-       fprintf(fp, "      --clock-gmt                   Print and parse timestamps in the GMT\n");
-       fprintf(fp, "                                    time zone instead of the local time zone\n");
-       fprintf(fp, "      --clock-seconds               Print the timestamps as `SEC.NS` instead\n");
-       fprintf(fp, "                                    of `hh:mm:ss.nnnnnnnnn`\n");
-       fprintf(fp, "      --color=(never | auto | always)\n");
-       fprintf(fp, "                                    Never, automatically, or always emit\n");
-       fprintf(fp, "                                    console color codes\n");
-       fprintf(fp, "  -f, --fields=FIELD[,FIELD]...     Print additional fields; FIELD can be:\n");
-       fprintf(fp, "                                      `all`, `trace`, `trace:hostname`,\n");
-       fprintf(fp, "                                      `trace:domain`, `trace:procname`,\n");
-       fprintf(fp, "                                      `trace:vpid`, `loglevel`, `emf`\n");
-       fprintf(fp, "  -n, --names=NAME[,NAME]...        Print field names; NAME can be:\n");
-       fprintf(fp, "                                      `payload` (or `arg` or `args`), `none`,\n");
-       fprintf(fp, "                                      `all`, `scope`, `header`, `context`\n");
-       fprintf(fp, "                                      (or `ctx`)\n");
-       fprintf(fp, "      --no-delta                    Do not print time delta between\n");
-       fprintf(fp, "                                    consecutive events\n");
-       fprintf(fp, "  -w, --output=PATH                 Write output text to PATH instead of\n");
-       fprintf(fp, "                                    the standard output\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Implicit `utils.muxer` filter component options:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "      --clock-force-correlate       Assume that clocks are inherently\n");
-       fprintf(fp, "                                    correlated across traces\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Implicit `utils.trimmer` filter component options:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "  -b, --begin=BEGIN                 Set the beginning time of the conversion\n");
-       fprintf(fp, "                                    time range to BEGIN (see the format of\n");
-       fprintf(fp, "                                    BEGIN below)\n");
-       fprintf(fp, "  -e, --end=END                     Set the end time of the conversion time\n");
-       fprintf(fp, "                                    range to END (see the format of END below)\n");
-       fprintf(fp, "  -t, --timerange=TIMERANGE         Set conversion time range to TIMERANGE:\n");
-       fprintf(fp, "                                    BEGIN,END or [BEGIN,END] (literally `[` and\n");
-       fprintf(fp, "                                    `]`) (see the format of BEGIN/END below)\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Implicit `lttng-utils.debug-info` filter component options:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "      --debug-info-dir=DIR          Search for debug info in directory DIR\n");
-       fprintf(fp, "                                    instead of `/usr/lib/debug`\n");
-       fprintf(fp, "      --debug-info-full-path        Show full debug info source and\n");
-       fprintf(fp, "                                    binary paths instead of just names\n");
-       fprintf(fp, "      --debug-info-target-prefix=DIR\n");
-       fprintf(fp, "                                    Use directory DIR as a prefix when\n");
-       fprintf(fp, "                                    looking up executables during debug\n");
-       fprintf(fp, "                                    info analysis\n");
-       fprintf(fp, "      --no-debug-info               Do not create an implicit\n");
-       fprintf(fp, "                                    `lttng-utils.debug-info` filter component\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Legacy options that still work:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "  -i, --input-format=(ctf | lttng-live)\n");
-       fprintf(fp, "                                    `ctf`:\n");
-       fprintf(fp, "                                      Create an implicit `ctf.fs` source\n");
-       fprintf(fp, "                                      component\n");
-       fprintf(fp, "                                    `lttng-live`:\n");
-       fprintf(fp, "                                      Create an implicit `ctf.lttng-live`\n");
-       fprintf(fp, "                                      source component\n");
-       fprintf(fp, "  -o, --output-format=(text | dummy | ctf-metadata)\n");
-       fprintf(fp, "                                    `text`:\n");
-       fprintf(fp, "                                      Create an implicit `text.text` sink\n");
-       fprintf(fp, "                                      component\n");
-       fprintf(fp, "                                    `dummy`:\n");
-       fprintf(fp, "                                      Create an implicit `utils.dummy` sink\n");
-       fprintf(fp, "                                      component\n");
-       fprintf(fp, "                                    `ctf-metadata`:\n");
-       fprintf(fp, "                                      Query the `ctf.fs` component class for\n");
-       fprintf(fp, "                                      metadata text and quit\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "See `babeltrace --help` for the list of general options.\n");
-       fprintf(fp, "\n\n");
-       fprintf(fp, "Format of BEGIN and END\n");
-       fprintf(fp, "-----------------------\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "    [YYYY-MM-DD [hh:mm:]]ss[.nnnnnnnnn]\n");
-       fprintf(fp, "\n\n");
-       print_expected_params_format(fp);
-}
-
-static struct poptOption convert_long_options[] = {
-       /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
-       { "begin", 'b', POPT_ARG_STRING, NULL, OPT_BEGIN, NULL, NULL },
-       { "clock-cycles", '\0', POPT_ARG_NONE, NULL, OPT_CLOCK_CYCLES, NULL, NULL },
-       { "clock-date", '\0', POPT_ARG_NONE, NULL, OPT_CLOCK_DATE, NULL, NULL },
-       { "clock-force-correlate", '\0', POPT_ARG_NONE, NULL, OPT_CLOCK_FORCE_CORRELATE, NULL, NULL },
-       { "clock-gmt", '\0', POPT_ARG_NONE, NULL, OPT_CLOCK_GMT, NULL, NULL },
-       { "clock-offset", '\0', POPT_ARG_STRING, NULL, OPT_CLOCK_OFFSET, NULL, NULL },
-       { "clock-offset-ns", '\0', POPT_ARG_STRING, NULL, OPT_CLOCK_OFFSET_NS, NULL, NULL },
-       { "clock-seconds", '\0', POPT_ARG_NONE, NULL, OPT_CLOCK_SECONDS, NULL, NULL },
-       { "color", '\0', POPT_ARG_STRING, NULL, OPT_COLOR, NULL, NULL },
-       { "debug", 'd', POPT_ARG_NONE, NULL, OPT_DEBUG, NULL, NULL },
-       { "debug-info-dir", 0, POPT_ARG_STRING, NULL, OPT_DEBUG_INFO_DIR, NULL, NULL },
-       { "debug-info-full-path", 0, POPT_ARG_NONE, NULL, OPT_DEBUG_INFO_FULL_PATH, NULL, NULL },
-       { "debug-info-target-prefix", 0, POPT_ARG_STRING, NULL, OPT_DEBUG_INFO_TARGET_PREFIX, NULL, NULL },
-       { "end", 'e', POPT_ARG_STRING, NULL, OPT_END, NULL, NULL },
-       { "fields", 'f', POPT_ARG_STRING, NULL, OPT_FIELDS, NULL, NULL },
-       { "filter", '\0', POPT_ARG_STRING, NULL, OPT_FILTER, NULL, NULL },
-       { "help", 'h', POPT_ARG_NONE, NULL, OPT_HELP, NULL, NULL },
-       { "input-format", 'i', POPT_ARG_STRING, NULL, OPT_INPUT_FORMAT, NULL, NULL },
-       { "name", '\0', POPT_ARG_STRING, NULL, OPT_NAME, NULL, NULL },
-       { "names", 'n', POPT_ARG_STRING, NULL, OPT_NAMES, NULL, NULL },
-       { "no-debug-info", '\0', POPT_ARG_NONE, NULL, OPT_NO_DEBUG_INFO, NULL, NULL },
-       { "no-delta", '\0', POPT_ARG_NONE, NULL, OPT_NO_DELTA, NULL, NULL },
-       { "omit-home-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_HOME_PLUGIN_PATH, NULL, NULL },
-       { "omit-system-plugin-path", '\0', POPT_ARG_NONE, NULL, OPT_OMIT_SYSTEM_PLUGIN_PATH, NULL, NULL },
-       { "output", 'w', POPT_ARG_STRING, NULL, OPT_OUTPUT, NULL, NULL },
-       { "output-format", 'o', POPT_ARG_STRING, NULL, OPT_OUTPUT_FORMAT, NULL, NULL },
-       { "params", 'p', POPT_ARG_STRING, NULL, OPT_PARAMS, NULL, NULL },
-       { "path", 'P', POPT_ARG_STRING, NULL, OPT_PATH, NULL, NULL },
-       { "plugin-path", '\0', POPT_ARG_STRING, NULL, OPT_PLUGIN_PATH, NULL, NULL },
-       { "run-args", '\0', POPT_ARG_NONE, NULL, OPT_RUN_ARGS, NULL, NULL },
-       { "run-args-0", '\0', POPT_ARG_NONE, NULL, OPT_RUN_ARGS_0, NULL, NULL },
-       { "sink", '\0', POPT_ARG_STRING, NULL, OPT_SINK, NULL, NULL },
-       { "source", '\0', POPT_ARG_STRING, NULL, OPT_SOURCE, NULL, NULL },
-       { "stream-intersection", '\0', POPT_ARG_NONE, NULL, OPT_STREAM_INTERSECTION, NULL, NULL },
-       { "timerange", '\0', POPT_ARG_STRING, NULL, OPT_TIMERANGE, NULL, NULL },
-       { "url", 'u', POPT_ARG_STRING, NULL, OPT_URL, NULL, NULL },
-       { "verbose", 'v', POPT_ARG_NONE, NULL, OPT_VERBOSE, NULL, NULL },
-       { NULL, 0, 0, NULL, 0, NULL, NULL },
-};
-
-static
-GString *get_component_auto_name(const char *prefix,
-               struct bt_value *existing_names)
-{
-       unsigned int i = 0;
-       GString *auto_name = g_string_new(NULL);
-
-       if (!auto_name) {
-               print_err_oom();
-               goto end;
-       }
-
-       if (!bt_value_map_has_key(existing_names, prefix)) {
-               g_string_assign(auto_name, prefix);
-               goto end;
-       }
-
-       do {
-               g_string_printf(auto_name, "%s-%d", prefix, i);
-               i++;
-       } while (bt_value_map_has_key(existing_names, auto_name->str));
-
-end:
-       return auto_name;
-}
-
-struct implicit_component_args {
-       bool exists;
-       GString *plugin_comp_cls_arg;
-       GString *name_arg;
-       GString *params_arg;
-       struct bt_value *extra_args;
-};
-
-static
-int assign_name_to_implicit_component(struct implicit_component_args *args,
-               const char *prefix, struct bt_value *existing_names,
-               GList **comp_names, bool append_to_comp_names)
-{
-       int ret = 0;
-       GString *name = NULL;
-
-       if (!args->exists) {
-               goto end;
-       }
-
-       name = get_component_auto_name(prefix, existing_names);
-
-       if (!name) {
-               ret = -1;
-               goto end;
-       }
-
-       g_string_assign(args->name_arg, name->str);
-
-       if (bt_value_map_insert(existing_names, name->str,
-                       bt_value_null)) {
-               print_err_oom();
-               ret = -1;
-               goto end;
-       }
-
-       if (append_to_comp_names) {
-               *comp_names = g_list_append(*comp_names, name);
-               name = NULL;
-       }
-
-end:
-       if (name) {
-               g_string_free(name, TRUE);
-       }
-
-       return ret;
-}
-
-static
-int append_run_args_for_implicit_component(
-               enum bt_component_class_type type,
-               struct implicit_component_args *impl_args,
-               struct bt_value *run_args)
-{
-       int ret = 0;
-       size_t i;
-
-       if (!impl_args->exists) {
-               goto end;
-       }
-
-       switch (type) {
-       case BT_COMPONENT_CLASS_TYPE_SOURCE:
-               if (bt_value_array_append_string(run_args, "--source")) {
-                       print_err_oom();
-                       goto error;
-               }
-               break;
-       case BT_COMPONENT_CLASS_TYPE_FILTER:
-               if (bt_value_array_append_string(run_args, "--filter")) {
-                       print_err_oom();
-                       goto error;
-               }
-               break;
-       case BT_COMPONENT_CLASS_TYPE_SINK:
-               if (bt_value_array_append_string(run_args, "--sink")) {
-                       print_err_oom();
-                       goto error;
-               }
-               break;
-       default:
-               assert(false);
-       }
-
-       if (bt_value_array_append_string(run_args,
-                       impl_args->plugin_comp_cls_arg->str)) {
-               print_err_oom();
-               goto error;
-       }
-
-       if (bt_value_array_append_string(run_args, "--name")) {
-               print_err_oom();
-               goto error;
-       }
-
-       if (bt_value_array_append_string(run_args, impl_args->name_arg->str)) {
-               print_err_oom();
-               goto error;
-       }
-
-       if (impl_args->params_arg->len > 0) {
-               if (bt_value_array_append_string(run_args, "--params")) {
-                       print_err_oom();
-                       goto error;
-               }
-
-               if (bt_value_array_append_string(run_args,
-                               impl_args->params_arg->str)) {
-                       print_err_oom();
-                       goto error;
-               }
-       }
-
-       for (i = 0; i < bt_value_array_size(impl_args->extra_args); i++) {
-               struct bt_value *elem;
-               const char *arg;
-
-               elem = bt_value_array_get(impl_args->extra_args, i);
-               if (!elem) {
-                       goto error;
-               }
-
-               assert(bt_value_is_string(elem));
-               if (bt_value_string_get(elem, &arg)) {
-                       goto error;
-               }
-
-               ret = bt_value_array_append_string(run_args, arg);
-               bt_put(elem);
-               if (ret) {
-                       print_err_oom();
-                       goto error;
-               }
-       }
-
-       goto end;
-
-error:
-       ret = -1;
-
-end:
-       return ret;
-}
-
-static
-void destroy_implicit_component_args(struct implicit_component_args *args)
-{
-       assert(args);
-
-       if (args->plugin_comp_cls_arg) {
-               g_string_free(args->plugin_comp_cls_arg, TRUE);
-       }
-
-       if (args->name_arg) {
-               g_string_free(args->name_arg, TRUE);
-       }
-
-       if (args->params_arg) {
-               g_string_free(args->params_arg, TRUE);
-       }
-
-       bt_put(args->extra_args);
-}
-
-static
-int init_implicit_component_args(struct implicit_component_args *args,
-               const char *plugin_comp_cls_arg, bool exists)
-{
-       int ret = 0;
-
-       args->exists = exists;
-       args->plugin_comp_cls_arg = g_string_new(plugin_comp_cls_arg);
-       args->name_arg = g_string_new(NULL);
-       args->params_arg = g_string_new(NULL);
-       args->extra_args = bt_value_array_create();
-
-       if (!args->plugin_comp_cls_arg || !args->name_arg ||
-                       !args->params_arg || !args->extra_args) {
-               ret = -1;
-               destroy_implicit_component_args(args);
-               print_err_oom();
-               goto end;
-       }
-
-end:
-       return ret;
-}
-
-static
-void append_implicit_component_param(struct implicit_component_args *args,
-       const char *key, const char *value)
-{
-       assert(args);
-       assert(key);
-       assert(value);
-       append_param_arg(args->params_arg, key, value);
-}
-
-static
-int append_implicit_component_extra_arg(struct implicit_component_args *args,
-               const char *key, const char *value)
-{
-       int ret = 0;
-
-       assert(args);
-       assert(key);
-       assert(value);
-
-       if (bt_value_array_append_string(args->extra_args, "--key")) {
-               print_err_oom();
-               ret = -1;
-               goto end;
-       }
-
-       if (bt_value_array_append_string(args->extra_args, key)) {
-               print_err_oom();
-               ret = -1;
-               goto end;
-       }
-
-       if (bt_value_array_append_string(args->extra_args, "--value")) {
-               print_err_oom();
-               ret = -1;
-               goto end;
-       }
-
-       if (bt_value_array_append_string(args->extra_args, value)) {
-               print_err_oom();
-               ret = -1;
-               goto end;
-       }
-
-end:
-       return ret;
-}
-
-static
-int convert_append_name_param(enum bt_config_component_dest dest,
-               GString *cur_name, GString *cur_name_prefix,
-               struct bt_value *run_args, struct bt_value *all_names,
-               GList **source_names, GList **filter_names,
-               GList **sink_names)
-{
-       int ret = 0;
-
-       if (cur_name_prefix->len > 0) {
-               /* We're after a --source/--filter/--sink */
-               GString *name = NULL;
-               bool append_name_opt = false;
-
-               if (cur_name->len == 0) {
-                       /*
-                        * No explicit name was provided for the user
-                        * component.
-                        */
-                       name = get_component_auto_name(
-                               cur_name_prefix->str,
-                               all_names);
-                       append_name_opt = true;
-               } else {
-                       /*
-                        * An explicit name was provided for the user
-                        * component.
-                        */
-                       if (bt_value_map_has_key(all_names,
-                                       cur_name->str)) {
-                               printf_err("Duplicate component instance name:\n    %s\n",
-                                       cur_name->str);
-                               goto error;
-                       }
-
-                       name = g_string_new(cur_name->str);
-               }
-
-               if (!name) {
-                       print_err_oom();
-                       goto error;
-               }
-
-               /*
-                * Remember this name globally, for the uniqueness of
-                * all component names.
-                */
-               if (bt_value_map_insert(all_names, name->str, bt_value_null)) {
-                       print_err_oom();
-                       goto error;
-               }
-
-               /*
-                * Append the --name option if necessary.
-                */
-               if (append_name_opt) {
-                       if (bt_value_array_append_string(run_args, "--name")) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, name->str)) {
-                               print_err_oom();
-                               goto error;
-                       }
-               }
-
-               /*
-                * Remember this name specifically for the type of the
-                * component. This is to create connection arguments.
-                */
-               switch (dest) {
-               case BT_CONFIG_COMPONENT_DEST_SOURCE:
-                       *source_names = g_list_append(*source_names, name);
-                       break;
-               case BT_CONFIG_COMPONENT_DEST_FILTER:
-                       *filter_names = g_list_append(*filter_names, name);
-                       break;
-               case BT_CONFIG_COMPONENT_DEST_SINK:
-                       *sink_names = g_list_append(*sink_names, name);
-                       break;
-               default:
-                       assert(false);
-               }
-
-               g_string_assign(cur_name_prefix, "");
-       }
-
-       goto end;
-
-error:
-       ret = -1;
-
-end:
-       return ret;
-}
-
-/*
- * Escapes `.`, `:`, and `\` of `input` with `\`.
- */
-GString *escape_dot_colon(const char *input)
-{
-       GString *output = g_string_new(NULL);
-       const char *ch;
-
-       if (!output) {
-               print_err_oom();
-               goto end;
-       }
-
-       for (ch = input; *ch != '\0'; ch++) {
-               if (*ch == '\\' || *ch == '.' || *ch == ':') {
-                       g_string_append_c(output, '\\');
-               }
-
-               g_string_append_c(output, *ch);
-       }
-
-end:
-       return output;
-}
-
-/*
- * Appends a --connect option to a list of arguments. `upstream_name`
- * and `downstream_name` are escaped with escape_dot_colon() in this
- * function.
- */
-int append_connect_arg(struct bt_value *run_args,
-               const char *upstream_name, const char *downstream_name)
-{
-       int ret = 0;
-       GString *e_upstream_name = escape_dot_colon(upstream_name);
-       GString *e_downstream_name = escape_dot_colon(downstream_name);
-       GString *arg = g_string_new(NULL);
-
-       if (!e_upstream_name || !e_downstream_name || !arg) {
-               print_err_oom();
-               ret = -1;
-               goto end;
-       }
-
-       ret = bt_value_array_append_string(run_args, "--connect");
-       if (ret) {
-               print_err_oom();
-               ret = -1;
-               goto end;
-       }
-
-       g_string_append(arg, e_upstream_name->str);
-       g_string_append_c(arg, ':');
-       g_string_append(arg, e_downstream_name->str);
-       ret = bt_value_array_append_string(run_args, arg->str);
-       if (ret) {
-               print_err_oom();
-               ret = -1;
-               goto end;
-       }
-
-end:
-       if (arg) {
-               g_string_free(arg, TRUE);
-       }
-
-       if (e_upstream_name) {
-               g_string_free(e_upstream_name, TRUE);
-       }
-
-       if (e_downstream_name) {
-               g_string_free(e_downstream_name, TRUE);
-       }
-
-       return ret;
-}
-
-/*
- * Appends the run command's --connect options for the convert command.
- */
-int convert_auto_connect(struct bt_value *run_args,
-               GList *source_names, GList *filter_names,
-               GList *sink_names)
-{
-       int ret = 0;
-       GList *source_at = source_names;
-       GList *filter_at = filter_names;
-       GList *filter_prev;
-       GList *sink_at = sink_names;
-
-       assert(source_names);
-       assert(filter_names);
-       assert(sink_names);
-
-       /* Connect all sources to the first filter */
-       for (source_at = source_names; source_at != NULL; source_at = g_list_next(source_at)) {
-               GString *source_name = source_at->data;
-               GString *filter_name = filter_at->data;
-
-               ret = append_connect_arg(run_args, source_name->str,
-                       filter_name->str);
-               if (ret) {
-                       goto error;
-               }
-       }
-
-       filter_prev = filter_at;
-       filter_at = g_list_next(filter_at);
-
-       /* Connect remaining filters */
-       for (; filter_at != NULL; filter_prev = filter_at, filter_at = g_list_next(filter_at)) {
-               GString *filter_name = filter_at->data;
-               GString *filter_prev_name = filter_prev->data;
-
-               ret = append_connect_arg(run_args, filter_prev_name->str,
-                       filter_name->str);
-               if (ret) {
-                       goto error;
-               }
-       }
-
-       /* Connect last filter to all sinks */
-       for (sink_at = sink_names; sink_at != NULL; sink_at = g_list_next(sink_at)) {
-               GString *filter_name = filter_prev->data;
-               GString *sink_name = sink_at->data;
-
-               ret = append_connect_arg(run_args, filter_name->str,
-                       sink_name->str);
-               if (ret) {
-                       goto error;
-               }
-       }
-
-       goto end;
-
-error:
-       ret = -1;
-
-end:
-       return ret;
-}
-
-static int split_timerange(const char *arg, char **begin, char **end)
-{
-       int ret = 0;
-       const char *ch = arg;
-       size_t end_pos;
-       GString *g_begin = NULL;
-       GString *g_end = NULL;
-
-       assert(arg);
-
-       if (*ch == '[') {
-               ch++;
-       }
-
-       g_begin = bt_common_string_until(ch, "", ",", &end_pos);
-       if (!g_begin || ch[end_pos] != ',' || g_begin->len == 0) {
-               goto error;
-       }
-
-       ch += end_pos + 1;
-
-       g_end = bt_common_string_until(ch, "", "]", &end_pos);
-       if (!g_end || g_end->len == 0) {
-               goto error;
-       }
-
-       assert(begin);
-       assert(end);
-       *begin = g_begin->str;
-       *end = g_end->str;
-       g_string_free(g_begin, FALSE);
-       g_string_free(g_end, FALSE);
-       g_begin = NULL;
-       g_end = NULL;
-       goto end;
-
-error:
-       ret = -1;
-
-end:
-       if (g_begin) {
-               g_string_free(g_begin, TRUE);
-       }
-
-       if (g_end) {
-               g_string_free(g_end, TRUE);
-       }
-
-       return ret;
-}
-
-static
-int g_list_prepend_gstring(GList **list, const char *string)
-{
-       int ret = 0;
-       GString *gs = g_string_new(string);
-
-       assert(list);
-
-       if (!gs) {
-               print_err_oom();
-               goto end;
-       }
-
-       *list = g_list_prepend(*list, gs);
-
-end:
-       return ret;
-}
-
-/*
- * Creates a Babeltrace config object from the arguments of a convert
- * command.
- *
- * *retcode is set to the appropriate exit code to use.
- */
-static
-struct bt_config *bt_config_convert_from_args(int argc, const char *argv[],
-               int *retcode, bool omit_system_plugin_path,
-               bool omit_home_plugin_path,
-               struct bt_value *initial_plugin_paths)
-{
-       poptContext pc = NULL;
-       char *arg = NULL;
-       enum bt_config_component_dest cur_comp_dest;
-       int opt, ret = 0;
-       struct bt_config *cfg = NULL;
-       bool got_verbose_opt = false;
-       bool got_debug_opt = false;
-       bool got_input_format_opt = false;
-       bool got_output_format_opt = false;
-       bool trimmer_has_begin = false;
-       bool trimmer_has_end = false;
-       GString *cur_name = NULL;
-       GString *cur_name_prefix = NULL;
-       const char *leftover = NULL;
-       bool print_run_args = false;
-       bool print_run_args_0 = false;
-       bool print_ctf_metadata = false;
-       struct bt_value *run_args = NULL;
-       struct bt_value *all_names = NULL;
-       GList *source_names = NULL;
-       GList *filter_names = NULL;
-       GList *sink_names = NULL;
-       struct implicit_component_args implicit_ctf_args = { 0 };
-       struct implicit_component_args implicit_lttng_live_args = { 0 };
-       struct implicit_component_args implicit_dummy_args = { 0 };
-       struct implicit_component_args implicit_text_args = { 0 };
-       struct implicit_component_args implicit_debug_info_args = { 0 };
-       struct implicit_component_args implicit_muxer_args = { 0 };
-       struct implicit_component_args implicit_trimmer_args = { 0 };
-       struct bt_value *plugin_paths = bt_get(initial_plugin_paths);
-       char error_buf[256] = { 0 };
-       size_t i;
-       struct bt_common_lttng_live_url_parts lttng_live_url_parts = { 0 };
-
-       *retcode = 0;
-
-       if (argc <= 1) {
-               print_convert_usage(stdout);
-               *retcode = -1;
-               goto end;
-       }
-
-       if (init_implicit_component_args(&implicit_ctf_args, "ctf.fs", false)) {
-               goto error;
-       }
-
-       if (init_implicit_component_args(&implicit_lttng_live_args,
-                       "ctf.lttng-live", false)) {
-               goto error;
-       }
-
-       if (init_implicit_component_args(&implicit_text_args, "text.text",
-                       false)) {
-               goto error;
-       }
-
-       if (init_implicit_component_args(&implicit_dummy_args, "utils.dummy",
-                       false)) {
-               goto error;
-       }
-
-       if (init_implicit_component_args(&implicit_debug_info_args,
-                       "lttng-utils.debug-info", true)) {
-               goto error;
-       }
-
-       if (init_implicit_component_args(&implicit_muxer_args, "utils.muxer",
-                       true)) {
-               goto error;
-       }
-
-       if (init_implicit_component_args(&implicit_trimmer_args,
-                       "utils.trimmer", false)) {
-               goto error;
-       }
-
-       all_names = bt_value_map_create();
-       if (!all_names) {
-               print_err_oom();
-               goto error;
-       }
-
-       run_args = bt_value_array_create();
-       if (!run_args) {
-               print_err_oom();
-               goto error;
-       }
-
-       cur_name = g_string_new(NULL);
-       if (!cur_name) {
-               print_err_oom();
-               goto error;
-       }
-
-       cur_name_prefix = g_string_new(NULL);
-       if (!cur_name_prefix) {
-               print_err_oom();
-               goto error;
-       }
-
-       ret = append_env_var_plugin_paths(plugin_paths);
-       if (ret) {
-               goto error;
-       }
-
-       /*
-        * First pass: collect all arguments which need to be passed
-        * as is to the run command. This pass can also add --name
-        * arguments if needed to automatically name unnamed component
-        * instances. Also it does the following transformations:
-        *
-        *     --path=PATH -> --key path --value PATH
-        *     --url=URL   -> --key url --value URL
-        *
-        * Also it appends the plugin paths of --plugin-path to
-        * `plugin_paths`.
-        */
-       pc = poptGetContext(NULL, argc, (const char **) argv,
-               convert_long_options, 0);
-       if (!pc) {
-               printf_err("Cannot get popt context\n");
-               goto error;
-       }
-
-       poptReadDefaultConfig(pc, 0);
-
-       while ((opt = poptGetNextOpt(pc)) > 0) {
-               char *name = NULL;
-               char *plugin_name = NULL;
-               char *comp_cls_name = NULL;
-
-               arg = poptGetOptArg(pc);
-
-               switch (opt) {
-               case OPT_SOURCE:
-               case OPT_FILTER:
-               case OPT_SINK:
-                       /* Append current component's name if needed */
-                       ret = convert_append_name_param(cur_comp_dest, cur_name,
-                               cur_name_prefix, run_args, all_names,
-                               &source_names, &filter_names, &sink_names);
-                       if (ret) {
-                               goto error;
-                       }
-
-                       /* Parse the argument */
-                       plugin_comp_cls_names(arg, &name, &plugin_name,
-                               &comp_cls_name);
-                       if (!plugin_name || !comp_cls_name) {
-                               printf_err("Invalid format for --source/--filter/--sink option's argument:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       if (name) {
-                               g_string_assign(cur_name, name);
-                       } else {
-                               g_string_assign(cur_name, "");
-                       }
-
-                       switch (opt) {
-                       case OPT_SOURCE:
-                               cur_comp_dest =
-                                       BT_CONFIG_COMPONENT_DEST_SOURCE;
-                               if (bt_value_array_append_string(run_args,
-                                               "--source")) {
-                                       print_err_oom();
-                                       goto error;
-                               }
-                               break;
-                       case OPT_FILTER:
-                               cur_comp_dest =
-                                       BT_CONFIG_COMPONENT_DEST_FILTER;
-                               if (bt_value_array_append_string(run_args,
-                                               "--filter")) {
-                                       print_err_oom();
-                                       goto error;
-                               }
-                               break;
-                       case OPT_SINK:
-                               cur_comp_dest =
-                                       BT_CONFIG_COMPONENT_DEST_SINK;
-                               if (bt_value_array_append_string(run_args,
-                                               "--sink")) {
-                                       print_err_oom();
-                                       goto error;
-                               }
-                               break;
-                       default:
-                               assert(false);
-                       }
-
-                       if (bt_value_array_append_string(run_args, arg)) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       g_string_assign(cur_name_prefix, "");
-                       g_string_append(cur_name_prefix, plugin_name);
-                       g_string_append_c(cur_name_prefix, '.');
-                       g_string_append(cur_name_prefix, comp_cls_name);
-                       free(name);
-                       free(plugin_name);
-                       free(comp_cls_name);
-                       name = NULL;
-                       plugin_name = NULL;
-                       comp_cls_name = NULL;
-                       break;
-               case OPT_PARAMS:
-                       if (cur_name_prefix->len == 0) {
-                               printf_err("No current component of which to set parameters:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args,
-                                       "--params")) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, arg)) {
-                               print_err_oom();
-                               goto error;
-                       }
-                       break;
-               case OPT_PATH:
-                       if (cur_name_prefix->len == 0) {
-                               printf_err("No current component of which to set `path` parameter:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, "--key")) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, "path")) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, "--value")) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, arg)) {
-                               print_err_oom();
-                               goto error;
-                       }
-                       break;
-               case OPT_URL:
-                       if (cur_name_prefix->len == 0) {
-                               printf_err("No current component of which to set `url` parameter:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, "--key")) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, "url")) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, "--value")) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, arg)) {
-                               print_err_oom();
-                               goto error;
-                       }
-                       break;
-               case OPT_NAME:
-                       if (cur_name_prefix->len == 0) {
-                               printf_err("No current component to name:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, "--name")) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, arg)) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       g_string_assign(cur_name, arg);
-                       break;
-               case OPT_OMIT_HOME_PLUGIN_PATH:
-                       if (bt_value_array_append_string(run_args,
-                                       "--omit-home-plugin-path")) {
-                               print_err_oom();
-                               goto error;
-                       }
-                       break;
-               case OPT_OMIT_SYSTEM_PLUGIN_PATH:
-                       if (bt_value_array_append_string(run_args,
-                                       "--omit-system-plugin-path")) {
-                               print_err_oom();
-                               goto error;
-                       }
-                       break;
-               case OPT_PLUGIN_PATH:
-                       if (bt_config_append_plugin_paths_check_setuid_setgid(
-                                       plugin_paths, arg)) {
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args,
-                                       "--plugin-path")) {
-                               print_err_oom();
-                               goto error;
-                       }
-
-                       if (bt_value_array_append_string(run_args, arg)) {
-                               print_err_oom();
-                               goto error;
-                       }
-                       break;
-               case OPT_HELP:
-                       print_convert_usage(stdout);
-                       *retcode = -1;
-                       BT_PUT(cfg);
-                       goto end;
-               case OPT_BEGIN:
-               case OPT_CLOCK_CYCLES:
-               case OPT_CLOCK_DATE:
-               case OPT_CLOCK_FORCE_CORRELATE:
-               case OPT_CLOCK_GMT:
-               case OPT_CLOCK_OFFSET:
-               case OPT_CLOCK_OFFSET_NS:
-               case OPT_CLOCK_SECONDS:
-               case OPT_COLOR:
-               case OPT_DEBUG:
-               case OPT_DEBUG_INFO_DIR:
-               case OPT_DEBUG_INFO_FULL_PATH:
-               case OPT_DEBUG_INFO_TARGET_PREFIX:
-               case OPT_END:
-               case OPT_FIELDS:
-               case OPT_INPUT_FORMAT:
-               case OPT_NAMES:
-               case OPT_NO_DEBUG_INFO:
-               case OPT_NO_DELTA:
-               case OPT_OUTPUT_FORMAT:
-               case OPT_OUTPUT:
-               case OPT_RUN_ARGS:
-               case OPT_RUN_ARGS_0:
-               case OPT_STREAM_INTERSECTION:
-               case OPT_TIMERANGE:
-               case OPT_VERBOSE:
-                       /* Ignore in this pass */
-                       break;
-               default:
-                       printf_err("Unknown command-line option specified (option code %d)\n",
-                               opt);
-                       goto error;
-               }
-
-               free(arg);
-               arg = NULL;
-       }
-
-       /* Append current component's name if needed */
-       ret = convert_append_name_param(cur_comp_dest, cur_name,
-               cur_name_prefix, run_args, all_names, &source_names,
-               &filter_names, &sink_names);
-       if (ret) {
-               goto error;
-       }
-
-       /* Check for option parsing error */
-       if (opt < -1) {
-               printf_err("While parsing command-line options, at option %s: %s\n",
-                       poptBadOption(pc, 0), poptStrerror(opt));
-               goto error;
-       }
-
-       poptFreeContext(pc);
-       free(arg);
-       arg = NULL;
-
-       /*
-        * Second pass: transform the convert-specific options and
-        * arguments into implicit component instances for the run
-        * command.
-        */
-       pc = poptGetContext(NULL, argc, (const char **) argv,
-               convert_long_options, 0);
-       if (!pc) {
-               printf_err("Cannot get popt context\n");
-               goto error;
-       }
-
-       poptReadDefaultConfig(pc, 0);
-
-       while ((opt = poptGetNextOpt(pc)) > 0) {
-               arg = poptGetOptArg(pc);
-
-               switch (opt) {
-               case OPT_BEGIN:
-                       if (trimmer_has_begin) {
-                               printf("At --begin option: --begin or --timerange option already specified\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       trimmer_has_begin = true;
-                       ret = append_implicit_component_extra_arg(
-                               &implicit_trimmer_args, "begin", arg);
-                       implicit_trimmer_args.exists = true;
-                       if (ret) {
-                               goto error;
-                       }
-                       break;
-               case OPT_END:
-                       if (trimmer_has_end) {
-                               printf("At --end option: --end or --timerange option already specified\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       trimmer_has_end = true;
-                       ret = append_implicit_component_extra_arg(
-                               &implicit_trimmer_args, "end", arg);
-                       implicit_trimmer_args.exists = true;
-                       if (ret) {
-                               goto error;
-                       }
-                       break;
-               case OPT_TIMERANGE:
-               {
-                       char *begin;
-                       char *end;
-
-                       if (trimmer_has_begin || trimmer_has_end) {
-                               printf("At --timerange option: --begin, --end, or --timerange option already specified\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       ret = split_timerange(arg, &begin, &end);
-                       if (ret) {
-                               printf_err("Invalid --timerange option's argument: expecting BEGIN,END or [BEGIN,END]:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-
-                       ret = append_implicit_component_extra_arg(
-                               &implicit_trimmer_args, "begin", begin);
-                       ret |= append_implicit_component_extra_arg(
-                               &implicit_trimmer_args, "end", end);
-                       implicit_trimmer_args.exists = true;
-                       free(begin);
-                       free(end);
-                       if (ret) {
-                               goto error;
-                       }
-                       break;
-               }
-               case OPT_CLOCK_CYCLES:
-                       append_implicit_component_param(
-                               &implicit_text_args, "clock-cycles", "yes");
-                       implicit_text_args.exists = true;
-                       break;
-               case OPT_CLOCK_DATE:
-                       append_implicit_component_param(
-                               &implicit_text_args, "clock-date", "yes");
-                       implicit_text_args.exists = true;
-                       break;
-               case OPT_CLOCK_FORCE_CORRELATE:
-                       append_implicit_component_param(
-                               &implicit_muxer_args, "force-correlate", "yes");
-                       break;
-               case OPT_CLOCK_GMT:
-                       append_implicit_component_param(
-                               &implicit_text_args, "clock-gmt", "yes");
-                       implicit_text_args.exists = true;
-                       break;
-               case OPT_CLOCK_OFFSET:
-                       ret = append_implicit_component_extra_arg(
-                               &implicit_ctf_args, "clock-offset-cycles", arg);
-                       implicit_ctf_args.exists = true;
-                       if (ret) {
-                               goto error;
-                       }
-                       break;
-               case OPT_CLOCK_OFFSET_NS:
-                       ret = append_implicit_component_extra_arg(
-                               &implicit_ctf_args, "clock-offset-ns", arg);
-                       implicit_ctf_args.exists = true;
-                       if (ret) {
-                               goto error;
-                       }
-                       break;
-               case OPT_CLOCK_SECONDS:
-                       append_implicit_component_param(
-                               &implicit_text_args, "clock-seconds", "yes");
-                       implicit_text_args.exists = true;
-                       break;
-               case OPT_COLOR:
-                       ret = append_implicit_component_extra_arg(
-                               &implicit_text_args, "color", arg);
-                       implicit_text_args.exists = true;
-                       if (ret) {
-                               goto error;
-                       }
-                       break;
-               case OPT_NO_DEBUG_INFO:
-                       implicit_debug_info_args.exists = false;
-                       break;
-               case OPT_DEBUG_INFO_DIR:
-                       ret = append_implicit_component_extra_arg(
-                               &implicit_debug_info_args, "dir", arg);
-                       if (ret) {
-                               goto error;
-                       }
-                       break;
-               case OPT_DEBUG_INFO_FULL_PATH:
-                       append_implicit_component_param(
-                               &implicit_debug_info_args, "full-path", "yes");
-                       break;
-               case OPT_DEBUG_INFO_TARGET_PREFIX:
-                       ret = append_implicit_component_extra_arg(
-                               &implicit_debug_info_args,
-                               "target-prefix", arg);
-                       if (ret) {
-                               goto error;
-                       }
-                       break;
-               case OPT_FIELDS:
-               {
-                       struct bt_value *fields = fields_from_arg(arg);
-
-                       if (!fields) {
-                               goto error;
-                       }
-
-                       ret = insert_flat_params_from_array(
-                               implicit_text_args.params_arg,
-                               fields, "field");
-                       bt_put(fields);
-                       if (ret) {
-                               goto error;
-                       }
-                       break;
-               }
-               case OPT_NAMES:
-               {
-                       struct bt_value *names = names_from_arg(arg);
-
-                       if (!names) {
-                               goto error;
-                       }
-
-                       ret = insert_flat_params_from_array(
-                               implicit_text_args.params_arg,
-                               names, "name");
-                       bt_put(names);
-                       if (ret) {
-                               goto error;
-                       }
-                       break;
-               }
-               case OPT_NO_DELTA:
-                       append_implicit_component_param(
-                               &implicit_text_args, "no-delta", "yes");
-                       implicit_text_args.exists = true;
-                       break;
-               case OPT_INPUT_FORMAT:
-                       if (got_input_format_opt) {
-                               printf_err("Duplicate --input-format option\n");
-                               goto error;
-                       }
-
-                       got_input_format_opt = true;
-
-                       if (strcmp(arg, "ctf") == 0) {
-                               implicit_ctf_args.exists = true;
-                       } else if (strcmp(arg, "lttng-live") == 0) {
-                               implicit_lttng_live_args.exists = true;
-                       } else {
-                               printf_err("Unknown legacy input format:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-                       break;
-               case OPT_OUTPUT_FORMAT:
-                       if (got_output_format_opt) {
-                               printf_err("Duplicate --output-format option\n");
-                               goto error;
-                       }
-
-                       got_output_format_opt = true;
-
-                       if (strcmp(arg, "text") == 0) {
-                               implicit_text_args.exists = true;
-                       } else if (strcmp(arg, "dummy") == 0) {
-                               implicit_dummy_args.exists = true;
-                       } else if (strcmp(arg, "ctf-metadata") == 0) {
-                               print_ctf_metadata = true;
-                       } else {
-                               printf_err("Unknown legacy output format:\n    %s\n",
-                                       arg);
-                               goto error;
-                       }
-                       break;
-               case OPT_OUTPUT:
-                       ret = append_implicit_component_extra_arg(
-                               &implicit_text_args, "path", arg);
-                       implicit_text_args.exists = true;
-                       if (ret) {
-                               goto error;
-                       }
-                       break;
-               case OPT_RUN_ARGS:
-                       if (print_run_args_0) {
-                               printf_err("Cannot specify --run-args and --run-args-0\n");
-                               goto error;
-                       }
-
-                       print_run_args = true;
-                       break;
-               case OPT_RUN_ARGS_0:
-                       if (print_run_args) {
-                               printf_err("Cannot specify --run-args and --run-args-0\n");
-                               goto error;
-                       }
-
-                       print_run_args_0 = true;
-                       break;
-               case OPT_STREAM_INTERSECTION:
-                       append_implicit_component_param(&implicit_ctf_args,
-                               "stream-intersection", "yes");
-                       implicit_ctf_args.exists = true;
-                       break;
-               case OPT_VERBOSE:
-                       if (got_verbose_opt) {
-                               printf_err("Duplicate -v/--verbose option\n");
-                               goto error;
-                       }
-
-                       append_implicit_component_param(&implicit_text_args,
-                               "verbose", "yes");
-                       implicit_text_args.exists = true;
-                       got_verbose_opt = true;
-                       break;
-               case OPT_DEBUG:
-                       got_debug_opt = true;
-                       break;
-               }
-
-               free(arg);
-               arg = NULL;
-       }
-
-       /* Check for option parsing error */
-       if (opt < -1) {
-               printf_err("While parsing command-line options, at option %s: %s\n",
-                       poptBadOption(pc, 0), poptStrerror(opt));
-               goto error;
-       }
-
-       /*
-        * Append home and system plugin paths now that we possibly got
-        * --plugin-path.
-        */
-       if (append_home_and_system_plugin_paths(plugin_paths,
-                       omit_system_plugin_path, omit_home_plugin_path)) {
-               goto error;
-       }
-
-       /* Consume leftover argument */
-       leftover = poptGetArg(pc);
-
-       if (poptPeekArg(pc)) {
-               printf_err("Unexpected argument:\n    %s\n",
-                       poptPeekArg(pc));
-               goto error;
-       }
-
-       /* Print CTF metadata or print LTTng-live sessions */
-       if (print_ctf_metadata) {
-               if (!leftover) {
-                       printf_err("--output-format=ctf-metadata specified without a path\n");
-                       goto error;
-               }
-
-               cfg = bt_config_print_ctf_metadata_create(plugin_paths);
-               if (!cfg) {
-                       goto error;
-               }
-
-               cfg->debug = got_debug_opt;
-               cfg->verbose = got_verbose_opt;
-               g_string_assign(cfg->cmd_data.print_ctf_metadata.path,
-                       leftover);
-               goto end;
-       }
-
-       /*
-        * If -o dummy was not specified, and if there are no explicit
-        * sink components, then use an implicit `text.text` sink.
-        */
-       if (!implicit_dummy_args.exists && !sink_names) {
-               implicit_text_args.exists = true;
-       }
-
-       /* Decide where the leftover argument goes */
-       if (leftover) {
-               if (implicit_lttng_live_args.exists) {
-                       lttng_live_url_parts =
-                               bt_common_parse_lttng_live_url(leftover,
-                                       error_buf, 256);
-                       if (!lttng_live_url_parts.proto) {
-                               printf_err("Invalid LTTng-live URL format: %s\n",
-                                       error_buf);
-                               goto error;
-                       }
-
-                       if (!lttng_live_url_parts.session_name) {
-                               /* Print LTTng-live sessions */
-                               cfg = bt_config_print_lttng_live_sessions_create(
-                                       plugin_paths);
-                               if (!cfg) {
-                                       goto error;
-                               }
-
-                               cfg->debug = got_debug_opt;
-                               cfg->verbose = got_verbose_opt;
-                               g_string_assign(cfg->cmd_data.print_lttng_live_sessions.url,
-                                       leftover);
-                               goto end;
-                       }
-
-                       ret = append_implicit_component_extra_arg(
-                               &implicit_lttng_live_args, "url", leftover);
-                       if (ret) {
-                               goto error;
-                       }
-               } else {
-                       ret = append_implicit_component_extra_arg(
-                               &implicit_ctf_args, "path", leftover);
-                       implicit_ctf_args.exists = true;
-                       if (ret) {
-                               goto error;
-                       }
-               }
-       }
-
-       /*
-        * Ensure mutual exclusion between implicit `ctf.fs` and
-        * `ctf.lttng-live` sources.
-        */
-       if (implicit_ctf_args.exists && implicit_lttng_live_args.exists) {
-               printf_err("Cannot create both implicit `ctf.fs` and `ctf.lttng-live` source components\n");
-               goto error;
-       }
-
-       /*
-        * If the implicit `ctf.fs` or `ctf.lttng-live` source exists,
-        * make sure there's a leftover (which is the path or URL).
-        */
-       if (implicit_ctf_args.exists && !leftover) {
-               printf_err("Missing path for implicit `ctf.fs` source component\n");
-               goto error;
-       }
-
-       if (implicit_lttng_live_args.exists && !leftover) {
-               printf_err("Missing URL for implicit `ctf.lttng-live` source component\n");
-               goto error;
-       }
-
-       /* Assign names to implicit components */
-       ret = assign_name_to_implicit_component(&implicit_ctf_args,
-               "ctf", all_names, &source_names, true);
-       if (ret) {
-               goto error;
-       }
-
-       ret = assign_name_to_implicit_component(&implicit_lttng_live_args,
-               "lttng-live", all_names, &source_names, true);
-       if (ret) {
-               goto error;
-       }
-
-       ret = assign_name_to_implicit_component(&implicit_text_args,
-               "text", all_names, &sink_names, true);
-       if (ret) {
-               goto error;
-       }
-
-       ret = assign_name_to_implicit_component(&implicit_dummy_args,
-               "dummy", all_names, &sink_names, true);
-       if (ret) {
-               goto error;
-       }
-
-       ret = assign_name_to_implicit_component(&implicit_muxer_args,
-               "mux", all_names, NULL, false);
-       if (ret) {
-               goto error;
-       }
-
-       ret = assign_name_to_implicit_component(&implicit_trimmer_args,
-               "trim", all_names, NULL, false);
-       if (ret) {
-               goto error;
-       }
-
-       ret = assign_name_to_implicit_component(&implicit_debug_info_args,
-               "debug-info", all_names, NULL, false);
-       if (ret) {
-               goto error;
-       }
-
-       /* Make sure there's at least one source and one sink */
-       if (!source_names) {
-               printf_err("No source component\n");
-               goto error;
-       }
-
-       if (!sink_names) {
-               printf_err("No sink component\n");
-               goto error;
-       }
-
-       /*
-        * Prepend the muxer, the trimmer, and the debug info to the
-        * filter chain so that we have:
-        *
-        *     sources -> muxer -> [trimmer] -> [debug info] ->
-        *                [user filters] -> sinks
-        */
-       if (implicit_debug_info_args.exists) {
-               if (g_list_prepend_gstring(&filter_names,
-                               implicit_debug_info_args.name_arg->str)) {
-                       goto error;
-               }
-       }
-
-       if (implicit_trimmer_args.exists) {
-               if (g_list_prepend_gstring(&filter_names,
-                               implicit_trimmer_args.name_arg->str)) {
-                       goto error;
-               }
-       }
-
-       if (g_list_prepend_gstring(&filter_names,
-                       implicit_muxer_args.name_arg->str)) {
-               goto error;
-       }
-
-       /*
-        * Append the equivalent run arguments for the implicit
-        * components.
-        */
-       ret = append_run_args_for_implicit_component(
-               BT_COMPONENT_CLASS_TYPE_SOURCE, &implicit_ctf_args, run_args);
-       if (ret) {
-               goto error;
-       }
-
-       ret = append_run_args_for_implicit_component(
-               BT_COMPONENT_CLASS_TYPE_SOURCE, &implicit_lttng_live_args,
-               run_args);
-       if (ret) {
-               goto error;
-       }
-
-       ret = append_run_args_for_implicit_component(
-               BT_COMPONENT_CLASS_TYPE_SINK, &implicit_text_args, run_args);
-       if (ret) {
-               goto error;
-       }
-
-       ret = append_run_args_for_implicit_component(
-               BT_COMPONENT_CLASS_TYPE_SINK, &implicit_dummy_args, run_args);
-       if (ret) {
-               goto error;
-       }
-
-       ret = append_run_args_for_implicit_component(
-               BT_COMPONENT_CLASS_TYPE_FILTER, &implicit_muxer_args, run_args);
-       if (ret) {
-               goto error;
-       }
-
-       ret = append_run_args_for_implicit_component(
-               BT_COMPONENT_CLASS_TYPE_FILTER, &implicit_trimmer_args,
-               run_args);
-       if (ret) {
-               goto error;
-       }
-
-       ret = append_run_args_for_implicit_component(
-               BT_COMPONENT_CLASS_TYPE_FILTER, &implicit_debug_info_args,
-               run_args);
-       if (ret) {
-               goto error;
-       }
-
-       /* Auto-connect components */
-       ret = convert_auto_connect(run_args, source_names, filter_names,
-                       sink_names);
-       if (ret) {
-               printf_err("Cannot auto-connect components\n");
-               goto error;
-       }
-
-       /*
-        * We have all the run command arguments now. Depending on
-        * --run-args, we pass this to the run command or print them
-        * here.
-        */
-       if (print_run_args || print_run_args_0) {
-               for (i = 0; i < bt_value_array_size(run_args); i++) {
-                       struct bt_value *arg_value =
-                               bt_value_array_get(run_args, i);
-                       const char *arg;
-                       GString *quoted = NULL;
-                       const char *arg_to_print;
-
-                       assert(arg_value);
-                       ret = bt_value_string_get(arg_value, &arg);
-                       assert(ret == 0);
-                       BT_PUT(arg_value);
-
-                       if (print_run_args) {
-                               quoted = bt_common_shell_quote(arg);
-                               if (!quoted) {
-                                       goto error;
-                               }
-
-                               arg_to_print = quoted->str;
-                       } else {
-                               arg_to_print = arg;
-                       }
-
-                       printf("%s", arg_to_print);
-
-                       if (quoted) {
-                               g_string_free(quoted, TRUE);
-                       }
-
-                       if (i < bt_value_array_size(run_args) - 1) {
-                               if (print_run_args) {
-                                       putchar(' ');
-                               } else {
-                                       putchar('\0');
-                               }
-                       }
-               }
-
-               *retcode = -1;
-               BT_PUT(cfg);
-               goto end;
-       }
-
-       cfg = bt_config_run_from_args_array(run_args, retcode,
-               omit_system_plugin_path, omit_home_plugin_path,
-               initial_plugin_paths);
-       goto end;
-
-error:
-       *retcode = 1;
-       BT_PUT(cfg);
-
-end:
-       if (pc) {
-               poptFreeContext(pc);
+       if (connection->downstream_comp_name) {
+               g_string_free(connection->downstream_comp_name, TRUE);
        }
 
-       free(arg);
-
-       if (cur_name) {
-               g_string_free(cur_name, TRUE);
-       }
-
-       if (cur_name_prefix) {
-               g_string_free(cur_name_prefix, TRUE);
-       }
-
-       bt_put(run_args);
-       bt_put(all_names);
-       destroy_glist_of_gstring(source_names);
-       destroy_glist_of_gstring(filter_names);
-       destroy_glist_of_gstring(sink_names);
-       destroy_implicit_component_args(&implicit_ctf_args);
-       destroy_implicit_component_args(&implicit_lttng_live_args);
-       destroy_implicit_component_args(&implicit_dummy_args);
-       destroy_implicit_component_args(&implicit_text_args);
-       destroy_implicit_component_args(&implicit_debug_info_args);
-       destroy_implicit_component_args(&implicit_muxer_args);
-       destroy_implicit_component_args(&implicit_trimmer_args);
-       bt_put(plugin_paths);
-       bt_common_destroy_lttng_live_url_parts(&lttng_live_url_parts);
-       return cfg;
-}
-
-/*
- * Prints the Babeltrace 2.x general usage.
- */
-static
-void print_gen_usage(FILE *fp)
-{
-       fprintf(fp, "Usage: babeltrace [GENERAL OPTIONS] [COMMAND] [COMMAND ARGUMENTS]\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "General options:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "  -d, --debug        Turn on debug mode\n");
-       fprintf(fp, "  -h  --help         Show this help and quit\n");
-       fprintf(fp, "  -v, --verbose      Turn on verbose mode\n");
-       fprintf(fp, "  -V, --version      Show version and quit\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Available commands:\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "    convert       Convert and trim traces (default)\n");
-       fprintf(fp, "    help          Get help for a plugin or a component class\n");
-       fprintf(fp, "    list-plugins  List available plugins and their content\n");
-       fprintf(fp, "    query         Query objects from a component class\n");
-       fprintf(fp, "    run           Build a processing graph and run it\n");
-       fprintf(fp, "\n");
-       fprintf(fp, "Use `babeltrace COMMAND --help` to show the help of COMMAND.\n");
-}
-
-struct bt_config *bt_config_from_args(int argc, const char *argv[],
-               int *retcode, bool omit_system_plugin_path,
-               bool omit_home_plugin_path,
-               struct bt_value *initial_plugin_paths)
-{
-       struct bt_config *config = NULL;
-       bool verbose = false;
-       bool debug = false;
-       int i;
-       const char **command_argv = NULL;
-       int command_argc = -1;
-       const char *command_name = NULL;
-
-       enum command_type {
-               COMMAND_TYPE_NONE = -1,
-               COMMAND_TYPE_RUN = 0,
-               COMMAND_TYPE_CONVERT,
-               COMMAND_TYPE_LIST_PLUGINS,
-               COMMAND_TYPE_HELP,
-               COMMAND_TYPE_QUERY,
-       } command_type = COMMAND_TYPE_NONE;
-
-       *retcode = -1;
-
-       if (!initial_plugin_paths) {
-               initial_plugin_paths = bt_value_array_create();
-               if (!initial_plugin_paths) {
-                       *retcode = 1;
-                       goto end;
-               }
-       } else {
-               bt_get(initial_plugin_paths);
-       }
-
-       if (argc <= 1) {
-               print_gen_usage(stdout);
-               goto end;
-       }
-
-       for (i = 1; i < argc; i++) {
-               const char *cur_arg = argv[i];
-
-               if (strcmp(cur_arg, "-d") == 0 ||
-                               strcmp(cur_arg, "--debug") == 0) {
-                       debug = true;
-               } else if (strcmp(cur_arg, "-v") == 0 ||
-                               strcmp(cur_arg, "--verbose") == 0) {
-                       verbose = true;
-               } else if (strcmp(cur_arg, "-V") == 0 ||
-                               strcmp(cur_arg, "--version") == 0) {
-                       print_version();
-                       goto end;
-               } else if (strcmp(cur_arg, "-h") == 0 ||
-                               strcmp(cur_arg, "--help") == 0) {
-                       print_gen_usage(stdout);
-                       goto end;
-               } else {
-                       bool has_command = true;
-
-                       /*
-                        * First unknown argument: is it a known command
-                        * name?
-                        */
-                       if (strcmp(cur_arg, "convert") == 0) {
-                               command_type = COMMAND_TYPE_CONVERT;
-                       } else if (strcmp(cur_arg, "list-plugins") == 0) {
-                               command_type = COMMAND_TYPE_LIST_PLUGINS;
-                       } else if (strcmp(cur_arg, "help") == 0) {
-                               command_type = COMMAND_TYPE_HELP;
-                       } else if (strcmp(cur_arg, "query") == 0) {
-                               command_type = COMMAND_TYPE_QUERY;
-                       } else if (strcmp(cur_arg, "run") == 0) {
-                               command_type = COMMAND_TYPE_RUN;
-                       } else {
-                               /*
-                                * Unknown argument, but not a known
-                                * command name: assume the whole
-                                * arguments are for the default convert
-                                * command.
-                                */
-                               command_type = COMMAND_TYPE_CONVERT;
-                               command_argv = argv;
-                               command_argc = argc;
-                               has_command = false;
-                       }
-
-                       if (has_command) {
-                               command_argv = &argv[i];
-                               command_argc = argc - i;
-                               command_name = cur_arg;
-                       }
-                       break;
-               }
-       }
-
-       if (command_type == COMMAND_TYPE_NONE) {
-               /*
-                * We only got non-help, non-version general options
-                * like --verbose and --debug, without any other
-                * arguments, so we can't do anything useful: print the
-                * usage and quit.
-                */
-               print_gen_usage(stdout);
-               goto end;
+       if (connection->upstream_port_glob) {
+               g_string_free(connection->upstream_port_glob, TRUE);
        }
 
-       assert(command_argv);
-       assert(command_argc >= 0);
-
-       switch (command_type) {
-       case COMMAND_TYPE_RUN:
-               config = bt_config_run_from_args(command_argc, command_argv,
-                       retcode, omit_system_plugin_path,
-                       omit_home_plugin_path, initial_plugin_paths);
-               break;
-       case COMMAND_TYPE_CONVERT:
-               config = bt_config_convert_from_args(command_argc, command_argv,
-                       retcode, omit_system_plugin_path,
-                       omit_home_plugin_path, initial_plugin_paths);
-               break;
-       case COMMAND_TYPE_LIST_PLUGINS:
-               config = bt_config_list_plugins_from_args(command_argc,
-                       command_argv, retcode, omit_system_plugin_path,
-                       omit_home_plugin_path, initial_plugin_paths);
-               break;
-       case COMMAND_TYPE_HELP:
-               config = bt_config_help_from_args(command_argc,
-                       command_argv, retcode, omit_system_plugin_path,
-                       omit_home_plugin_path, initial_plugin_paths);
-               break;
-       case COMMAND_TYPE_QUERY:
-               config = bt_config_query_from_args(command_argc,
-                       command_argv, retcode, omit_system_plugin_path,
-                       omit_home_plugin_path, initial_plugin_paths);
-               break;
-       default:
-               assert(false);
+       if (connection->downstream_port_glob) {
+               g_string_free(connection->downstream_port_glob, TRUE);
        }
 
-       if (config) {
-               if (verbose) {
-                       config->verbose = true;
-               }
-
-               if (debug) {
-                       config->debug = true;
-               }
-
-               config->command_name = command_name;
+       if (connection->arg) {
+               g_string_free(connection->arg, TRUE);
        }
 
-end:
-       bt_put(initial_plugin_paths);
-       return config;
+       g_free(connection);
 }
index 508840e4bc64c7dca47265b3eb9d93eb430ebb03..ca84ae3fdd721bc01334ab8f3bbbf29e0e63b082 100644 (file)
@@ -1,10 +1,10 @@
-#ifndef BABELTRACE_CONVERTER_CFG_H
-#define BABELTRACE_CONVERTER_CFG_H
+#ifndef CLI_BABELTRACE_CFG_H
+#define CLI_BABELTRACE_CFG_H
 
 /*
- * Babeltrace trace converter - configuration
+ * Babeltrace trace converter - CLI tool's configuration
  *
- * Copyright 2016 Philippe Proulx <pproulx@efficios.com>
+ * Copyright 2016-2017 Philippe Proulx <pproulx@efficios.com>
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
 #include <babeltrace/graph/component-class.h>
 #include <glib.h>
 
+enum bt_config_command {
+       BT_CONFIG_COMMAND_RUN,
+       BT_CONFIG_COMMAND_PRINT_CTF_METADATA,
+       BT_CONFIG_COMMAND_PRINT_LTTNG_LIVE_SESSIONS,
+       BT_CONFIG_COMMAND_LIST_PLUGINS,
+       BT_CONFIG_COMMAND_HELP,
+       BT_CONFIG_COMMAND_QUERY,
+};
+
 struct bt_config_component {
        struct bt_object base;
        enum bt_component_class_type type;
@@ -43,13 +52,12 @@ struct bt_config_component {
        GString *instance_name;
 };
 
-enum bt_config_command {
-       BT_CONFIG_COMMAND_RUN,
-       BT_CONFIG_COMMAND_PRINT_CTF_METADATA,
-       BT_CONFIG_COMMAND_PRINT_LTTNG_LIVE_SESSIONS,
-       BT_CONFIG_COMMAND_LIST_PLUGINS,
-       BT_CONFIG_COMMAND_HELP,
-       BT_CONFIG_COMMAND_QUERY,
+struct bt_config_connection {
+       GString *upstream_comp_name;
+       GString *downstream_comp_name;
+       GString *upstream_port_glob;
+       GString *downstream_port_glob;
+       GString *arg;
 };
 
 struct bt_config {
@@ -76,6 +84,12 @@ struct bt_config {
 
                        /* Array of pointers to struct bt_config_connection */
                        GPtrArray *connections;
+
+                       /*
+                        * Number of microseconds to sleep when we need
+                        * to retry to run the graph.
+                        */
+                       uint64_t retry_duration_us;
                } run;
 
                /* BT_CONFIG_COMMAND_HELP */
@@ -108,15 +122,9 @@ struct bt_config_component *bt_config_get_component(GPtrArray *array,
        return bt_get(g_ptr_array_index(array, index));
 }
 
-struct bt_config *bt_config_from_args(int argc, const char *argv[],
-               int *retcode, bool omit_system_plugin_path,
-               bool omit_home_plugin_path,
-               struct bt_value *initial_plugin_paths);
-
-struct bt_config_component *bt_config_component_from_arg(
-               enum bt_component_class_type type, const char *arg);
-
 enum bt_value_status bt_config_append_plugin_paths(
                struct bt_value *plugin_paths, const char *arg);
 
-#endif /* BABELTRACE_CONVERTER_CFG_H */
+void bt_config_connection_destroy(struct bt_config_connection *connection);
+
+#endif /* CLI_BABELTRACE_CFG_H */
index 8391c4a9d21a0e3469e82142fccde91b58626a02..d2d9f260747baa07cb3d89549d2019f81997bb0c 100644 (file)
 #include <glib.h>
 #include <inttypes.h>
 #include "babeltrace-cfg.h"
-#include "babeltrace-cfg-connect.h"
-#include "default-cfg.h"
+#include "babeltrace-cfg-cli-args.h"
+#include "babeltrace-cfg-cli-args-default.h"
+
+#define ENV_BABELTRACE_WARN_COMMAND_NAME_DIRECTORY_CLASH "BABELTRACE_CLI_WARN_COMMAND_NAME_DIRECTORY_CLASH"
 
 GPtrArray *loaded_plugins;
 
 static
-void init_loaded_plugins_array(void)
+void init_static_data(void)
 {
-       loaded_plugins = g_ptr_array_new_full(8, bt_put);
+       loaded_plugins = g_ptr_array_new_with_free_func(bt_put);
 }
 
 static
-void fini_loaded_plugins_array(void)
+void fini_static_data(void)
 {
        g_ptr_array_free(loaded_plugins, TRUE);
 }
@@ -113,43 +115,6 @@ void print_indent(size_t indent)
        }
 }
 
-static char *escape_name_for_shell(const char *input)
-{
-       char *output = g_malloc0(strlen(input) * 5 + 1);
-       const char *in;
-       char *out = output;
-
-       if (!output) {
-               goto end;
-       }
-
-       for (in = input; *in != '\0'; in++) {
-               switch (*in) {
-               case '\\':
-                       *out++ = '\\';
-                       *out++ = '\\';
-                       break;
-               case '\'':
-                       *out++ = '\'';
-                       *out++ = '"';
-                       *out++ = '\'';
-                       *out++ = '"';
-                       *out++ = '\'';
-                       break;
-               case '.':
-                       *out++ = '\\';
-                       *out++ = '.';
-                       break;
-               default:
-                       *out++ = *in;
-                       break;
-               }
-       }
-
-end:
-       return output;
-}
-
 static
 const char *component_type_str(enum bt_component_class_type type)
 {
@@ -166,18 +131,19 @@ const char *component_type_str(enum bt_component_class_type type)
        }
 }
 
-static void print_plugin_comp_cls_opt(FILE *fh, const char *plugin_name,
+static
+void print_plugin_comp_cls_opt(FILE *fh, const char *plugin_name,
                const char *comp_cls_name, enum bt_component_class_type type)
 {
-       char *shell_plugin_name = NULL;
-       char *shell_comp_cls_name = NULL;
+       GString *shell_plugin_name = NULL;
+       GString *shell_comp_cls_name = NULL;
 
-       shell_plugin_name = escape_name_for_shell(plugin_name);
+       shell_plugin_name = bt_common_shell_quote(plugin_name, false);
        if (!shell_plugin_name) {
                goto end;
        }
 
-       shell_comp_cls_name = escape_name_for_shell(comp_cls_name);
+       shell_comp_cls_name = bt_common_shell_quote(comp_cls_name, false);
        if (!shell_comp_cls_name) {
                goto end;
        }
@@ -190,15 +156,20 @@ static void print_plugin_comp_cls_opt(FILE *fh, const char *plugin_name,
                bt_common_color_fg_default(),
                bt_common_color_bold(),
                bt_common_color_fg_blue(),
-               shell_plugin_name,
+               shell_plugin_name->str,
                bt_common_color_fg_default(),
                bt_common_color_fg_yellow(),
-               shell_comp_cls_name,
+               shell_comp_cls_name->str,
                bt_common_color_reset());
 
 end:
-       g_free(shell_plugin_name);
-       g_free(shell_comp_cls_name);
+       if (shell_plugin_name) {
+               g_string_free(shell_plugin_name, TRUE);
+       }
+
+       if (shell_comp_cls_name) {
+               g_string_free(shell_comp_cls_name, TRUE);
+       }
 }
 
 static
@@ -404,12 +375,12 @@ void print_cfg_run(struct bt_config *cfg)
                                i);
 
                printf("    %s%s%s -> %s%s%s\n",
-                       cfg_connection->src_instance_name->str,
-                       cfg_connection->src_port_name->len > 0 ? "." : "",
-                       cfg_connection->src_port_name->str,
-                       cfg_connection->dst_instance_name->str,
-                       cfg_connection->dst_port_name->len > 0 ? "." : "",
-                       cfg_connection->dst_port_name->str);
+                       cfg_connection->upstream_comp_name->str,
+                       cfg_connection->upstream_port_glob->len > 0 ? "." : "",
+                       cfg_connection->upstream_port_glob->str,
+                       cfg_connection->downstream_comp_name->str,
+                       cfg_connection->downstream_port_glob->len > 0 ? "." : "",
+                       cfg_connection->downstream_port_glob->str);
        }
 }
 
@@ -483,153 +454,6 @@ void print_cfg(struct bt_config *cfg)
        }
 }
 
-static
-struct bt_component *create_trimmer(struct bt_config_component *source_cfg)
-{
-       struct bt_component *trimmer = NULL;
-       struct bt_component_class *trimmer_class = NULL;
-       struct bt_value *trimmer_params = NULL;
-       struct bt_value *value;
-
-       trimmer_params = bt_value_map_create();
-       if (!trimmer_params) {
-               goto end;
-       }
-
-       value = bt_value_map_get(source_cfg->params, "begin");
-       if (value) {
-               enum bt_value_status ret;
-
-               ret = bt_value_map_insert(trimmer_params, "begin",
-                               value);
-               BT_PUT(value);
-               if (ret) {
-                       goto end;
-               }
-       }
-       value = bt_value_map_get(source_cfg->params, "end");
-       if (value) {
-               enum bt_value_status ret;
-
-               ret = bt_value_map_insert(trimmer_params, "end",
-                               value);
-               BT_PUT(value);
-               if (ret) {
-                       goto end;
-               }
-       }
-       value = bt_value_map_get(source_cfg->params, "clock-gmt");
-       if (value) {
-               enum bt_value_status ret;
-
-               ret = bt_value_map_insert(trimmer_params, "clock-gmt",
-                               value);
-               BT_PUT(value);
-               if (ret) {
-                       goto end;
-               }
-       }
-
-       trimmer_class = find_component_class("utils", "trimmer",
-               BT_COMPONENT_CLASS_TYPE_FILTER);
-       if (!trimmer_class) {
-               fprintf(stderr, "Could not find trimmer component class. Aborting...\n");
-               goto end;
-       }
-       trimmer = bt_component_create(trimmer_class, "source_trimmer",
-                       trimmer_params);
-       if (!trimmer) {
-               goto end;
-       }
-end:
-       bt_put(trimmer_params);
-       bt_put(trimmer_class);
-       return trimmer;
-}
-
-static
-int connect_source_sink(struct bt_graph *graph,
-               struct bt_component *source,
-               struct bt_config_component *source_cfg,
-               struct bt_component *sink)
-{
-       int ret = 0;
-
-#if 0
-       struct bt_connection *connection = NULL;
-       struct bt_component *trimmer = NULL;
-       struct bt_port *source_port =
-                       bt_component_source_get_default_output_port(source);
-       struct bt_port *sink_port =
-                       bt_component_sink_get_default_input_port(sink);
-       struct bt_port *to_sink_port = NULL;
-       struct bt_port *trimmer_input_port = NULL;
-
-       if (!source_port) {
-               fprintf(stderr, "Failed to find default source output port. Aborting...\n");
-               ret = -1;
-               goto end;
-       }
-       if (!sink_port) {
-               fprintf(stderr, "Failed to find default sink input port. Aborting...\n");
-               ret = -1;
-               goto end;
-       }
-
-       if (bt_value_map_has_key(source_cfg->params, "begin")
-                       || bt_value_map_has_key(source_cfg->params, "end")) {
-               /* A trimmer must be inserted in the graph. */
-               trimmer = create_trimmer(source_cfg);
-               if (!trimmer) {
-                       fprintf(stderr, "Failed to create trimmer component. Aborting...\n");
-                       ret = -1;
-                       goto end;
-               }
-
-               trimmer_input_port = bt_component_filter_get_default_input_port(
-                               trimmer);
-               if (!trimmer_input_port) {
-                       fprintf(stderr, "Failed to find trimmer input port. Aborting...\n");
-                       ret = -1;
-                       goto end;
-               }
-               to_sink_port = bt_component_filter_get_default_output_port(
-                               trimmer);
-               if (!to_sink_port) {
-                       fprintf(stderr, "Failed to find trimmer output port. Aborting...\n");
-                       ret = -1;
-                       goto end;
-               }
-
-               connection = bt_graph_connect_ports(graph, source_port,
-                               trimmer_input_port);
-               if (!connection) {
-                       fprintf(stderr, "Failed to connect source to trimmer. Aborting...\n");
-                       ret = -1;
-                       goto end;
-               }
-               BT_PUT(connection);
-       } else {
-               BT_MOVE(to_sink_port, source_port);
-       }
-
-       connection = bt_graph_connect_ports(graph, to_sink_port, sink_port);
-       if (!connection) {
-               fprintf(stderr, "Failed to connect to sink. Aborting...\n");
-               ret = -1;
-               goto end;
-       }
-end:
-       bt_put(trimmer);
-       bt_put(source_port);
-       bt_put(sink_port);
-       bt_put(to_sink_port);
-       bt_put(connection);
-
-#endif
-       return ret;
-}
-
 static
 void add_to_loaded_plugins(struct bt_plugin_set *plugin_set)
 {
@@ -719,7 +543,8 @@ end:
        return ret;
 }
 
-static int load_all_plugins(struct bt_value *plugin_paths)
+static
+int load_all_plugins(struct bt_value *plugin_paths)
 {
        int ret = 0;
 
@@ -739,7 +564,8 @@ end:
        return ret;
 }
 
-static void print_plugin_info(struct bt_plugin *plugin)
+static
+void print_plugin_info(struct bt_plugin *plugin)
 {
        unsigned int major, minor, patch;
        const char *extra;
@@ -785,7 +611,8 @@ static void print_plugin_info(struct bt_plugin *plugin)
                license ? license : "(Unknown)");
 }
 
-static int cmd_query(struct bt_config *cfg)
+static
+int cmd_query(struct bt_config *cfg)
 {
        int ret;
        struct bt_component_class *comp_cls = NULL;
@@ -842,7 +669,8 @@ end:
        return ret;
 }
 
-static int cmd_help(struct bt_config *cfg)
+static
+int cmd_help(struct bt_config *cfg)
 {
        int ret;
        struct bt_plugin *plugin = NULL;
@@ -943,7 +771,8 @@ end:
        return ret;
 }
 
-static int cmd_list_plugins(struct bt_config *cfg)
+static
+int cmd_list_plugins(struct bt_config *cfg)
 {
        int ret;
        int plugins_count, component_classes_count = 0, i;
@@ -993,7 +822,7 @@ static int cmd_list_plugins(struct bt_config *cfg)
                print_plugin_info(plugin);
 
                if (component_classes_count == 0) {
-                       printf("  %sComponent classes%s: (None)\n",
+                       printf("  %sComponent classes%s: (none)\n",
                                bt_common_color_bold(),
                                bt_common_color_reset());
                } else {
@@ -1031,13 +860,15 @@ end:
        return ret;
 }
 
-static int cmd_print_lttng_live_sessions(struct bt_config *cfg)
+static
+int cmd_print_lttng_live_sessions(struct bt_config *cfg)
 {
        printf("TODO\n");
        return -1;
 }
 
-static int cmd_print_ctf_metadata(struct bt_config *cfg)
+static
+int cmd_print_ctf_metadata(struct bt_config *cfg)
 {
        int ret = 0;
        struct bt_component_class *comp_cls = NULL;
@@ -1107,120 +938,537 @@ end:
        return 0;
 }
 
-static int cmd_run(struct bt_config *cfg)
+struct cmd_run_ctx {
+       /* Owned by this */
+       GHashTable *components;
+
+       /* Owned by this */
+       struct bt_graph *graph;
+
+       /* Weak */
+       struct bt_config *cfg;
+
+       bool connect_ports;
+};
+
+static
+int cmd_run_ctx_connect_upstream_port_to_downstream_component(
+               struct cmd_run_ctx *ctx, struct bt_component *upstream_comp,
+               struct bt_port *upstream_port,
+               struct bt_config_connection *cfg_conn)
 {
        int ret = 0;
-       struct bt_component_class *source_class = NULL;
-       struct bt_component_class *sink_class = NULL;
-       struct bt_component *source = NULL, *sink = NULL;
-       struct bt_value *source_params = NULL, *sink_params = NULL;
-       struct bt_config_component *source_cfg = NULL, *sink_cfg = NULL;
-       struct bt_graph *graph = NULL;
+       GQuark downstreamp_comp_name_quark;
+       struct bt_component *downstream_comp;
+       int64_t downstream_port_count;
+       uint64_t i;
+       int64_t (*port_count_fn)(struct bt_component *);
+       struct bt_port *(*port_by_index_fn)(struct bt_component *, uint64_t);
+       void *conn = NULL;
+
+       downstreamp_comp_name_quark = g_quark_from_string(
+               cfg_conn->downstream_comp_name->str);
+       assert(downstreamp_comp_name_quark > 0);
+       downstream_comp = g_hash_table_lookup(ctx->components,
+               (gpointer) (long) downstreamp_comp_name_quark);
+       if (!downstream_comp) {
+               fprintf(stderr, "Cannot create connection: cannot find downstream component: %s\n",
+                       cfg_conn->arg->str);
+               goto error;
+       }
+
+       if (bt_component_is_filter(downstream_comp)) {
+               port_count_fn = bt_component_filter_get_input_port_count;
+               port_by_index_fn = bt_component_filter_get_input_port_by_index;
+       } else if (bt_component_is_sink(downstream_comp)) {
+               port_count_fn = bt_component_sink_get_input_port_count;
+               port_by_index_fn = bt_component_sink_get_input_port_by_index;
+       } else {
+               /*
+                * Should never happen because the connections are
+                * validated before we get here.
+                */
+               assert(false);
+       }
 
-       ret = load_all_plugins(cfg->plugin_paths);
-       if (ret) {
-               goto end;
+       downstream_port_count = port_count_fn(downstream_comp);
+       assert(downstream_port_count >= 0);
+
+       for (i = 0; i < downstream_port_count; i++) {
+               struct bt_port *downstream_port =
+                       port_by_index_fn(downstream_comp, i);
+               const char *downstream_port_name;
+
+               assert(downstream_port);
+
+               /* Skip port if it's already connected */
+               if (bt_port_is_connected(downstream_port)) {
+                       bt_put(downstream_port);
+                       continue;
+               }
+
+               downstream_port_name = bt_port_get_name(downstream_port);
+               assert(downstream_port_name);
+
+               if (bt_common_star_glob_match(
+                               cfg_conn->downstream_port_glob->str, -1ULL,
+                               downstream_port_name, -1ULL)) {
+                       /* We have a winner! */
+                       conn = bt_graph_connect_ports(ctx->graph,
+                               upstream_port, downstream_port);
+                       bt_put(downstream_port);
+                       if (!conn) {
+                               fprintf(stderr,
+                                       "Cannot create connection: graph refuses to connect ports (`%s` to `%s`): %s\n",
+                                       bt_port_get_name(upstream_port),
+                                       downstream_port_name,
+                                       cfg_conn->arg->str);
+                               goto error;
+                       }
+
+                       goto end;
+               }
+
+               bt_put(downstream_port);
+       }
+
+       if (!conn) {
+               fprintf(stderr,
+                       "Cannot create connection: cannot find a matching downstream port for upstream port `%s`: %s\n",
+                       bt_port_get_name(upstream_port), cfg_conn->arg->str);
+               goto error;
        }
 
-       /* TODO handle more than 1 source and 1 sink. */
-       if (cfg->cmd_data.run.sources->len != 1 ||
-                       cfg->cmd_data.run.sinks->len != 1) {
-               fprintf(stderr, "Only one source and one sink component class are supported. Aborting...\n");
+       goto end;
+
+error:
+       ret = -1;
+
+end:
+       bt_put(conn);
+       return ret;
+}
+
+static
+int cmd_run_ctx_connect_upstream_port(struct cmd_run_ctx *ctx,
+               struct bt_port *upstream_port)
+{
+       int ret = 0;
+       const char *upstream_port_name;
+       const char *upstream_comp_name;
+       struct bt_component *upstream_comp = NULL;
+       size_t i;
+
+       assert(ctx);
+       assert(upstream_port);
+       upstream_port_name = bt_port_get_name(upstream_port);
+       assert(upstream_port_name);
+       upstream_comp = bt_port_get_component(upstream_port);
+       if (!upstream_comp) {
+               // TODO: log warning
                ret = -1;
                goto end;
        }
 
-       source_cfg = bt_config_get_component(cfg->cmd_data.run.sources, 0);
-       source_params = bt_get(source_cfg->params);
-       source_class = find_component_class(source_cfg->plugin_name->str,
-                       source_cfg->comp_cls_name->str,
-                       BT_COMPONENT_CLASS_TYPE_SOURCE);
-       if (!source_class) {
-               fprintf(stderr, "Could not find ");
-               print_plugin_comp_cls_opt(stderr, source_cfg->plugin_name->str,
-                       source_cfg->comp_cls_name->str, BT_COMPONENT_CLASS_TYPE_SOURCE);
-               fprintf(stderr, ". Aborting...\n");
-               ret = -1;
+       upstream_comp_name = bt_component_get_name(upstream_comp);
+       assert(upstream_comp_name);
+
+       for (i = 0; i < ctx->cfg->cmd_data.run.connections->len; i++) {
+               struct bt_config_connection *cfg_conn =
+                       g_ptr_array_index(
+                               ctx->cfg->cmd_data.run.connections, i);
+
+               if (strcmp(cfg_conn->upstream_comp_name->str,
+                               upstream_comp_name) == 0) {
+                       if (bt_common_star_glob_match(
+                                       cfg_conn->upstream_port_glob->str,
+                                       -1ULL, upstream_port_name, -1ULL)) {
+                               ret = cmd_run_ctx_connect_upstream_port_to_downstream_component(
+                                       ctx, upstream_comp, upstream_port,
+                                       cfg_conn);
+                               if (ret) {
+                                       fprintf(stderr,
+                                               "Cannot connect port `%s` of component `%s` to a downstream port: %s\n",
+                                               upstream_port_name,
+                                               upstream_comp_name,
+                                               cfg_conn->arg->str);
+                                       goto error;
+                               }
+
+                               goto end;
+                       }
+               }
+       }
+
+       fprintf(stderr,
+               "Cannot create connection: upstream port `%s` does not match any connection\n",
+               bt_port_get_name(upstream_port));
+
+error:
+       ret = -1;
+
+end:
+       bt_put(upstream_comp);
+       return ret;
+}
+
+static
+void graph_port_added_listener(struct bt_port *port, void *data)
+{
+       struct bt_component *comp = NULL;
+       struct cmd_run_ctx *ctx = data;
+
+       if (bt_port_is_connected(port)) {
+               // TODO: log warning
                goto end;
        }
 
-       sink_cfg = bt_config_get_component(cfg->cmd_data.run.sinks, 0);
-       sink_params = bt_get(sink_cfg->params);
-       sink_class = find_component_class(sink_cfg->plugin_name->str,
-                       sink_cfg->comp_cls_name->str,
-                       BT_COMPONENT_CLASS_TYPE_SINK);
-       if (!sink_class) {
-               fprintf(stderr, "Could not find ");
-               print_plugin_comp_cls_opt(stderr, sink_cfg->plugin_name->str,
-                       sink_cfg->comp_cls_name->str, BT_COMPONENT_CLASS_TYPE_SINK);
-               fprintf(stderr, ". Aborting...\n");
-               ret = -1;
+       comp = bt_port_get_component(port);
+       if (!comp) {
+               // TODO: log warning
                goto end;
        }
 
-       graph = bt_graph_create();
-       if (!graph) {
-               ret = -1;
+       if (!bt_port_is_output(port)) {
+               // TODO: log info
                goto end;
        }
 
-       source = bt_component_create(source_class, "source", source_params);
-       if (!source) {
-               fprintf(stderr, "Failed to instantiate selected source component. Aborting...\n");
-                ret = -1;
-                goto end;
-        }
+       if (cmd_run_ctx_connect_upstream_port(ctx, port)) {
+               // TODO: log fatal
+               fprintf(stderr, "Added port could not be connected: aborting\n");
+               abort();
+       }
+
+end:
+       bt_put(comp);
+       return;
+}
+
+static
+void graph_port_removed_listener(struct bt_component *component,
+               struct bt_port *port, void *data)
+{
+       // TODO: log info
+}
+
+static
+void graph_ports_connected_listener(struct bt_port *upstream_port,
+               struct bt_port *downstream_port, void *data)
+{
+       // TODO: log info
+}
+
+static
+void graph_ports_disconnected_listener(
+               struct bt_component *upstream_component,
+               struct bt_component *downstream_component,
+               struct bt_port *upstream_port, struct bt_port *downstream_port,
+               void *data)
+{
+       // TODO: log info
+}
+
+static
+void cmd_run_ctx_destroy(struct cmd_run_ctx *ctx)
+{
+       if (!ctx) {
+               return;
+       }
+
+       if (ctx->components) {
+               g_hash_table_destroy(ctx->components);
+               ctx->components = NULL;
+       }
+
+       BT_PUT(ctx->graph);
+       ctx->cfg = NULL;
+}
+
+static
+int cmd_run_ctx_init(struct cmd_run_ctx *ctx, struct bt_config *cfg)
+{
+       int ret = 0;
+
+       ctx->cfg = cfg;
+       ctx->connect_ports = false;
+       ctx->components = g_hash_table_new_full(g_direct_hash, g_direct_equal,
+               NULL, bt_put);
+       if (!ctx->components) {
+               goto error;
+       }
+
+       ctx->graph = bt_graph_create();
+       if (!ctx->graph) {
+               goto error;
+       }
+
+       ret = bt_graph_add_port_added_listener(ctx->graph,
+               graph_port_added_listener, ctx);
+       if (ret) {
+               goto error;
+       }
+
+       ret = bt_graph_add_port_removed_listener(ctx->graph,
+               graph_port_removed_listener, ctx);
+       if (ret) {
+               goto error;
+       }
+
+       ret = bt_graph_add_ports_connected_listener(ctx->graph,
+               graph_ports_connected_listener, ctx);
+       if (ret) {
+               goto error;
+       }
+
+       ret = bt_graph_add_ports_disconnected_listener(ctx->graph,
+               graph_ports_disconnected_listener, ctx);
+       if (ret) {
+               goto error;
+       }
+
+       goto end;
+
+error:
+       cmd_run_ctx_destroy(ctx);
+       ret = -1;
+
+end:
+       return ret;
+}
+
+static
+int cmd_run_ctx_create_components_from_config_components(
+               struct cmd_run_ctx *ctx, GPtrArray *cfg_components)
+{
+       size_t i;
+       struct bt_component_class *comp_cls = NULL;
+       struct bt_component *comp = NULL;
+       int ret = 0;
+
+       for (i = 0; i < cfg_components->len; i++) {
+               struct bt_config_component *cfg_comp =
+                       g_ptr_array_index(cfg_components, i);
+               GQuark quark;
+
+               comp_cls = find_component_class(cfg_comp->plugin_name->str,
+                       cfg_comp->comp_cls_name->str, cfg_comp->type);
+               if (!comp_cls) {
+                       fprintf(stderr, "%s%sCannot find component class %s",
+                               bt_common_color_bold(),
+                               bt_common_color_fg_red(),
+                               bt_common_color_reset());
+                       print_plugin_comp_cls_opt(stderr,
+                               cfg_comp->plugin_name->str,
+                               cfg_comp->comp_cls_name->str,
+                               cfg_comp->type);
+                       fprintf(stderr, "\n");
+                       goto error;
+               }
+
+               comp = bt_component_create(comp_cls,
+                       cfg_comp->instance_name->str, cfg_comp->params);
+               if (!comp) {
+                       fprintf(stderr, "%s%sCannot create component `%s`%s\n",
+                               bt_common_color_bold(),
+                               bt_common_color_fg_red(),
+                               cfg_comp->instance_name->str,
+                               bt_common_color_reset());
+                       goto error;
+               }
+
+               quark = g_quark_from_string(cfg_comp->instance_name->str);
+               assert(quark > 0);
+               g_hash_table_insert(ctx->components,
+                       (gpointer) (long) quark, comp);
+               comp = NULL;
+               BT_PUT(comp_cls);
+       }
+
+       goto end;
+
+error:
+       ret = -1;
+
+end:
+       bt_put(comp);
+       bt_put(comp_cls);
+       return ret;
+}
 
-       sink = bt_component_create(sink_class, "sink", sink_params);
-       if (!sink) {
-               fprintf(stderr, "Failed to instantiate selected output component. Aborting...\n");
+static
+int cmd_run_ctx_create_components(struct cmd_run_ctx *ctx)
+{
+       int ret = 0;
+
+       /*
+        * Make sure that, during this phase, our graph's "port added"
+        * listener does not connect ports while we are creating the
+        * components because we have a special, initial phase for
+        * this.
+        */
+       ctx->connect_ports = false;
+
+       ret = cmd_run_ctx_create_components_from_config_components(
+               ctx, ctx->cfg->cmd_data.run.sources);
+       if (ret) {
                ret = -1;
                goto end;
        }
 
-       ret = connect_source_sink(graph, source, source_cfg, sink);
+       ret = cmd_run_ctx_create_components_from_config_components(
+               ctx, ctx->cfg->cmd_data.run.filters);
        if (ret) {
                ret = -1;
                goto end;
        }
 
+       ret = cmd_run_ctx_create_components_from_config_components(
+               ctx, ctx->cfg->cmd_data.run.sinks);
+       if (ret) {
+               ret = -1;
+               goto end;
+       }
+
+end:
+       return ret;
+}
+
+static
+int cmd_run_ctx_connect_comp_ports(struct cmd_run_ctx *ctx,
+               struct bt_component *comp,
+               int64_t (*port_count_fn)(struct bt_component *),
+               struct bt_port *(*port_by_index_fn)(struct bt_component *, uint64_t))
+{
+       int ret = 0;
+       int64_t count;
+       uint64_t i;
+
+       count = port_count_fn(comp);
+       assert(count >= 0);
+
+       for (i = 0; i < count; i++) {
+               struct bt_port *upstream_port = port_by_index_fn(comp, i);
+
+               assert(upstream_port);
+               ret = cmd_run_ctx_connect_upstream_port(ctx, upstream_port);
+               bt_put(upstream_port);
+               if (ret) {
+                       goto end;
+               }
+       }
+
+end:
+       return ret;
+}
+
+static
+int cmd_run_ctx_connect_ports(struct cmd_run_ctx *ctx)
+{
+       int ret = 0;
+       GHashTableIter iter;
+       gpointer g_name_quark, g_comp;
+
+       ctx->connect_ports = true;
+       g_hash_table_iter_init(&iter, ctx->components);
+
+       while (g_hash_table_iter_next(&iter, &g_name_quark, &g_comp)) {
+               if (bt_component_is_source(g_comp)) {
+                       ret = cmd_run_ctx_connect_comp_ports(ctx,
+                               g_comp, bt_component_source_get_output_port_count,
+                               bt_component_source_get_output_port_by_index);
+               } else if (bt_component_is_filter(g_comp)) {
+                       ret = cmd_run_ctx_connect_comp_ports(ctx,
+                               g_comp, bt_component_filter_get_output_port_count,
+                               bt_component_filter_get_output_port_by_index);
+               }
+
+               if (ret) {
+                       goto end;
+               }
+       }
+
+end:
+       return ret;
+}
+
+static
+int cmd_run(struct bt_config *cfg)
+{
+       int ret = 0;
+       struct cmd_run_ctx ctx = { 0 };
+
+       ret = load_all_plugins(cfg->plugin_paths);
+       if (ret) {
+               goto error;
+       }
+
+       /* Initialize the command's context and the graph object */
+       if (cmd_run_ctx_init(&ctx, cfg)) {
+               fprintf(stderr, "Cannot initialize the command's context\n");
+               goto error;
+       }
+
+       /* Create the requested component instances */
+       if (cmd_run_ctx_create_components(&ctx)) {
+               fprintf(stderr, "Cannot create components\n");
+               goto error;
+       }
+
+       /* Connect the initially visible component ports */
+       if (cmd_run_ctx_connect_ports(&ctx)) {
+               fprintf(stderr, "Cannot connect initial component ports\n");
+               goto error;
+       }
+
+       /* Run the graph */
        while (true) {
-               enum bt_graph_status graph_status;
+               enum bt_graph_status graph_status = bt_graph_run(ctx.graph);
 
-               graph_status = bt_graph_run(graph);
                switch (graph_status) {
+               case BT_GRAPH_STATUS_OK:
+                       break;
                case BT_GRAPH_STATUS_AGAIN:
-                       /* Wait for an arbitraty 500 ms. */
-                       usleep(500000);
+                       if (cfg->cmd_data.run.retry_duration_us > 0) {
+                               if (usleep(cfg->cmd_data.run.retry_duration_us)) {
+                                       // TODO: check EINTR and signal handler
+                               }
+                       }
                        break;
                case BT_COMPONENT_STATUS_END:
                        goto end;
                default:
                        fprintf(stderr, "Sink component returned an error, aborting...\n");
-                       ret = -1;
-                       goto end;
+                       goto error;
                }
        }
 
+       goto end;
+
+error:
+       if (ret == 0) {
+               ret = -1;
+       }
+
 end:
-       bt_put(sink_class);
-       bt_put(source_class);
-       bt_put(source);
-       bt_put(sink);
-       bt_put(source_params);
-       bt_put(sink_params);
-       bt_put(sink_cfg);
-       bt_put(source_cfg);
-       bt_put(graph);
+       cmd_run_ctx_destroy(&ctx);
        return ret;
 }
 
-static void warn_command_name_and_directory_clash(struct bt_config *cfg)
+static
+void warn_command_name_and_directory_clash(struct bt_config *cfg)
 {
+       const char *env_clash;
+
        if (!cfg->command_name) {
                return;
        }
 
+       env_clash = getenv(ENV_BABELTRACE_WARN_COMMAND_NAME_DIRECTORY_CLASH);
+       if (env_clash && strcmp(env_clash, "0") == 0) {
+               return;
+       }
+
        if (g_file_test(cfg->command_name,
                        G_FILE_TEST_EXISTS | G_FILE_TEST_IS_DIR)) {
                fprintf(stderr, "\nNOTE: The `%s` command was executed. If you meant to convert a\n",
@@ -1239,8 +1487,8 @@ int main(int argc, const char **argv)
        int retcode;
        struct bt_config *cfg;
 
-       init_loaded_plugins_array();
-       cfg = bt_config_from_args_with_defaults(argc, argv, &retcode);
+       init_static_data();
+       cfg = bt_config_cli_args_create_with_default(argc, argv, &retcode);
 
        if (retcode < 0) {
                /* Quit without errors; typically usage/version */
@@ -1298,6 +1546,6 @@ int main(int argc, const char **argv)
 
 end:
        BT_PUT(cfg);
-       fini_loaded_plugins_array();
+       fini_static_data();
        return retcode;
 }
diff --git a/cli/default-cfg.c b/cli/default-cfg.c
deleted file mode 100644 (file)
index fb32543..0000000
+++ /dev/null
@@ -1,75 +0,0 @@
-/*
- * default-cfg.c
- *
- * Babeltrace Trace Converter - Default Configuration
- *
- * Copyright 2016 - Jérémie Galarneau <jeremie.galarneau@efficios.com>
- *
- * Author: Jérémie Galarneau <jeremie.galarneau@efficios.com>
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-#include <babeltrace/values.h>
-#include "babeltrace-cfg.h"
-#include "default-cfg.h"
-#include "config.h"
-
-#ifdef BT_SET_DEFAULT_IN_TREE_CONFIGURATION
-
-struct bt_config *bt_config_from_args_with_defaults(int argc,
-               const char *argv[], int *retcode)
-{
-       struct bt_value *initial_plugin_paths;
-       struct bt_config *cfg = NULL;
-       int ret;
-
-       initial_plugin_paths = bt_value_array_create();
-       if (!initial_plugin_paths) {
-               goto error;
-       }
-
-       ret = bt_config_append_plugin_paths(initial_plugin_paths,
-               CONFIG_IN_TREE_PLUGIN_PATH);
-       if (ret) {
-               goto error;
-       }
-
-       cfg = bt_config_from_args(argc, argv, retcode, true, true,
-               initial_plugin_paths);
-       goto end;
-
-error:
-       *retcode = 1;
-       BT_PUT(cfg);
-
-end:
-       bt_put(initial_plugin_paths);
-       return cfg;
-}
-
-#else /* BT_SET_DEFAULT_IN_TREE_CONFIGURATION */
-
-struct bt_config *bt_config_from_args_with_defaults(int argc,
-               const char *argv[], int *retcode)
-{
-       return bt_config_from_args(argc, argv, retcode, false, false, NULL);
-}
-
-#endif /* BT_SET_DEFAULT_IN_TREE_CONFIGURATION */
diff --git a/cli/default-cfg.h b/cli/default-cfg.h
deleted file mode 100644 (file)
index d6b9188..0000000
+++ /dev/null
@@ -1,33 +0,0 @@
-#ifndef BABELTRACE_DEFAULT_CFG_H
-#define BABELTRACE_DEFAULT_CFG_H
-
-/*
- * Babeltrace Trace Converter - Default Configuration
- *
- * Copyright 2016 Jérémie Galarneau <jeremie.galarneau@efficios.com>
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-#include "babeltrace-cfg.h"
-
-struct bt_config *bt_config_from_args_with_defaults(int argc,
-               const char *argv[], int *retcode);
-
-#endif /* BABELTRACE_DEFAULT_CFG_H */
index a987e83e060d155e1ffc3f2efef203e7954d2ac4..bc22fa5c6a71a25ed32da120d4c70471ff80c2fd 100644 (file)
@@ -673,3 +673,296 @@ error:
 end:
        return parts;
 }
+
+BT_HIDDEN
+void bt_common_normalize_star_glob_pattern(char *pattern)
+{
+       const char *p;
+       char *np;
+       bool got_star = false;
+
+       assert(pattern);
+
+       for (p = pattern, np = pattern; *p != '\0'; p++) {
+               switch (*p) {
+               case '*':
+                       if (got_star) {
+                               /* Avoid consecutive stars. */
+                               continue;
+                       }
+
+                       got_star = true;
+                       break;
+               case '\\':
+                       /* Copy backslash character. */
+                       *np = *p;
+                       np++;
+                       p++;
+
+                       if (*p == '\0') {
+                               goto end;
+                       }
+
+                       /* Fall through default case. */
+               default:
+                       got_star = false;
+                       break;
+               }
+
+               /* Copy single character. */
+               *np = *p;
+               np++;
+       }
+
+end:
+       *np = '\0';
+}
+
+static inline
+bool at_end_of_pattern(const char *p, const char *pattern, size_t pattern_len)
+{
+       return (p - pattern) == pattern_len || *p == '\0';
+}
+
+/*
+ * Globbing matching function with the star feature only (`?` and
+ * character sets are not supported). This matches `candidate` (plain
+ * string) against `pattern`. A literal star can be escaped with `\` in
+ * `pattern`.
+ *
+ * `pattern_len` or `candidate_len` can be greater than the actual
+ * string length of `pattern` or `candidate` if the string is
+ * null-terminated.
+ */
+BT_HIDDEN
+bool bt_common_star_glob_match(const char *pattern, size_t pattern_len,
+               const char *candidate, size_t candidate_len) {
+       const char *retry_c = candidate, *retry_p = pattern, *c, *p;
+       bool got_a_star = false;
+
+retry:
+       c = retry_c;
+       p = retry_p;
+
+       /*
+        * The concept here is to retry a match in the specific case
+        * where we already got a star. The retry position for the
+        * pattern is just after the most recent star, and the retry
+        * position for the candidate is the character following the
+        * last try's first character.
+        *
+        * Example:
+        *
+        *     candidate: hi ev every onyx one
+        *                ^
+        *     pattern:   hi*every*one
+        *                ^
+        *
+        *     candidate: hi ev every onyx one
+        *                 ^
+        *     pattern:   hi*every*one
+        *                 ^
+        *
+        *     candidate: hi ev every onyx one
+        *                  ^
+        *     pattern:   hi*every*one
+        *                  ^
+        *
+        *     candidate: hi ev every onyx one
+        *                  ^
+        *     pattern:   hi*every*one
+        *                   ^ MISMATCH
+        *
+        *     candidate: hi ev every onyx one
+        *                   ^
+        *     pattern:   hi*every*one
+        *                   ^
+        *
+        *     candidate: hi ev every onyx one
+        *                   ^^
+        *     pattern:   hi*every*one
+        *                   ^^
+        *
+        *     candidate: hi ev every onyx one
+        *                   ^ ^
+        *     pattern:   hi*every*one
+        *                   ^ ^ MISMATCH
+        *
+        *     candidate: hi ev every onyx one
+        *                    ^
+        *     pattern:   hi*every*one
+        *                   ^ MISMATCH
+        *
+        *     candidate: hi ev every onyx one
+        *                     ^
+        *     pattern:   hi*every*one
+        *                   ^ MISMATCH
+        *
+        *     candidate: hi ev every onyx one
+        *                      ^
+        *     pattern:   hi*every*one
+        *                   ^
+        *
+        *     candidate: hi ev every onyx one
+        *                      ^^
+        *     pattern:   hi*every*one
+        *                   ^^
+        *
+        *     candidate: hi ev every onyx one
+        *                      ^ ^
+        *     pattern:   hi*every*one
+        *                   ^ ^
+        *
+        *     candidate: hi ev every onyx one
+        *                      ^  ^
+        *     pattern:   hi*every*one
+        *                   ^  ^
+        *
+        *     candidate: hi ev every onyx one
+        *                      ^   ^
+        *     pattern:   hi*every*one
+        *                   ^   ^
+        *
+        *     candidate: hi ev every onyx one
+        *                           ^
+        *     pattern:   hi*every*one
+        *                        ^
+        *
+        *     candidate: hi ev every onyx one
+        *                           ^
+        *     pattern:   hi*every*one
+        *                         ^ MISMATCH
+        *
+        *     candidate: hi ev every onyx one
+        *                            ^
+        *     pattern:   hi*every*one
+        *                         ^
+        *
+        *     candidate: hi ev every onyx one
+        *                            ^^
+        *     pattern:   hi*every*one
+        *                         ^^
+        *
+        *     candidate: hi ev every onyx one
+        *                            ^ ^
+        *     pattern:   hi*every*one
+        *                         ^ ^ MISMATCH
+        *
+        *     candidate: hi ev every onyx one
+        *                             ^
+        *     pattern:   hi*every*one
+        *                         ^ MISMATCH
+        *
+        *     candidate: hi ev every onyx one
+        *                              ^
+        *     pattern:   hi*every*one
+        *                         ^ MISMATCH
+        *
+        *     candidate: hi ev every onyx one
+        *                               ^
+        *     pattern:   hi*every*one
+        *                         ^ MISMATCH
+        *
+        *     candidate: hi ev every onyx one
+        *                                ^
+        *     pattern:   hi*every*one
+        *                         ^ MISMATCH
+        *
+        *     candidate: hi ev every onyx one
+        *                                 ^
+        *     pattern:   hi*every*one
+        *                         ^
+        *
+        *     candidate: hi ev every onyx one
+        *                                 ^^
+        *     pattern:   hi*every*one
+        *                         ^^
+        *
+        *     candidate: hi ev every onyx one
+        *                                 ^ ^
+        *     pattern:   hi*every*one
+        *                         ^ ^
+        *
+        *     candidate: hi ev every onyx one
+        *                                 ^  ^
+        *     pattern:   hi*every*one
+        *                         ^  ^ SUCCESS
+        */
+       while ((c - candidate) < candidate_len && *c != '\0') {
+               assert(*c);
+
+               if (at_end_of_pattern(p, pattern, pattern_len)) {
+                       goto end_of_pattern;
+               }
+
+               switch (*p) {
+               case '*':
+                       got_a_star = true;
+
+                       /*
+                        * Our first try starts at the current candidate
+                        * character and after the star in the pattern.
+                        */
+                       retry_c = c;
+                       retry_p = p + 1;
+
+                       if (at_end_of_pattern(retry_p, pattern, pattern_len)) {
+                               /*
+                                * Star at the end of the pattern at
+                                * this point: automatic match.
+                                */
+                               return true;
+                       }
+
+                       goto retry;
+               case '\\':
+                       /* Go to escaped character. */
+                       p++;
+
+                       /*
+                        * Fall through the default case which compares
+                        * the escaped character now.
+                        */
+               default:
+                       if (at_end_of_pattern(p, pattern, pattern_len) ||
+                                       *c != *p) {
+end_of_pattern:
+                               /* Character mismatch OR end of pattern. */
+                               if (!got_a_star) {
+                                       /*
+                                        * We didn't get any star yet,
+                                        * so this first mismatch
+                                        * automatically makes the whole
+                                        * test fail.
+                                        */
+                                       return false;
+                               }
+
+                               /*
+                                * Next try: next candidate character,
+                                * original pattern character (following
+                                * the most recent star).
+                                */
+                               retry_c++;
+                               goto retry;
+                       }
+                       break;
+               }
+
+               /* Next pattern and candidate characters. */
+               c++;
+               p++;
+       }
+
+       /*
+        * We checked every candidate character and we're still in a
+        * success state: the only pattern character allowed to remain
+        * is a star.
+        */
+       if (at_end_of_pattern(p, pattern, pattern_len)) {
+               return true;
+       }
+
+       p++;
+       return p[-1] == '*' && at_end_of_pattern(p, pattern, pattern_len);
+}
index 13c4b79ac8a045156b55f1700860bfaaa246ab69..6cd15b8e573df85b7a9f2d8a53183a923715c6f4 100644 (file)
@@ -119,4 +119,11 @@ BT_HIDDEN
 struct bt_common_lttng_live_url_parts bt_common_parse_lttng_live_url(
                const char *url, char *error_buf, size_t error_buf_size);
 
+BT_HIDDEN
+void bt_common_normalize_star_glob_pattern(char *pattern);
+
+BT_HIDDEN
+bool bt_common_star_glob_match(const char *pattern, size_t pattern_len,
+                const char *candidate, size_t candidate_len);
+
 #endif /* BABELTRACE_COMMON_INTERNAL_H */
This page took 0.250146 seconds and 4 git commands to generate.