aboutsummaryrefslogtreecommitdiffstats
path: root/lib/observer/doc/src
diff options
context:
space:
mode:
authorSiri Hansen <[email protected]>2016-09-27 10:54:10 +0200
committerSiri Hansen <[email protected]>2016-09-27 10:54:10 +0200
commitcf7220cd933a7b7efbb79c2b8458b21ff047d863 (patch)
treed32295d74e8f397f586467d9c9b6465f9f5cc40a /lib/observer/doc/src
parentcd4916b5fa531bdfea77a87bd8f37133955532f9 (diff)
parentac1a648ff518e0aa92cb14773b617829081a75d0 (diff)
downloadotp-cf7220cd933a7b7efbb79c2b8458b21ff047d863.tar.gz
otp-cf7220cd933a7b7efbb79c2b8458b21ff047d863.tar.bz2
otp-cf7220cd933a7b7efbb79c2b8458b21ff047d863.zip
Merge branch 'siri/ttb/ip-client-queue-size/OTP-13829' into maint
* siri/ttb/ip-client-queue-size/OTP-13829: [ttb] Add option <c>queue_size</c> to tracer/2
Diffstat (limited to 'lib/observer/doc/src')
-rw-r--r--lib/observer/doc/src/ttb.xml16
1 files changed, 15 insertions, 1 deletions
diff --git a/lib/observer/doc/src/ttb.xml b/lib/observer/doc/src/ttb.xml
index 42b0fa1d8a..7cd15e15d3 100644
--- a/lib/observer/doc/src/ttb.xml
+++ b/lib/observer/doc/src/ttb.xml
@@ -114,7 +114,8 @@ ttb:p(all, call).</input></pre>
<v>Opt = {file,Client} | {handler, FormatHandler} | {process_info,PI} |
shell | {shell, ShellSpec} | {timer, TimerSpec} |
{overload_check, {MSec, Module, Function}} |
- {flush, MSec} | resume | {resume, FetchTimeout}</v>
+ {flush, MSec} | resume | {resume, FetchTimeout} |
+ {queue_size, QueueSize}</v>
<v>TimerSpec = MSec | {MSec, StopOpts}</v>
<v>MSec = FetchTimeout = integer()</v>
<v>Module = Function = atom() </v>
@@ -126,6 +127,7 @@ ttb:p(all, call).</input></pre>
<v>FormatHandler = See format/2</v>
<v>PI = true | false </v>
<v>ShellSpec = true | false | only</v>
+ <v>QueueSize = non_neg_integer()</v>
</type>
<desc>
<p>Starts a file trace port on all specified nodes
@@ -147,6 +149,18 @@ ttb:p(all, call).</input></pre>
<c>Client</c> must be <c>{local, File}</c>. All
trace information is then sent to the trace control node where
it is written to file.</p></item>
+ <tag><c>queue_size</c></tag>
+ <item><p>When tracing to shell or <c>{local,File}</c>, an ip
+ trace driver is used internally. The ip trace driver has a
+ queue of maximum <c>QueueSize</c> messages waiting to be
+ delivered. If the driver cannot deliver messages as fast as
+ they are produced, the queue size might be exceeded and
+ messages are dropped. This parameter is optional, and is
+ only useful if many <c>{drop,N}</c> trace messages are
+ received by the trace handler. It has no meaning if shell
+ or <c>{local,File}</c> is not used. See
+ <seealso marker="runtime_tools:dbg#trace_port/2">dbg:trace_port/2</seealso>
+ for more information about the ip trace driver.</p></item>
<tag><c>process_info</c></tag>
<item><p>Indicates if process
information is to be collected. If <c>PI = true</c> (which is