[babeltrace.git] / src / bindings / python / bt2 / bt2 / native_bt_autodisc.i.h

/*
 * The MIT License (MIT)
 *
 * Copyright (c) 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 <autodisc/autodisc.h>
#include <common/common.h>

/*
 * Interface between the Python bindings and the auto source discovery system:
 * input strings go in, specs for components to instantiate go out.
 *
 * `inputs` must be an array of strings, the list of inputs in which to look
 * for traces.  `plugin_set` is the set of plugins to query.
 *
 * Returns a map with the following entries:
 *
 *   - status: signed integer, return status of this function
 *   - results: array, each element is an array describing one auto
 *              source discovery result (see `struct
 *              auto_source_discovery_result` for more details about these):
 *
 *     - 0: plugin name, string
 *     - 1: class name, string
 *     - 2: inputs, array of strings
 *     - 3: original input indices, array of unsigned integers
 *
 * This function can also return None, if it failed to allocate memory
 * for the return value and status code.
 */
bt_value *bt_bt2_auto_discover_source_components(const bt_value *inputs,
		const bt_plugin_set *plugin_set)
{
	uint64_t i;
	int status = 0;
	static const char * const module_name = "Automatic source discovery";
	const bt_plugin **plugins = NULL;
	const uint64_t plugin_count = bt_plugin_set_get_plugin_count(plugin_set);
	struct auto_source_discovery auto_disc = { 0 };
	bt_value *result = NULL;
	bt_value *components_list = NULL;
	bt_value *component_info = NULL;
	bt_value_map_insert_entry_status insert_entry_status;

	BT_ASSERT(bt_value_get_type(inputs) == BT_VALUE_TYPE_ARRAY);
	for (i = 0; i < bt_value_array_get_length(inputs); i++) {
		const bt_value *elem = bt_value_array_borrow_element_by_index_const(inputs, i);
		BT_ASSERT(bt_value_get_type(elem) == BT_VALUE_TYPE_STRING);
	}

	result = bt_value_map_create();
	if (!result) {
		static const char * const err = "Failed to create a map value.";
		BT_LOGE_STR(err);
		BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name, err);
		PyErr_NoMemory();
		goto end;
	}

	status = auto_source_discovery_init(&auto_disc);
	if (status != 0) {
		BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
                	"Failed to initialize auto source discovery structure.");
                goto error;
	}

	/* Create array of bt_plugin pointers from plugin set. */
	plugins = g_new(const bt_plugin *, plugin_count);
	if (!plugins) {
		BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
                	"Failed to allocate plugins array.");
		status = __BT_FUNC_STATUS_MEMORY_ERROR;
                goto error;
	}

	for (i = 0; i < plugin_count; i++) {
		plugins[i] = bt_plugin_set_borrow_plugin_by_index_const(plugin_set, i);
	}

	status = auto_discover_source_components(
		inputs,
		plugins,
		plugin_count,
		NULL,
		bt_python_bindings_bt2_log_level,
		&auto_disc,
		NULL);
	if (status != 0) {
		BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
                	"Failed to auto discover sources.");
		goto error;
	}

	components_list = bt_value_array_create();
	if (!components_list) {
		BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
                	"Failed to allocate one array value.");
		status = __BT_FUNC_STATUS_MEMORY_ERROR;
		goto error;
	}

	insert_entry_status = bt_value_map_insert_entry(result, "results", components_list);
	if (insert_entry_status != BT_VALUE_MAP_INSERT_ENTRY_STATUS_OK) {
		BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
                	"Failed to insert a map entry.");
		status = (int) insert_entry_status;
		goto error;
	}

	for (i = 0; i < auto_disc.results->len; i++) {
		struct auto_source_discovery_result *result =
			g_ptr_array_index(auto_disc.results, i);
		bt_value_array_append_element_status append_element_status;

		component_info = bt_value_array_create();
		if (!component_info) {
			BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
                		"Failed to allocate one array value.");
			status = __BT_FUNC_STATUS_MEMORY_ERROR;
			goto error;
		}

		append_element_status = bt_value_array_append_string_element(
			component_info, result->plugin_name);
		if (append_element_status != BT_VALUE_ARRAY_APPEND_ELEMENT_STATUS_OK) {
			BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
                		"Failed to append one array element.");
			status = (int) append_element_status;
			goto error;
		}

		append_element_status = bt_value_array_append_string_element(
			component_info, result->source_cc_name);
		if (append_element_status != BT_VALUE_ARRAY_APPEND_ELEMENT_STATUS_OK) {
			BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
                		"Failed to append one array element.");
			status = (int) append_element_status;
			goto error;
		}

		append_element_status = bt_value_array_append_element(
			component_info, result->inputs);
		if (append_element_status != BT_VALUE_ARRAY_APPEND_ELEMENT_STATUS_OK) {
			BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
                		"Failed to append one array element.");
			status = (int) append_element_status;
			goto error;
		}

		append_element_status = bt_value_array_append_element(
			component_info, result->original_input_indices);
		if (append_element_status != BT_VALUE_ARRAY_APPEND_ELEMENT_STATUS_OK) {
			BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
                		"Failed to append one array element.");
			status = (int) append_element_status;
			goto error;
		}

		append_element_status = bt_value_array_append_element(components_list,
			component_info);
		if (append_element_status != BT_VALUE_ARRAY_APPEND_ELEMENT_STATUS_OK) {
			BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
                		"Failed to append one array element.");
			status = (int) append_element_status;
			goto error;
		}

		BT_VALUE_PUT_REF_AND_RESET(component_info);
	}

	status = 0;
	goto end;
error:
	BT_ASSERT(status != 0);

end:
	if (result) {
		insert_entry_status = bt_value_map_insert_signed_integer_entry(result, "status", status);
		if (insert_entry_status != BT_VALUE_MAP_INSERT_ENTRY_STATUS_OK) {
			BT_VALUE_PUT_REF_AND_RESET(result);
			PyErr_NoMemory();
		}
	}

	auto_source_discovery_fini(&auto_disc);
	g_free(plugins);
	bt_value_put_ref(components_list);
	bt_value_put_ref(component_info);

	return result;
}
Commit	Line	Data
f3c9a159 SM	1	/*
	2	* The MIT License (MIT)
	3	*
	4	* Copyright (c) 2016 Philippe Proulx <pproulx@efficios.com>
	5	*
	6	* Permission is hereby granted, free of charge, to any person obtaining a copy
	7	* of this software and associated documentation files (the "Software"), to deal
	8	* in the Software without restriction, including without limitation the rights
	9	* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
	10	* copies of the Software, and to permit persons to whom the Software is
	11	* furnished to do so, subject to the following conditions:
	12	*
	13	* The above copyright notice and this permission notice shall be included in
	14	* all copies or substantial portions of the Software.
	15	*
	16	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	17	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	18	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
	19	* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
	20	* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
	21	* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
	22	* THE SOFTWARE.
	23	*/
	24
	25	#include <autodisc/autodisc.h>
	26	#include <common/common.h>
	27
	28	/*
	29	* Interface between the Python bindings and the auto source discovery system:
	30	* input strings go in, specs for components to instantiate go out.
	31	*
	32	* `inputs` must be an array of strings, the list of inputs in which to look
	33	* for traces. `plugin_set` is the set of plugins to query.
	34	*
	35	* Returns a map with the following entries:
	36	*
	37	* - status: signed integer, return status of this function
	38	* - results: array, each element is an array describing one auto
	39	* source discovery result (see `struct
	40	* auto_source_discovery_result` for more details about these):
	41	*
	42	* - 0: plugin name, string
	43	* - 1: class name, string
	44	* - 2: inputs, array of strings
	45	* - 3: original input indices, array of unsigned integers
	46	*
	47	* This function can also return None, if it failed to allocate memory
	48	* for the return value and status code.
	49	*/
	50	bt_value bt_bt2_auto_discover_source_components(const bt_value inputs,
	51	const bt_plugin_set *plugin_set)
	52	{
	53	uint64_t i;
	54	int status = 0;
	55	static const char * const module_name = "Automatic source discovery";
	56	const bt_plugin **plugins = NULL;
	57	const uint64_t plugin_count = bt_plugin_set_get_plugin_count(plugin_set);
	58	struct auto_source_discovery auto_disc = { 0 };
	59	bt_value *result = NULL;
	60	bt_value *components_list = NULL;
	61	bt_value *component_info = NULL;
	62	bt_value_map_insert_entry_status insert_entry_status;
	63
	64	BT_ASSERT(bt_value_get_type(inputs) == BT_VALUE_TYPE_ARRAY);
393729a6	65	for (i = 0; i < bt_value_array_get_length(inputs); i++) {
f3c9a159 SM	66	const bt_value *elem = bt_value_array_borrow_element_by_index_const(inputs, i);
	67	BT_ASSERT(bt_value_get_type(elem) == BT_VALUE_TYPE_STRING);
	68	}
	69
	70	result = bt_value_map_create();
	71	if (!result) {
	72	static const char * const err = "Failed to create a map value.";
	73	BT_LOGE_STR(err);
	74	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name, err);
	75	PyErr_NoMemory();
	76	goto end;
	77	}
	78
	79	status = auto_source_discovery_init(&auto_disc);
	80	if (status != 0) {
	81	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
	82	"Failed to initialize auto source discovery structure.");
	83	goto error;
	84	}
	85
	86	/* Create array of bt_plugin pointers from plugin set. */
	87	plugins = g_new(const bt_plugin *, plugin_count);
	88	if (!plugins) {
	89	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
	90	"Failed to allocate plugins array.");
	91	status = __BT_FUNC_STATUS_MEMORY_ERROR;
	92	goto error;
	93	}
	94
	95	for (i = 0; i < plugin_count; i++) {
	96	plugins[i] = bt_plugin_set_borrow_plugin_by_index_const(plugin_set, i);
	97	}
	98
	99	status = auto_discover_source_components(
	100	inputs,
	101	plugins,
	102	plugin_count,
	103	NULL,
	104	bt_python_bindings_bt2_log_level,
3dae1685 SM	105	&auto_disc,
3dae1685 SM	106	NULL);
f3c9a159 SM	107	if (status != 0) {
	108	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
	109	"Failed to auto discover sources.");
	110	goto error;
	111	}
	112
	113	components_list = bt_value_array_create();
	114	if (!components_list) {
	115	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
	116	"Failed to allocate one array value.");
	117	status = __BT_FUNC_STATUS_MEMORY_ERROR;
	118	goto error;
	119	}
	120
	121	insert_entry_status = bt_value_map_insert_entry(result, "results", components_list);
	122	if (insert_entry_status != BT_VALUE_MAP_INSERT_ENTRY_STATUS_OK) {
	123	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
	124	"Failed to insert a map entry.");
	125	status = (int) insert_entry_status;
	126	goto error;
	127	}
	128
	129	for (i = 0; i < auto_disc.results->len; i++) {
	130	struct auto_source_discovery_result *result =
	131	g_ptr_array_index(auto_disc.results, i);
	132	bt_value_array_append_element_status append_element_status;
	133
	134	component_info = bt_value_array_create();
	135	if (!component_info) {
	136	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
	137	"Failed to allocate one array value.");
	138	status = __BT_FUNC_STATUS_MEMORY_ERROR;
	139	goto error;
	140	}
	141
	142	append_element_status = bt_value_array_append_string_element(
	143	component_info, result->plugin_name);
	144	if (append_element_status != BT_VALUE_ARRAY_APPEND_ELEMENT_STATUS_OK) {
	145	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
	146	"Failed to append one array element.");
	147	status = (int) append_element_status;
	148	goto error;
	149	}
	150
	151	append_element_status = bt_value_array_append_string_element(
	152	component_info, result->source_cc_name);
	153	if (append_element_status != BT_VALUE_ARRAY_APPEND_ELEMENT_STATUS_OK) {
	154	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
	155	"Failed to append one array element.");
	156	status = (int) append_element_status;
	157	goto error;
	158	}
	159
	160	append_element_status = bt_value_array_append_element(
	161	component_info, result->inputs);
	162	if (append_element_status != BT_VALUE_ARRAY_APPEND_ELEMENT_STATUS_OK) {
	163	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
	164	"Failed to append one array element.");
	165	status = (int) append_element_status;
	166	goto error;
	167	}
	168
	169	append_element_status = bt_value_array_append_element(
	170	component_info, result->original_input_indices);
171	if (append_element_status != BT_VALUE_ARRAY_APPEND_ELEMENT_STATUS_OK) {
172	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
173	"Failed to append one array element.");
174	status = (int) append_element_status;
175	goto error;
176	}
177
178	append_element_status = bt_value_array_append_element(components_list,
179	component_info);
180	if (append_element_status != BT_VALUE_ARRAY_APPEND_ELEMENT_STATUS_OK) {
181	BT_CURRENT_THREAD_ERROR_APPEND_CAUSE_FROM_UNKNOWN(module_name,
182	"Failed to append one array element.");
183	status = (int) append_element_status;
184	goto error;
185	}
186
187	BT_VALUE_PUT_REF_AND_RESET(component_info);
188	}
189
190	status = 0;
191	goto end;
192	error:
193	BT_ASSERT(status != 0);
194
195	end:
196	if (result) {
197	insert_entry_status = bt_value_map_insert_signed_integer_entry(result, "status", status);
198	if (insert_entry_status != BT_VALUE_MAP_INSERT_ENTRY_STATUS_OK) {
199	BT_VALUE_PUT_REF_AND_RESET(result);
200	PyErr_NoMemory();
201	}
202	}
203
204	auto_source_discovery_fini(&auto_disc);
205	g_free(plugins);
206	bt_value_put_ref(components_list);
207	bt_value_put_ref(component_info);
208
209	return result;
210	}