2 * SPDX-License-Identifier: MIT
4 * Copyright (C) 2016 Philippe Proulx <pproulx@efficios.com>
7 #ifndef CTF_FS_DS_FILE_H
8 #define CTF_FS_DS_FILE_H
17 #include <babeltrace2/babeltrace.h>
19 #include "cpp-common/bt2/trace-ir.hpp"
20 #include "cpp-common/bt2c/data-len.hpp"
21 #include "cpp-common/bt2c/logging.hpp"
23 #include "../common/src/msg-iter/msg-iter.hpp"
26 struct ctf_fs_ds_file_info
28 using UP = std::unique_ptr<ctf_fs_ds_file_info>;
32 /* Guaranteed to be set, as opposed to the index. */
38 using UP = std::unique_ptr<ctf_fs_ds_file>;
40 explicit ctf_fs_ds_file(const bt2c::Logger& parentLogger) :
41 logger {parentLogger, "PLUGIN/SRC.CTF.FS/DS"}
45 ctf_fs_ds_file(const ctf_fs_ds_file&) = delete;
46 ctf_fs_ds_file& operator=(const ctf_fs_ds_file&) = delete;
52 struct ctf_fs_metadata *metadata = nullptr;
56 bt2::Stream::Shared stream;
58 void *mmap_addr = nullptr;
61 * Max length of chunk to mmap() when updating the current mapping.
62 * This value must be page-aligned.
64 size_t mmap_max_len = 0;
66 /* Length of the current mapping. Never exceeds the file's length. */
69 /* Offset in the file where the current mapping starts. */
70 off_t mmap_offset_in_file = 0;
73 * Offset, in the current mapping, of the address to return on the next
76 off_t request_offset_in_mapping = 0;
79 struct ctf_fs_ds_index_entry
81 explicit ctf_fs_ds_index_entry(const bt2c::DataLen offsetParam,
82 const bt2c::DataLen packetSizeParam) noexcept :
84 packetSize(packetSizeParam)
88 /* Weak, belongs to ctf_fs_ds_file_info. */
89 const char *path = nullptr;
91 /* Position of the packet from the beginning of the file. */
94 /* Size of the packet. */
95 bt2c::DataLen packetSize;
98 * Extracted from the packet context, relative to the respective fields'
99 * mapped clock classes (in cycles).
101 uint64_t timestamp_begin = 0, timestamp_end = 0;
104 * Converted from the packet context, relative to the trace's EPOCH
105 * (in ns since EPOCH).
107 int64_t timestamp_begin_ns = 0, timestamp_end_ns = 0;
110 * Packet sequence number, or UINT64_MAX if not present in the index.
112 uint64_t packet_seq_num = UINT64_MAX;
115 struct ctf_fs_ds_index
117 std::vector<ctf_fs_ds_index_entry> entries;
120 struct ctf_fs_ds_file_group
122 using UP = std::unique_ptr<ctf_fs_ds_file_group>;
125 * This is an _ordered_ array of data stream file infos which
126 * belong to this group (a single stream instance).
128 * You can call ctf_fs_ds_file_create() with one of those paths
129 * and the trace IR stream below.
131 std::vector<ctf_fs_ds_file_info::UP> ds_file_infos;
134 struct ctf_stream_class *sc = nullptr;
136 bt2::Stream::Shared stream;
138 /* Stream (instance) ID; -1ULL means none */
139 uint64_t stream_id = 0;
141 /* Weak, belongs to component */
142 struct ctf_fs_trace *ctf_fs_trace = nullptr;
144 ctf_fs_ds_index index;
147 ctf_fs_ds_file::UP ctf_fs_ds_file_create(ctf_fs_trace *ctf_fs_trace, bt2::Stream::Shared stream,
148 const char *path, const bt2c::Logger& logger);
150 bt2s::optional<ctf_fs_ds_index> ctf_fs_ds_file_build_index(struct ctf_fs_ds_file *ds_file,
151 struct ctf_fs_ds_file_info *ds_file_info,
152 struct ctf_msg_iter *msg_iter);
154 ctf_fs_ds_file_info::UP ctf_fs_ds_file_info_create(const char *path, int64_t begin_ns);
156 ctf_fs_ds_file_group::UP ctf_fs_ds_file_group_create(struct ctf_fs_trace *ctf_fs_trace,
157 struct ctf_stream_class *sc,
158 uint64_t stream_instance_id,
159 ctf_fs_ds_index index);
162 * Medium operations to iterate on a single ctf_fs_ds_file.
164 * The data pointer when using this must be a pointer to the ctf_fs_ds_file.
166 extern struct ctf_msg_iter_medium_ops ctf_fs_ds_file_medops;
169 * Medium operations to iterate on the packet of a ctf_fs_ds_group.
171 * The iteration is done based on the index of the group.
173 * The data pointer when using these medops must be a pointer to a ctf_fs_ds
174 * group_medops_data structure.
176 extern struct ctf_msg_iter_medium_ops ctf_fs_ds_group_medops;
178 struct ctf_fs_ds_group_medops_data_deleter
180 void operator()(struct ctf_fs_ds_group_medops_data *data) noexcept;
183 using ctf_fs_ds_group_medops_data_up =
184 std::unique_ptr<ctf_fs_ds_group_medops_data, ctf_fs_ds_group_medops_data_deleter>;
186 enum ctf_msg_iter_medium_status
187 ctf_fs_ds_group_medops_data_create(struct ctf_fs_ds_file_group *ds_file_group,
188 bt_self_message_iterator *self_msg_iter,
189 const bt2c::Logger& logger, ctf_fs_ds_group_medops_data_up& out);
191 void ctf_fs_ds_group_medops_data_reset(struct ctf_fs_ds_group_medops_data *data);
193 #endif /* CTF_FS_DS_FILE_H */