1 babeltrace2-sink.ctf.fs(7)
2 =========================
3 :manpagetype: component class
4 :revdate: 5 October 2017
9 babeltrace2-sink.ctf.fs - Babeltrace's file system CTF sink component
15 The Babeltrace compcls:sink.ctf.fs component class, provided by the
16 man:babeltrace2-plugin-ctf(7) plugin, once instantiated, writes the
17 events it receives to one or more http://diamon.org/ctf/[CTF] traces on
20 A compcls:sink.ctf.fs component does not merge traces, in that it writes
21 the notifications of different input traces to different output traces.
23 This component guarantees that the output traces are semantically
24 equivalent to the input traces. This means that a given output CTF trace
27 * The original trace environment.
28 * The original clock classes.
29 * The original event class names, log levels, and other static
30 attributes, except for the numeric IDs.
31 * The original field _values_, except for:
32 ** Timestamp fields, but the equivalent clock value remains the same.
35 The component does not guarantee to keep:
37 * The original field type attributes (for example, the sizes of the
39 * The original stream class and event class numeric IDs.
44 The path of a CTF trace is the directory which directly contains the
45 metadata and data stream files as children.
47 The rules to determine the path of a generated CTF trace are:
49 * If the param:single-trace parameter is true, use the value of the
55 * If the input trace has a name, use `OUTPUTPATH/TRACENAME[SUFFIX]`,
56 where `OUTPUTPATH` is the value of the param:path parameter,
57 `TRACENAME` is the input trace's name, and `SUFFIX` is an optional
58 numeric suffix if `OUTPUTPATH/TRACENAME` already exists.
60 Note that the name of a trace that a compcls:source.ctf.fs component
61 creates includes its hostname and its relative path while making sure to
64 Otherwise, use `OUTPUTPATH/trace[SUFFIX]`, where `OUTPUTPATH` and
65 `SUFFIX` are defined above.
69 INITIALIZATION PARAMETERS
70 -------------------------
71 param:path='PATH' (string, mandatory)::
72 Depending on the value of the param:single-trace parameter, prefix
73 of output trace paths or full output trace path.
75 param:single-trace=`yes` (boolean, optional)::
76 Assume that the component only receives notifications related to
77 a single source trace.
85 Single input port from which the component receives the
91 This component class has no objects to query.
96 include::common-ctf-plugin-env.txt[]
101 include::common-common-compat-env.txt[]
103 `BABELTRACE_SINK_CTF_FS_LOG_LEVEL`::
104 Component class's log level. The available values are the
105 same as for the manopt:babeltrace2(1):--log-level option of
109 include::common-footer.txt[]
114 man:babeltrace2-plugin-ctf(7),
115 man:babeltrace2-intro(7)