[babeltrace.git] / plugins / ctf / fs / fs.h

#ifndef BABELTRACE_PLUGIN_CTF_FS_H
#define BABELTRACE_PLUGIN_CTF_FS_H

/*
 * BabelTrace - CTF on File System Component
 *
 * Copyright 2016 Jérémie Galarneau <jeremie.galarneau@efficios.com>
 * Copyright 2016 Philippe Proulx <pproulx@efficios.com>
 *
 * Author: Jérémie Galarneau <jeremie.galarneau@efficios.com>
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */

#include <babeltrace/babeltrace-internal.h>
#include <babeltrace/component/component.h>
#include "data-stream.h"

#define CTF_FS_COMPONENT_DESCRIPTION \
	"Component used to read a CTF trace located on a file system."

BT_HIDDEN
extern bool ctf_fs_debug;

struct bt_notification_heap;

struct ctf_fs_file {
	struct ctf_fs_component *ctf_fs;
	GString *path;
	FILE *fp;
	off_t size;
};

struct ctf_fs_metadata {
	struct bt_ctf_trace *trace;
	uint8_t uuid[16];
	bool is_uuid_set;
	int bo;
	char *text;
};

struct ctf_fs_stream {
	struct ctf_fs_file *file;
	struct bt_ctf_stream *stream;
	/* FIXME There should be many and ctf_fs_stream should not own them. */
	struct bt_ctf_notif_iter *notif_iter;
	/* A stream is assumed to be indexed. */
	struct index index;
	void *mmap_addr;
	/* Max length of chunk to mmap() when updating the current mapping. */
	size_t mmap_max_len;
	/* Length of the current mapping. */
	size_t mmap_len;
	/* Length of the current mapping which *exists* in the backing file. */
	size_t mmap_valid_len;
	/* Offset in the file where the current mapping starts. */
	off_t mmap_offset;
	/*
	 * Offset, in the current mapping, of the address to return on the next
	 * request.
	 */
	off_t request_offset;
	bool end_reached;
};

struct ctf_fs_iterator {
	struct bt_notification_heap *pending_notifications;
	struct bt_notification *current_notification;
	/*
	 * struct ctf_fs_data_stream* which have not yet been associated to a
	 * bt_ctf_stream. The association is performed on the first packet
	 * read by the stream (since, at that point, we have read a packet
	 * header).
	 */
	GPtrArray *pending_streams;
	/* bt_ctf_stream -> ctf_fs_stream */
	GHashTable *stream_ht;
};

struct ctf_fs_component_options {
	bool opt_dummy : 1;
};

struct ctf_fs_component {
	GString *trace_path;
	FILE *error_fp;
	size_t page_size;
	struct ctf_fs_component_options options;
	struct ctf_fs_metadata *metadata;
};

BT_HIDDEN
enum bt_component_status ctf_fs_init(struct bt_component *source,
		struct bt_value *params);

#endif /* BABELTRACE_PLUGIN_CTF_FS_H */
Commit	Line	Data
541b0a11 JG	1	#ifndef BABELTRACE_PLUGIN_CTF_FS_H
541b0a11 JG	2	#define BABELTRACE_PLUGIN_CTF_FS_H
490db841 JG	3
490db841 JG	4	/*
6a29d9fd	5	* BabelTrace - CTF on File System Component
490db841	6	*
f3bc2010	7	* Copyright 2016 Jérémie Galarneau <jeremie.galarneau@efficios.com>
56a1cced	8	* Copyright 2016 Philippe Proulx <pproulx@efficios.com>
490db841 JG	9	*
	10	* Author: Jérémie Galarneau <jeremie.galarneau@efficios.com>
	11	*
	12	* Permission is hereby granted, free of charge, to any person obtaining a copy
	13	* of this software and associated documentation files (the "Software"), to deal
	14	* in the Software without restriction, including without limitation the rights
	15	* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
	16	* copies of the Software, and to permit persons to whom the Software is
	17	* furnished to do so, subject to the following conditions:
	18	*
	19	* The above copyright notice and this permission notice shall be included in
	20	* all copies or substantial portions of the Software.
	21	*
	22	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	23	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	24	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
	25	* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
	26	* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
	27	* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
	28	* SOFTWARE.
	29	*/
	30
f3bc2010	31	#include <babeltrace/babeltrace-internal.h>
33b34c43	32	#include <babeltrace/component/component.h>
b6c3dcb2	33	#include "data-stream.h"
490db841	34
ea0b4b9e	35	#define CTF_FS_COMPONENT_DESCRIPTION \
6a29d9fd	36	"Component used to read a CTF trace located on a file system."
490db841	37
78bb6992 MD	38	BT_HIDDEN
78bb6992 MD	39	extern bool ctf_fs_debug;
56a1cced	40
78586d8a JG	41	struct bt_notification_heap;
78586d8a JG	42
56a1cced JG	43	struct ctf_fs_file {
	44	struct ctf_fs_component *ctf_fs;
	45	GString *path;
	46	FILE *fp;
	47	off_t size;
	48	};
	49
	50	struct ctf_fs_metadata {
	51	struct bt_ctf_trace *trace;
	52	uint8_t uuid[16];
	53	bool is_uuid_set;
	54	int bo;
	55	char *text;
	56	};
	57
	58	struct ctf_fs_stream {
	59	struct ctf_fs_file *file;
	60	struct bt_ctf_stream *stream;
78586d8a	61	/* FIXME There should be many and ctf_fs_stream should not own them. */
56a1cced	62	struct bt_ctf_notif_iter *notif_iter;
b6c3dcb2 JG	63	/* A stream is assumed to be indexed. */
b6c3dcb2 JG	64	struct index index;
56a1cced	65	void *mmap_addr;
fc9a526c JG	66	/* Max length of chunk to mmap() when updating the current mapping. */
	67	size_t mmap_max_len;
	68	/* Length of the current mapping. */
56a1cced	69	size_t mmap_len;
fc9a526c JG	70	/* Length of the current mapping which exists in the backing file. */
	71	size_t mmap_valid_len;
	72	/* Offset in the file where the current mapping starts. */
56a1cced	73	off_t mmap_offset;
fc9a526c JG	74	/*
	75	* Offset, in the current mapping, of the address to return on the next
	76	* request.
	77	*/
56a1cced	78	off_t request_offset;
043e2020	79	bool end_reached;
56a1cced JG	80	};
56a1cced JG	81
760051fa	82	struct ctf_fs_iterator {
78586d8a	83	struct bt_notification_heap *pending_notifications;
5b29e799 JG	84	struct bt_notification *current_notification;
	85	/*
	86	* struct ctf_fs_data_stream* which have not yet been associated to a
	87	* bt_ctf_stream. The association is performed on the first packet
	88	* read by the stream (since, at that point, we have read a packet
	89	* header).
	90	*/
	91	GPtrArray *pending_streams;
	92	/* bt_ctf_stream -> ctf_fs_stream */
	93	GHashTable *stream_ht;
760051fa JG	94	};
760051fa JG	95
ea0b4b9e JG	96	struct ctf_fs_component_options {
	97	bool opt_dummy : 1;
	98	};
	99
	100	struct ctf_fs_component {
56a1cced JG	101	GString *trace_path;
	102	FILE *error_fp;
	103	size_t page_size;
ea0b4b9e	104	struct ctf_fs_component_options options;
5b29e799	105	struct ctf_fs_metadata *metadata;
ea0b4b9e JG	106	};
ea0b4b9e JG	107
f3bc2010	108	BT_HIDDEN
ea0b4b9e	109	enum bt_component_status ctf_fs_init(struct bt_component *source,
f3bc2010	110	struct bt_value *params);
490db841	111
541b0a11	112	#endif /* BABELTRACE_PLUGIN_CTF_FS_H */