If the \link ctfirtraceclass CTF IR trace class\endlink of an event
object (parent of its \link ctfirstreamclass CTF IR stream class\endlink,
which is the parent of its event class) was created by a
-\link ctfirwriter CTF IR writer\endlink object, then the only possible
+\link ctfwriter CTF writer\endlink object, then the only possible
action you can do with this event object is to append it to a
\link ctfirstream CTF IR stream\endlink with
bt_ctf_stream_append_event(). Otherwise, you can create an event
@endcode
@note
-See \ref ctfirwriterstreamclass which documents additional CTF IR stream
-class functions exclusive to the CTF IR writer mode.
+See \ref ctfwriterstreamclass which documents additional CTF IR stream
+class functions exclusive to the CTF writer mode.
A CTF IR <strong><em>stream class</em></strong> is a template that you
can use to create concrete \link ctfirstream CTF IR streams\endlink.
- bt_ctf_trace_add_stream_class()
- bt_ctf_event_create()
- bt_ctf_writer_create_stream()
- (\link ctfirwriter CTF IR writer\endlink mode only)
+ (\link ctfwriter CTF writer\endlink mode only)
You cannot modify a frozen stream class: it is considered immutable,
except for:
@sa ctfirstream
@sa ctfireventclass
@sa ctfirtraceclass
-@sa ctfirwriterstreamclass
+@sa ctfwriterstreamclass
@file
@brief CTF IR stream class type and functions.
/** @} */
-// TODO: document for writer
+// TODO: document for CTF writer
extern struct bt_ctf_clock *bt_ctf_stream_class_get_clock(
struct bt_ctf_stream_class *stream_class);
@endcode
@note
-See \ref ctfirwriterstream which documents additional CTF IR stream
-functions exclusive to the CTF IR writer mode.
+See \ref ctfwriterstream which documents additional CTF IR stream
+functions exclusive to the CTF writer mode.
A CTF IR <strong><em>stream</em></strong> is an instance of a
\link ctfirstreamclass CTF IR stream class\endlink.
- <strong>Normal mode</strong>: use bt_ctf_stream_create() with a stream
class having a \link ctfirtraceclass CTF IR trace class\endlink parent
- \em not created by a \link ctfirwriter CTF IR writer\endlink object to
+ \em not created by a \link ctfwriter CTF writer\endlink object to
create a default stream.
-- <strong>CTF IR writer mode</strong>: use bt_ctf_stream_create() with
- a stream class having a trace class parent created by a CTF IR writer
+- <strong>CTF writer mode</strong>: use bt_ctf_stream_create() with
+ a stream class having a trace class parent created by a CTF writer
object, or use bt_ctf_writer_create_stream().
A CTF IR stream object represents a CTF stream, that is, a sequence of
@sa ctfirstreamclass
@sa ctfirpacket
-@sa ctfirwriterstream
+@sa ctfwriterstream
@file
@brief CTF IR stream type and functions.
@struct bt_ctf_stream
@brief A CTF IR stream.
@sa ctfirstream
-@sa ctfirwriterstream
+@sa ctfwriterstream
*/
struct bt_ctf_stream;
struct bt_ctf_event;
\link ctfirtraceclass CTF IR trace class\endlink.
If the parent \link ctfirtraceclass trace class\endlink of
-\p stream_class was created by a \link ctfirwriter CTF IR writer\endlink
-object, then the stream object is created in CTF IR writer mode, and
-you can use the functions of \ref ctfirwriterstream on it.
+\p stream_class was created by a \link ctfwriter CTF writer\endlink
+object, then the stream object is created in CTF writer mode, and
+you can use the functions of \ref ctfwriterstream on it.
Otherwise it is created in normal mode: you should only use the
functions documented in this module on it.
- <strong>Normal mode</strong>: use bt_ctf_trace_create() to create a
default, empty trace class.
-- <strong>CTF IR writer mode</strong>: use bt_ctf_writer_get_trace() to
- get the trace class created by a given CTF IR writer object.
+- <strong>CTF writer mode</strong>: use bt_ctf_writer_get_trace() to
+ get the trace class created by a given CTF writer object.
A trace class has the following properties:
- bt_ctf_trace_add_stream_class()
- bt_ctf_writer_create_stream()
- (\link ctfirwriter CTF IR writer\endlink mode only)
+ (\link ctfwriter CTF writer\endlink mode only)
You cannot modify a frozen trace class: it is considered immutable,
except for: