[babeltrace.git] / plugins / lttng-utils / debug-info.h

#ifndef BABELTRACE_PLUGIN_DEBUG_INFO_H
#define BABELTRACE_PLUGIN_DEBUG_INFO_H

/*
 * Babeltrace - Debug information Plug-in
 *
 * Copyright (c) 2015 EfficiOS Inc.
 * Copyright (c) 2015 Antoine Busque <abusque@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 <stdbool.h>
#include <stdint.h>
#include <stddef.h>
#include <babeltrace/babeltrace-internal.h>
#include <babeltrace/babeltrace.h>

enum debug_info_stream_state {
	/*
	 * We know the stream exists but we have never received a
	 * stream_begin notification for it.
	 */
	DEBUG_INFO_UNKNOWN_STREAM,
	/* We know this stream is active (between stream_begin and _end). */
	DEBUG_INFO_ACTIVE_STREAM,
	/* We have received a stream_end for this stream. */
	DEBUG_INFO_COMPLETED_STREAM,
};

struct debug_info_component {
	FILE *err;
	char *arg_debug_info_field_name;
	const char *arg_debug_dir;
	bool arg_full_path;
	const char *arg_target_prefix;
};

struct debug_info_iterator {
	struct debug_info_component *debug_info_component;
	/* Map between struct bt_trace and struct bt_writer. */
	GHashTable *trace_map;
	/* Input iterators associated with this output iterator. */
	GPtrArray *input_iterator_group;
	struct bt_notification *current_notification;
	struct bt_notification_iterator *input_iterator;
	FILE *err;
};

struct debug_info_trace {
	struct bt_trace *trace;
	struct bt_trace *writer_trace;
	struct debug_info_component *debug_info_component;
	struct debug_info_iterator *debug_it;
	int static_listener_id;
	int trace_static;
	/* Map between reader and writer stream. */
	GHashTable *stream_map;
	/* Map between reader and writer stream class. */
	GHashTable *stream_class_map;
	/* Map between reader and writer stream class. */
	GHashTable *packet_map;
	/* Map between a trace_class and its corresponding debug_info. */
	GHashTable *trace_debug_map;
	/* Map between a stream and enum debug_info_stream_state. */
	GHashTable *stream_states;
};

struct debug_info_source {
	/* Strings are owned by debug_info_source. */
	char *func;
	uint64_t line_no;
	char *src_path;
	/* short_src_path points inside src_path, no need to free. */
	const char *short_src_path;
	char *bin_path;
	/* short_bin_path points inside bin_path, no need to free. */
	const char *short_bin_path;
	/*
	 * Location within the binary. Either absolute (@0x1234) or
	 * relative (+0x4321).
	 */
	char *bin_loc;
};

BT_HIDDEN
struct debug_info *debug_info_create(struct debug_info_component *comp);

BT_HIDDEN
void debug_info_destroy(struct debug_info *debug_info);

BT_HIDDEN
struct debug_info_source *debug_info_query(struct debug_info *debug_info,
		int64_t vpid, uint64_t ip);

BT_HIDDEN
void debug_info_handle_event(FILE *err, struct bt_event *event,
		struct debug_info *debug_info);

BT_HIDDEN
void debug_info_close_trace(struct debug_info_iterator *debug_it,
		struct debug_info_trace *di_trace);

#endif /* BABELTRACE_PLUGIN_DEBUG_INFO_H */
Commit	Line	Data
4f45f9bb JD	1	#ifndef BABELTRACE_PLUGIN_DEBUG_INFO_H
	2	#define BABELTRACE_PLUGIN_DEBUG_INFO_H
	3
	4	/*
	5	* Babeltrace - Debug information Plug-in
	6	*
	7	* Copyright (c) 2015 EfficiOS Inc.
	8	* Copyright (c) 2015 Antoine Busque <abusque@efficios.com>
	9	*
	10	* Permission is hereby granted, free of charge, to any person obtaining a copy
	11	* of this software and associated documentation files (the "Software"), to deal
	12	* in the Software without restriction, including without limitation the rights
	13	* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
	14	* copies of the Software, and to permit persons to whom the Software is
	15	* furnished to do so, subject to the following conditions:
	16	*
	17	* The above copyright notice and this permission notice shall be included in
	18	* all copies or substantial portions of the Software.
	19	*
	20	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	21	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	22	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
	23	* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
	24	* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
	25	* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
	26	* SOFTWARE.
	27	*/
	28
	29	#include <stdbool.h>
	30	#include <stdint.h>
	31	#include <stddef.h>
	32	#include <babeltrace/babeltrace-internal.h>
9d408fca	33	#include <babeltrace/babeltrace.h>
4f45f9bb	34
1c78e839 JD	35	enum debug_info_stream_state {
	36	/*
	37	* We know the stream exists but we have never received a
	38	* stream_begin notification for it.
	39	*/
	40	DEBUG_INFO_UNKNOWN_STREAM,
	41	/* We know this stream is active (between stream_begin and _end). */
	42	DEBUG_INFO_ACTIVE_STREAM,
	43	/* We have received a stream_end for this stream. */
	44	DEBUG_INFO_COMPLETED_STREAM,
	45	};
	46
4f45f9bb JD	47	struct debug_info_component {
	48	FILE *err;
	49	char *arg_debug_info_field_name;
	50	const char *arg_debug_dir;
	51	bool arg_full_path;
	52	const char *arg_target_prefix;
	53	};
	54
	55	struct debug_info_iterator {
	56	struct debug_info_component *debug_info_component;
50842bdc	57	/* Map between struct bt_trace and struct bt_writer. */
4f45f9bb	58	GHashTable *trace_map;
504db471 JD	59	/* Input iterators associated with this output iterator. */
	60	GPtrArray *input_iterator_group;
	61	struct bt_notification *current_notification;
	62	struct bt_notification_iterator *input_iterator;
	63	FILE *err;
	64	};
	65
	66	struct debug_info_trace {
50842bdc PP	67	struct bt_trace *trace;
50842bdc PP	68	struct bt_trace *writer_trace;
504db471	69	struct debug_info_component *debug_info_component;
1c78e839	70	struct debug_info_iterator *debug_it;
504db471 JD	71	int static_listener_id;
504db471 JD	72	int trace_static;
4f45f9bb JD	73	/* Map between reader and writer stream. */
	74	GHashTable *stream_map;
	75	/* Map between reader and writer stream class. */
	76	GHashTable *stream_class_map;
	77	/* Map between reader and writer stream class. */
	78	GHashTable *packet_map;
	79	/* Map between a trace_class and its corresponding debug_info. */
	80	GHashTable *trace_debug_map;
1c78e839 JD	81	/* Map between a stream and enum debug_info_stream_state. */
1c78e839 JD	82	GHashTable *stream_states;
4f45f9bb JD	83	};
	84
	85	struct debug_info_source {
	86	/* Strings are owned by debug_info_source. */
	87	char *func;
	88	uint64_t line_no;
	89	char *src_path;
	90	/* short_src_path points inside src_path, no need to free. */
	91	const char *short_src_path;
	92	char *bin_path;
	93	/* short_bin_path points inside bin_path, no need to free. */
	94	const char *short_bin_path;
	95	/*
	96	* Location within the binary. Either absolute (@0x1234) or
	97	* relative (+0x4321).
	98	*/
	99	char *bin_loc;
	100	};
	101
	102	BT_HIDDEN
9d325e17	103	struct debug_info debug_info_create(struct debug_info_component comp);
4f45f9bb JD	104
	105	BT_HIDDEN
	106	void debug_info_destroy(struct debug_info *debug_info);
	107
	108	BT_HIDDEN
	109	struct debug_info_source debug_info_query(struct debug_info debug_info,
	110	int64_t vpid, uint64_t ip);
	111
	112	BT_HIDDEN
50842bdc	113	void debug_info_handle_event(FILE err, struct bt_event event,
4f45f9bb JD	114	struct debug_info *debug_info);
4f45f9bb JD	115
1c78e839 JD	116	BT_HIDDEN
	117	void debug_info_close_trace(struct debug_info_iterator *debug_it,
	118	struct debug_info_trace *di_trace);
	119
4f45f9bb	120	#endif /* BABELTRACE_PLUGIN_DEBUG_INFO_H */