[babeltrace.git] / src / plugins / ctf / fs-sink / fs-sink.c

/*
 * Copyright 2019 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.
 */

#define BT_COMP_LOG_SELF_COMP (fs_sink->self_comp)
#define BT_LOG_OUTPUT_LEVEL (fs_sink->log_level)
#define BT_LOG_TAG "PLUGIN/SINK.CTF.FS"
#include "logging/comp-logging.h"

#include <babeltrace2/babeltrace.h>
#include <stdio.h>
#include <stdbool.h>
#include <glib.h>
#include "common/assert.h"
#include "ctfser/ctfser.h"

#include "fs-sink.h"
#include "fs-sink-trace.h"
#include "fs-sink-stream.h"
#include "fs-sink-ctf-meta.h"
#include "translate-trace-ir-to-ctf-ir.h"
#include "translate-ctf-ir-to-tsdl.h"

static
const char * const in_port_name = "in";

static
bt_component_class_init_method_status ensure_output_dir_exists(
		struct fs_sink_comp *fs_sink)
{
	bt_component_class_init_method_status status =
		BT_COMPONENT_CLASS_INIT_METHOD_STATUS_OK;
	int ret;

	ret = g_mkdir_with_parents(fs_sink->output_dir_path->str, 0755);
	if (ret) {
		BT_COMP_LOGE_ERRNO(
			"Cannot create directories for output directory",
			": output-dir-path=\"%s\"",
			fs_sink->output_dir_path->str);
		status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_ERROR;
		goto end;
	}

end:
	return status;
}

static
bt_component_class_init_method_status
configure_component(struct fs_sink_comp *fs_sink,
		const bt_value *params)
{
	bt_component_class_init_method_status status =
		BT_COMPONENT_CLASS_INIT_METHOD_STATUS_OK;
	const bt_value *value;

	value = bt_value_map_borrow_entry_value_const(params, "path");
	if (!value) {
		BT_COMP_LOGE_STR("Missing mandatory `path` parameter.");
		status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_ERROR;
		goto end;
	}

	if (!bt_value_is_string(value)) {
		BT_COMP_LOGE_STR("`path` parameter: expecting a string.");
		status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_ERROR;
		goto end;
	}

	g_string_assign(fs_sink->output_dir_path,
		bt_value_string_get(value));
	value = bt_value_map_borrow_entry_value_const(params,
		"assume-single-trace");
	if (value) {
		if (!bt_value_is_bool(value)) {
			BT_COMP_LOGE_STR("`assume-single-trace` parameter: expecting a boolean.");
			status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_ERROR;
			goto end;
		}

		fs_sink->assume_single_trace = (bool) bt_value_bool_get(value);
	}

	value = bt_value_map_borrow_entry_value_const(params,
		"ignore-discarded-events");
	if (value) {
		if (!bt_value_is_bool(value)) {
			BT_COMP_LOGE_STR("`ignore-discarded-events` parameter: expecting a boolean.");
			status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_ERROR;
			goto end;
		}

		fs_sink->ignore_discarded_events =
			(bool) bt_value_bool_get(value);
	}

	value = bt_value_map_borrow_entry_value_const(params,
		"ignore-discarded-packets");
	if (value) {
		if (!bt_value_is_bool(value)) {
			BT_COMP_LOGE_STR("`ignore-discarded-packets` parameter: expecting a boolean.");
			status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_ERROR;
			goto end;
		}

		fs_sink->ignore_discarded_packets =
			(bool) bt_value_bool_get(value);
	}

	value = bt_value_map_borrow_entry_value_const(params,
		"quiet");
	if (value) {
		if (!bt_value_is_bool(value)) {
			BT_COMP_LOGE_STR("`quiet` parameter: expecting a boolean.");
			status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_ERROR;
			goto end;
		}

		fs_sink->quiet = (bool) bt_value_bool_get(value);
	}

end:
	return status;
}

static
void destroy_fs_sink_comp(struct fs_sink_comp *fs_sink)
{
	if (!fs_sink) {
		goto end;
	}

	if (fs_sink->output_dir_path) {
		g_string_free(fs_sink->output_dir_path, TRUE);
		fs_sink->output_dir_path = NULL;
	}

	if (fs_sink->traces) {
		g_hash_table_destroy(fs_sink->traces);
		fs_sink->traces = NULL;
	}

	BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_PUT_REF_AND_RESET(
		fs_sink->upstream_iter);
	g_free(fs_sink);

end:
	return;
}

BT_HIDDEN
bt_component_class_init_method_status ctf_fs_sink_init(
		bt_self_component_sink *self_comp_sink,
		bt_self_component_sink_configuration *config,
		const bt_value *params,
		void *init_method_data)
{
	bt_component_class_init_method_status status =
		BT_COMPONENT_CLASS_INIT_METHOD_STATUS_OK;
	bt_self_component_add_port_status add_port_status;
	struct fs_sink_comp *fs_sink = NULL;
	bt_self_component *self_comp =
		bt_self_component_sink_as_self_component(self_comp_sink);
	bt_logging_level log_level = bt_component_get_logging_level(
		bt_self_component_as_component(self_comp));

	fs_sink = g_new0(struct fs_sink_comp, 1);
	if (!fs_sink) {
		BT_COMP_LOG_CUR_LVL(BT_LOG_ERROR, log_level, self_comp,
			"Failed to allocate one CTF FS sink structure.");
		status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_MEMORY_ERROR;
		goto end;
	}

	fs_sink->log_level = log_level;
	fs_sink->self_comp = self_comp;
	fs_sink->output_dir_path = g_string_new(NULL);
	status = configure_component(fs_sink, params);
	if (status != BT_COMPONENT_CLASS_INIT_METHOD_STATUS_OK) {
		/* configure_component() logs errors */
		goto end;
	}

	if (fs_sink->assume_single_trace &&
			g_file_test(fs_sink->output_dir_path->str,
				G_FILE_TEST_EXISTS)) {
		BT_COMP_LOGE("Single trace mode, but output path exists: "
			"output-path=\"%s\"", fs_sink->output_dir_path->str);
		status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_ERROR;
		goto end;
	}

	status = ensure_output_dir_exists(fs_sink);
	if (status != BT_COMPONENT_CLASS_INIT_METHOD_STATUS_OK) {
		/* ensure_output_dir_exists() logs errors */
		goto end;
	}

	fs_sink->traces = g_hash_table_new_full(g_direct_hash, g_direct_equal,
		NULL, (GDestroyNotify) fs_sink_trace_destroy);
	if (!fs_sink->traces) {
		BT_COMP_LOGE_STR("Failed to allocate one GHashTable.");
		status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_MEMORY_ERROR;
		goto end;
	}

	add_port_status = bt_self_component_sink_add_input_port(
		self_comp_sink, in_port_name, NULL, NULL);
	switch (add_port_status) {
	case BT_SELF_COMPONENT_ADD_PORT_STATUS_ERROR:
		status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_ERROR;
		goto end;
	case BT_SELF_COMPONENT_ADD_PORT_STATUS_MEMORY_ERROR:
		status = BT_COMPONENT_CLASS_INIT_METHOD_STATUS_MEMORY_ERROR;
		goto end;
	default:
		break;
	}

	bt_self_component_set_data(self_comp, fs_sink);

end:
	if (status != BT_COMPONENT_CLASS_INIT_METHOD_STATUS_OK) {
		destroy_fs_sink_comp(fs_sink);
	}

	return status;
}

static inline
struct fs_sink_stream *borrow_stream(struct fs_sink_comp *fs_sink,
		const bt_stream *ir_stream)
{
	const bt_trace *ir_trace = bt_stream_borrow_trace_const(ir_stream);
	struct fs_sink_trace *trace;
	struct fs_sink_stream *stream = NULL;

	trace = g_hash_table_lookup(fs_sink->traces, ir_trace);
	if (G_UNLIKELY(!trace)) {
		if (fs_sink->assume_single_trace &&
				g_hash_table_size(fs_sink->traces) > 0) {
			BT_COMP_LOGE("Single trace mode, but getting more than one trace: "
				"stream-name=\"%s\"",
				bt_stream_get_name(ir_stream));
			goto end;
		}

		trace = fs_sink_trace_create(fs_sink, ir_trace);
		if (!trace) {
			goto end;
		}
	}

	stream = g_hash_table_lookup(trace->streams, ir_stream);
	if (G_UNLIKELY(!stream)) {
		stream = fs_sink_stream_create(trace, ir_stream);
		if (!stream) {
			goto end;
		}
	}

end:
	return stream;
}

static inline
bt_component_class_sink_consume_method_status handle_event_msg(
		struct fs_sink_comp *fs_sink, const bt_message *msg)
{
	int ret;
	bt_component_class_sink_consume_method_status status =
		BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_OK;
	const bt_event *ir_event = bt_message_event_borrow_event_const(msg);
	const bt_stream *ir_stream = bt_event_borrow_stream_const(ir_event);
	struct fs_sink_stream *stream;
	struct fs_sink_ctf_event_class *ec = NULL;
	const bt_clock_snapshot *cs = NULL;

	stream = borrow_stream(fs_sink, ir_stream);
	if (G_UNLIKELY(!stream)) {
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	ret = try_translate_event_class_trace_ir_to_ctf_ir(fs_sink,
		stream->sc, bt_event_borrow_class_const(ir_event), &ec);
	if (ret) {
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	BT_ASSERT(ec);

	if (stream->sc->default_clock_class) {
		cs = bt_message_event_borrow_default_clock_snapshot_const(
			msg);
	}

	/*
	 * If this event's stream does not support packets, then we
	 * lazily create artificial packets.
	 *
	 * The size of an artificial packet is arbitrarily at least
	 * 4 MiB (it usually is greater because we close it when
	 * comes the time to write a new event and the packet's content
	 * size is >= 4 MiB), except the last one which can be smaller.
	 */
	if (G_UNLIKELY(!stream->sc->has_packets)) {
		if (stream->packet_state.is_open &&
				bt_ctfser_get_offset_in_current_packet_bits(&stream->ctfser) / 8 >=
				4 * 1024 * 1024) {
			/*
			 * Stream's current packet is larger than 4 MiB:
			 * close it. A new packet will be opened just
			 * below.
			 */
			ret = fs_sink_stream_close_packet(stream, NULL);
			if (ret) {
				status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
				goto end;
			}
		}

		if (!stream->packet_state.is_open) {
			/* Stream's packet is not currently opened: open it */
			ret = fs_sink_stream_open_packet(stream, NULL, NULL);
			if (ret) {
				status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
				goto end;
			}
		}
	}

	BT_ASSERT(stream->packet_state.is_open);
	ret = fs_sink_stream_write_event(stream, cs, ir_event, ec);
	if (G_UNLIKELY(ret)) {
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

end:
	return status;
}

static inline
bt_component_class_sink_consume_method_status handle_packet_beginning_msg(
		struct fs_sink_comp *fs_sink, const bt_message *msg)
{
	int ret;
	bt_component_class_sink_consume_method_status status =
		BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_OK;
	const bt_packet *ir_packet =
		bt_message_packet_beginning_borrow_packet_const(msg);
	const bt_stream *ir_stream = bt_packet_borrow_stream_const(ir_packet);
	struct fs_sink_stream *stream;
	const bt_clock_snapshot *cs = NULL;

	stream = borrow_stream(fs_sink, ir_stream);
	if (G_UNLIKELY(!stream)) {
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	if (stream->sc->packets_have_ts_begin) {
		cs = bt_message_packet_beginning_borrow_default_clock_snapshot_const(
			msg);
		BT_ASSERT(cs);
	}

	/*
	 * If we previously received a discarded events message with
	 * a time range, make sure that its beginning time matches what's
	 * expected for CTF 1.8, that is:
	 *
	 * * Its beginning time is the previous packet's end
	 *   time (or the current packet's beginning time if
	 *   this is the first packet).
	 *
	 * We check this here instead of in handle_packet_end_msg()
	 * because we want to catch any incompatible message as early as
	 * possible to report the error.
	 *
	 * Validation of the discarded events message's end time is
	 * performed in handle_packet_end_msg().
	 */
	if (stream->discarded_events_state.in_range) {
		uint64_t expected_cs;

		/*
		 * `stream->discarded_events_state.in_range` is only set
		 * when the stream class's discarded events have a time
		 * range.
		 *
		 * It is required that the packet beginning and end
		 * messages for this stream class have times when
		 * discarded events have a time range.
		 */
		BT_ASSERT(stream->sc->discarded_events_has_ts);
		BT_ASSERT(stream->sc->packets_have_ts_begin);
		BT_ASSERT(stream->sc->packets_have_ts_end);

		if (stream->prev_packet_state.end_cs == UINT64_C(-1)) {
			/* We're opening the first packet */
			expected_cs = bt_clock_snapshot_get_value(cs);
		} else {
			expected_cs = stream->prev_packet_state.end_cs;
		}

		if (stream->discarded_events_state.beginning_cs !=
				expected_cs) {
			BT_COMP_LOGE("Incompatible discarded events message: "
				"unexpected beginning time: "
				"beginning-cs-val=%" PRIu64 ", "
				"expected-beginning-cs-val=%" PRIu64 ", "
				"stream-id=%" PRIu64 ", stream-name=\"%s\", "
				"trace-name=\"%s\", path=\"%s/%s\"",
				stream->discarded_events_state.beginning_cs,
				expected_cs,
				bt_stream_get_id(ir_stream),
				bt_stream_get_name(ir_stream),
				bt_trace_get_name(
					bt_stream_borrow_trace_const(ir_stream)),
				stream->trace->path->str, stream->file_name->str);
			status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
			goto end;
		}
	}

	/*
	 * If we previously received a discarded packets message with a
	 * time range, make sure that its beginning and end times match
	 * what's expected for CTF 1.8, that is:
	 *
	 * * Its beginning time is the previous packet's end time.
	 *
	 * * Its end time is the current packet's beginning time.
	 */
	if (stream->discarded_packets_state.in_range) {
		uint64_t expected_end_cs;

		/*
		 * `stream->discarded_packets_state.in_range` is only
		 * set when the stream class's discarded packets have a
		 * time range.
		 *
		 * It is required that the packet beginning and end
		 * messages for this stream class have times when
		 * discarded packets have a time range.
		 */
		BT_ASSERT(stream->sc->discarded_packets_has_ts);
		BT_ASSERT(stream->sc->packets_have_ts_begin);
		BT_ASSERT(stream->sc->packets_have_ts_end);

		/*
		 * It is not supported to have a discarded packets
		 * message _before_ the first packet: we cannot validate
		 * that its beginning time is compatible with CTF 1.8 in
		 * this case.
		 */
		if (stream->prev_packet_state.end_cs == UINT64_C(-1)) {
			BT_COMP_LOGE("Incompatible discarded packets message "
				"occuring before the stream's first packet: "
				"stream-id=%" PRIu64 ", stream-name=\"%s\", "
				"trace-name=\"%s\", path=\"%s/%s\"",
				bt_stream_get_id(ir_stream),
				bt_stream_get_name(ir_stream),
				bt_trace_get_name(
					bt_stream_borrow_trace_const(ir_stream)),
				stream->trace->path->str, stream->file_name->str);
			status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
			goto end;
		}

		if (stream->discarded_packets_state.beginning_cs !=
				stream->prev_packet_state.end_cs) {
			BT_COMP_LOGE("Incompatible discarded packets message: "
				"unexpected beginning time: "
				"beginning-cs-val=%" PRIu64 ", "
				"expected-beginning-cs-val=%" PRIu64 ", "
				"stream-id=%" PRIu64 ", stream-name=\"%s\", "
				"trace-name=\"%s\", path=\"%s/%s\"",
				stream->discarded_packets_state.beginning_cs,
				stream->prev_packet_state.end_cs,
				bt_stream_get_id(ir_stream),
				bt_stream_get_name(ir_stream),
				bt_trace_get_name(
					bt_stream_borrow_trace_const(ir_stream)),
				stream->trace->path->str, stream->file_name->str);
			status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
			goto end;
		}

		expected_end_cs = bt_clock_snapshot_get_value(cs);

		if (stream->discarded_packets_state.end_cs !=
				expected_end_cs) {
			BT_COMP_LOGE("Incompatible discarded packets message: "
				"unexpected end time: "
				"end-cs-val=%" PRIu64 ", "
				"expected-end-cs-val=%" PRIu64 ", "
				"stream-id=%" PRIu64 ", stream-name=\"%s\", "
				"trace-name=\"%s\", path=\"%s/%s\"",
				stream->discarded_packets_state.end_cs,
				expected_end_cs,
				bt_stream_get_id(ir_stream),
				bt_stream_get_name(ir_stream),
				bt_trace_get_name(
					bt_stream_borrow_trace_const(ir_stream)),
				stream->trace->path->str, stream->file_name->str);
			status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
			goto end;
		}
	}

	/*
	 * We're not in a discarded packets time range anymore since we
	 * require that the discarded packets time ranges go from one
	 * packet's end time to the next packet's beginning time, and
	 * we're handling a packet beginning message here.
	 */
	stream->discarded_packets_state.in_range = false;

	ret = fs_sink_stream_open_packet(stream, cs, ir_packet);
	if (ret) {
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

end:
	return status;
}

static inline
bt_component_class_sink_consume_method_status handle_packet_end_msg(
		struct fs_sink_comp *fs_sink, const bt_message *msg)
{
	int ret;
	bt_component_class_sink_consume_method_status status =
		BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_OK;
	const bt_packet *ir_packet =
		bt_message_packet_end_borrow_packet_const(msg);
	const bt_stream *ir_stream = bt_packet_borrow_stream_const(ir_packet);
	struct fs_sink_stream *stream;
	const bt_clock_snapshot *cs = NULL;

	stream = borrow_stream(fs_sink, ir_stream);
	if (G_UNLIKELY(!stream)) {
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	if (stream->sc->packets_have_ts_end) {
		cs = bt_message_packet_end_borrow_default_clock_snapshot_const(
			msg);
		BT_ASSERT(cs);
	}

	/*
	 * If we previously received a discarded events message with
	 * a time range, make sure that its end time matches what's
	 * expected for CTF 1.8, that is:
	 *
	 * * Its end time is the current packet's end time.
	 *
	 * Validation of the discarded events message's beginning time
	 * is performed in handle_packet_beginning_msg().
	 */
	if (stream->discarded_events_state.in_range) {
		uint64_t expected_cs;

		/*
		 * `stream->discarded_events_state.in_range` is only set
		 * when the stream class's discarded events have a time
		 * range.
		 *
		 * It is required that the packet beginning and end
		 * messages for this stream class have times when
		 * discarded events have a time range.
		 */
		BT_ASSERT(stream->sc->discarded_events_has_ts);
		BT_ASSERT(stream->sc->packets_have_ts_begin);
		BT_ASSERT(stream->sc->packets_have_ts_end);

		expected_cs = bt_clock_snapshot_get_value(cs);

		if (stream->discarded_events_state.end_cs != expected_cs) {
			BT_COMP_LOGE("Incompatible discarded events message: "
				"unexpected end time: "
				"end-cs-val=%" PRIu64 ", "
				"expected-end-cs-val=%" PRIu64 ", "
				"stream-id=%" PRIu64 ", stream-name=\"%s\", "
				"trace-name=\"%s\", path=\"%s/%s\"",
				stream->discarded_events_state.end_cs,
				expected_cs,
				bt_stream_get_id(ir_stream),
				bt_stream_get_name(ir_stream),
				bt_trace_get_name(
					bt_stream_borrow_trace_const(ir_stream)),
				stream->trace->path->str, stream->file_name->str);
			status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
			goto end;
		}
	}

	ret = fs_sink_stream_close_packet(stream, cs);
	if (ret) {
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	/*
	 * We're not in a discarded events time range anymore since we
	 * require that the discarded events time ranges go from one
	 * packet's end time to the next packet's end time, and we're
	 * handling a packet end message here.
	 */
	stream->discarded_events_state.in_range = false;

end:
	return status;
}

static inline
bt_component_class_sink_consume_method_status handle_stream_beginning_msg(
		struct fs_sink_comp *fs_sink, const bt_message *msg)
{
	bt_component_class_sink_consume_method_status status =
		BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_OK;
	const bt_stream *ir_stream =
		bt_message_stream_beginning_borrow_stream_const(msg);
	const bt_stream_class *ir_sc =
		bt_stream_borrow_class_const(ir_stream);
	struct fs_sink_stream *stream;
	bool packets_have_beginning_end_cs =
		bt_stream_class_packets_have_beginning_default_clock_snapshot(ir_sc) &&
		bt_stream_class_packets_have_end_default_clock_snapshot(ir_sc);

	/*
	 * Not supported: discarded events or discarded packets support
	 * without packets support. Packets are the way to know where
	 * discarded events/packets occured in CTF 1.8.
	 */
	if (!bt_stream_class_supports_packets(ir_sc)) {
		BT_ASSERT(!bt_stream_class_supports_discarded_packets(ir_sc));

		if (!fs_sink->ignore_discarded_events &&
				bt_stream_class_supports_discarded_events(ir_sc)) {
			BT_COMP_LOGE("Unsupported stream: "
				"stream does not support packets, "
				"but supports discarded events: "
				"stream-addr=%p, "
				"stream-id=%" PRIu64 ", "
				"stream-name=\"%s\"",
				ir_stream, bt_stream_get_id(ir_stream),
				bt_stream_get_name(ir_stream));
			status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
			goto end;
		}
	}

	/*
	 * Not supported: discarded events with default clock snapshots,
	 * but packet beginning/end without default clock snapshot.
	 */
	if (!fs_sink->ignore_discarded_events &&
			bt_stream_class_discarded_events_have_default_clock_snapshots(ir_sc) &&
			!packets_have_beginning_end_cs) {
		BT_COMP_LOGE("Unsupported stream: discarded events have "
			"default clock snapshots, but packets have no "
			"beginning and/or end default clock snapshots: "
			"stream-addr=%p, "
			"stream-id=%" PRIu64 ", "
			"stream-name=\"%s\"",
			ir_stream, bt_stream_get_id(ir_stream),
			bt_stream_get_name(ir_stream));
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	/*
	 * Not supported: discarded packets with default clock
	 * snapshots, but packet beginning/end without default clock
	 * snapshot.
	 */
	if (!fs_sink->ignore_discarded_packets &&
			bt_stream_class_discarded_packets_have_default_clock_snapshots(ir_sc) &&
			!packets_have_beginning_end_cs) {
		BT_COMP_LOGE("Unsupported stream: discarded packets have "
			"default clock snapshots, but packets have no "
			"beginning and/or end default clock snapshots: "
			"stream-addr=%p, "
			"stream-id=%" PRIu64 ", "
			"stream-name=\"%s\"",
			ir_stream, bt_stream_get_id(ir_stream),
			bt_stream_get_name(ir_stream));
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	stream = borrow_stream(fs_sink, ir_stream);
	if (!stream) {
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	BT_COMP_LOGI("Created new, empty stream file: "
		"stream-id=%" PRIu64 ", stream-name=\"%s\", "
		"trace-name=\"%s\", path=\"%s/%s\"",
		bt_stream_get_id(ir_stream), bt_stream_get_name(ir_stream),
		bt_trace_get_name(bt_stream_borrow_trace_const(ir_stream)),
		stream->trace->path->str, stream->file_name->str);

end:
	return status;
}

static inline
bt_component_class_sink_consume_method_status handle_stream_end_msg(
		struct fs_sink_comp *fs_sink, const bt_message *msg)
{
	bt_component_class_sink_consume_method_status status =
		BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_OK;
	const bt_stream *ir_stream =
		bt_message_stream_end_borrow_stream_const(msg);
	struct fs_sink_stream *stream;

	stream = borrow_stream(fs_sink, ir_stream);
	if (!stream) {
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	if (G_UNLIKELY(!stream->sc->has_packets &&
			stream->packet_state.is_open)) {
		/* Close stream's current artificial packet */
		int ret = fs_sink_stream_close_packet(stream, NULL);

		if (ret) {
			status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
			goto end;
		}
	}

	BT_COMP_LOGI("Closing stream file: "
		"stream-id=%" PRIu64 ", stream-name=\"%s\", "
		"trace-name=\"%s\", path=\"%s/%s\"",
		bt_stream_get_id(ir_stream), bt_stream_get_name(ir_stream),
		bt_trace_get_name(bt_stream_borrow_trace_const(ir_stream)),
		stream->trace->path->str, stream->file_name->str);

	/*
	 * This destroys the stream object and frees all its resources,
	 * closing the stream file.
	 */
	g_hash_table_remove(stream->trace->streams, ir_stream);

end:
	return status;
}

static inline
bt_component_class_sink_consume_method_status handle_discarded_events_msg(
		struct fs_sink_comp *fs_sink, const bt_message *msg)
{
	bt_component_class_sink_consume_method_status status =
		BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_OK;
	const bt_stream *ir_stream =
		bt_message_discarded_events_borrow_stream_const(msg);
	struct fs_sink_stream *stream;
	const bt_clock_snapshot *cs = NULL;
	bt_property_availability avail;
	uint64_t count;

	stream = borrow_stream(fs_sink, ir_stream);
	if (!stream) {
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	if (fs_sink->ignore_discarded_events) {
		BT_COMP_LOGI("Ignoring discarded events message: "
			"stream-id=%" PRIu64 ", stream-name=\"%s\", "
			"trace-name=\"%s\", path=\"%s/%s\"",
			bt_stream_get_id(ir_stream),
			bt_stream_get_name(ir_stream),
			bt_trace_get_name(
				bt_stream_borrow_trace_const(ir_stream)),
			stream->trace->path->str, stream->file_name->str);
		goto end;
	}

	if (stream->discarded_events_state.in_range) {
		BT_COMP_LOGE("Unsupported contiguous discarded events message: "
			"stream-id=%" PRIu64 ", stream-name=\"%s\", "
			"trace-name=\"%s\", path=\"%s/%s\"",
			bt_stream_get_id(ir_stream),
			bt_stream_get_name(ir_stream),
			bt_trace_get_name(
				bt_stream_borrow_trace_const(ir_stream)),
			stream->trace->path->str, stream->file_name->str);
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	/*
	 * If we're currently in an opened packet (got a packet
	 * beginning message, but no packet end message yet), we do not
	 * support having a discarded events message with a time range
	 * because we require that the discarded events message's time
	 * range go from a packet's end time to the next packet's end
	 * time.
	 */
	if (stream->packet_state.is_open &&
			stream->sc->discarded_events_has_ts) {
		BT_COMP_LOGE("Unsupported discarded events message with "
			"default clock snapshots occuring within a packet: "
			"stream-id=%" PRIu64 ", stream-name=\"%s\", "
			"trace-name=\"%s\", path=\"%s/%s\"",
			bt_stream_get_id(ir_stream),
			bt_stream_get_name(ir_stream),
			bt_trace_get_name(
				bt_stream_borrow_trace_const(ir_stream)),
			stream->trace->path->str, stream->file_name->str);
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	if (stream->sc->discarded_events_has_ts) {
		/*
		 * Make the stream's state be in the time range of a
		 * discarded events message since we have the message's
		 * time range (`stream->sc->discarded_events_has_ts`).
		 */
		stream->discarded_events_state.in_range = true;

		/*
		 * The clock snapshot values will be validated when
		 * handling the next packet beginning and end messages
		 * (next calls to handle_packet_beginning_msg() and
		 * handle_packet_end_msg()).
		 */
		cs = bt_message_discarded_events_borrow_beginning_default_clock_snapshot_const(
			msg);
		BT_ASSERT(cs);
		stream->discarded_events_state.beginning_cs =
			bt_clock_snapshot_get_value(cs);
		cs = bt_message_discarded_events_borrow_end_default_clock_snapshot_const(
			msg);
		BT_ASSERT(cs);
		stream->discarded_events_state.end_cs = bt_clock_snapshot_get_value(cs);
	}

	avail = bt_message_discarded_events_get_count(msg, &count);
	if (avail != BT_PROPERTY_AVAILABILITY_AVAILABLE) {
		/*
		 * There's no specific count of discarded events: set it
		 * to 1 so that we know that we at least discarded
		 * something.
		 */
		count = 1;
	}

	stream->packet_state.discarded_events_counter += count;

end:
	return status;
}

static inline
bt_component_class_sink_consume_method_status handle_discarded_packets_msg(
		struct fs_sink_comp *fs_sink, const bt_message *msg)
{
	bt_component_class_sink_consume_method_status status =
		BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_OK;
	const bt_stream *ir_stream =
		bt_message_discarded_packets_borrow_stream_const(msg);
	struct fs_sink_stream *stream;
	const bt_clock_snapshot *cs = NULL;
	bt_property_availability avail;
	uint64_t count;

	stream = borrow_stream(fs_sink, ir_stream);
	if (!stream) {
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	if (fs_sink->ignore_discarded_packets) {
		BT_COMP_LOGI("Ignoring discarded packets message: "
			"stream-id=%" PRIu64 ", stream-name=\"%s\", "
			"trace-name=\"%s\", path=\"%s/%s\"",
			bt_stream_get_id(ir_stream),
			bt_stream_get_name(ir_stream),
			bt_trace_get_name(
				bt_stream_borrow_trace_const(ir_stream)),
			stream->trace->path->str, stream->file_name->str);
		goto end;
	}

	if (stream->discarded_packets_state.in_range) {
		BT_COMP_LOGE("Unsupported contiguous discarded packets message: "
			"stream-id=%" PRIu64 ", stream-name=\"%s\", "
			"trace-name=\"%s\", path=\"%s/%s\"",
			bt_stream_get_id(ir_stream),
			bt_stream_get_name(ir_stream),
			bt_trace_get_name(
				bt_stream_borrow_trace_const(ir_stream)),
			stream->trace->path->str, stream->file_name->str);
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_ERROR;
		goto end;
	}

	/*
	 * Discarded packets messages are guaranteed to occur between
	 * packets.
	 */
	BT_ASSERT(!stream->packet_state.is_open);

	if (stream->sc->discarded_packets_has_ts) {
		/*
		 * Make the stream's state be in the time range of a
		 * discarded packets message since we have the message's
		 * time range (`stream->sc->discarded_packets_has_ts`).
		 */
		stream->discarded_packets_state.in_range = true;

		/*
		 * The clock snapshot values will be validated when
		 * handling the next packet beginning message (next call
		 * to handle_packet_beginning_msg()).
		 */
		cs = bt_message_discarded_packets_borrow_beginning_default_clock_snapshot_const(
			msg);
		BT_ASSERT(cs);
		stream->discarded_packets_state.beginning_cs =
			bt_clock_snapshot_get_value(cs);
		cs = bt_message_discarded_packets_borrow_end_default_clock_snapshot_const(
			msg);
		BT_ASSERT(cs);
		stream->discarded_packets_state.end_cs =
			bt_clock_snapshot_get_value(cs);
	}

	avail = bt_message_discarded_packets_get_count(msg, &count);
	if (avail != BT_PROPERTY_AVAILABILITY_AVAILABLE) {
		/*
		 * There's no specific count of discarded packets: set
		 * it to 1 so that we know that we at least discarded
		 * something.
		 */
		count = 1;
	}

	stream->packet_state.seq_num += count;

end:
	return status;
}

static inline
void put_messages(bt_message_array_const msgs, uint64_t count)
{
	uint64_t i;

	for (i = 0; i < count; i++) {
		BT_MESSAGE_PUT_REF_AND_RESET(msgs[i]);
	}
}

BT_HIDDEN
bt_component_class_sink_consume_method_status ctf_fs_sink_consume(
		bt_self_component_sink *self_comp)
{
	bt_component_class_sink_consume_method_status status =
		BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_OK;
	struct fs_sink_comp *fs_sink;
	bt_message_iterator_next_status next_status;
	uint64_t msg_count = 0;
	bt_message_array_const msgs;

	fs_sink = bt_self_component_get_data(
			bt_self_component_sink_as_self_component(self_comp));
	BT_ASSERT(fs_sink);
	BT_ASSERT(fs_sink->upstream_iter);

	/* Consume messages */
	next_status = bt_self_component_port_input_message_iterator_next(
		fs_sink->upstream_iter, &msgs, &msg_count);
	if (next_status < 0) {
		status = (int) next_status;
		goto end;
	}

	switch (next_status) {
	case BT_MESSAGE_ITERATOR_NEXT_STATUS_OK:
	{
		uint64_t i;

		for (i = 0; i < msg_count; i++) {
			const bt_message *msg = msgs[i];

			BT_ASSERT(msg);

			switch (bt_message_get_type(msg)) {
			case BT_MESSAGE_TYPE_EVENT:
				status = handle_event_msg(fs_sink, msg);
				break;
			case BT_MESSAGE_TYPE_PACKET_BEGINNING:
				status = handle_packet_beginning_msg(
					fs_sink, msg);
				break;
			case BT_MESSAGE_TYPE_PACKET_END:
				status = handle_packet_end_msg(
					fs_sink, msg);
				break;
			case BT_MESSAGE_TYPE_MESSAGE_ITERATOR_INACTIVITY:
				/* Ignore */
				BT_COMP_LOGD_STR("Ignoring message iterator inactivity message.");
				break;
			case BT_MESSAGE_TYPE_STREAM_BEGINNING:
				status = handle_stream_beginning_msg(
					fs_sink, msg);
				break;
			case BT_MESSAGE_TYPE_STREAM_END:
				status = handle_stream_end_msg(
					fs_sink, msg);
				break;
			case BT_MESSAGE_TYPE_DISCARDED_EVENTS:
				status = handle_discarded_events_msg(
					fs_sink, msg);
				break;
			case BT_MESSAGE_TYPE_DISCARDED_PACKETS:
				status = handle_discarded_packets_msg(
					fs_sink, msg);
				break;
			default:
				abort();
			}

			BT_MESSAGE_PUT_REF_AND_RESET(msgs[i]);

			if (status != BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_OK) {
				BT_COMP_LOGE("Failed to handle message: "
					"generated CTF traces could be incomplete: "
					"output-dir-path=\"%s\"",
					fs_sink->output_dir_path->str);
				goto error;
			}
		}

		break;
	}
	case BT_MESSAGE_ITERATOR_NEXT_STATUS_AGAIN:
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_AGAIN;
		break;
	case BT_MESSAGE_ITERATOR_NEXT_STATUS_END:
		/* TODO: Finalize all traces (should already be done?) */
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_END;
		break;
	case BT_MESSAGE_ITERATOR_NEXT_STATUS_MEMORY_ERROR:
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_MEMORY_ERROR;
		break;
	case BT_MESSAGE_ITERATOR_NEXT_STATUS_ERROR:
		status = BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_MEMORY_ERROR;
		break;
	default:
		break;
	}

	goto end;

error:
	BT_ASSERT(status != BT_COMPONENT_CLASS_SINK_CONSUME_METHOD_STATUS_OK);
	put_messages(msgs, msg_count);

end:
	return status;
}

BT_HIDDEN
bt_component_class_sink_graph_is_configured_method_status
ctf_fs_sink_graph_is_configured(
		bt_self_component_sink *self_comp)
{
	bt_component_class_sink_graph_is_configured_method_status status;
	bt_self_component_port_input_message_iterator_create_from_sink_component_status
		msg_iter_status;
	struct fs_sink_comp *fs_sink = bt_self_component_get_data(
			bt_self_component_sink_as_self_component(self_comp));

	msg_iter_status =
		bt_self_component_port_input_message_iterator_create_from_sink_component(
			self_comp,
			bt_self_component_sink_borrow_input_port_by_name(
				self_comp, in_port_name), &fs_sink->upstream_iter);
	if (msg_iter_status != BT_SELF_COMPONENT_PORT_INPUT_MESSAGE_ITERATOR_CREATE_FROM_SINK_COMPONENT_STATUS_OK) {
		status = (int) msg_iter_status;
		goto end;
	}

	status = BT_COMPONENT_CLASS_SINK_GRAPH_IS_CONFIGURED_METHOD_STATUS_OK;
end:
	return status;
}

BT_HIDDEN
void ctf_fs_sink_finalize(bt_self_component_sink *self_comp)
{
	struct fs_sink_comp *fs_sink = bt_self_component_get_data(
			bt_self_component_sink_as_self_component(self_comp));

	destroy_fs_sink_comp(fs_sink);
}