%
% x-kernel v3.3
%
% Copyright (c) 1996,1993,1991,1990  Arizona Board of Regents
%

\section{Extrace}\label{Extrace}

{\it Extrace} is a graphical analysis tool used to analyze trace output
from {\xS} simulations. Extrace is used specifically for analyzing
router buffers and ethernet driver traces.

Invoking the "extrace" tool:
\begin{verbatim}
extrace [arguments] [plot-types] trace-filename
\end{verbatim}

plot-types:
\begin{verbatim}
queue
port0
port1
\end{verbatim}

args:   Same as in ptcp:
\begin{verbatim}
                                -allplot
                                -header
                                -tail
                                -a
                                -o
                                -xbeg=
                                -xend=
                                -xtime=
                                -xtics=
                                -maxRate= (can use T1, Kb and Mb)
                                -maxTics=
                                -journal
                                -pn
                                -n
                                -big
                                -auto1
                                -auto2

\end{verbatim}
new:
\begin{verbatim}
-group=<#>
\end{verbatim}
Group events into groups of size \#. For example,
if the queue information of a router was written
every 10ms, a grouping of 5 would be equivalend to
writing the information every 50ms.
\begin{verbatim}
-bucket=<#>
\end{verbatim}
Used for the histograms printed out to the screen.
Specifies the bucket size of the histogram.
\begin{verbatim}
-reset=<time>
\end{verbatim}
Reset gathering of statistics, so the numbers shown
only represent statistics after time (in ms).
\begin{verbatim}
-db=<filename>
\end{verbatim}
Writes information to the specified (db) file.
\begin{verbatim}
lenDb[r|w]
\end{verbatim}
To be documented.
