* BabelTrace - CTF on File System Component
*/
-#ifndef BABELTRACE_PLUGIN_CTF_FS_H
-#define BABELTRACE_PLUGIN_CTF_FS_H
+#ifndef BABELTRACE_PLUGINS_CTF_FS_SRC_FS_HPP
+#define BABELTRACE_PLUGINS_CTF_FS_SRC_FS_HPP
#include <glib.h>
#include <babeltrace2/babeltrace.h>
-#include "metadata.hpp"
+#include "cpp-common/bt2c/aliases.hpp"
+#include "cpp-common/bt2c/logging.hpp"
-extern bool ctf_fs_debug;
-
-struct ctf_fs_file
-{
- bt_logging_level log_level = (bt_logging_level) 0;
-
- /* Weak */
- bt_self_component *self_comp = nullptr;
+#include "data-stream-file.hpp"
+#include "plugins/ctf/common/src/metadata/metadata-stream-parser-utils.hpp"
+#include "plugins/ctf/common/src/msg-iter.hpp"
- /* Owned by this */
- GString *path = nullptr;
+#define CTF_FS_METADATA_FILENAME "metadata"
- /* Owned by this */
- FILE *fp = nullptr;
-
- off_t size = 0;
-};
+extern bool ctf_fs_debug;
-struct ctf_fs_metadata
+struct ctf_fs_trace
{
- /* Owned by this */
- struct ctf_metadata_decoder *decoder = nullptr;
+ using UP = std::unique_ptr<ctf_fs_trace>;
- /* Owned by this */
- bt_trace_class *trace_class = nullptr;
+ explicit ctf_fs_trace(const ctf::src::ClkClsCfg& clkClsCfg,
+ const bt2::OptionalBorrowedObject<bt2::SelfComponent> selfComp,
+ const bt2c::Logger& parentLogger) :
+ _mLogger {parentLogger, "PLUGIN/SRC.CTF.FS/TRACE"},
+ _mClkClsCfg {clkClsCfg}, _mSelfComp {selfComp}
+ {
+ }
- /* Weak (owned by `decoder` above) */
- struct ctf_trace_class *tc = nullptr;
+ const ctf::src::TraceCls *cls() const
+ {
+ BT_ASSERT(_mParseRet);
+ BT_ASSERT(_mParseRet->traceCls);
+ return _mParseRet->traceCls.get();
+ }
- /* Owned by this */
- char *text = nullptr;
+ const bt2s::optional<bt2c::Uuid>& metadataStreamUuid() const noexcept
+ {
+ BT_ASSERT(_mParseRet);
+ return _mParseRet->uuid;
+ }
- int bo = 0;
-};
+ void parseMetadata(const bt2c::ConstBytes buffer)
+ {
+ _mParseRet = ctf::src::parseMetadataStream(_mSelfComp, _mClkClsCfg, buffer, _mLogger);
+ }
-struct ctf_fs_component
-{
- bt_logging_level log_level = (bt_logging_level) 0;
+ bt2::Trace::Shared trace;
- /* Array of struct ctf_fs_port_data *, owned by this */
- GPtrArray *port_data = nullptr;
+ std::vector<ctf_fs_ds_file_group::UP> ds_file_groups;
- /* Owned by this */
- struct ctf_fs_trace *trace = nullptr;
-
- struct ctf_fs_metadata_config metadata_config;
-};
-
-struct ctf_fs_trace
-{
- bt_logging_level log_level = (bt_logging_level) 0;
-
- /*
- * Weak. These are mostly used to generate log messages or to append
- * error causes. They are mutually exclusive, only one of them must be
- * set.
- */
- bt_self_component *self_comp = nullptr;
- bt_self_component_class *self_comp_class = nullptr;
-
- /* Owned by this */
- struct ctf_fs_metadata *metadata = nullptr;
-
- /* Owned by this */
- bt_trace *trace = nullptr;
-
- /* Array of struct ctf_fs_ds_file_group *, owned by this */
- GPtrArray *ds_file_groups = nullptr;
-
- /* Owned by this */
- GString *path = nullptr;
+ std::string path;
/* Next automatic stream ID when not provided by packet header */
uint64_t next_stream_id = 0;
+
+private:
+ bt2c::Logger _mLogger;
+ ctf::src::ClkClsCfg _mClkClsCfg;
+ bt2::OptionalBorrowedObject<bt2::SelfComponent> _mSelfComp;
+ bt2s::optional<ctf::src::MetadataStreamParser::ParseRet> _mParseRet;
};
-struct ctf_fs_ds_index_entry
+struct ctf_fs_port_data
{
- /* Weak, belongs to ctf_fs_ds_file_info. */
- const char *path = nullptr;
-
- /* Position, in bytes, of the packet from the beginning of the file. */
- uint64_t offset = 0;
-
- /* Size of the packet, in bytes. */
- uint64_t packet_size = 0;
+ using UP = std::unique_ptr<ctf_fs_port_data>;
- /*
- * Extracted from the packet context, relative to the respective fields'
- * mapped clock classes (in cycles).
- */
- uint64_t timestamp_begin = 0, timestamp_end = 0;
-
- /*
- * Converted from the packet context, relative to the trace's EPOCH
- * (in ns since EPOCH).
- */
- int64_t timestamp_begin_ns = 0, timestamp_end_ns = 0;
-
- /*
- * Packet sequence number, or UINT64_MAX if not present in the index.
- */
- uint64_t packet_seq_num = 0;
-};
+ /* Weak, belongs to ctf_fs_trace */
+ struct ctf_fs_ds_file_group *ds_file_group = nullptr;
-struct ctf_fs_ds_index
-{
- /* Array of pointer to struct ctf_fs_ds_index_entry. */
- GPtrArray *entries = nullptr;
+ /* Weak */
+ struct ctf_fs_component *ctf_fs = nullptr;
};
-struct ctf_fs_ds_file_group
+struct ctf_fs_component
{
- /*
- * Array of struct ctf_fs_ds_file_info, owned by this.
- *
- * This is an _ordered_ array of data stream file infos which
- * belong to this group (a single stream instance).
- *
- * You can call ctf_fs_ds_file_create() with one of those paths
- * and the trace IR stream below.
- */
- GPtrArray *ds_file_infos = nullptr;
-
- /* Owned by this */
- struct ctf_stream_class *sc = nullptr;
+ using UP = std::unique_ptr<ctf_fs_component>;
- /* Owned by this */
- bt_stream *stream = nullptr;
+ explicit ctf_fs_component(const ctf::src::ClkClsCfg& clkClsCfgParam,
+ const bt2c::Logger& parentLogger) noexcept :
+ logger {parentLogger, "PLUGIN/SRC.CTF.FS/COMP"},
+ clkClsCfg {clkClsCfgParam}
+ {
+ }
- /* Stream (instance) ID; -1ULL means none */
- uint64_t stream_id = 0;
+ bt2c::Logger logger;
- /* Weak, belongs to component */
- struct ctf_fs_trace *ctf_fs_trace = nullptr;
+ std::vector<ctf_fs_port_data::UP> port_data;
- /*
- * Owned by this.
- */
- struct ctf_fs_ds_index *index = nullptr;
-};
+ ctf_fs_trace::UP trace;
-struct ctf_fs_port_data
-{
- /* Weak, belongs to ctf_fs_trace */
- struct ctf_fs_ds_file_group *ds_file_group = nullptr;
-
- /* Weak */
- struct ctf_fs_component *ctf_fs = nullptr;
+ ctf::src::ClkClsCfg clkClsCfg;
+ ctf::src::MsgIterQuirks quirks;
};
struct ctf_fs_msg_iter_data
{
- bt_logging_level log_level = (bt_logging_level) 0;
+ using UP = std::unique_ptr<ctf_fs_msg_iter_data>;
- /* Weak */
- bt_self_component *self_comp = nullptr;
+ explicit ctf_fs_msg_iter_data(const bt2::SelfMessageIterator selfMsgIterParam) :
+ selfMsgIter {selfMsgIterParam}, logger {selfMsgIter, "PLUGIN/SRC.CTF.FS/MSG-ITER"}
+ {
+ }
- /* Weak */
- bt_self_message_iterator *self_msg_iter = nullptr;
+ bt2::SelfMessageIterator selfMsgIter;
- /* Weak, belongs to ctf_fs_trace */
- struct ctf_fs_ds_file_group *ds_file_group = nullptr;
+ bt2c::Logger logger;
- /* Owned by this */
- struct ctf_msg_iter *msg_iter = nullptr;
+ /* Weak, belongs to ctf_fs_component */
+ ctf_fs_port_data *port_data = nullptr;
+
+ bt2s::optional<ctf::src::MsgIter> msgIter;
/*
* Saved error. If we hit an error in the _next method, but have some
bt_message_iterator_class_next_method_status next_saved_status =
BT_MESSAGE_ITERATOR_CLASS_NEXT_METHOD_STATUS_OK;
const struct bt_error *next_saved_error = nullptr;
-
- struct ctf_fs_ds_group_medops_data *msg_iter_medops_data = nullptr;
};
bt_component_class_initialize_method_status
bt_message_iterator_class_seek_beginning_method_status
ctf_fs_iterator_seek_beginning(bt_self_message_iterator *message_iterator);
-/* Create and initialize a new, empty ctf_fs_component. */
-
-struct ctf_fs_component *ctf_fs_component_create(bt_logging_level log_level);
-
/*
* Create one `struct ctf_fs_trace` from one trace, or multiple traces sharing
* the same UUID.
* `paths_value` must be an array of strings,
*
* The created `struct ctf_fs_trace` is assigned to `ctf_fs->trace`.
- *
- * `self_comp` and `self_comp_class` are used for logging, only one of them
- * should be set.
*/
int ctf_fs_component_create_ctf_fs_trace(struct ctf_fs_component *ctf_fs,
- const bt_value *paths_value,
- const bt_value *trace_name_value,
- bt_self_component *self_comp,
- bt_self_component_class *self_comp_class);
+ bt2::ConstArrayValue pathsValue, const char *traceName,
+ bt2::OptionalBorrowedObject<bt2::SelfComponent> selfComp);
+
+namespace ctf {
+namespace src {
+namespace fs {
-/* Free `ctf_fs` and everything it owns. */
+/* `src.ctf.fs` parameters */
-void ctf_fs_destroy(struct ctf_fs_component *ctf_fs);
+struct Parameters
+{
+ explicit Parameters(const bt2::ConstArrayValue inputsParam) noexcept : inputs {inputsParam}
+ {
+ }
+
+ bt2::ConstArrayValue inputs;
+ bt2s::optional<std::string> traceName;
+ ClkClsCfg clkClsCfg;
+};
+
+} /* namespace fs */
+} /* namespace src */
+} /* namespace ctf */
/*
* Read and validate parameters taken by the src.ctf.fs plugin.
*
- * - The mandatory `paths` parameter is returned in `*paths`.
- * - The optional `clock-class-offset-s` and `clock-class-offset-ns`, if
- * present, are recorded in the `ctf_fs` structure.
- * - The optional `trace-name` parameter is returned in `*trace_name` if
- * present, else `*trace_name` is set to NULL.
- *
- * `self_comp` and `self_comp_class` are used for logging, only one of them
- * should be set.
- *
- * Return true on success, false if any parameter didn't pass validation.
+ * Throw if any parameter doesn't pass validation.
*/
-bool read_src_fs_parameters(const bt_value *params, const bt_value **paths,
- const bt_value **trace_name, struct ctf_fs_component *ctf_fs,
- bt_self_component *self_comp, bt_self_component_class *self_comp_class);
+ctf::src::fs::Parameters read_src_fs_parameters(bt2::ConstMapValue params,
+ const bt2c::Logger& logger);
/*
* Generate the port name to be used for a given data stream file group.
- *
- * The result must be freed using g_free by the caller.
*/
-gchar *ctf_fs_make_port_name(struct ctf_fs_ds_file_group *ds_file_group);
+std::string ctf_fs_make_port_name(ctf_fs_ds_file_group *ds_file_group);
-#endif /* BABELTRACE_PLUGIN_CTF_FS_H */
+#endif /* BABELTRACE_PLUGINS_CTF_FS_SRC_FS_HPP */