ctf.fs: bt_ctf_notif_iter_create(): assert() that all medops exist

[babeltrace.git] / include / babeltrace / trace-handle.h

diff --git a/include/babeltrace/trace-handle.h b/include/babeltrace/trace-handle.h
index 31877ee1886a681165d25fdd9d2b2b94e9252af9..55c850f8d0e374840b6d8a1c66137ff130dda47a 100644 (file)
--- 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,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 beginning timestamp
- * 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 end timestamp of a
+ * 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 */