Lines Matching refs:texttt
25 \title{\texttt{btrecord} and \texttt{btreplay} User Guide}
41 \texttt{btrecord} and \texttt{btreplay}, and shows some commonly used
49 \texttt{blktrace}\footnote{\texttt{git://git.kernel.dk/blktrace.git}}
50 directory, as it includes \texttt{../blktrace} in the \texttt{Makefile}.
54 \newpage\section{\texttt{btrecord} and \texttt{btreplay} Operating Model}
56 The \texttt{blktrace} utility provides the ability to collect detailed
69 \item Run \texttt{blktrace} to collect traces. Here you specify the
73 specify the \texttt{-a queue} command line option to \texttt{blktrace}.
75 \item While \texttt{blktrace} is running, you run the workload that you
78 \item When the work load has completed, you stop the \texttt{blktrace}
82 \texttt{blktrace} using the \texttt{btrecord} utility. This will parse
83 each trace file created by \texttt{blktrace}, and craft IO descriptions
86 \item Once \texttt{btrecord} has successfully created a series of data
87 files to be processed, you can run the \texttt{btreplay} utility which
105 \texttt{blktrace} run are used to determine the amount of time between
106 IOs during the sample workload. \texttt{btreplay} \emph{attempts} to
127 \subsection{\texttt{btrecord/btreplay} Method of Operation}
129 As noted above, \texttt{btrecord} extracts \texttt{QUEUE} operations from
130 \texttt{blktrace} output. These \texttt{QUEUE} operations indicate the
140 the \texttt{btrecord} utility provides you with two controlling knobs:
143 \item[\texttt{--max-bunch-time}] This is the amount of time to encompass
149 \item[\texttt{--max-pkts}] A \emph{bunch} size can be anywhere from
158 about \emph{bunches} of IOs to be replayed. \texttt{btreplay} operates on
166 recorded by \texttt{btrecord}, and attempts to faithfully reproduce the
173 \texttt{--cpus} option allows one to state how many CPUs on the replay
178 \texttt{--cpus} option.)
208 \texttt{--max-pkts} option). One \emph{could} simply specify
209 \texttt{-max-pkts=1} and then each IO would be treated individually. Of
233 With version 0.9.1 we now support the \texttt{-M} option to do this
243 \subsection{\texttt{btrecord} Command Line Options}
259 \caption{\label{fig:btrecord--help}\texttt{btrecord --help} Output}
263 \subsubsection{\label{sec:c-o-d}\texttt{-d} or
264 \texttt{--input-directory}\\Set Input Directory}
266 The \texttt{-d} option requires a single parameter providing the directory
268 current directory (\texttt{.}).
270 \subsubsection{\label{sec:c-o-D}\texttt{-D} or
271 \texttt{--output-directory}\\Set Output Directory}
273 The \texttt{-D} option requires a single parameter providing the directory
275 current directory (\texttt{.}).
277 \subsubsection{\texttt{-F} or \texttt{--find-traces}\\Find Trace Files
280 The \texttt{-F} option instructs \texttt{btrecord} to go find all the
281 trace files in the directory specified (either via the \texttt{-d}
284 \subsubsection{\texttt{-h} or \texttt{--help}\\Display Help Message}
285 \subsubsection{\texttt{-V} or \texttt{--version}\\Display
286 \texttt{btrecord}Version}
288 The \texttt{-h} option displays the command line options and
292 The \texttt{-V} option displays the \texttt{btreplay} version, as shown here:
301 \subsubsection{\label{sec:c-o-m}\texttt{-m} or
302 \texttt{--max-bunch-time}\\Set Maximum Time Per Bunch}
304 The \texttt{-m} option requires a single parameter which specifies an
313 \subsubsection{\label{sec:c-o-M}\texttt{-M} or
314 \texttt{--max-pkts}\\Set Maximum Packets Per Bunch}
316 The \texttt{-M} option requires a single parameter which specifies the
317 maximum number of IOs to store in a single bunch. As with the \texttt{-m}
323 \subsubsection{\label{sec:c-o-o}\texttt{-o} or
324 \texttt{--output-base}\\Set Base Name for Output Files}
330 \texttt{blktrace} output file).
332 \item \texttt{btrecord} base name -- by default ``replay''.
335 \texttt{blktrace} output file name).
341 \subsubsection{\label{sec:c-o-v}\texttt{-v} or
342 \texttt{--verbose}\\Select Verbose Output}
363 identifier. Thus: \texttt{sdab:0:} means the device \texttt{sdab} and
382 \newpage\subsection{\texttt{btreplay} Command Line Options}
401 \caption{\label{fig:btreplay--help}\texttt{btreplay --help} Output}
405 \subsubsection{\label{sec:p-o-c}\texttt{-c} or
406 \texttt{--cpus}\\Set Number of CPUs to Use}
408 \subsubsection{\label{sec:p-o-d}\texttt{-d} or
409 \texttt{--input-directory}\\Set Input Directory}
411 The \texttt{-d} option requires a single parameter providing the directory
413 current directory (\texttt{.}).
415 \subsubsection{\texttt{-F} or \texttt{--find-records}\\Find RecordFiles
418 The \texttt{-F} option instructs \texttt{btreplay} to go find all the
419 record files in the directory specified (either via the \texttt{-d}
422 \subsubsection{\texttt{-h} or \texttt{--help}\\Display Help Message}
423 \subsubsection{\texttt{-V} or \texttt{--version}\\Display
424 \texttt{btreplay}Version}
426 The \texttt{-h} option displays the command line options and
430 The \texttt{-V} option displays the \texttt{btreplay} version, as show here:
439 \subsubsection{\label{sec:p-o-i}\texttt{-i} or
440 \texttt{--input-base}\\Set Base Name for Input Files}
446 \texttt{blktrace} output file).
448 \item \texttt{btrecord} base name -- by default ``replay''.
451 \texttt{blktrace} output file name).
457 \subsubsection{\label{sec:p-o-I}\texttt{-I} or
458 \texttt{--iterations}\\Set Number of Iterations to Run}
463 \subsubsection{\label{sec:p-o-M}\texttt{-M} or \texttt{map-devs}\\
471 \item The device name on the recorded system (with the \texttt{'/dev/'}
472 removed). Example: \texttt{/dev/sda} would just be \texttt{sda}.
475 \texttt{'/dev/'} path prepended).
478 An example file for when one would map devices \texttt{/dev/sda} and
479 \texttt{/dev/sdb} on the recorded system to \texttt{dev/sdg} and
480 \texttt{sdh} on the replay system would be:
491 The utility \emph{does} allow for multiple \texttt{-M} options to be
494 \subsubsection{\label{sec:o-N}\texttt{-N} or \texttt{--no-stalls}\\Disable
500 \subsubsection{\label{sec:o-x}\texttt{-x} or \texttt{--acc-factor}\\Acceleration
503 While the \texttt{--no-stalls} option allows the traces to be replayed
510 \subsubsection{\label{sec:p-o-v}\texttt{-v} or
511 \texttt{--verbose}\\Select Verbose Output}
513 When specified on the command line, this option instructs \texttt{btreplay}
515 performed by \texttt{btreplay}. The name of each file so created will be
516 the input file name used with an extension of \texttt{.rep} appended onto
517 it. Thus, an input file of the name \texttt{sdab.replay.3} would generate a
518 verbose output file with the name \texttt{sdab.replay.3.rep} in the
521 In addition, \texttt{btreplay} will also output to \texttt{stderr} the
524 \subsubsection{\label{sec:p-o-W}\texttt{-W} or
525 \texttt{--write-enable}\\Enable Writing During Replay}
527 As a precautionary measure, by default \texttt{btreplay} will \emph{not}
528 process \emph{write} requests. In order to enable \texttt{btreplay} to
530 \texttt{-W} option.