1BABELTRACE(1)                                                    BABELTRACE(1)
2
3
4

NAME

6       babeltrace — Babeltrace Trace Viewer and Converter
7
8

SYNOPSIS

10       babeltrace [OPTIONS] FILE...
11

DESCRIPTION

13       Babeltrace is a trace viewer and converter reading and writing the Com‐
14       mon Trace Format (CTF). Its main use is to pretty-print CTF traces into
15       a human-readable text output ordered by time.
16
17
18       This program follow the usual GNU command line syntax with long options
19       starting with two dashes. Below is a summary of the available options.
20
21       FILE   Input trace FILE(s) or directory(ies)
22
23       -w, --output OUTPUT
24              Output trace path (default: stdout)
25
26       -i, --input-format FORMAT
27              Input trace format (default: ctf). CTF  is  currently  the  only
28              supported input format.
29
30       -o, --output-format FORMAT
31              Output trace format (default: text)
32
33       -h, --help
34              This help message
35
36       -l, --list
37              List available formats
38
39       -v, --verbose
40              Verbose mode (or set BABELTRACE_VERBOSE environment variable)
41
42       -d, --debug
43              Debug mode (or set BABELTRACE_DEBUG environment variable)
44
45       --no-delta
46              Do not print time delta between consecutive events
47
48       -n, --names name1<,name2,...>
49              Print  field  names: (payload OR args OR arg), none, all, scope,
50              header, (context OR ctx), (default: payload,context).
51
52       -f, --fields name1<,name2,...>
53              Print   additional   fields:   all,    trace,    trace:hostname,
54              trace:domain, trace:procname, trace:vpid, loglevel.
55
56       --clock-cycles
57              Disregard internal clock offset (use raw value)
58
59       --clock-offset seconds
60              Clock offset in seconds
61
62       --clock-seconds
63              Print the timestamps as [sec.ns] (default is: [hh:mm:ss.ns])
64
65       --clock-date
66              Print clock date
67
68       --clock-gmt
69              Print clock in GMT time zone (default: local time zone)
70
71       --stream-intersection
72              Only print events when all streams are active
73
74       --debug-info-dir
75              Directory  in  which  to  look  for  debugging information files
76              (default: /usr/lib/debug/)
77
78       --debug-info-target-prefix
79              Directory to use as a prefix for executable lookup
80
81       --debug-info-full-path
82              Show full debug info source and binary paths (if available)
83
84
85       Formats available: ctf, dummy, text.
86
87

ENVIRONMENT VARIABLES

89       Note that all command line options  will  override  environmenal  vari‐
90       ables.
91
92       BABELTRACE_VERBOSE
93              Activate verbose Babeltrace output.
94
95       BABELTRACE_DEBUG
96              Activate debug Babeltrace output.
97
98

SEE ALSO

100       babeltrace-log(1), lttng(1), lttng-ust(3), lttng-sessiond(8)
101

BUGS

103       The  lttng-live  plugin  does not honor the the "--output" command line
104       option.
105
106       If you encounter any issues or usability problem, please report  it  on
107       our  mailing  list  <lttng-dev@lists.lttng.org>  to  help  improve this
108       project.
109

CREDITS

111       Babeltrace and the babeltrace library are  distributed  under  the  MIT
112       license. See the files LICENSE and mit-license.txt for details.
113
114       A  Web site is available at http://www.efficios.com/babeltrace for more
115       information  on  Babeltrace  and   the   Common   Trace   Format.   See
116       http://lttng.org for more information on the LTTng project.
117
118       Mailing list for support and development: <lttng-dev@lists.lttng.org>.
119
120       You can find us on IRC server irc.oftc.net (OFTC) in #lttng.
121

THANKS

123       Thanks  to  the  Linux Foundation and Ericsson for funding part of this
124       work. Thanks to the Multicore Association Tool  Infrastructure  Working
125       Group for their active role in the creation of the Common Trace Format.
126

AUTHORS

128       Babeltrace was originally written by Mathieu Desnoyers, with additional
129       contributions from various other people. It is currently maintained  by
130       Mathieu Desnoyers <mathieu.desnoyers@efficios.com>.
131
132                               February 6, 2012                  BABELTRACE(1)
Impressum