X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=plugins%2Fctf%2Ffs-src%2Ffs.h;h=9e9ee84d86fa91fcaac3e267a29b632d2743e42a;hb=68b66a256a54d32992dfefeaad11eea88b7df234;hp=1ee4a6821e91bef0da3ca5f3c2fad15b11bd6f1b;hpb=f280892e9c882183c4af86992e41efc39a017802;p=babeltrace.git diff --git a/plugins/ctf/fs-src/fs.h b/plugins/ctf/fs-src/fs.h index 1ee4a682..9e9ee84d 100644 --- a/plugins/ctf/fs-src/fs.h +++ b/plugins/ctf/fs-src/fs.h @@ -29,8 +29,8 @@ */ #include -#include -#include +#include +#include #include "data-stream-file.h" #include "metadata.h" #include "../common/metadata/decoder.h" @@ -99,6 +99,31 @@ struct ctf_fs_trace { uint64_t next_stream_id; }; +struct ctf_fs_ds_index_entry { + /* Position, in bytes, of the packet from the beginning of the file. */ + uint64_t offset; + + /* Size of the packet, in bytes. */ + uint64_t packet_size; + + /* + * Extracted from the packet context, relative to the respective fields' + * mapped clock classes (in cycles). + */ + uint64_t timestamp_begin, timestamp_end; + + /* + * Converted from the packet context, relative to the trace's EPOCH + * (in ns since EPOCH). + */ + int64_t timestamp_begin_ns, timestamp_end_ns; +}; + +struct ctf_fs_ds_index { + /* Array of pointer to struct ctf_fs_fd_index_entry. */ + GPtrArray *entries; +}; + struct ctf_fs_ds_file_group { /* * Array of struct ctf_fs_ds_file_info, owned by this. @@ -122,6 +147,16 @@ struct ctf_fs_ds_file_group { /* Weak, belongs to component */ struct ctf_fs_trace *ctf_fs_trace; + + /* + * Owned by this. May be NULL. + * + * A stream cannot be assumed to be indexed as the indexing might have + * been skipped. Moreover, the index's fields may not all be available + * depending on the producer (e.g. timestamp_begin/end are not + * mandatory). + */ + struct ctf_fs_ds_index *index; }; struct ctf_fs_port_data { @@ -204,10 +239,27 @@ int ctf_fs_component_create_ctf_fs_traces(bt_self_component_source *self_comp, BT_HIDDEN void ctf_fs_destroy(struct ctf_fs_component *ctf_fs); -/* Validate the "paths" parameter passed to this component. It must be - present, and it must be an array of strings. */ +/* + * 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. + * + * Return true on success, false if any parameter didn't pass validation. + */ + +BT_HIDDEN +bool read_src_fs_parameters(const bt_value *params, + const bt_value **paths, struct ctf_fs_component *ctf_fs); + +/* + * 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. + */ BT_HIDDEN -bool validate_paths_parameter(const bt_value *paths); +gchar *ctf_fs_make_port_name(struct ctf_fs_ds_file_group *ds_file_group); #endif /* BABELTRACE_PLUGIN_CTF_FS_H */