X-Git-Url: https://git.lttng.org/?p=lttngtop.git;a=blobdiff_plain;f=lib%2Fbabeltrace%2Ftrace-handle.h;fp=lib%2Fbabeltrace%2Ftrace-handle.h;h=96e4a81bc167b272b3569473e3f9ecade58aa80d;hp=0000000000000000000000000000000000000000;hb=b1acd2b342a35dc6c5a8036fb0280321203e89b7;hpb=a18dc7c24b4ac751c46a96198aebcbb1dcd4cdd6 diff --git a/lib/babeltrace/trace-handle.h b/lib/babeltrace/trace-handle.h new file mode 100644 index 0000000..96e4a81 --- /dev/null +++ b/lib/babeltrace/trace-handle.h @@ -0,0 +1,82 @@ +#ifndef _BABELTRACE_TRACE_HANDLE_H +#define _BABELTRACE_TRACE_HANDLE_H + +/* + * BabelTrace + * + * trace_handle header + * + * Copyright 2012 EfficiOS Inc. and Linux Foundation + * + * Author: Mathieu Desnoyers + * Julien Desfossez + * + * 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 +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/* + * trace_handle : unique identifier of a trace + * + * The trace_handle allows the user to manipulate a trace file directly. + * It is a unique identifier representing a trace file. + */ +struct bt_trace_handle; +struct bt_ctf_event; + +/* + * bt_trace_handle_get_path : returns the path of a trace_handle or NULL + * on error. + */ +const char *bt_trace_handle_get_path(struct bt_context *ctx, int handle_id); + +/* + * bt_trace_handle_get_timestamp_begin : returns the creation time (in + * nanoseconds or cycles depending on type) of the buffers of a trace + * or -1ULL on error. + */ +uint64_t bt_trace_handle_get_timestamp_begin(struct bt_context *ctx, + int handle_id, enum bt_clock_type type); + +/* + * bt_trace_handle_get_timestamp_end : returns the destruction timestamp + * (in nanoseconds or cycles depending on type) of the buffers of a trace + * or -1ULL on error. + */ +uint64_t bt_trace_handle_get_timestamp_end(struct bt_context *ctx, + int handle_id, enum bt_clock_type type); + +/* + * bt_ctf_event_get_handle_id : get the handle id associated with an event + * + * Returns -1 on error + */ +int bt_ctf_event_get_handle_id(const struct bt_ctf_event *event); + +#ifdef __cplusplus +} +#endif + +#endif /* _BABELTRACE_TRACE_HANDLE_H */