summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAlan D. Brunelle <alan.brunelle@hp.com>2008-05-27 08:34:13 -0400
committerAlan D. Brunelle <alan.brunelle@hp.com>2008-05-27 08:34:13 -0400
commitac00378edac625cc01abb2647ef6c4f377971a78 (patch)
tree6b4e022bd833e83404dee7af8860afd095960669 /doc
parent1a15f6a82d62babb9d2f04a7400ff316a666dd42 (diff)
downloadblktrace-ac00378edac625cc01abb2647ef6c4f377971a78.tar.gz
blktrace-ac00378edac625cc01abb2647ef6c4f377971a78.tar.bz2
Added in new message updates to the documentation.
Diffstat (limited to 'doc')
-rw-r--r--doc/blktrace.tex13
1 files changed, 12 insertions, 1 deletions
diff --git a/doc/blktrace.tex b/doc/blktrace.tex
index 7e08543..82c35e8 100644
--- a/doc/blktrace.tex
+++ b/doc/blktrace.tex
@@ -21,7 +21,7 @@
\title{blktrace User Guide}
\author{blktrace: Jens Axboe (jens.axboe@oracle.com)\\
User Guide: Alan D. Brunelle (Alan.Brunelle@hp.com)}
-\date{18 February 2007}
+\date{27 May 2008}
\begin{document}
\maketitle
@@ -536,6 +536,9 @@ Short & Long & Description \\ \hline\hline
using better hardware - either a better io controller, or a platform
with an IOMMU.
+ \item[m -- message] Text message generated via kernel call to
+ \texttt{blk\_add\_trace\_msg}.
+
\item[M -- back merge] A previously inserted request exists that ends
on the boundary of where this io begins, so the io scheduler can merge
them together.
@@ -721,6 +724,9 @@ The default output for all event types includes this header.
\item[A -- remap] Sector and length is output, along with the original
device and sector offset.
+ \item[m -- message] The supplied message is appended to the end of
+ the standard header.
+
\end{description}
%------------------------------
@@ -796,6 +802,11 @@ kernel routine invocable interfaces:
Adds a trace with a remap event. \emph{dev} and \emph{sector} denote
the original device this \emph{bio} was mapped from.
+ \item[blk\_add\_trace\_msg(struct request\_queue *q, char *fmt, ...)]
+ Adds a formatted message to the output stream. The total message
+ size can not exceed BLK\_TN\_MSG\_MSG characters (currently
+ 1024). Standard format conversions are supported (as supplied
+ by \texttt{vscnprintf}.
\end{description}
\end{document}