| 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) |