X-Git-Url: http://git.efficios.com/?p=babeltrace.git;a=blobdiff_plain;f=include%2Fbabeltrace%2Ftrace-handle.h;h=96e4a81bc167b272b3569473e3f9ecade58aa80d;hp=65171e7090cfd1574db20874c753ae2e3281b0c2;hb=c462e188f3e7819c7bc74f671038cdbf36e8c3c0;hpb=30c276af575248a4f83e594c987264f6caa238ba

diff --git a/include/babeltrace/trace-handle.h b/include/babeltrace/trace-handle.h
index 65171e70..96e4a81b 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 <stdint.h>
+#include <babeltrace/clock-types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
 
 /*
  * trace_handle : unique identifier of a trace
@@ -34,21 +47,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 creation time of the buffers
- * 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 destruction timestamp of the
- * buffers of a trace.
+ * 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);
+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
@@ -57,4 +75,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 */