This is the mail archive of the
systemtap@sourceware.org
mailing list for the systemtap project.
Re: [PATCH doc/langref.tex] Restore and update marker probe info.
On Thu, 3 Sep 2009, Josh Stone wrote:
On 09/01/2009 11:38 AM, Robb Romans wrote:
+Marker probe points begin with a kernel or module (\texttt{"NAME"})
+prefix, the same as DWARF probes. This prefix identifies the source of
+the symbol table used for finding markers. The suffix names the marker
+itself: \texttt{mark."NAME"}. The marker name string, which can
+contain wildcard characters, is matched against the names given to the
+marker macros when the kernel or module is compiled.
We actually don't support module("NAME") for markers (which I realize
was in error in the text before too). We also support a format string,
so it can be either of these:
kernel.mark("MARK")
kernel.mark("MARK").format("FORMAT")
The current manpage is correct about these, if you want to look at
stapprobes.3stap.in.
Thanks. Here's an updated patch. OK to apply?
Robb
From 412a5196e4e6741140c8b4603f02c6304b1ed019 Mon Sep 17 00:00:00 2001
From: Robb Romans <robb@linux.vnet.ibm.com>
Date: Wed, 9 Sep 2009 11:49:19 -0500
Subject: [PATCH] Update marker probe information in Language Reference.
Signed-off-by: Robb Romans <robb@linux.vnet.ibm.com>
---
doc/langref.tex | 56 +++++++++++++++++++++++++++++++++++++-----------------
1 files changed, 38 insertions(+), 18 deletions(-)
diff --git a/doc/langref.tex b/doc/langref.tex
index 9208173..aa583c2 100644
--- a/doc/langref.tex
+++ b/doc/langref.tex
@@ -911,26 +911,46 @@ function, use \textbf{.statement} probes. Do not use wildcards in
to not register. Also, run statement probes in guru mode only.
-\begin{comment}
\subsection{Marker probes}
+\index{marker probes}
+This family of probe points connects to static probe markers inserted
+into the kernel or a module. These markers are special macro calls in
+the kernel that make probing faster and more reliable than with
+DWARF-based probes. DWARF debugging information is not required to
+use probe markers.
+
+Marker probe points begin with a \texttt{kernel} prefix which
+identifies the source of the symbol table used for finding
+markers. The suffix names the marker itself:
+\texttt{mark.("MARK")}. The marker name string, which can contain
+wildcard characters, is matched against the names given to the marker
+macros when the kernel or module is compiled. Optionally, you can
+specify \texttt{format("FORMAT")}. Specifying the marker format
+string allows differentiation between two markers with the same name
+but different marker format strings.
+
+The handler associated with a marker probe reads any optional
+parameters specified at the macro call site named \texttt{\$arg1}
+through \texttt{\$argNN}, where \texttt{NN} is the number of
+parameters supplied by the macro. Number and string parameters are
+passed in a type-safe manner.
+
+The marker format string associated with a marker is available in
+\texttt{\$format}. The marker name string is available in
+\texttt{\$name}.
+
+Here are the marker probe constructs:
+\begin{vindent}
+\begin{verbatim}
+kernel.mark("MARK")
+kernel.mark("MARK").format("FORMAT")
+\end{verbatim}
+\end{vindent}
+
+For more information about marker probes, see
+\url{http://sourceware.org/systemtap/wiki/UsingMarkers}.
+
-This family of probe points connects to static probe markers inserted into
-the kernel or a module. These markers are special macro calls in the kernel
-that make probing faster and more reliable than with DWARF-based probes.
-DWARF debugging information is not required to use probe markers.
-
-Marker probe points begin with a kernel or module(\char`\"{}\emph{name}\char`\"{})
-prefix, the same as DWARF probes. This prefix identifies the source of the
-symbol table used for finding markers. The suffix names the marker itself:
-mark(\char`\"{}\emph{name}\char`\"{}). The marker name string, which may
-contain wildcard characters, is matched against the names given to the marker
-macros when the kernel or module was compiled.
-
-The handler associated with a marker probe reads any optional parameters
-specified at the macro call site named \$arg1 through \$argNN, where NN is
-the number of parameters supplied by the macro. Number and string parameters
-are passed in a type-safe manner.
-\end{comment}
\subsection{Timer probes}
\index{timer probes}
--
1.6.0.4
--
Robb Romans
IBM LTC Information Development
robb@linux.vnet.ibm.com