Added in new message updates to the documentation.
authorAlan D. Brunelle <alan.brunelle@hp.com>
Tue, 27 May 2008 12:34:13 +0000 (08:34 -0400)
committerAlan D. Brunelle <alan.brunelle@hp.com>
Tue, 27 May 2008 12:34:13 +0000 (08:34 -0400)
doc/blktrace.tex

index 7e08543aa5bd95274e9232b7524ae028290e29f8..82c35e8efb34fd09132da99ca8393d0cbade73c5 100644 (file)
@@ -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}