summaryrefslogtreecommitdiffstats
path: root/stapvars.5.in
diff options
context:
space:
mode:
Diffstat (limited to 'stapvars.5.in')
-rw-r--r--stapvars.5.in45
1 files changed, 45 insertions, 0 deletions
diff --git a/stapvars.5.in b/stapvars.5.in
new file mode 100644
index 00000000..f0f0bbfc
--- /dev/null
+++ b/stapvars.5.in
@@ -0,0 +1,45 @@
+.\" -*- nroff -*-
+.TH STAPVARS 5 @DATE@ "Red Hat"
+.SH NAME
+stapvars \- systemtap variables
+
+.SH DESCRIPTION
+The following sections enumerate the public variables provided by
+standard tapsets installed under @prefix@/share/systemtap/tapset. Each
+variable is described with a type, and its behavior/restrictions.
+The syntax is the same as printed with the
+.IR stap " option " \-p2 .
+Examples:
+
+.TP
+example1:long
+Variable "example1" contains an integer.
+
+.TP
+example2:string [long]
+Variable "example2" is an array of strings, indexed by integers.
+
+.SS ARGV
+
+.TP
+argc:long
+Contains the value of the
+.BR
+$#
+value: the number of command line arguments passed to the systemtap script.
+It is initialized with an implicit begin(-1) probe.
+
+.TP
+argv:string [long]
+Contains each command line argument as a string. argv[1] will equal @1 if
+there was at least one command line argument. Arguments beyond #32 are not
+transcribed, and produce a warning message within the begin(-1) probe that
+initializes this array.
+
+.SH FILES
+.nh
+.IR @prefix@/share/systemtap/tapset
+.hy
+
+.SH SEE ALSO
+.IR stap (1)