java/byteman docs oops: document context variables in java probes

diff --git a/doc/langref.tex b/doc/langref.tex
index 3e3c8d00501a21561c233c90786b253c811b0da4..9494c5a768cc914c3e52fea66fd37edafab52a0d 100644 (file)
--- a/doc/langref.tex
+++ b/doc/langref.tex
@@ -1442,6 +1442,13 @@ The last two probe points work analogously, but refer to Java
 processes by PID. (PIDs for already running processes can be obtained
 using the \texttt{jps} utility.)
 
+Context variables defined within java probes include \verb+$provider+
+(which identifies the class providing the definition of the triggered
+method) and \verb+$name+ (which gives the signature of the method).
+Arguments to the method can be accessed using context variables
+\verb+$arg1$+ through \verb+$arg10+, for up to the first 10 arguments
+of a method.
+
 \subsection{PROCFS probes}
 \index{PROCFS probes}
 These probe points allow procfs pseudo-files in

diff --git a/man/stapprobes.3stap b/man/stapprobes.3stap
index 203cea3de9f5a1c5cfa5320e460bb58449321795..6e2d1bbc851403652610d215fab856cdc9a43af8 100644 (file)
--- a/man/stapprobes.3stap
+++ b/man/stapprobes.3stap
@@ -857,6 +857,18 @@ java(PID).class("CLASSNAME").method("PATTERN").return
 (PIDs for an already running process can be obtained using the
 .IR jps (1)
 utility.)
+.PP
+Context variables defined within java probes include
+.IR $provider
+(which identifies the class providing the definition of the triggered
+method) and
+.IR $name
+(which gives the signature of the method). Arguments to the method can be
+accessed using context variables
+.IR $arg1
+through
+.IR $arg10
+(for up to the first 10 arguments of a method).
 
 .SS PROCFS