Debian Codegraph @

man/cs/error::pass2.7stap

raw
1 .\" t
2 .TH ERROR::PASS2 7stap
3 .SH JMÉNO
4 error::pass2 \- chyby procesní fáze 2
5
6 .SH POPIS
7 Chyby, které se mohou vyskytnout během procesní fáze 2 mají řadu příčin. Mezi
8 ty nejobvyklejší patří:
9
10 .TP
11 chybějící ladicí informace
12 Skript potřebuje ladicí informace pro lokalizaci sondážního bodu, ale ladicí
13 informace nejsou doustupné. Více podrobností naleznete v manuálových stránkách
14 .IR error::dwarf (7stap)
15 a
16 .IR warning::debuginfo (7stap).
17
18 .TP
19 nedostupná třída sondážních bodů
20 Některé sondážní body jsou specifické pro verzi, architekturu, nebo konfiguraci.
21 Například sondy pro uživatelské procesy
22 .IR process.*
23 mohou vyžadovat jadernou funkcionalitu "utrace", nebo "uprobes".
24
25 .TP
26 nedostupné sondážní body
27 Některé sondážní body mohou být nedostupné i když jejich třída dostupná je.
28 Například
29 .IR kprobe.function("foobar")
30 může selhat pokud funkce
31 .IR foobar
32 byla z jádra odstraněna. Pro některé symboly mohou chybět ladicí informace. Tím
33 obvykle trpí sondážní body
34 .IR .function " nebo " .statement " . "
35 Přesvědčte se o dostupnosti ladicích informací. Vyzkoušejte program
36 .IR stap\-prep
37 který umí nainstalovat chybějící závislosti.
38 Použijte zástupný symbol jako např.
39 .I stap \-l 'kprobe.function("*foo*")'
40 abyste zjistili dostupné varianty sondážního bodu. Použijte modifikátory
41 .IR ! " nebo " ?
42 pro vyznačení volitelnosti, či dostatečnosti daného sondážního bodu, aby funkční
43 části skriptu mohly pokračovat v činnosti.
44
45 .TP
46 překlepy
47 V specifikaci sondážních bodů mohou být překlepy, jako např. ("sycsall" vs.
48 "syscall"). Zástupné symboly nemusejí být expandovatelné ani na jeden validní
49 sondážní bod. Ověřte platnost/existenci sondážních bodů pomocí
50 .IR "stap \-l FILTR" .
51 Další běžnou chybou je použití chybného operátoru dereference:
52 .IR .
53 namísto správného
54 .IR \-> .
55 Příklad správného použití je
56 .IR $foo\->bar\->baz
57 ačkoliv v C by správný zápis byl
58 .IR foo\->bar.baz .
59
60 .TP
61 nedostupné kontextové proměnné
62 Systemtap skripty se často pokoušejí přistoupit ke kontextovým proměnným
63 v analyzovaném kódu prostřednictvím syntaxe
64 .IR $variable " ."
65 Dostupnost takových proměnných může záviset na verzi kompilátoru, zvolené
66 optimalizaci, architektuře atd. Použijte
67 .IR "stap \-L FILTR"
68 k vypsání dostupných kontextových proměnných pro danou sondu. Použijte
69 .IR @defined()
70 pro ověření dostupnosti proměnné v rámci skriptu. Zvažte použití volby
71 .IR "stap \-\-skip\-badvars"
72 čímž se nedostupné kontextové proměnné tiše přeskočí, a jejich hodnota se
73 automaticky nastaví na 0. Experimentujte s volbou
74 .IR "\-\-prologue\-searching" .
75
76 .TP
77 nekonzistentní cache
78 Občas může cache systemtap modulu ($HOME/.systemtap/cache) obsahovat zastaralé
79 informace. Pomocí přepínače
80 .IR "stap \-\-poison\-cache ..."
81 lze obsah cache zneplatnit.
82 .BR Poznámka:
83 Toto by se nemělo stát, jde o chybu. Prosím, nahlaste ji.
84
85 .SH VÍCE INFORMACÍ
86 Upovídanost procesní fáze 2 lze zvýšit pomocí
87 .IR "--vp 02" .
88
89 .SH VIZ TÉŽ
90 .nh
91 .nf
92 .IR stap (1),
93 .IR stap-prep (1),
94 .IR stapprobes (3stap),
95 .IR probe::* (3stap),
96 .IR error::dwarf (7stap),
97 .IR error::inode-uprobes (7stap),
98 .IR warning::debuginfo (7stap),
99 .IR error::reporting (7stap)