X-Git-Url: http://git.efficios.com/?p=babeltrace.git;a=blobdiff_plain;f=include%2Fbabeltrace%2Ftrace-handle.h;h=f0e23125d1a86511bfc3e9b3efba015702c31ead;hp=31877ee1886a681165d25fdd9d2b2b94e9252af9;hb=2b78f360e801cfe3fa51092c56c96c8fe23983e0;hpb=98a0490342a1b8f8841ef52aaaef2cef11782ff1 diff --git a/include/babeltrace/trace-handle.h b/include/babeltrace/trace-handle.h index 31877ee1..f0e23125 100644 --- a/include/babeltrace/trace-handle.h +++ b/include/babeltrace/trace-handle.h @@ -23,6 +23,7 @@ */ #include +#include /* * trace_handle : unique identifier of a trace @@ -34,21 +35,26 @@ struct bt_trace_handle; struct bt_ctf_event; /* - * bt_trace_handle_get_path : returns the path of a trace_handle. + * 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 beginning timestamp - * of a trace. + * 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); +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 end timestamp of a - * trace. + * bt_trace_handle_get_timestamp_end : returns the destruction timestamp + * (in anoseconds 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); +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