4 :revdate: 5 October 2017
9 babeltrace-log - Convert a Linux kernel ring buffer to a CTF trace
15 *babeltrace-log* [opt:--with-timestamps] 'OUTPUT-PATH'
20 The `babeltrace-log` tool reads the lines of a Linux kernel ring buffer,
21 as printed by the man:dmesg(1) tool, from the standard input stream and
22 converts them to a http://diamon.org/ctf/[CTF] trace written to the
23 'OUTPUT-PATH' directory.
29 $ dmesg | babeltrace-log --with-timestamps my-trace
32 The events of the generated CTF trace are named `string` and contain a
33 single payload string field named `str` which contains the corresponding
36 By default, `babeltrace-log` does not try to extract the timestamps of
37 the kernel ring buffer lines to use them as the created events's
38 timestamps. A typical man:dmesg(1) line looks like this:
41 [87166.510937] PM: Finishing wakeup.
44 In the last example, the `[87166.510937]` part is a timestamp which
45 could be extracted. You can make `babeltrace-log` extract timestamps
46 from lines with the opt:--with-timestamps option.
51 opt:-t, opt:--with-timestamps::
52 Extract timestamps from the kernel ring buffer lines: set
53 the created event's payload's `str` field to the rest of the line,
54 excluding any timestamp prefix.
59 See the environment variables of man:babeltrace-source.text.dmesg(7),
60 man:babeltrace-filter.utils.muxer(7), and
61 man:babeltrace-sink.ctf.fs(7).
63 include::common-lib-env.txt[]
65 include::common-cli-files.txt[]
67 include::common-cmd-footer.txt[]
72 man:babeltrace-intro(7),
73 man:babeltrace-source.text.dmesg(7),
74 man:babeltrace-filter.utils.muxer(7),
75 man:babeltrace-sink.ctf.fs(7)