summaryrefslogtreecommitdiffstats
path: root/stap.1.in
diff options
context:
space:
mode:
Diffstat (limited to 'stap.1.in')
-rw-r--r--stap.1.in15
1 files changed, 15 insertions, 0 deletions
diff --git a/stap.1.in b/stap.1.in
index 135e92f5..16a799cf 100644
--- a/stap.1.in
+++ b/stap.1.in
@@ -869,6 +869,21 @@ run a probe handler, default 1024. This number should be large enough
for the probe handler's own needs, plus a safety margin.
.PP
+Multipule scripts can write data into a relay buffer concurrently. A host
+script provides an interface for accessing its relay buffer to guest scripts.
+Then, the output of the guests are merged into the output of the host.
+To run a script as a host, execute stap with
+.BR \-DRELAYHOST[=name]
+option. The
+.BR name
+identifies your host script among several hosts.
+While running the host, execute stap with
+.BR \-DRELAYGUEST[=name]
+to add a guest script to the host.
+Note that you must unload guests before unloading a host. If there are some
+guests connected to the host, unloading the host will be failed.
+
+.PP
In case something goes wrong with
.IR stap " or " staprun
after a probe has already started running, one may safely kill both