X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=include%2Fbabeltrace%2Ftrace-handle.h;h=55c850f8d0e374840b6d8a1c66137ff130dda47a;hb=61cf588beae752e5ddfc60b6b5310f769ac9e852;hp=65171e7090cfd1574db20874c753ae2e3281b0c2;hpb=30c276af575248a4f83e594c987264f6caa238ba;p=babeltrace.git diff --git a/include/babeltrace/trace-handle.h b/include/babeltrace/trace-handle.h index 65171e70..55c850f8 100644 --- a/include/babeltrace/trace-handle.h +++ b/include/babeltrace/trace-handle.h @@ -20,9 +20,22 @@ * * 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 @@ -34,21 +47,31 @@ 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 creation time of the buffers - * of a trace. + * bt_trace_handle_get_timestamp_begin : get the creation time (in + * nanoseconds or cycles depending on type) of the buffers of a trace. + * + * Returns 0 on success, -1 on error. */ -uint64_t bt_trace_handle_get_timestamp_begin(struct bt_context *ctx, int handle_id); +int bt_trace_handle_get_timestamp_begin(struct bt_context *ctx, + int handle_id, enum bt_clock_type type, + int64_t *timestamp); /* - * bt_trace_handle_get_timestamp_end : returns the destruction timestamp of the - * buffers of a trace. + * bt_trace_handle_get_timestamp_end : get the destruction time + * (in nanoseconds or cycles depending on type) of the buffers of a + * trace. + * + * Returns 0 on success, -1 on error. */ -uint64_t bt_trace_handle_get_timestamp_end(struct bt_context *ctx, int handle_id); +int bt_trace_handle_get_timestamp_end(struct bt_context *ctx, + int handle_id, enum bt_clock_type type, + int64_t *timestamp); /* * bt_ctf_event_get_handle_id : get the handle id associated with an event @@ -57,4 +80,8 @@ uint64_t bt_trace_handle_get_timestamp_end(struct bt_context *ctx, int handle_id */ int bt_ctf_event_get_handle_id(const struct bt_ctf_event *event); +#ifdef __cplusplus +} +#endif + #endif /* _BABELTRACE_TRACE_HANDLE_H */