NAME

       babeltrace — Babeltrace Trace Viewer and Converter

SYNOPSIS

       babeltrace [OPTIONS] FILE...

DESCRIPTION

       Babeltrace  is  a  trace viewer and converter reading and writing the Common Trace Format (CTF). Its main
       use is to pretty-print CTF traces into a human-readable text output ordered by time.

       This program follow the usual GNU command line syntax with long options starting with two  dashes.  Below
       is a summary of the available options.

       FILE   Input trace FILE(s) or directory(ies)

       -w, --output OUTPUT
              Output trace path (default: stdout)

       -i, --input-format FORMAT
              Input trace format (default: ctf). CTF is currently the only supported input format.

       -o, --output-format FORMAT
              Output trace format (default: text)

       -h, --help
              This help message

       -l, --list
              List available formats

       -v, --verbose
              Verbose mode (or set BABELTRACE_VERBOSE environment variable)

       -d, --debug
              Debug mode (or set BABELTRACE_DEBUG environment variable)

       --no-delta
              Do not print time delta between consecutive events

       -n, --names name1<,name2,...>
              Print field names: (payload OR args OR arg), none, all, scope, header, (context OR ctx), (default:
              payload,context).

       -f, --fields name1<,name2,...>
              Print additional fields: all, trace,  trace:hostname,  trace:domain,  trace:procname,  trace:vpid,
              loglevel.

       --clock-cycles
              Disregard internal clock offset (use raw value)

       --clock-offset seconds
              Clock offset in seconds

       --clock-seconds
              Print the timestamps as [sec.ns] (default is: [hh:mm:ss.ns])

       --clock-date
              Print clock date

       --clock-gmt
              Print clock in GMT time zone (default: local time zone)

       --stream-intersection
              Only print events when all streams are active

       --debug-info-dir
              Directory in which to look for debugging information files (default: /usr/lib/debug/)

       --debug-info-target-prefix
              Directory to use as a prefix for executable lookup

       --debug-info-full-path
              Show full debug info source and binary paths (if available)

       Formats available: ctf, dummy, text.

ENVIRONMENT VARIABLES

       Note that all command line options will override environmenal variables.

       BABELTRACE_VERBOSE
              Activate verbose Babeltrace output.

       BABELTRACE_DEBUG
              Activate debug Babeltrace output.

SEE ALSO

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

BUGS

       The lttng-live plugin does not honor the the "--output" command line option.

       If  you  encounter  any  issues  or  usability  problem,  please  report  it  on our mailing list <lttng-
       dev@lists.lttng.org> to help improve this project.

CREDITS

       Babeltrace and the babeltrace library are distributed under the MIT license. See the  files  LICENSE  and
       mit-license.txt for details.

       A  Web site is available at http://www.efficios.com/babeltrace for more information on Babeltrace and the
       Common Trace Format. See http://lttng.org for more information on the LTTng project.

       Mailing list for support and development: <lttng-dev@lists.lttng.org>.

       You can find us on IRC server irc.oftc.net (OFTC) in #lttng.

THANKS

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

AUTHORS

       Babeltrace was originally written by Mathieu Desnoyers, with additional contributions from various  other
       people. It is currently maintained by Mathieu Desnoyers <mathieu.desnoyers@efficios.com>.

                                                February 6, 2012                                   BABELTRACE(1)