lib: remove LOADING_ERROR status
[babeltrace.git] / src / lib / plugin / plugin-so.c
index b7acd815ae6dfb1286e97f8a93378e696e1b0b5f..ae7955986f6b9cba1d4198127a790f2433d07d9a 100644 (file)
@@ -23,8 +23,8 @@
  * SOFTWARE.
  */
 
-#define BT_LOG_TAG "PLUGIN-SO"
-#include "lib/lib-logging.h"
+#define BT_LOG_TAG "LIB/PLUGIN-SO"
+#include "lib/logging.h"
 
 #include "common/assert.h"
 #include "lib/assert-pre.h"
@@ -44,6 +44,8 @@
 
 #include "plugin.h"
 #include "plugin-so.h"
+#include "lib/func-status.h"
+#include "common/common.h"
 
 #define NATIVE_PLUGIN_SUFFIX           "." G_MODULE_SUFFIX
 #define NATIVE_PLUGIN_SUFFIX_LEN       sizeof(NATIVE_PLUGIN_SUFFIX)
@@ -102,21 +104,6 @@ void fini_comp_class_list(void)
        BT_LOGD_STR("Released references from all component classes to shared library handles.");
 }
 
-static inline
-const char *bt_self_plugin_status_string(enum bt_self_plugin_status status)
-{
-       switch (status) {
-       case BT_SELF_PLUGIN_STATUS_OK:
-               return "BT_SELF_PLUGIN_STATUS_OK";
-       case BT_SELF_PLUGIN_STATUS_ERROR:
-               return "BT_SELF_PLUGIN_STATUS_ERROR";
-       case BT_SELF_PLUGIN_STATUS_NOMEM:
-               return "BT_SELF_PLUGIN_STATUS_NOMEM";
-       default:
-               return "(unknown)";
-       }
-}
-
 static
 void bt_plugin_so_shared_lib_handle_destroy(struct bt_object *obj)
 {
@@ -138,28 +125,33 @@ void bt_plugin_so_shared_lib_handle_destroy(struct bt_object *obj)
        }
 
        if (shared_lib_handle->module) {
-#ifndef NDEBUG
+#ifdef BT_DEBUG_MODE
                /*
                 * Valgrind shows incomplete stack traces when
                 * dynamically loaded libraries are closed before it
-                * finishes. Use the BABELTRACE_NO_DLCLOSE in a debug
+                * finishes. Use the LIBBABELTRACE2_NO_DLCLOSE in a debug
                 * build to avoid this.
                 */
-               const char *var = getenv("BABELTRACE_NO_DLCLOSE");
+               const char *var = getenv("LIBBABELTRACE2_NO_DLCLOSE");
 
                if (!var || strcmp(var, "1") != 0) {
 #endif
                        BT_LOGI("Closing GModule: path=\"%s\"", path);
 
                        if (!g_module_close(shared_lib_handle->module)) {
+                               /*
+                                * Just log here: we're in a destructor,
+                                * so we cannot append an error cause
+                                * (there's no returned status).
+                                */
                                BT_LOGE("Cannot close GModule: %s: path=\"%s\"",
                                        g_module_error(), path);
                        }
 
                        shared_lib_handle->module = NULL;
-#ifndef NDEBUG
+#ifdef BT_DEBUG_MODE
                } else {
-                       BT_LOGI("Not closing GModule because `BABELTRACE_NO_DLCLOSE=1`: "
+                       BT_LOGI("Not closing GModule because `LIBBABELTRACE2_NO_DLCLOSE=1`: "
                                "path=\"%s\"", path);
                }
 #endif
@@ -174,33 +166,37 @@ void bt_plugin_so_shared_lib_handle_destroy(struct bt_object *obj)
 }
 
 static
-struct bt_plugin_so_shared_lib_handle *bt_plugin_so_shared_lib_handle_create(
-               const char *path)
+int bt_plugin_so_shared_lib_handle_create(
+               const char *path,
+               struct bt_plugin_so_shared_lib_handle **shared_lib_handle)
 {
-       struct bt_plugin_so_shared_lib_handle *shared_lib_handle = NULL;
+       int status = BT_FUNC_STATUS_OK;
 
+       BT_ASSERT(shared_lib_handle);
        BT_LOGI("Creating shared library handle: path=\"%s\"", path);
-       shared_lib_handle = g_new0(struct bt_plugin_so_shared_lib_handle, 1);
-       if (!shared_lib_handle) {
-               BT_LOGE_STR("Failed to allocate one shared library handle.");
-               goto error;
+       *shared_lib_handle = g_new0(struct bt_plugin_so_shared_lib_handle, 1);
+       if (!*shared_lib_handle) {
+               BT_LIB_LOGE_APPEND_CAUSE("Failed to allocate one shared library handle.");
+               status = BT_FUNC_STATUS_MEMORY_ERROR;
+               goto end;
        }
 
-       bt_object_init_shared(&shared_lib_handle->base,
+       bt_object_init_shared(&(*shared_lib_handle)->base,
                bt_plugin_so_shared_lib_handle_destroy);
 
        if (!path) {
                goto end;
        }
 
-       shared_lib_handle->path = g_string_new(path);
-       if (!shared_lib_handle->path) {
-               BT_LOGE_STR("Failed to allocate a GString.");
-               goto error;
+       (*shared_lib_handle)->path = g_string_new(path);
+       if (!(*shared_lib_handle)->path) {
+               BT_LIB_LOGE_APPEND_CAUSE("Failed to allocate a GString.");
+               status = BT_FUNC_STATUS_MEMORY_ERROR;
+               goto end;
        }
 
-       shared_lib_handle->module = g_module_open(path, G_MODULE_BIND_LOCAL);
-       if (!shared_lib_handle->module) {
+       (*shared_lib_handle)->module = g_module_open(path, G_MODULE_BIND_LOCAL);
+       if (!(*shared_lib_handle)->module) {
                /*
                 * INFO-level logging because we're only _trying_ to
                 * open this file as a Babeltrace plugin: if it's not,
@@ -210,21 +206,21 @@ struct bt_plugin_so_shared_lib_handle *bt_plugin_so_shared_lib_handle_create(
                 */
                BT_LOGI("Cannot open GModule: %s: path=\"%s\"",
                        g_module_error(), path);
-               goto error;
+               BT_OBJECT_PUT_REF_AND_RESET(*shared_lib_handle);
+               status = BT_FUNC_STATUS_NOT_FOUND;
+               goto end;
        }
 
        goto end;
 
-error:
-       BT_OBJECT_PUT_REF_AND_RESET(shared_lib_handle);
-
 end:
-       if (shared_lib_handle) {
+       BT_ASSERT(*shared_lib_handle || status != BT_FUNC_STATUS_OK);
+       if (*shared_lib_handle) {
                BT_LOGI("Created shared library handle: path=\"%s\", addr=%p",
-                       path, shared_lib_handle);
+                       path, *shared_lib_handle);
        }
 
-       return shared_lib_handle;
+       return status;
 }
 
 static
@@ -271,8 +267,8 @@ void bt_plugin_so_destroy_spec_data(struct bt_plugin *plugin)
  * 6. Freeze the plugin object.
  */
 static
-enum bt_plugin_status bt_plugin_so_init(
-               struct bt_plugin *plugin,
+int bt_plugin_so_init(struct bt_plugin *plugin,
+               bool fail_on_load_error,
                const struct __bt_plugin_descriptor *descriptor,
                struct __bt_plugin_descriptor_attribute const * const *attrs_begin,
                struct __bt_plugin_descriptor_attribute const * const *attrs_end,
@@ -295,7 +291,6 @@ enum bt_plugin_status bt_plugin_so_init(
                                bt_component_class_source_init_method init;
                                bt_component_class_source_finalize_method finalize;
                                bt_component_class_source_query_method query;
-                               bt_component_class_source_accept_output_port_connection_method accept_output_port_connection;
                                bt_component_class_source_output_port_connected_method output_port_connected;
                                bt_component_class_source_message_iterator_init_method msg_iter_init;
                                bt_component_class_source_message_iterator_finalize_method msg_iter_finalize;
@@ -309,8 +304,6 @@ enum bt_plugin_status bt_plugin_so_init(
                                bt_component_class_filter_init_method init;
                                bt_component_class_filter_finalize_method finalize;
                                bt_component_class_filter_query_method query;
-                               bt_component_class_filter_accept_input_port_connection_method accept_input_port_connection;
-                               bt_component_class_filter_accept_output_port_connection_method accept_output_port_connection;
                                bt_component_class_filter_input_port_connected_method input_port_connected;
                                bt_component_class_filter_output_port_connected_method output_port_connected;
                                bt_component_class_filter_message_iterator_init_method msg_iter_init;
@@ -325,14 +318,13 @@ enum bt_plugin_status bt_plugin_so_init(
                                bt_component_class_sink_init_method init;
                                bt_component_class_sink_finalize_method finalize;
                                bt_component_class_sink_query_method query;
-                               bt_component_class_sink_accept_input_port_connection_method accept_input_port_connection;
                                bt_component_class_sink_input_port_connected_method input_port_connected;
                                bt_component_class_sink_graph_is_configured_method graph_is_configured;
                        } sink;
                } methods;
        };
 
-       enum bt_plugin_status status = BT_PLUGIN_STATUS_OK;
+       int status = BT_FUNC_STATUS_OK;
        struct __bt_plugin_descriptor_attribute const * const *cur_attr_ptr;
        struct __bt_plugin_component_class_descriptor const * const *cur_cc_descr_ptr;
        struct __bt_plugin_component_class_descriptor_attribute const * const *cur_cc_descr_attr_ptr;
@@ -355,8 +347,8 @@ enum bt_plugin_status bt_plugin_so_init(
        comp_class_full_descriptors = g_array_new(FALSE, TRUE,
                sizeof(struct comp_class_full_descriptor));
        if (!comp_class_full_descriptors) {
-               BT_LOGE_STR("Failed to allocate a GArray.");
-               status = BT_PLUGIN_STATUS_ERROR;
+               BT_LIB_LOGE_APPEND_CAUSE("Failed to allocate a GArray.");
+               status = BT_FUNC_STATUS_MEMORY_ERROR;
                goto end;
        }
 
@@ -372,7 +364,7 @@ enum bt_plugin_status bt_plugin_so_init(
                const struct __bt_plugin_descriptor_attribute *cur_attr =
                        *cur_attr_ptr;
 
-               if (cur_attr == NULL) {
+               if (!cur_attr) {
                        continue;
                }
 
@@ -404,21 +396,30 @@ enum bt_plugin_status bt_plugin_so_init(
                                cur_attr->value.version.extra);
                        break;
                default:
-                       /*
-                        * WARN-level logging because this should not
-                        * happen with the appropriate ABI version. If
-                        * we're here, we know that for the reported
-                        * version of the ABI, this attribute is
-                        * unknown.
-                        */
-                       BT_LOGW("Ignoring unknown plugin descriptor attribute: "
-                               "plugin-path=\"%s\", plugin-name=\"%s\", "
-                               "attr-type-name=\"%s\", attr-type-id=%d",
-                               spec->shared_lib_handle->path ?
-                                       spec->shared_lib_handle->path->str :
-                                       NULL,
-                               descriptor->name, cur_attr->type_name,
-                               cur_attr->type);
+                       if (fail_on_load_error) {
+                               BT_LIB_LOGW_APPEND_CAUSE(
+                                       "Unknown plugin descriptor attribute: "
+                                       "plugin-path=\"%s\", plugin-name=\"%s\", "
+                                       "attr-type-name=\"%s\", attr-type-id=%d",
+                                       spec->shared_lib_handle->path ?
+                                               spec->shared_lib_handle->path->str :
+                                               NULL,
+                                       descriptor->name, cur_attr->type_name,
+                                       cur_attr->type);
+                               status = BT_FUNC_STATUS_ERROR;
+                               goto end;
+                       } else {
+                               BT_LIB_LOGW(
+                                       "Ignoring unknown plugin descriptor attribute: "
+                                       "plugin-path=\"%s\", plugin-name=\"%s\", "
+                                       "attr-type-name=\"%s\", attr-type-id=%d",
+                                       spec->shared_lib_handle->path ?
+                                               spec->shared_lib_handle->path->str :
+                                               NULL,
+                                       descriptor->name, cur_attr->type_name,
+                                       cur_attr->type);
+                       }
+
                        break;
                }
        }
@@ -433,7 +434,7 @@ enum bt_plugin_status bt_plugin_so_init(
                        *cur_cc_descr_ptr;
                struct comp_class_full_descriptor full_descriptor = {0};
 
-               if (cur_cc_descr == NULL) {
+               if (!cur_cc_descr) {
                        continue;
                }
 
@@ -456,7 +457,7 @@ enum bt_plugin_status bt_plugin_so_init(
                        *cur_cc_descr_attr_ptr;
                enum bt_component_class_type cc_type;
 
-               if (cur_cc_descr_attr == NULL) {
+               if (!cur_cc_descr_attr) {
                        continue;
                }
 
@@ -541,34 +542,6 @@ enum bt_plugin_status bt_plugin_so_init(
                                        abort();
                                }
                                break;
-                       case BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_ACCEPT_INPUT_PORT_CONNECTION_METHOD:
-                               switch (cc_type) {
-                               case BT_COMPONENT_CLASS_TYPE_FILTER:
-                                       cc_full_descr->methods.filter.accept_input_port_connection =
-                                               cur_cc_descr_attr->value.filter_accept_input_port_connection_method;
-                                       break;
-                               case BT_COMPONENT_CLASS_TYPE_SINK:
-                                       cc_full_descr->methods.sink.accept_input_port_connection =
-                                               cur_cc_descr_attr->value.sink_accept_input_port_connection_method;
-                                       break;
-                               default:
-                                       abort();
-                               }
-                               break;
-                       case BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_ACCEPT_OUTPUT_PORT_CONNECTION_METHOD:
-                               switch (cc_type) {
-                               case BT_COMPONENT_CLASS_TYPE_SOURCE:
-                                       cc_full_descr->methods.source.accept_output_port_connection =
-                                               cur_cc_descr_attr->value.source_accept_output_port_connection_method;
-                                       break;
-                               case BT_COMPONENT_CLASS_TYPE_FILTER:
-                                       cc_full_descr->methods.filter.accept_output_port_connection =
-                                               cur_cc_descr_attr->value.filter_accept_output_port_connection_method;
-                                       break;
-                               default:
-                                       abort();
-                               }
-                               break;
                        case BT_PLUGIN_COMPONENT_CLASS_DESCRIPTOR_ATTRIBUTE_TYPE_INPUT_PORT_CONNECTED_METHOD:
                                switch (cc_type) {
                                case BT_COMPONENT_CLASS_TYPE_FILTER:
@@ -692,30 +665,46 @@ enum bt_plugin_status bt_plugin_so_init(
                                }
                                break;
                        default:
-                               /*
-                                * WARN-level logging because this
-                                * should not happen with the
-                                * appropriate ABI version. If we're
-                                * here, we know that for the reported
-                                * version of the ABI, this attribute is
-                                * unknown.
-                                */
-                               BT_LOGW("Ignoring unknown component class descriptor attribute: "
-                                       "plugin-path=\"%s\", "
-                                       "plugin-name=\"%s\", "
-                                       "comp-class-name=\"%s\", "
-                                       "comp-class-type=%s, "
-                                       "attr-type-name=\"%s\", "
-                                       "attr-type-id=%d",
-                                       spec->shared_lib_handle->path ?
-                                               spec->shared_lib_handle->path->str :
-                                               NULL,
-                                       descriptor->name,
-                                       cur_cc_descr_attr->comp_class_descriptor->name,
-                                       bt_component_class_type_string(
-                                               cur_cc_descr_attr->comp_class_descriptor->type),
-                                       cur_cc_descr_attr->type_name,
-                                       cur_cc_descr_attr->type);
+                               if (fail_on_load_error) {
+                                       BT_LIB_LOGW_APPEND_CAUSE(
+                                               "Unknown component class descriptor attribute: "
+                                               "plugin-path=\"%s\", "
+                                               "plugin-name=\"%s\", "
+                                               "comp-class-name=\"%s\", "
+                                               "comp-class-type=%s, "
+                                               "attr-type-name=\"%s\", "
+                                               "attr-type-id=%d",
+                                               spec->shared_lib_handle->path ?
+                                                       spec->shared_lib_handle->path->str :
+                                                       NULL,
+                                               descriptor->name,
+                                               cur_cc_descr_attr->comp_class_descriptor->name,
+                                               bt_component_class_type_string(
+                                                       cur_cc_descr_attr->comp_class_descriptor->type),
+                                               cur_cc_descr_attr->type_name,
+                                               cur_cc_descr_attr->type);
+                                       status = BT_FUNC_STATUS_ERROR;
+                                       goto end;
+                               } else {
+                                       BT_LIB_LOGW(
+                                               "Ignoring unknown component class descriptor attribute: "
+                                               "plugin-path=\"%s\", "
+                                               "plugin-name=\"%s\", "
+                                               "comp-class-name=\"%s\", "
+                                               "comp-class-type=%s, "
+                                               "attr-type-name=\"%s\", "
+                                               "attr-type-id=%d",
+                                               spec->shared_lib_handle->path ?
+                                                       spec->shared_lib_handle->path->str :
+                                                       NULL,
+                                               descriptor->name,
+                                               cur_cc_descr_attr->comp_class_descriptor->name,
+                                               bt_component_class_type_string(
+                                                       cur_cc_descr_attr->comp_class_descriptor->type),
+                                               cur_cc_descr_attr->type_name,
+                                               cur_cc_descr_attr->type);
+                               }
+
                                break;
                        }
                }
@@ -723,16 +712,29 @@ enum bt_plugin_status bt_plugin_so_init(
 
        /* Initialize plugin */
        if (spec->init) {
-               enum bt_self_plugin_status init_status;
+               enum bt_plugin_init_func_status init_status;
 
                BT_LOGD_STR("Calling user's plugin initialization function.");
                init_status = spec->init((void *) plugin);
-               BT_LOGD("User function returned: %s",
-                       bt_self_plugin_status_string(init_status));
+               BT_LOGD("User function returned: status=%s",
+                       bt_common_func_status_string(init_status));
 
                if (init_status < 0) {
-                       BT_LOGW_STR("User's plugin initialization function failed.");
-                       status = BT_PLUGIN_STATUS_ERROR;
+                       if (fail_on_load_error) {
+                               BT_LIB_LOGW_APPEND_CAUSE(
+                                       "User's plugin initialization function failed: "
+                                       "status=%s",
+                                       bt_common_func_status_string(init_status));
+                               status = init_status;
+                               goto end;
+                       } else {
+                               BT_LIB_LOGW(
+                                       "User's plugin initialization function failed: "
+                                       "status=%s",
+                                       bt_common_func_status_string(init_status));
+                               status = BT_FUNC_STATUS_NOT_FOUND;
+                       }
+
                        goto end;
                }
        }
@@ -783,28 +785,38 @@ enum bt_plugin_status bt_plugin_so_init(
                                sink_comp_class);
                        break;
                default:
-                       /*
-                        * WARN-level logging because this should not
-                        * happen with the appropriate ABI version. If
-                        * we're here, we know that for the reported
-                        * version of the ABI, this component class type
-                        * is unknown.
-                        */
-                       BT_LOGW("Ignoring unknown component class type: "
-                               "plugin-path=\"%s\", plugin-name=\"%s\", "
-                               "comp-class-name=\"%s\", comp-class-type=%d",
-                               spec->shared_lib_handle->path->str ?
-                                       spec->shared_lib_handle->path->str :
-                                       NULL,
-                               descriptor->name,
-                               cc_full_descr->descriptor->name,
-                               cc_full_descr->descriptor->type);
-                       continue;
+                       if (fail_on_load_error) {
+                               BT_LIB_LOGW_APPEND_CAUSE(
+                                       "Unknown component class type: "
+                                       "plugin-path=\"%s\", plugin-name=\"%s\", "
+                                       "comp-class-name=\"%s\", comp-class-type=%d",
+                                       spec->shared_lib_handle->path->str ?
+                                               spec->shared_lib_handle->path->str :
+                                               NULL,
+                                       descriptor->name,
+                                       cc_full_descr->descriptor->name,
+                                       cc_full_descr->descriptor->type);
+                               status = BT_FUNC_STATUS_ERROR;
+                               goto end;
+                       } else {
+                               BT_LIB_LOGW(
+                                       "Ignoring unknown component class type: "
+                                       "plugin-path=\"%s\", plugin-name=\"%s\", "
+                                       "comp-class-name=\"%s\", comp-class-type=%d",
+                                       spec->shared_lib_handle->path->str ?
+                                               spec->shared_lib_handle->path->str :
+                                               NULL,
+                                       descriptor->name,
+                                       cc_full_descr->descriptor->name,
+                                       cc_full_descr->descriptor->type);
+                               continue;
+                       }
                }
 
                if (!comp_class) {
-                       BT_LOGE_STR("Cannot create component class.");
-                       status = BT_PLUGIN_STATUS_ERROR;
+                       BT_LIB_LOGE_APPEND_CAUSE(
+                               "Cannot create component class.");
+                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                        goto end;
                }
 
@@ -812,8 +824,9 @@ enum bt_plugin_status bt_plugin_so_init(
                        ret = bt_component_class_set_description(
                                comp_class, cc_full_descr->description);
                        if (ret) {
-                               BT_LOGE_STR("Cannot set component class's description.");
-                               status = BT_PLUGIN_STATUS_ERROR;
+                               BT_LIB_LOGE_APPEND_CAUSE(
+                                       "Cannot set component class's description.");
+                               status = BT_FUNC_STATUS_MEMORY_ERROR;
                                BT_OBJECT_PUT_REF_AND_RESET(comp_class);
                                goto end;
                        }
@@ -823,8 +836,9 @@ enum bt_plugin_status bt_plugin_so_init(
                        ret = bt_component_class_set_help(comp_class,
                                cc_full_descr->help);
                        if (ret) {
-                               BT_LOGE_STR("Cannot set component class's help string.");
-                               status = BT_PLUGIN_STATUS_ERROR;
+                               BT_LIB_LOGE_APPEND_CAUSE(
+                                       "Cannot set component class's help string.");
+                               status = BT_FUNC_STATUS_MEMORY_ERROR;
                                BT_OBJECT_PUT_REF_AND_RESET(comp_class);
                                goto end;
                        }
@@ -837,8 +851,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        src_comp_class,
                                        cc_full_descr->methods.source.init);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set source component class's initialization method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set source component class's initialization method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(src_comp_class);
                                        goto end;
                                }
@@ -849,8 +864,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        src_comp_class,
                                        cc_full_descr->methods.source.finalize);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set source component class's finalization method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set source component class's finalization method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(src_comp_class);
                                        goto end;
                                }
@@ -861,20 +877,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        src_comp_class,
                                        cc_full_descr->methods.source.query);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set source component class's query method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
-                                       BT_OBJECT_PUT_REF_AND_RESET(src_comp_class);
-                                       goto end;
-                               }
-                       }
-
-                       if (cc_full_descr->methods.source.accept_output_port_connection) {
-                               ret = bt_component_class_source_set_accept_output_port_connection_method(
-                                       src_comp_class,
-                                       cc_full_descr->methods.source.accept_output_port_connection);
-                               if (ret) {
-                                       BT_LOGE_STR("Cannot set source component class's \"accept input output connection\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set source component class's query method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(src_comp_class);
                                        goto end;
                                }
@@ -885,8 +890,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        src_comp_class,
                                        cc_full_descr->methods.source.output_port_connected);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set source component class's \"output port connected\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set source component class's \"output port connected\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(src_comp_class);
                                        goto end;
                                }
@@ -897,8 +903,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        src_comp_class,
                                        cc_full_descr->methods.source.msg_iter_init);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set source component class's message iterator initialization method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set source component class's message iterator initialization method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(src_comp_class);
                                        goto end;
                                }
@@ -909,8 +916,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        src_comp_class,
                                        cc_full_descr->methods.source.msg_iter_finalize);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set source component class's message iterator finalization method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set source component class's message iterator finalization method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(src_comp_class);
                                        goto end;
                                }
@@ -921,8 +929,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        src_comp_class,
                                        cc_full_descr->methods.source.msg_iter_seek_ns_from_origin);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set source component class's message iterator \"seek nanoseconds from origin\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set source component class's message iterator \"seek nanoseconds from origin\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(src_comp_class);
                                        goto end;
                                }
@@ -933,8 +942,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        src_comp_class,
                                        cc_full_descr->methods.source.msg_iter_seek_beginning);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set source component class's message iterator \"seek beginning\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set source component class's message iterator \"seek beginning\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(src_comp_class);
                                        goto end;
                                }
@@ -945,8 +955,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        src_comp_class,
                                        cc_full_descr->methods.source.msg_iter_can_seek_ns_from_origin);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set source component class's message iterator \"can seek nanoseconds from origin\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set source component class's message iterator \"can seek nanoseconds from origin\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(src_comp_class);
                                        goto end;
                                }
@@ -957,8 +968,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        src_comp_class,
                                        cc_full_descr->methods.source.msg_iter_can_seek_beginning);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set source component class's message iterator \"can seek beginning\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set source component class's message iterator \"can seek beginning\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(src_comp_class);
                                        goto end;
                                }
@@ -971,8 +983,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        flt_comp_class,
                                        cc_full_descr->methods.filter.init);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's initialization method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set filter component class's initialization method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
                                        goto end;
                                }
@@ -983,8 +996,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        flt_comp_class,
                                        cc_full_descr->methods.filter.finalize);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's finalization method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set filter component class's finalization method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
                                        goto end;
                                }
@@ -995,32 +1009,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        flt_comp_class,
                                        cc_full_descr->methods.filter.query);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's query method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
-                                       BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
-                                       goto end;
-                               }
-                       }
-
-                       if (cc_full_descr->methods.filter.accept_input_port_connection) {
-                               ret = bt_component_class_filter_set_accept_input_port_connection_method(
-                                       flt_comp_class,
-                                       cc_full_descr->methods.filter.accept_input_port_connection);
-                               if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's \"accept input port connection\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
-                                       BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
-                                       goto end;
-                               }
-                       }
-
-                       if (cc_full_descr->methods.filter.accept_output_port_connection) {
-                               ret = bt_component_class_filter_set_accept_output_port_connection_method(
-                                       flt_comp_class,
-                                       cc_full_descr->methods.filter.accept_output_port_connection);
-                               if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's \"accept input output connection\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set filter component class's query method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
                                        goto end;
                                }
@@ -1031,8 +1022,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        flt_comp_class,
                                        cc_full_descr->methods.filter.input_port_connected);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's \"input port connected\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set filter component class's \"input port connected\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
                                        goto end;
                                }
@@ -1043,8 +1035,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        flt_comp_class,
                                        cc_full_descr->methods.filter.output_port_connected);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's \"output port connected\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set filter component class's \"output port connected\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
                                        goto end;
                                }
@@ -1055,8 +1048,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        flt_comp_class,
                                        cc_full_descr->methods.filter.msg_iter_init);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's message iterator initialization method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set filter component class's message iterator initialization method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
                                        goto end;
                                }
@@ -1067,8 +1061,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        flt_comp_class,
                                        cc_full_descr->methods.filter.msg_iter_finalize);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's message iterator finalization method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set filter component class's message iterator finalization method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
                                        goto end;
                                }
@@ -1079,8 +1074,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        flt_comp_class,
                                        cc_full_descr->methods.filter.msg_iter_seek_ns_from_origin);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's message iterator \"seek nanoseconds from origin\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set filter component class's message iterator \"seek nanoseconds from origin\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
                                        goto end;
                                }
@@ -1091,8 +1087,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        flt_comp_class,
                                        cc_full_descr->methods.filter.msg_iter_seek_beginning);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's message iterator \"seek beginning\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set filter component class's message iterator \"seek beginning\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
                                        goto end;
                                }
@@ -1103,8 +1100,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        flt_comp_class,
                                        cc_full_descr->methods.filter.msg_iter_can_seek_ns_from_origin);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's message iterator \"can seek nanoseconds from origin\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set filter component class's message iterator \"can seek nanoseconds from origin\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
                                        goto end;
                                }
@@ -1115,8 +1113,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        flt_comp_class,
                                        cc_full_descr->methods.filter.msg_iter_can_seek_beginning);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set filter component class's message iterator \"can seek beginning\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set filter component class's message iterator \"can seek beginning\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(flt_comp_class);
                                        goto end;
                                }
@@ -1129,8 +1128,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        sink_comp_class,
                                        cc_full_descr->methods.sink.init);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set sink component class's initialization method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set sink component class's initialization method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(sink_comp_class);
                                        goto end;
                                }
@@ -1141,8 +1141,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        sink_comp_class,
                                        cc_full_descr->methods.sink.finalize);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set sink component class's finalization method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set sink component class's finalization method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(sink_comp_class);
                                        goto end;
                                }
@@ -1153,20 +1154,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        sink_comp_class,
                                        cc_full_descr->methods.sink.query);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set sink component class's query method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
-                                       BT_OBJECT_PUT_REF_AND_RESET(sink_comp_class);
-                                       goto end;
-                               }
-                       }
-
-                       if (cc_full_descr->methods.sink.accept_input_port_connection) {
-                               ret = bt_component_class_sink_set_accept_input_port_connection_method(
-                                       sink_comp_class,
-                                       cc_full_descr->methods.sink.accept_input_port_connection);
-                               if (ret) {
-                                       BT_LOGE_STR("Cannot set sink component class's \"accept input port connection\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set sink component class's query method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(sink_comp_class);
                                        goto end;
                                }
@@ -1177,8 +1167,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        sink_comp_class,
                                        cc_full_descr->methods.sink.input_port_connected);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set sink component class's \"input port connected\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set sink component class's \"input port connected\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(sink_comp_class);
                                        goto end;
                                }
@@ -1189,8 +1180,9 @@ enum bt_plugin_status bt_plugin_so_init(
                                        sink_comp_class,
                                        cc_full_descr->methods.sink.graph_is_configured);
                                if (ret) {
-                                       BT_LOGE_STR("Cannot set sink component class's \"graph is configured\" method.");
-                                       status = BT_PLUGIN_STATUS_ERROR;
+                                       BT_LIB_LOGE_APPEND_CAUSE(
+                                               "Cannot set sink component class's \"graph is configured\" method.");
+                                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                                        BT_OBJECT_PUT_REF_AND_RESET(sink_comp_class);
                                        goto end;
                                }
@@ -1213,7 +1205,8 @@ enum bt_plugin_status bt_plugin_so_init(
                        (void *) comp_class);
                BT_OBJECT_PUT_REF_AND_RESET(comp_class);
                if (status < 0) {
-                       BT_LOGE("Cannot add component class to plugin.");
+                       BT_LIB_LOGE_APPEND_CAUSE(
+                               "Cannot add component class to plugin.");
                        goto end;
                }
        }
@@ -1238,7 +1231,8 @@ struct bt_plugin *bt_plugin_so_create_empty(
        plugin->destroy_spec_data = bt_plugin_so_destroy_spec_data;
        plugin->spec_data = g_new0(struct bt_plugin_so_spec_data, 1);
        if (!plugin->spec_data) {
-               BT_LOGE_STR("Failed to allocate one SO plugin specific data structure.");
+               BT_LIB_LOGE_APPEND_CAUSE(
+                       "Failed to allocate one SO plugin specific data structure.");
                goto error;
        }
 
@@ -1272,8 +1266,9 @@ size_t count_non_null_items_in_section(const void *begin, const void *end)
 }
 
 static
-struct bt_plugin_set *bt_plugin_so_create_all_from_sections(
+int bt_plugin_so_create_all_from_sections(
                struct bt_plugin_so_shared_lib_handle *shared_lib_handle,
+               bool fail_on_load_error,
                struct __bt_plugin_descriptor const * const *descriptors_begin,
                struct __bt_plugin_descriptor const * const *descriptors_end,
                struct __bt_plugin_descriptor_attribute const * const *attrs_begin,
@@ -1281,20 +1276,22 @@ struct bt_plugin_set *bt_plugin_so_create_all_from_sections(
                struct __bt_plugin_component_class_descriptor const * const *cc_descriptors_begin,
                struct __bt_plugin_component_class_descriptor const * const *cc_descriptors_end,
                struct __bt_plugin_component_class_descriptor_attribute const * const *cc_descr_attrs_begin,
-               struct __bt_plugin_component_class_descriptor_attribute const * const *cc_descr_attrs_end)
+               struct __bt_plugin_component_class_descriptor_attribute const * const *cc_descr_attrs_end,
+               struct bt_plugin_set **plugin_set_out)
 {
+       int status = BT_FUNC_STATUS_OK;
        size_t descriptor_count;
        size_t attrs_count;
        size_t cc_descriptors_count;
        size_t cc_descr_attrs_count;
        size_t i;
-       struct bt_plugin_set *plugin_set = NULL;
 
+       BT_ASSERT(plugin_set_out);
+       *plugin_set_out = NULL;
        descriptor_count = count_non_null_items_in_section(descriptors_begin, descriptors_end);
        attrs_count = count_non_null_items_in_section(attrs_begin, attrs_end);
        cc_descriptors_count = count_non_null_items_in_section(cc_descriptors_begin, cc_descriptors_end);
        cc_descr_attrs_count =  count_non_null_items_in_section(cc_descr_attrs_begin, cc_descr_attrs_end);
-
        BT_LOGI("Creating all SO plugins from sections: "
                "plugin-path=\"%s\", "
                "descr-begin-addr=%p, descr-end-addr=%p, "
@@ -1310,19 +1307,19 @@ struct bt_plugin_set *bt_plugin_so_create_all_from_sections(
                cc_descr_attrs_begin, cc_descr_attrs_end,
                descriptor_count, attrs_count,
                cc_descriptors_count, cc_descr_attrs_count);
-       plugin_set = bt_plugin_set_create();
-       if (!plugin_set) {
-               BT_LOGE_STR("Cannot create empty plugin set.");
+       *plugin_set_out = bt_plugin_set_create();
+       if (!*plugin_set_out) {
+               BT_LIB_LOGE_APPEND_CAUSE("Cannot create empty plugin set.");
+               status = BT_FUNC_STATUS_MEMORY_ERROR;
                goto error;
        }
 
        for (i = 0; i < descriptors_end - descriptors_begin; i++) {
-               enum bt_plugin_status status;
                const struct __bt_plugin_descriptor *descriptor =
                        descriptors_begin[i];
                struct bt_plugin *plugin;
 
-               if (descriptor == NULL) {
+               if (!descriptor) {
                        continue;
                }
 
@@ -1331,73 +1328,93 @@ struct bt_plugin_set *bt_plugin_so_create_all_from_sections(
                        descriptor->name, descriptor->major, descriptor->minor);
 
                if (descriptor->major > __BT_PLUGIN_VERSION_MAJOR) {
-                       /*
-                        * INFO-level logging because we're only
-                        * _trying_ to open this file as a compatible
-                        * Babeltrace plugin: if it's not, it's not an
-                        * error. And because this can be tried during
-                        * bt_plugin_find_all_from_dir(), it's not even
-                        * a warning.
-                        */
-                       BT_LOGI("Unknown ABI major version: abi-major=%d",
-                               descriptor->major);
-                       goto error;
+                       if (fail_on_load_error) {
+                               BT_LIB_LOGW_APPEND_CAUSE(
+                                       "Unknown ABI major version: abi-major=%d",
+                                               descriptor->major);
+                               status = BT_FUNC_STATUS_ERROR;
+                               goto error;
+                       } else {
+                               BT_LIB_LOGW(
+                                       "Unknown ABI major version: abi-major=%d",
+                                               descriptor->major);
+                               continue;
+                       }
                }
 
                plugin = bt_plugin_so_create_empty(shared_lib_handle);
                if (!plugin) {
-                       BT_LOGE_STR("Cannot create empty shared library handle.");
+                       BT_LIB_LOGE_APPEND_CAUSE(
+                               "Cannot create empty shared library handle.");
+                       status = BT_FUNC_STATUS_MEMORY_ERROR;
                        goto error;
                }
 
                if (shared_lib_handle && shared_lib_handle->path) {
-                       bt_plugin_set_path(plugin, shared_lib_handle->path->str);
+                       bt_plugin_set_path(plugin,
+                               shared_lib_handle->path->str);
                }
 
-               status = bt_plugin_so_init(plugin, descriptor, attrs_begin,
-                       attrs_end, cc_descriptors_begin, cc_descriptors_end,
+               status = bt_plugin_so_init(plugin, fail_on_load_error,
+                       descriptor, attrs_begin, attrs_end,
+                       cc_descriptors_begin, cc_descriptors_end,
                        cc_descr_attrs_begin, cc_descr_attrs_end);
-               if (status < 0) {
+               if (status == BT_FUNC_STATUS_OK) {
+                       /* Add to plugin set */
+                       bt_plugin_set_add_plugin(*plugin_set_out, plugin);
+                       BT_OBJECT_PUT_REF_AND_RESET(plugin);
+               } else if (status < 0) {
                        /*
-                        * DEBUG-level logging because we're only
-                        * _trying_ to open this file as a compatible
-                        * Babeltrace plugin: if it's not, it's not an
-                        * error. And because this can be tried during
-                        * bt_plugin_find_all_from_dir(), it's not
-                        * even a warning.
+                        * bt_plugin_so_init() handles
+                        * `fail_on_load_error`, so this is a "real"
+                        * error.
                         */
-                       BT_LOGD_STR("Cannot initialize SO plugin object from sections.");
+                       BT_LIB_LOGW_APPEND_CAUSE(
+                               "Cannot initialize SO plugin object from sections.");
                        BT_OBJECT_PUT_REF_AND_RESET(plugin);
                        goto error;
                }
 
-               /* Add to plugin set */
-               bt_plugin_set_add_plugin(plugin_set, plugin);
-               bt_object_put_ref(plugin);
+               BT_ASSERT(!plugin);
+       }
+
+       BT_ASSERT(*plugin_set_out);
+
+       if ((*plugin_set_out)->plugins->len == 0) {
+               BT_OBJECT_PUT_REF_AND_RESET(*plugin_set_out);
+               status = BT_FUNC_STATUS_NOT_FOUND;
        }
 
        goto end;
 
 error:
-       BT_OBJECT_PUT_REF_AND_RESET(plugin_set);
+       BT_ASSERT(status < 0);
+       BT_OBJECT_PUT_REF_AND_RESET(*plugin_set_out);
 
 end:
-       return plugin_set;
+       return status;
 }
 
 BT_HIDDEN
-struct bt_plugin_set *bt_plugin_so_create_all_from_static(void)
+int bt_plugin_so_create_all_from_static(bool fail_on_load_error,
+               struct bt_plugin_set **plugin_set_out)
 {
-       struct bt_plugin_set *plugin_set = NULL;
-       struct bt_plugin_so_shared_lib_handle *shared_lib_handle =
-               bt_plugin_so_shared_lib_handle_create(NULL);
+       int status;
+       struct bt_plugin_so_shared_lib_handle *shared_lib_handle = NULL;
 
-       if (!shared_lib_handle) {
+       BT_ASSERT(plugin_set_out);
+       *plugin_set_out = NULL;
+       status = bt_plugin_so_shared_lib_handle_create(NULL,
+               &shared_lib_handle);
+       if (status != BT_FUNC_STATUS_OK) {
+               BT_ASSERT(!shared_lib_handle);
                goto end;
        }
 
+       BT_ASSERT(shared_lib_handle);
        BT_LOGD_STR("Creating all SO plugins from built-in plugins.");
-       plugin_set = bt_plugin_so_create_all_from_sections(shared_lib_handle,
+       status = bt_plugin_so_create_all_from_sections(shared_lib_handle,
+               fail_on_load_error,
                __bt_get_begin_section_plugin_descriptors(),
                __bt_get_end_section_plugin_descriptors(),
                __bt_get_begin_section_plugin_descriptor_attributes(),
@@ -1405,19 +1422,22 @@ struct bt_plugin_set *bt_plugin_so_create_all_from_static(void)
                __bt_get_begin_section_component_class_descriptors(),
                __bt_get_end_section_component_class_descriptors(),
                __bt_get_begin_section_component_class_descriptor_attributes(),
-               __bt_get_end_section_component_class_descriptor_attributes());
+               __bt_get_end_section_component_class_descriptor_attributes(),
+               plugin_set_out);
+       BT_ASSERT((status == BT_FUNC_STATUS_OK && *plugin_set_out &&
+               (*plugin_set_out)->plugins->len > 0) || !*plugin_set_out);
 
 end:
        BT_OBJECT_PUT_REF_AND_RESET(shared_lib_handle);
-
-       return plugin_set;
+       return status;
 }
 
 BT_HIDDEN
-struct bt_plugin_set *bt_plugin_so_create_all_from_file(const char *path)
+int bt_plugin_so_create_all_from_file(const char *path,
+               bool fail_on_load_error, struct bt_plugin_set **plugin_set_out)
 {
        size_t path_len;
-       struct bt_plugin_set *plugin_set = NULL;
+       int status;
        struct __bt_plugin_descriptor const * const *descriptors_begin = NULL;
        struct __bt_plugin_descriptor const * const *descriptors_end = NULL;
        struct __bt_plugin_descriptor_attribute const * const *attrs_begin = NULL;
@@ -1438,6 +1458,8 @@ struct bt_plugin_set *bt_plugin_so_create_all_from_file(const char *path)
        struct bt_plugin_so_shared_lib_handle *shared_lib_handle = NULL;
 
        BT_ASSERT(path);
+       BT_ASSERT(plugin_set_out);
+       *plugin_set_out = NULL;
        path_len = strlen(path);
        BT_ASSERT_PRE(path_len > PLUGIN_SUFFIX_LEN,
                "Path length is too short: path-length=%zu, min-length=%zu",
@@ -1457,14 +1479,16 @@ struct bt_plugin_set *bt_plugin_so_create_all_from_file(const char *path)
                NATIVE_PLUGIN_SUFFIX_LEN);
        if (!is_shared_object && !is_libtool_wrapper) {
                /* Name indicates this is not a plugin file; not an error */
-               BT_LOGI("File is not a SO plugin file: path=\"%s\"", path);
+               BT_LOGI("File is not an SO plugin file: path=\"%s\"", path);
+               status = BT_FUNC_STATUS_NOT_FOUND;
                goto end;
        }
 
-       shared_lib_handle = bt_plugin_so_shared_lib_handle_create(path);
-       if (!shared_lib_handle) {
+       status = bt_plugin_so_shared_lib_handle_create(path,
+               &shared_lib_handle);
+       if (status != BT_FUNC_STATUS_OK) {
                /* bt_plugin_so_shared_lib_handle_create() logs more details */
-               BT_LOGD_STR("Cannot create shared library handle.");
+               BT_ASSERT(!shared_lib_handle);
                goto end;
        }
 
@@ -1472,19 +1496,41 @@ struct bt_plugin_set *bt_plugin_so_create_all_from_file(const char *path)
                        (gpointer *) &get_begin_section_plugin_descriptors)) {
                descriptors_begin = get_begin_section_plugin_descriptors();
        } else {
+               /*
+                * Use this first symbol to know whether or not this
+                * shared object _looks like_ a Babeltrace plugin. Since
+                * g_module_symbol() failed, assume that this is not a
+                * Babeltrace plugin, so it's not an error.
+                */
                BT_LOGI("Cannot resolve plugin symbol: path=\"%s\", "
                        "symbol=\"%s\"", path,
                        "__bt_get_begin_section_plugin_descriptors");
+               status = BT_FUNC_STATUS_NOT_FOUND;
                goto end;
        }
 
+       /*
+        * If g_module_symbol() fails for any of the other symbols, fail
+        * if `fail_on_load_error` is true.
+        */
        if (g_module_symbol(shared_lib_handle->module, "__bt_get_end_section_plugin_descriptors",
                        (gpointer *) &get_end_section_plugin_descriptors)) {
                descriptors_end = get_end_section_plugin_descriptors();
        } else {
-               BT_LOGI("Cannot resolve plugin symbol: path=\"%s\", "
-                       "symbol=\"%s\"", path,
-                       "__bt_get_end_section_plugin_descriptors");
+               if (fail_on_load_error) {
+                       BT_LIB_LOGW_APPEND_CAUSE(
+                               "Cannot resolve plugin symbol: path=\"%s\", "
+                               "symbol=\"%s\"", path,
+                               "__bt_get_end_section_plugin_descriptors");
+                       status = BT_FUNC_STATUS_ERROR;
+               } else {
+                       BT_LIB_LOGW(
+                               "Cannot resolve plugin symbol: path=\"%s\", "
+                               "symbol=\"%s\"", path,
+                               "__bt_get_end_section_plugin_descriptors");
+                       status = BT_FUNC_STATUS_NOT_FOUND;
+               }
+
                goto end;
        }
 
@@ -1507,13 +1553,28 @@ struct bt_plugin_set *bt_plugin_so_create_all_from_file(const char *path)
        }
 
        if ((!!attrs_begin - !!attrs_end) != 0) {
-               BT_LOGI("Found section start or end symbol, but not both: "
-                       "path=\"%s\", symbol-start=\"%s\", "
-                       "symbol-end=\"%s\", symbol-start-addr=%p, "
-                       "symbol-end-addr=%p",
-                       path, "__bt_get_begin_section_plugin_descriptor_attributes",
-                       "__bt_get_end_section_plugin_descriptor_attributes",
-                       attrs_begin, attrs_end);
+               if (fail_on_load_error) {
+                       BT_LIB_LOGW_APPEND_CAUSE(
+                               "Found section start or end symbol, but not both: "
+                               "path=\"%s\", symbol-start=\"%s\", "
+                               "symbol-end=\"%s\", symbol-start-addr=%p, "
+                               "symbol-end-addr=%p",
+                               path, "__bt_get_begin_section_plugin_descriptor_attributes",
+                               "__bt_get_end_section_plugin_descriptor_attributes",
+                               attrs_begin, attrs_end);
+                       status = BT_FUNC_STATUS_ERROR;
+               } else {
+                       BT_LIB_LOGW(
+                               "Found section start or end symbol, but not both: "
+                               "path=\"%s\", symbol-start=\"%s\", "
+                               "symbol-end=\"%s\", symbol-start-addr=%p, "
+                               "symbol-end-addr=%p",
+                               path, "__bt_get_begin_section_plugin_descriptor_attributes",
+                               "__bt_get_end_section_plugin_descriptor_attributes",
+                               attrs_begin, attrs_end);
+                       status = BT_FUNC_STATUS_NOT_FOUND;
+               }
+
                goto end;
        }
 
@@ -1536,13 +1597,28 @@ struct bt_plugin_set *bt_plugin_so_create_all_from_file(const char *path)
        }
 
        if ((!!cc_descriptors_begin - !!cc_descriptors_end) != 0) {
-               BT_LOGI("Found section start or end symbol, but not both: "
-                       "path=\"%s\", symbol-start=\"%s\", "
-                       "symbol-end=\"%s\", symbol-start-addr=%p, "
-                       "symbol-end-addr=%p",
-                       path, "__bt_get_begin_section_component_class_descriptors",
-                       "__bt_get_end_section_component_class_descriptors",
-                       cc_descriptors_begin, cc_descriptors_end);
+               if (fail_on_load_error) {
+                       BT_LIB_LOGW_APPEND_CAUSE(
+                               "Found section start or end symbol, but not both: "
+                               "path=\"%s\", symbol-start=\"%s\", "
+                               "symbol-end=\"%s\", symbol-start-addr=%p, "
+                               "symbol-end-addr=%p",
+                               path, "__bt_get_begin_section_component_class_descriptors",
+                               "__bt_get_end_section_component_class_descriptors",
+                               cc_descriptors_begin, cc_descriptors_end);
+                       status = BT_FUNC_STATUS_ERROR;
+               } else {
+                       BT_LIB_LOGW(
+                               "Found section start or end symbol, but not both: "
+                               "path=\"%s\", symbol-start=\"%s\", "
+                               "symbol-end=\"%s\", symbol-start-addr=%p, "
+                               "symbol-end-addr=%p",
+                               path, "__bt_get_begin_section_component_class_descriptors",
+                               "__bt_get_end_section_component_class_descriptors",
+                               cc_descriptors_begin, cc_descriptors_end);
+                       status = BT_FUNC_STATUS_NOT_FOUND;
+               }
+
                goto end;
        }
 
@@ -1565,26 +1641,42 @@ struct bt_plugin_set *bt_plugin_so_create_all_from_file(const char *path)
        }
 
        if ((!!cc_descr_attrs_begin - !!cc_descr_attrs_end) != 0) {
-               BT_LOGI("Found section start or end symbol, but not both: "
-                       "path=\"%s\", symbol-start=\"%s\", "
-                       "symbol-end=\"%s\", symbol-start-addr=%p, "
-                       "symbol-end-addr=%p",
-                       path, "__bt_get_begin_section_component_class_descriptor_attributes",
-                       "__bt_get_end_section_component_class_descriptor_attributes",
-                       cc_descr_attrs_begin, cc_descr_attrs_end);
+               if (fail_on_load_error) {
+                       BT_LIB_LOGW_APPEND_CAUSE(
+                               "Found section start or end symbol, but not both: "
+                               "path=\"%s\", symbol-start=\"%s\", "
+                               "symbol-end=\"%s\", symbol-start-addr=%p, "
+                               "symbol-end-addr=%p",
+                               path, "__bt_get_begin_section_component_class_descriptor_attributes",
+                               "__bt_get_end_section_component_class_descriptor_attributes",
+                               cc_descr_attrs_begin, cc_descr_attrs_end);
+                       status = BT_FUNC_STATUS_ERROR;
+               } else {
+                       BT_LIB_LOGW(
+                               "Found section start or end symbol, but not both: "
+                               "path=\"%s\", symbol-start=\"%s\", "
+                               "symbol-end=\"%s\", symbol-start-addr=%p, "
+                               "symbol-end-addr=%p",
+                               path, "__bt_get_begin_section_component_class_descriptor_attributes",
+                               "__bt_get_end_section_component_class_descriptor_attributes",
+                               cc_descr_attrs_begin, cc_descr_attrs_end);
+                       status = BT_FUNC_STATUS_NOT_FOUND;
+               }
+
                goto end;
        }
 
        /* Initialize plugin */
        BT_LOGD_STR("Initializing plugin object.");
-       plugin_set = bt_plugin_so_create_all_from_sections(shared_lib_handle,
+       status = bt_plugin_so_create_all_from_sections(shared_lib_handle,
+               fail_on_load_error,
                descriptors_begin, descriptors_end, attrs_begin, attrs_end,
                cc_descriptors_begin, cc_descriptors_end,
-               cc_descr_attrs_begin, cc_descr_attrs_end);
+               cc_descr_attrs_begin, cc_descr_attrs_end, plugin_set_out);
 
 end:
        BT_OBJECT_PUT_REF_AND_RESET(shared_lib_handle);
-       return plugin_set;
+       return status;
 }
 
 static
This page took 0.041705 seconds and 4 git commands to generate.