common: remove `prio-heap.{c,h}`
[babeltrace.git] / doc / man / common-convert-examples.txt
CommitLineData
e70712b3
PP
1.Pretty-print the events, in order, of one or more CTF traces.
2====
3[role="term"]
4----
5$ babeltrace2 my-ctf-traces
6----
7
8[role="term"]
9----
10$ babeltrace2 my-ctf-traces
11----
12
13[role="term"]
14----
15$ babeltrace2 my-ctf-trace-1 my-ctf-trace-2 my-ctf-trace-3
16----
17====
18
19.Trim a CTF trace and pretty-print the events.
20====
21[role="term"]
22----
23$ babeltrace2 my-ctf-trace --begin=22:55:43.658582931 \
24 --end=22:55:46.967687564
25----
26
27[role="term"]
28----
29$ babeltrace2 my-trace --begin=22:55:43.658582931
30----
31
32[role="term"]
33----
34$ babeltrace2 my-trace --end=22:55:46.967687564
35----
36
37[role="term"]
38----
39$ babeltrace2 my-trace --timerange=22:55:43,22:55:46.967687564
40----
41====
42
43.Trim a CTF trace, enable the stream intersection mode, and write a CTF trace.
44====
45[role="term"]
46----
47$ babeltrace2 my-ctf-trace --stream-intersection \
48 --timerange=22:55:43,22:55:46.967687564 \
49 --output-format=ctf --output=out-ctf-trace
50----
51====
52
53.Print the available remote LTTng sessions (through LTTng live).
54====
55[role="term"]
56----
57$ babeltrace2 --input-format=lttng-live net://localhost
58----
59====
60
61.Pretty-print LTTng live events.
62====
63[role="term"]
64----
65$ babeltrace2 net://localhost/host/myhostname/my-session-name
66----
67====
68
69.Record LTTng live traces to the file system (as CTF traces).
70====
71[role="term"]
72----
73$ babeltrace2 net://localhost/host/myhostname/my-session-name \
74 --params=session-not-found-action=end \
75 --output-format=ctf --output=out-ctf-traces
76----
77====
78
79.Read a CTF trace as fast as possible using a dummy output.
80====
81[role="term"]
82----
83$ babeltrace2 my-trace --output-format=dummy
84----
85====
86
87.Read three CTF traces in stream intersection mode, add debugging information, and pretty-print them to a file.
88====
89[role="term"]
90----
91$ babeltrace2 ctf-trace1 ctf-trace2 ctf-trace3 --stream-intersection \
92 --debug-info --output=pretty-out
93----
94====
95
96.Pretty-print a CTF trace and traces from an explicit source component, with the event times showed in seconds since the Unix epoch.
97====
98[role="term"]
99----
100$ babeltrace2 ctf-trace --component=src.my-plugin.my-src \
101 --params='path="spec-trace",output-some-event-type=yes' \
102 --clock-seconds
103----
104====
105
106.Send LTTng live events to an explicit sink component.
107====
108[role="term"]
109----
110$ babeltrace2 net://localhost/host/myhostname/mysession \
111 --component=sink.my-plugin.my-sink
112----
113====
114
115.Trim a CTF trace, add debugging information, apply an explicit filter component, and write as a CTF trace.
116====
117[role="term"]
118----
119$ babeltrace2 /path/to/ctf/trace --timerange=22:14:38,22:15:07 \
120 --debug-info --component=filter.my-plugin.my-filter \
121 --params=criteria=xyz,ignore-abc=yes \
122 --output-format=ctf --output=out-ctf-trace
123----
124====
125
126.Print the metadata text of a CTF trace.
127====
128[role="term"]
129----
130$ babeltrace2 /path/to/ctf/trace --output-format=ctf-metadata
131----
132====
This page took 0.055575 seconds and 4 git commands to generate.