Lines Matching refs:texttt
23 \title{\texttt{btt} User Guide}
32 \texttt{btt} is a post-processing tool for the block layer IO tracing
43 IO rates and the like. \texttt{btt} goes further and produces a variety
48 This document will discuss \texttt{btt} usage, provide some sample output,
50 by the \texttt{btt} utility.
60 This document refers to the output formats generated by \texttt{btt}
68 The simple pipeline to get going with \texttt{btt} is to perform the
72 \item Run \texttt{blktrace}, specifying whatever devices and other
76 \item After tracing completes, run \texttt{blkrawverify}, specifying
78 will use \texttt{btt} with -- section~\ref{sec:o-D} shows how you
81 -- utilizing \texttt{btt} on \emph{unclean} trace files produces
85 helps to ensure data coming from \texttt{btt} makes the most sense.
87 \item Run \texttt{blkparse} with the \texttt{-d} option specifying
88 a file to store the combined binary stream. (e.g.: \texttt{blkparse
91 \texttt{blktrace} produces a series of binary files
93 device. \texttt{blkparse} provides the ability to combine all the
96 \item Run \texttt{btt} specifying the file produced by
97 \texttt{blkparse} utilizing the \texttt{-i} option (e.g.: \texttt{btt
104 The major default areas of output provided by \texttt{btt}
121 will see these listed as \texttt{S2G} times.}:
160 work in \texttt{btt} is to better understand the multiplex nature of
325 handled. To determine this, \texttt{btt} keeps track of how many Q
350 \texttt{--all-data} or \texttt{-A} argument (see section~\ref{sec:o-A})
351 to \texttt{btt} further sections are output:
382 \item[Per Device] Similar to the per-process display, \texttt{btt}
449 \item[subset of \texttt{.avg} data, easily parsed ] When the
450 \texttt{-X} option is specified \emph{and} the \texttt{-o} has also
481 xmgrace\footnote{\texttt{http://plasma-gate.weizmann.ac.il/Grace/}
599 \texttt{btt} attempts to produce the results from running an
600 \texttt{iostat -x} command in parallel with the system as it is being
601 traced. The fields (columns) generated by the \texttt{--iostat} or
602 \texttt{-I} option can be seen from the following output snippet --
621 \texttt{btt} can produce a text file containing time line data for each
678 The latency data files which can be optionally produced by \texttt{btt}
689 \texttt{btt} can also produce two data files containing all IO-to-IO sector
702 the following fields separated by underscores (\texttt{\_}):
705 \item The prefix provided as the argument to the \texttt{-s} option.
707 \item The string \texttt{q2q} or \texttt{d2d}, indicating the Q2Q or
717 An example name would be after specifying \texttt{-s seek} would be:
718 \texttt{seek\_065,048\_q2q\_w.dat}.
759 \item[\texttt{-a}] If the \texttt{-a} or \texttt{--seek-absolute}
766 When the \texttt{-m} option provides a name, Q2Q and/or D2D seeks
767 will trigger \texttt{btt} to output seeks-per-second information. The
772 \texttt{btt} will just output the time value for the point, and the
790 \texttt{-m} output:
833 \subsection{\label{sec:o-a}\texttt{--seek-absolute}/\texttt{-a}}
837 and the start of the next. By default \texttt{btt} uses the concept
841 \subsection{\label{sec:o-A}\texttt{--all-data}/\texttt{-A}}
843 Normally \texttt{btt} will not print out verbose information
848 \subsection{\label{sec:o-B}\texttt{--dump-blocknos}/\texttt{-B}}
867 \subsection{\label{sec:o-d}\texttt{--range-delta}/\texttt{-d}}
869 Section~\ref{sec:activity} discussed how \texttt{btt} outputs a file
876 \subsection{\label{sec:o-D}\texttt{--devices}/\texttt{-D}}
878 Normally, \texttt{btt} will produce data for all devices detected in
883 for devices 8,0 and 8,8 would then be: \texttt{"8,0:8,8"}.
885 \subsection{\label{sec:o-e}\texttt{--exes}/\texttt{-e}}
887 Likewise, \texttt{btt} will produce data for all processes (executables)
891 would be \texttt{"-e mkfs.ext3,mount"}.
893 \subsection{\label{sec:o-h}\texttt{--help}/\texttt{-h}}
898 \subsection{\label{sec:o-i}\texttt{--input-file}/\texttt{-i}}
900 Specifies the binary input file that \texttt{btt} will interpret traces
904 \subsection{\label{sec:o-I}\texttt{--iostat}/\texttt{-I}}
906 This option triggers \texttt{btt} to generate iostat-like output to the
910 \subsection{\label{sec:o-l}\texttt{--d2c-latencies}/\texttt{-l}}
912 This option instructs \texttt{btt} to generate the D2C latency file
915 \subsection{\label{sec:o-L}\texttt{--periodic-latencies}/\texttt{-L}}
921 \subsection{\label{sec:o-m}\texttt{--seeks-per-second}\texttt{-m}}
923 Tells \texttt{btt} to output seeks per second information. Each device
933 \subsection{\label{sec:o-M}\texttt{--dev-maps}/\texttt{-M}}
937 \subsection{\label{sec:o-o}\texttt{--output-file}/\texttt{-o}}
939 Normally \texttt{btt} sends the statistical output (covered in
943 \subsection{\label{sec:o-p}\texttt{--per-io-dump}/\texttt{-p}}
945 This option tells \texttt{btt} to generate the per IO dump file as
948 \subsection{\label{sec:o-P}\texttt{--per-io-tress}/\texttt{-P}}
950 The \texttt{-P} option will generate a file that contains a list of all IO
954 \subsection{\label{sec:o-q}\texttt{--q2c-latencies}/\texttt{-q}}
956 This option instructs \texttt{btt} to generate the Q2C latency file
959 \subsection{\label{sec:o-Q}\texttt{--active-queue-depth}/\texttt{-Q}}
961 This option tells \texttt{btt} to generate a data file (using the given
967 \subsection{\label{sec:o-r}\texttt{--no-remaps}/\texttt{-r}}
971 \subsection{\label{sec:o-s}\texttt{--seeks}/\texttt{-s}}
973 This option instructs \texttt{btt} to generate the seek data file
976 \subsection{\label{sec:o-S}\texttt{--iostat-interval}/\texttt{-S}}
978 The normal \texttt{iostat} command allows one to specify the snapshot
979 interval, likewise, \texttt{btt} allows one to specify how many seconds
981 about the iostat-like capabilities of \texttt{btt} may be found in
984 \subsection{\label{sec:o-tT}\texttt{--time-start}/\texttt{-t} and
985 \texttt{--time-end}/\texttt{T}}
988 \emph{This \texttt{btt} capability is still under construction, results are
992 These options allow one to dictate to \texttt{btt} when to start and stop
997 \subsection{\label{sec:o-u}\texttt{--unplug-hist}/\texttt{-u}}
999 This option instructs \texttt{btt} to generate a data file containing
1018 the prefix, followed by the device identifier in \texttt{major,minor}
1019 form, with a \texttt{.dat} extension (as an example, with \texttt{-u
1020 up\_hist} specified on the command line: \texttt{up\_hist\_008,032.dat}.
1022 \subsection{\label{sec:o-V}\texttt{--version}/\texttt{-V}}
1024 Prints out the \texttt{btt} version, and exits.
1026 \subsection{\label{sec:o-v}\texttt{--verbose}/\texttt{-v}}
1028 While \texttt{btt} is processing data, it will put out periodic (1-second
1049 \subsection{\label{sec:o-X}\texttt{--easy-parse-avgs}/\texttt{-X}}
1053 the \texttt{-o} option is selected (thus producing a file with a
1054 \texttt{.avg} exentsion), \emph{and} the \texttt{-X} flag is present,
1055 then \texttt{btt} will generate this file.
1059 or the device name when \texttt{-M} is specified), and then a number of
1066 \texttt{DMI} & Device Merge Information:\\
1068 \texttt{QSK} & Device Q2Q Seek Information:\\
1070 \texttt{DSK} & Device D2D Seek Information:\\
1072 \texttt{PLG} & Plug Information:\\
1074 \texttt{UPG} & Unplug Information:\\
1076 \texttt{ARQ} & Active Requests at Q Information:\\
1078 \texttt{Q2Q} & Queue-to-Queue times:\\
1079 \texttt{Q2G} & Queue-to-GetRequest times:\\
1080 \texttt{S2G} & Sleep-to-GetRequest times:\\
1081 \texttt{G2I} & GetRequest-to-Insert times:\\
1082 \texttt{Q2M} & Queue-to-Merge times:\\
1083 \texttt{I2D} & Insert-to-Issue times:\\
1084 \texttt{M2D} & Merge-to-Issue times:\\
1085 \texttt{D2C} & Issue-to-Complete times:\\
1086 \texttt{Q2C} & Queue-to-Complete times:\\
1111 \subsection{\label{sec:o-z}\texttt{--q2d-latencies}/\texttt{-l}}
1113 This option instructs \texttt{btt} to generate the Q2D latency file
1119 upon the block numbers output when \texttt{-B} is specified (see
1120 section~\ref{sec:o-B} for more details about the \texttt{-B option}). The
1125 The script requires Python\footnote{\texttt{www.python.org}} and
1126 gnuplot\footnote{\texttt{www.gnuplot.info}}, and will enter interactive
1128 gnuplot commands at the \texttt{'gnuplot>'} prompt, and/or can change
1133 \subsection*{\texttt{bno\_plot.py} Command Line Options}
1165 \caption{\label{fig:bno_plot}Sample \texttt{bno\_plot.py} Screen Shot}
1169 \newpage\section{\label{sec:appendix}Sample \texttt{btt}
1176 \subsection{\label{sec:o-B}\texttt{--dump-blocknos}/\texttt{-B}}