X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=include%2Fbabeltrace%2Fctf-ir%2Fstream-class.h;h=75be6b678f7f37b07aa19d5f14491abf45b5c5ad;hb=de3dd40e6fcad56e227f5fc8a8290fbaa88b4e07;hp=d7089ccb938254c4ebe5a771776ccb47ff72d255;hpb=48d711a204f69520bbb7b0f2e69623a6fa7e0744;p=babeltrace.git diff --git a/include/babeltrace/ctf-ir/stream-class.h b/include/babeltrace/ctf-ir/stream-class.h index d7089ccb..75be6b67 100644 --- a/include/babeltrace/ctf-ir/stream-class.h +++ b/include/babeltrace/ctf-ir/stream-class.h @@ -65,6 +65,16 @@ struct bt_ctf_clock; */ extern struct bt_ctf_stream_class *bt_ctf_stream_class_create(const char *name); +/* + * bt_ctf_stream_class_get_trace: Get a stream class' associated trace. + * + * @param stream_class Stream class. + * + * Returns the stream class' associated trace, NULL on error. + */ +extern struct bt_ctf_trace *bt_ctf_stream_class_get_trace( + struct bt_ctf_stream_class *stream_class); + /* * bt_ctf_stream_class_get_name: Get a stream class' name. * @@ -144,7 +154,8 @@ extern int bt_ctf_stream_class_set_id( * The stream class will share the ownership of "event_class" by incrementing * its reference count. * - * Note that an event class may only be added to one stream class. + * Note that an event class may only be added to one stream class. It + * also becomes immutable. * * @param stream_class Stream class. * @param event_class Event class to add to the provided stream class. @@ -189,6 +200,18 @@ extern struct bt_ctf_event_class *bt_ctf_stream_class_get_event_class( extern struct bt_ctf_event_class *bt_ctf_stream_class_get_event_class_by_name( struct bt_ctf_stream_class *stream_class, const char *name); +/* + * bt_ctf_stream_class_get_event_class_by_name: Get stream class event class by + * ID. + * + * @param stream_class Stream class. + * @param id Event class ID. + * + * Returns event class, NULL on error. + */ +extern struct bt_ctf_event_class *bt_ctf_stream_class_get_event_class_by_id( + struct bt_ctf_stream_class *stream_class, uint32_t id); + /* * bt_ctf_stream_class_get_packet_context_type: get the stream class' packet * context type. @@ -267,6 +290,8 @@ extern int bt_ctf_stream_class_set_event_context_type( * bt_ctf_stream_class_get and bt_ctf_stream_class_put: increment and * decrement the stream class' reference count. * + * You may also use bt_ctf_get() and bt_ctf_put() with stream class objects. + * * These functions ensure that the stream class won't be destroyed while it * is in use. The same number of get and put (plus one extra put to * release the initial reference done at creation) have to be done to