Debian Codegraph @

doc/SystemTap_Beginners_Guide/en-US/Errors.xml

raw
1 <?xml version='1.0'?>
2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
3 ]>
4
5 <chapter id="errors">
6 <title>Understanding SystemTap Errors</title>
7
8 <remark>By type - http://sourceware.org/systemtap/tutorial/node23.html</remark>
9
10 <para>This chapter explains the most common errors you may encounter while using SystemTap.</para>
11
12 <section id="parsetype">
13 <title>Parse and Semantic Errors</title>
14 <indexterm>
15 <primary>understanding SystemTap errors</primary>
16 <secondary>parse/semantics error</secondary>
17 </indexterm>
18
19 <indexterm>
20 <primary>errors</primary>
21 <secondary>parse/semantics error</secondary>
22 </indexterm>
23
24 <indexterm>
25 <primary>parse/semantics error</primary>
26 <secondary>understanding SystemTap errors</secondary>
27 </indexterm>
28 <para>Parse and semantic errors occur while SystemTap attempts to parse and
29 translate the script into C, before converting it into a kernel
30 module. For example, type errors result from operations that assign invalid
31 values to variables or arrays.
32 </para>
33
34 <bridgehead renderas="sect2">parse error: expected <replaceable>foo</replaceable>, saw <replaceable>bar</replaceable></bridgehead>
35 <!-- next 3 indexterms for invalid values to variables/arrays -->
36 <indexterm>
37 <primary>understanding SystemTap errors</primary>
38 <secondary>parse/semantics error</secondary>
39 <tertiary>invalid values to variables/arrays</tertiary>
40 </indexterm>
41
42 <indexterm>
43 <primary>errors</primary>
44 <secondary>parse/semantics error</secondary>
45 <tertiary>invalid values to variables/arrays</tertiary>
46 </indexterm>
47
48 <indexterm>
49 <primary>parse/semantics error</primary>
50 <secondary>understanding SystemTap errors</secondary>
51 <tertiary>invalid values to variables/arrays</tertiary>
52 </indexterm>
53
54 <indexterm>
55 <primary>invalid values to variables/arrays</primary>
56 <secondary>parse/semantics error</secondary>
57 <tertiary>understanding SystemTap errors</tertiary>
58 </indexterm>
59
60
61
62 <!-- next 2 indexterms for grammatical script error -->
63
64 <indexterm>
65 <primary>understanding SystemTap errors</primary>
66 <secondary>parse/semantics error</secondary>
67 <tertiary>grammatical/typographical script error</tertiary>
68 </indexterm>
69
70 <indexterm>
71 <primary>errors</primary>
72 <secondary>parse/semantics error</secondary>
73 <tertiary>grammatical/typographical script error</tertiary>
74 </indexterm>
75
76 <indexterm>
77 <primary>parse/semantics error</primary>
78 <secondary>understanding SystemTap errors</secondary>
79 <tertiary>grammatical/typographical script error</tertiary>
80 </indexterm>
81
82 <indexterm>
83 <primary>grammatical/typographical script error</primary>
84 <secondary>parse/semantics error</secondary>
85 <tertiary>understanding SystemTap errors</tertiary>
86 </indexterm>
87 <!-- next 2 indexterms for typographical script error -->
88
89 <indexterm>
90 <primary>typographical script error</primary>
91 <secondary>parse/semantics error</secondary>
92 <tertiary>understanding SystemTap errors</tertiary>
93 </indexterm>
94
95
96 <para>The script contains a grammatical or typographical error. SystemTap detected the type of the construct that is incorrect, given the context of the probe.
97 </para>
98
99 <remark>need more clarification (example) on this; could not replicate. how to
100 replicate?</remark>
101
102 <para>
103 For example, the following invalid SystemTap script is missing its probe
104 handlers:
105 </para>
106
107 <para>
108 <programlisting><xi:include parse="text" href="extras/perror.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting>
109 </para>
110
111 <para>
112 An attempt to run this SystemTap script fails with the following error
113 message showing that the parser expects
114 something other than the <command>probe</command> keyword in
115 column 1 of line 2:
116 </para>
117 <para>
118 <programlisting>parse error: expected one of '. , ( ? ! { = +='
119 saw: keyword at perror.stp:2:1
120 1 parse error(s).</programlisting>
121 </para>
122
123 <bridgehead renderas="sect2">parse error: embedded code in unprivileged script</bridgehead>
124 <!-- next 2 indexterms for embedded code in unprivileged script -->
125
126 <indexterm>
127 <primary>understanding SystemTap errors</primary>
128 <secondary>parse/semantics error</secondary>
129 <tertiary>embedded code in unprivileged script</tertiary>
130 </indexterm>
131
132 <indexterm>
133 <primary>errors</primary>
134 <secondary>parse/semantics error</secondary>
135 <tertiary>embedded code in unprivileged script</tertiary>
136 </indexterm>
137
138 <indexterm>
139 <primary>parse/semantics error</primary>
140 <secondary>understanding SystemTap errors</secondary>
141 <tertiary>embedded code in unprivileged script</tertiary>
142 </indexterm>
143
144 <indexterm>
145 <primary>embedded code in unprivileged script</primary>
146 <secondary>parse/semantics error</secondary>
147 <tertiary>understanding SystemTap errors</tertiary>
148 </indexterm>
149
150 <indexterm>
151 <primary>unprivileged script, embedded code in</primary>
152 <secondary>parse/semantics error</secondary>
153 <tertiary>understanding SystemTap errors</tertiary>
154 </indexterm>
155
156 <indexterm>
157 <primary>unsafe embedded code in unprivileged script</primary>
158 <secondary>parse/semantics error</secondary>
159 <tertiary>understanding SystemTap errors</tertiary>
160 </indexterm>
161
162 <para>
163 The script contains unsafe embedded C code, that is, blocks of code
164 surrounded by <command>%{</command> and <command>%}</command>. SystemTap
165 allows you to embed C code in a script, which is useful if there are no
166 tapsets to suit your purposes. However, embedded C constructs are not
167 safe and SystemTap reports this error to warn you if such constructs
168 appear in the script.
169 </para>
170
171
172 <!-- next 2 indexterms for guru mode -->
173
174 <indexterm>
175 <primary>understanding SystemTap errors</primary>
176 <secondary>parse/semantics error</secondary>
177 <tertiary>guru mode</tertiary>
178 </indexterm>
179
180 <indexterm>
181 <primary>errors</primary>
182 <secondary>parse/semantics error</secondary>
183 <tertiary>guru mode</tertiary>
184 </indexterm>
185
186 <indexterm>
187 <primary>parse/semantics error</primary>
188 <secondary>understanding SystemTap errors</secondary>
189 <tertiary>guru mode</tertiary>
190 </indexterm>
191
192 <indexterm>
193 <primary>guru mode</primary>
194 <secondary>parse/semantics error</secondary>
195 <tertiary>understanding SystemTap errors</tertiary>
196 </indexterm>
197
198 <para>
199 If you are sure that any similar constructs in the script are safe
200 <emphasis>and</emphasis> you
201 are a member of the <systemitem class="groupname">stapdev</systemitem>
202 group (or have root privileges),
203 run the script in "guru" mode by using the <option>-g</option> option:
204 </para>
205
206 <screen><command>stap -g <replaceable>script</replaceable></command></screen>
207
208 <bridgehead renderas="sect2">semantic error: type mismatch for identifier '<replaceable>foo</replaceable>' ... string vs. long</bridgehead>
209 <!-- next 2 indexterms for type mismatch for identifier -->
210
211 <indexterm>
212 <primary>understanding SystemTap errors</primary>
213 <secondary>parse/semantics error</secondary>
214 <tertiary>type mismatch for identifier</tertiary>
215 </indexterm>
216
217 <indexterm>
218 <primary>errors</primary>
219 <secondary>parse/semantics error</secondary>
220 <tertiary>type mismatch for identifier</tertiary>
221 </indexterm>
222
223 <indexterm>
224 <primary>parse/semantics error</primary>
225 <secondary>understanding SystemTap errors</secondary>
226 <tertiary>type mismatch for identifier</tertiary>
227 </indexterm>
228
229 <indexterm>
230 <primary>type mismatch for identifier</primary>
231 <secondary>parse/semantics error</secondary>
232 <tertiary>understanding SystemTap errors</tertiary>
233 </indexterm>
234
235 <indexterm>
236 <primary>identifier type mismatch</primary>
237 <secondary>parse/semantics error</secondary>
238 <tertiary>understanding SystemTap errors</tertiary>
239 </indexterm>
240 <para>
241 The function <replaceable>foo</replaceable> in the
242 script used the wrong type
243 (such as <literal>%s</literal> or <literal>%d</literal>).
244 In the following example, the format specifier should be
245 <literal>%s</literal> and not <literal>%d</literal>, because the
246 <function>execname()</function> function returns a string:
247 </para>
248
249 <programlisting>probe syscall.open
250 {
251 printf ("%d(%d) open\n", execname(), pid())
252 }</programlisting>
253
254 <bridgehead renderas="sect2">semantic error: unresolved type for identifier '<replaceable>foo</replaceable>'</bridgehead>
255 <!-- next 2 indexterms for unresolved type for identifier -->
256
257 <indexterm>
258 <primary>understanding SystemTap errors</primary>
259 <secondary>parse/semantics error</secondary>
260 <tertiary>unresolved type for identifier</tertiary>
261 </indexterm>
262
263 <indexterm>
264 <primary>errors</primary>
265 <secondary>parse/semantics error</secondary>
266 <tertiary>unresolved type for identifier</tertiary>
267 </indexterm>
268
269 <indexterm>
270 <primary>parse/semantics error</primary>
271 <secondary>understanding SystemTap errors</secondary>
272 <tertiary>unresolved type for identifier</tertiary>
273 </indexterm>
274
275 <indexterm>
276 <primary>unresolved type for identifier</primary>
277 <secondary>parse/semantics error</secondary>
278 <tertiary>understanding SystemTap errors</tertiary>
279 </indexterm>
280 <para>The identifier (variable) was used, but no type (integer or
281 string) could be determined. This occurs, for instance, if you use a
282 variable in a <command>printf</command> statement while
283 the script never assigns a value to the variable.</para>
284
285 <bridgehead renderas="sect2">semantic error: Expecting symbol or array index expression</bridgehead>
286 <!-- next 2 indexterms for expected symbol/array index expression -->
287
288 <indexterm>
289 <primary>understanding SystemTap errors</primary>
290 <secondary>parse/semantics error</secondary>
291 <tertiary>expected symbol/array index expression</tertiary>
292 </indexterm>
293
294 <indexterm>
295 <primary>errors</primary>
296 <secondary>parse/semantics error</secondary>
297 <tertiary>expected symbol/array index expression</tertiary>
298 </indexterm>
299
300 <indexterm>
301 <primary>parse/semantics error</primary>
302 <secondary>understanding SystemTap errors</secondary>
303 <tertiary>expected symbol/array index expression</tertiary>
304 </indexterm>
305
306 <indexterm>
307 <primary>expected symbol/array index expression</primary>
308 <secondary>parse/semantics error</secondary>
309 <tertiary>understanding SystemTap errors</tertiary>
310 </indexterm>
311
312 <para>
313 SystemTap could not assign a value to a variable or to a location in an
314 array. The destination for the assignment is not a valid destination.
315 The following example code would generate this error:
316 </para>
317 <programlisting><xi:include parse="text" href="extras/werror.stp" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting>
318
319 <bridgehead renderas="sect2">while searching for arity <replaceable>N</replaceable> function, semantic error: unresolved function call</bridgehead>
320 <!-- next 2 indexterms for unresolved function call -->
321
322 <indexterm>
323 <primary>understanding SystemTap errors</primary>
324 <secondary>parse/semantics error</secondary>
325 <tertiary>unresolved function call</tertiary>
326 </indexterm>
327
328 <indexterm>
329 <primary>errors</primary>
330 <secondary>parse/semantics error</secondary>
331 <tertiary>unresolved function call</tertiary>
332 </indexterm>
333
334 <indexterm>
335 <primary>parse/semantics error</primary>
336 <secondary>understanding SystemTap errors</secondary>
337 <tertiary>unresolved function call</tertiary>
338 </indexterm>
339
340 <indexterm>
341 <primary>unresolved function call</primary>
342 <secondary>parse/semantics error</secondary>
343 <tertiary>understanding SystemTap errors</tertiary>
344 </indexterm>
345
346 <indexterm>
347 <primary>function call (unresolved)</primary>
348 <secondary>parse/semantics error</secondary>
349 <tertiary>understanding SystemTap errors</tertiary>
350 </indexterm>
351 <para>A function call or array index expression in the script used an invalid
352 number of arguments or parameters. In SystemTap,
353 <firstterm>arity</firstterm> can either refer to the number of indices
354 for an array, or the number of parameters to a function.</para>
355
356 <bridgehead renderas="sect2">semantic error: array locals not supported, missing global declaration?</bridgehead>
357
358 <!-- next 2 indexterms for non-global arrays -->
359 <indexterm>
360 <primary>array locals not supported</primary>
361 <secondary>parse/semantics error</secondary>
362 <tertiary>understanding SystemTap errors</tertiary>
363 </indexterm>
364 <indexterm>
365 <primary>understanding SystemTap errors</primary>
366 <secondary>parse/semantics error</secondary>
367 <tertiary>non-global arrays</tertiary>
368 </indexterm>
369
370 <indexterm>
371 <primary>errors</primary>
372 <secondary>parse/semantics error</secondary>
373 <tertiary>non-global arrays</tertiary>
374 </indexterm>
375
376 <indexterm>
377 <primary>parse/semantics error</primary>
378 <secondary>understanding SystemTap errors</secondary>
379 <tertiary>non-global arrays</tertiary>
380 </indexterm>
381
382 <indexterm>
383 <primary>non-global arrays</primary>
384 <secondary>parse/semantics error</secondary>
385 <tertiary>understanding SystemTap errors</tertiary>
386 </indexterm>
387 <para>The script used an array operation without declaring the array as
388 a global variable (global variables can be declared after their use in
389 SystemTap scripts). Similar messages appear if an array is used, but with inconsistent arities.</para>
390
391 <bridgehead renderas="sect2">semantic error: variable '<replaceable>foo</replaceable>' modified during 'foreach' iteration</bridgehead>
392 <!-- next 2 indexterms for variable modified during 'foreach' -->
393
394 <indexterm>
395 <primary>understanding SystemTap errors</primary>
396 <secondary>parse/semantics error</secondary>
397 <tertiary>variable modified during 'foreach'</tertiary>
398 </indexterm>
399
400 <indexterm>
401 <primary>errors</primary>
402 <secondary>parse/semantics error</secondary>
403 <tertiary>variable modified during 'foreach'</tertiary>
404 </indexterm>
405
406 <indexterm>
407 <primary>parse/semantics error</primary>
408 <secondary>understanding SystemTap errors</secondary>
409 <tertiary>variable modified during 'foreach'</tertiary>
410 </indexterm>
411
412 <indexterm>
413 <primary>variable modified during 'foreach'</primary>
414 <secondary>parse/semantics error</secondary>
415 <tertiary>understanding SystemTap errors</tertiary>
416 </indexterm>
417 <para>The array <replaceable>foo</replaceable> is being modified (being assigned to or deleted from) within an active <command>foreach</command> loop. This error also displays if an operation within the script performs a function call within the <command>foreach</command> loop.</para>
418
419 <bridgehead renderas="sect2">semantic error: probe point mismatch at position <replaceable>N</replaceable>, while resolving probe point <replaceable>foo</replaceable></bridgehead>
420
421
422 <!-- next 2 indexterms for probe mismatch -->
423
424 <indexterm>
425 <primary>understanding SystemTap errors</primary>
426 <secondary>parse/semantics error</secondary>
427 <tertiary>probe mismatch</tertiary>
428 </indexterm>
429
430 <indexterm>
431 <primary>errors</primary>
432 <secondary>parse/semantics error</secondary>
433 <tertiary>probe mismatch</tertiary>
434 </indexterm>
435
436 <indexterm>
437 <primary>parse/semantics error</primary>
438 <secondary>understanding SystemTap errors</secondary>
439 <tertiary>probe mismatch</tertiary>
440 </indexterm>
441
442 <indexterm>
443 <primary>probe mismatch</primary>
444 <secondary>parse/semantics error</secondary>
445 <tertiary>understanding SystemTap errors</tertiary>
446 </indexterm>
447 <para>SystemTap did not understand what the event or SystemTap function
448 <replaceable>foo</replaceable> refers
449 to. This usually means that SystemTap could not find a match for
450 <replaceable>foo</replaceable> in the
451 tapset library. <replaceable>N</replaceable> refers to the
452 line and column of
453 the error.</para>
454
455 <remark>how to explain N in previous? "The divergence from the “tree” of probe point namespace is at position N (starting with zero at left)." (from tutorial) </remark>
456
457 <bridgehead renderas="sect2">semantic error: no match for probe point, while resolving probe point <replaceable>foo</replaceable></bridgehead>
458
459
460 <!-- next 2 indexterms for no match for probe point -->
461
462 <indexterm>
463 <primary>understanding SystemTap errors</primary>
464 <secondary>parse/semantics error</secondary>
465 <tertiary>no match for probe point</tertiary>
466 </indexterm>
467
468 <indexterm>
469 <primary>errors</primary>
470 <secondary>parse/semantics error</secondary>
471 <tertiary>no match for probe point</tertiary>
472 </indexterm>
473
474 <indexterm>
475 <primary>parse/semantics error</primary>
476 <secondary>understanding SystemTap errors</secondary>
477 <tertiary>no match for probe point</tertiary>
478 </indexterm>
479
480 <indexterm>
481 <primary>no match for probe point</primary>
482 <secondary>parse/semantics error</secondary>
483 <tertiary>understanding SystemTap errors</tertiary>
484 </indexterm>
485
486 <indexterm>
487 <primary>probe point (no match for)</primary>
488 <secondary>parse/semantics error</secondary>
489 <tertiary>understanding SystemTap errors</tertiary>
490 </indexterm>
491 <para>SystemTap could not resolve the events or handler function <replaceable>foo</replaceable> for a variety of reasons. This error occurs when the script contains the event <command>kernel.function("<replaceable>something</replaceable>")</command>, and <replaceable>something</replaceable> does not exist. In some cases, the error could also mean the script contains an invalid kernel file name or source line number.</para>
492
493 <bridgehead renderas="sect2">semantic error: unresolved target-symbol expression</bridgehead>
494 <!-- next 2 indexterms for unresolved target-symbol expression -->
495
496 <indexterm>
497 <primary>understanding SystemTap errors</primary>
498 <secondary>parse/semantics error</secondary>
499 <tertiary>unresolved target-symbol expression</tertiary>
500 </indexterm>
501
502 <indexterm>
503 <primary>errors</primary>
504 <secondary>parse/semantics error</secondary>
505 <tertiary>unresolved target-symbol expression</tertiary>
506 </indexterm>
507
508 <indexterm>
509 <primary>parse/semantics error</primary>
510 <secondary>understanding SystemTap errors</secondary>
511 <tertiary>unresolved target-symbol expression</tertiary>
512 </indexterm>
513
514 <indexterm>
515 <primary>unresolved target-symbol expression</primary>
516 <secondary>parse/semantics error</secondary>
517 <tertiary>understanding SystemTap errors</tertiary>
518 </indexterm>
519
520 <indexterm>
521 <primary>target-symbol expression, unresolved</primary>
522 <secondary>parse/semantics error</secondary>
523 <tertiary>understanding SystemTap errors</tertiary>
524 </indexterm>
525 <para>A handler in the script references a target variable, but the
526 value of the variable could not be resolved. This error could also mean
527 that a handler is referencing a target variable that is not valid
528 in the context when it was referenced. This may be a result of compiler
529 optimization of the generated code.</para>
530
531 <bridgehead renderas="sect2">semantic error: libdwfl failure </bridgehead>
532
533 <!-- next 2 indexterms for libdwfl failure -->
534
535 <indexterm>
536 <primary>understanding SystemTap errors</primary>
537 <secondary>parse/semantics error</secondary>
538 <tertiary>libdwfl failure</tertiary>
539 </indexterm>
540
541 <indexterm>
542 <primary>errors</primary>
543 <secondary>parse/semantics error</secondary>
544 <tertiary>libdwfl failure</tertiary>
545 </indexterm>
546
547 <indexterm>
548 <primary>parse/semantics error</primary>
549 <secondary>understanding SystemTap errors</secondary>
550 <tertiary>libdwfl failure</tertiary>
551 </indexterm>
552
553 <indexterm>
554 <primary>libdwfl failure</primary>
555 <secondary>parse/semantics error</secondary>
556 <tertiary>understanding SystemTap errors</tertiary>
557 </indexterm>
558 <para>There was a problem processing the debugging information. In most
559 cases, this error results from the installation of a
560 <package>kernel-debuginfo</package> package whose version does not match
561 the probed kernel exactly. The installed <package>kernel-debuginfo</package> package itself may have some consistency or correctness problems.</para>
562
563 <bridgehead renderas="sect2">semantic error: cannot find <replaceable>foo</replaceable> debuginfo</bridgehead>
564 <para>SystemTap could not find a suitable <package>kernel-debuginfo</package> package.</para>
565 <!--
566 <formalpara>
567 <title></title>
568 <para></para>
569 </formalpara>
570 -->
571
572 </section>
573
574 <section id="runtimeerror">
575 <title>Runtime Errors and Warnings</title>
576 <indexterm>
577 <primary>understainding SystemTap errors</primary>
578 <secondary>runtime errors/warnings</secondary>
579 </indexterm>
580
581 <indexterm>
582 <primary>errors</primary>
583 <secondary>runtime errors/warnings</secondary>
584 </indexterm>
585
586 <indexterm>
587 <primary>runtime errors/warnings</primary>
588 <secondary>understainding SystemTap errors</secondary>
589 </indexterm>
590
591
592 <para>
593 Runtime errors and warnings occur when the SystemTap
594 instrumentation has been installed and is collecting data on
595 the system.
596 </para>
597
598 <bridgehead renderas="sect2">WARNING: Number of errors: <replaceable>N</replaceable>, skipped probes: <replaceable>M</replaceable></bridgehead>
599 <!-- next 2 indexterms for number of errors: N, skipped probes: M -->
600
601 <indexterm>
602 <primary>understainding SystemTap errors</primary>
603 <secondary>runtime errors/warnings</secondary>
604 <tertiary>number of errors: N, skipped probes: M</tertiary>
605 </indexterm>
606
607 <indexterm>
608 <primary>errors</primary>
609 <secondary>runtime errors/warnings</secondary>
610 <tertiary>number of errors: N, skipped probes: M</tertiary>
611 </indexterm>
612
613 <indexterm>
614 <primary>runtime errors/warnings</primary>
615 <secondary>understainding SystemTap errors</secondary>
616 <tertiary>number of errors: N, skipped probes: M</tertiary>
617 </indexterm>
618
619 <indexterm>
620 <primary>number of errors: N, skipped probes: M</primary>
621 <secondary>runtime errors/warnings</secondary>
622 <tertiary>understainding SystemTap errors</tertiary>
623 </indexterm>
624 <para>
625 Errors and/or skipped probes occurred during this run. Both
626 <replaceable>N</replaceable> and <replaceable>M</replaceable> are
627 the counts of the number of probes that were not executed due to
628 conditions such as too much time required to execute event handlers over
629 an interval of time.
630 </para>
631
632 <bridgehead renderas="sect2">division by 0</bridgehead>
633 <!-- next 2 indexterms for division by 0 -->
634
635 <indexterm>
636 <primary>understainding SystemTap errors</primary>
637 <secondary>runtime errors/warnings</secondary>
638 <tertiary>division by 0</tertiary>
639 </indexterm>
640
641 <indexterm>
642 <primary>errors</primary>
643 <secondary>runtime errors/warnings</secondary>
644 <tertiary>division by 0</tertiary>
645 </indexterm>
646
647 <indexterm>
648 <primary>runtime errors/warnings</primary>
649 <secondary>understainding SystemTap errors</secondary>
650 <tertiary>division by 0</tertiary>
651 </indexterm>
652
653 <indexterm>
654 <primary>division by 0</primary>
655 <secondary>runtime errors/warnings</secondary>
656 <tertiary>understainding SystemTap errors</tertiary>
657 </indexterm>
658
659 <indexterm>
660 <primary>invalid division</primary>
661 <secondary>runtime errors/warnings</secondary>
662 <tertiary>understainding SystemTap errors</tertiary>
663 </indexterm>
664
665 <para>
666 The script code performed an invalid division.
667 </para>
668
669 <bridgehead renderas="sect2">aggregate element not found</bridgehead>
670 <!-- next 2 indexterms for aggregate element not found -->
671
672 <indexterm>
673 <primary>understainding SystemTap errors</primary>
674 <secondary>runtime errors/warnings</secondary>
675 <tertiary>aggregate element not found</tertiary>
676 </indexterm>
677
678 <indexterm>
679 <primary>errors</primary>
680 <secondary>runtime errors/warnings</secondary>
681 <tertiary>aggregate element not found</tertiary>
682 </indexterm>
683
684 <indexterm>
685 <primary>runtime errors/warnings</primary>
686 <secondary>understainding SystemTap errors</secondary>
687 <tertiary>aggregate element not found</tertiary>
688 </indexterm>
689
690 <indexterm>
691 <primary>aggregate element not found</primary>
692 <secondary>runtime errors/warnings</secondary>
693 <tertiary>understainding SystemTap errors</tertiary>
694 </indexterm>
695 <para>
696 A statistics extractor function other than <command>@count</command>
697 was invoked on an aggregate that has not had any values accumulated yet.
698 This is similar to a division by zero.
699 </para>
700
701 <bridgehead renderas="sect2">aggregation overflow</bridgehead>
702 <!-- next 3 indexterms for aggregation overflow -->
703 <indexterm>
704 <primary>understainding SystemTap errors</primary>
705 <secondary>runtime errors/warnings</secondary>
706 <tertiary>aggregation overflow</tertiary>
707 </indexterm>
708
709 <indexterm>
710 <primary>errors</primary>
711 <secondary>runtime errors/warnings</secondary>
712 <tertiary>aggregation overflow</tertiary>
713 </indexterm>
714
715 <indexterm>
716 <primary>runtime errors/warnings</primary>
717 <secondary>understainding SystemTap errors</secondary>
718 <tertiary>aggregation overflow</tertiary>
719 </indexterm>
720
721 <indexterm>
722 <primary>aggregation overflow</primary>
723 <secondary>runtime errors/warnings</secondary>
724 <tertiary>understainding SystemTap errors</tertiary>
725 </indexterm>
726 <indexterm>
727 <primary>overflow of aggregation</primary>
728 <secondary>runtime errors/warnings</secondary>
729 <tertiary>understainding SystemTap errors</tertiary>
730 </indexterm>
731
732 <para>
733 An array containing aggregate values contains too many distinct key pairs at this time.
734 </para>
735 <!--<para>
736 An array containing aggregate values contains too many distinct key tuples at this time.
737 </para>-->
738
739
740 <bridgehead renderas="sect2">MAXNESTING exceeded</bridgehead>
741 <indexterm>
742 <primary>understainding SystemTap errors</primary>
743 <secondary>runtime errors/warnings</secondary>
744 <tertiary>MAXNESTING exceeded</tertiary>
745 </indexterm>
746
747 <indexterm>
748 <primary>errors</primary>
749 <secondary>runtime errors/warnings</secondary>
750 <tertiary>MAXNESTING exceeded</tertiary>
751 </indexterm>
752
753 <indexterm>
754 <primary>runtime errors/warnings</primary>
755 <secondary>understainding SystemTap errors</secondary>
756 <tertiary>MAXNESTING exceeded</tertiary>
757 </indexterm>
758
759 <indexterm>
760 <primary>MAXNESTING exceeded</primary>
761 <secondary>runtime errors/warnings</secondary>
762 <tertiary>understainding SystemTap errors</tertiary>
763 </indexterm>
764
765 <indexterm>
766 <primary>exceeded MAXNESTING</primary>
767 <secondary>runtime errors/warnings</secondary>
768 <tertiary>understainding SystemTap errors</tertiary>
769 </indexterm>
770
771 <para>
772 Too many levels of function call nesting were attempted.
773 The default nesting of function calls allowed is 10.
774 </para>
775
776 <bridgehead renderas="sect2">MAXACTION exceeded</bridgehead>
777 <!-- next 2 indexterms for MAXACTION exceeded -->
778
779 <indexterm>
780 <primary>understainding SystemTap errors</primary>
781 <secondary>runtime errors/warnings</secondary>
782 <tertiary>MAXACTION exceeded</tertiary>
783 </indexterm>
784
785 <indexterm>
786 <primary>errors</primary>
787 <secondary>runtime errors/warnings</secondary>
788 <tertiary>MAXACTION exceeded</tertiary>
789 </indexterm>
790
791 <indexterm>
792 <primary>runtime errors/warnings</primary>
793 <secondary>understainding SystemTap errors</secondary>
794 <tertiary>MAXACTION exceeded</tertiary>
795 </indexterm>
796
797 <indexterm>
798 <primary>MAXACTION exceeded</primary>
799 <secondary>runtime errors/warnings</secondary>
800 <tertiary>understainding SystemTap errors</tertiary>
801 </indexterm>
802
803 <indexterm>
804 <primary>exceeded MAXACTION</primary>
805 <secondary>runtime errors/warnings</secondary>
806 <tertiary>understainding SystemTap errors</tertiary>
807 </indexterm>
808 <para>
809 The probe handler attempted to execute too many statements in the
810 probe handler. The default number of actions allowed in a probe handler
811 is 1000.
812 </para>
813
814 <bridgehead renderas="sect2">kernel/user string copy fault at <replaceable>ADDR</replaceable></bridgehead>
815 <!-- next 2 indexterms for copy fault -->
816
817 <indexterm>
818 <primary>understainding SystemTap errors</primary>
819 <secondary>runtime errors/warnings</secondary>
820 <tertiary>copy fault</tertiary>
821 </indexterm>
822
823 <indexterm>
824 <primary>errors</primary>
825 <secondary>runtime errors/warnings</secondary>
826 <tertiary>copy fault</tertiary>
827 </indexterm>
828
829 <indexterm>
830 <primary>runtime errors/warnings</primary>
831 <secondary>understainding SystemTap errors</secondary>
832 <tertiary>copy fault</tertiary>
833 </indexterm>
834
835 <indexterm>
836 <primary>copy fault</primary>
837 <secondary>runtime errors/warnings</secondary>
838 <tertiary>understainding SystemTap errors</tertiary>
839 </indexterm>
840 <para>
841 The probe handler attempted to copy a string from kernel or
842 user space at an invalid address (<replaceable>ADDR</replaceable>).
843 </para>
844
845 <bridgehead renderas="sect2">pointer dereference fault</bridgehead>
846
847
848 <!-- next 2 indexterms for pointer dereference fault -->
849
850 <indexterm>
851 <primary>understainding SystemTap errors</primary>
852 <secondary>runtime errors/warnings</secondary>
853 <tertiary>pointer dereference fault</tertiary>
854 </indexterm>
855
856 <indexterm>
857 <primary>errors</primary>
858 <secondary>runtime errors/warnings</secondary>
859 <tertiary>pointer dereference fault</tertiary>
860 </indexterm>
861
862 <indexterm>
863 <primary>runtime errors/warnings</primary>
864 <secondary>understainding SystemTap errors</secondary>
865 <tertiary>pointer dereference fault</tertiary>
866 </indexterm>
867
868 <indexterm>
869 <primary>pointer dereference fault</primary>
870 <secondary>runtime errors/warnings</secondary>
871 <tertiary>understainding SystemTap errors</tertiary>
872 </indexterm>
873 <para>
874 There was a fault encountered during a pointer
875 dereference operation such as a target variable evaluation.
876 </para>
877
878 </section>
879
880 </chapter>
881