Linux Trace Toolkit Reference Manual
<<< Previous Page Home Up Next Page >>>

5. Decoder (visualizer) command-line operation

NAME

    tracevisualizer - The data analysis component of the Linux Trace Toolkit (LTT)

SYNOPSIS

    tracevisualizer  [ -g ] [ -d ] [ { -o | -t } EventTypes ] [ -cCPU-ID ] [ -pPID ] [ -s ] [ -a ] [ -k ] [ -f { t | s | l } ] [ TraceFile   ProcFile [ OutFile ]]

DESCRIPTION

    Note for embedded Linux users: The tracevisualizer is run on the host system.

    The tracevisualizer program is the data analysis component of the Linux Trace Toolkit (LTT). It is used perform data interpretation on the acquired data and display a graphical  trace of it if specified. Graphical display of the trace and other GUI tools requires that the toolkit be compiled with the GTK+ library installed. See TraceToolkit/Help/index.html for installation details.

    If the program is launched with no command-line arguments, it automatically launches the GUI and waits for the user to specify files to operate on. Otherwise, TraceFile is the file that was produced by the LTT data acquisition component. ProcFile is the system description file and is useful for process analysis calculations. OutFile is the file to which the trace and analysis is written in text format.

OPTIONS

    -g    Enter graphic mode.

    -o    Omit event types. Do not include in the data analysis the event types listed in EventTypes, which is a space-separated list of any of the following events:

If you've compile the trace decoder with RTAI support, then the following event types can be configured:


    -t    Trace event types. Only include in the data analysis the event types listed in EventTypes. See -o option for details. Note that -t and -o are mutually exclusive. Specifying both will result in an error.

    -c    Trace CPU-ID. Only include events that occurred on CPU-ID in data analysis.

    -p    Trace PID. Only include process number PID in data analysis.

    -s    Summarize. Do not list all acquired events in data analysis; only the result of the analysis. This has to be used with -a. Otherwise, it has no effect.

    -a    Analyze the trace and output the results.

    -k    The trace file is a flight recorder trace. The ProcFile argument, if present, will be ignored.

    -ft   Forget time, Do not print event times.

    -fs   Forget string. Do not print event descriptions.

    -fl   Forget data entry length. Do not print event data entry length.

    -fp   Forget PID. Do not print the PID of the process to which the event belongs.

    -fc   Forget CPU-ID. Do not print the CPU-ID of the CPU where the event occurred.

    -d    Dump to file. Write out data analysis to file OutFile. If no other option is specified, then it is not necessary to use -d since it's the default behavior of tracevisualizer.


<<< Previous Page Home Up Next Page >>>
Linux trace toolkit Decoder command-line operation