doc/man/common-convert-examples.txt

   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 ====