| 1 |
.\" t |
| 2 |
.TH ERROR::DWARF 7stap |
| 3 |
.SH JMÉNO |
| 4 |
error::dwarf \- chyby v souvislosti s ladicími informacemi formátu DWARF |
| 5 |
|
| 6 |
.SH POPIS |
| 7 |
|
| 8 |
Systemtap někdy spoléhá na ladicí informace k lokalizaci umístění sond, nebo k |
| 9 |
lokalizaci umístění zkoumaných (či instrumentovaných) proměnných, stejně jako |
| 10 |
to dělá symbolický debugger. Tyto ladicí informace lze získat analýzou |
| 11 |
zdrojového kódu a překladač je umí uchovávat v rámci formátu DWARF. Pokud |
| 12 |
systemtap ladicí informace potřebuje, ale překladač je neuchoval, dojde při |
| 13 |
zpracování skriptu k chybě během procesní fáze 2. |
| 14 |
|
| 15 |
.PP |
| 16 |
Obvyklé příčiny tohoto typu chyb: |
| 17 |
|
| 18 |
.TP |
| 19 |
verze překladače |
| 20 |
Překladače GCC 4.5 a starší generovaly ladicí informace omezené kvality. |
| 21 |
Vývojářům bylo doporučováno sestavovat s použitím |
| 22 |
.IR "-O0 -g" , |
| 23 |
tedy s vypnutím optimalizace. GCC 4.5 přineslo koncept "variable-tracking |
| 24 |
assignments", což umožňuje generovat kvalitní ladicí informace i s použitím |
| 25 |
optimalizací |
| 26 |
.IR "-O2 -g" . |
| 27 |
Není to dokonalé, ale jde o značné zlepšení. Poznamenejme, že chyba GCC |
| 28 |
PR51358 způsobuje, že ladicí informace získané při |
| 29 |
.IR "-O0 -g" |
| 30 |
jsou ve skutečnosti horší kvality, než ladicí informace vygenerované s |
| 31 |
.IR "-O2 -g" . |
| 32 |
|
| 33 |
Dalším souvisejícím problémem je kvalita ladicích informací pro oblast prologu |
| 34 |
(PR15123), kdy program sestavený s CFLAGS=-mfentry (obvykle jádro, kvůli ftrace) |
| 35 |
poskytuje nedostatek přesných ladicích informací v souvislosti se vstupem do |
| 36 |
funkce. To se týká zejména GCC verze 4.8 a starší. Pokud je to možné, kompilujte s |
| 37 |
.IR "-grecord-gcc-switches" |
| 38 |
a spusťte systemtap s |
| 39 |
.nh |
| 40 |
.IR $PR15123_ASSUME_MFENTRY=1 . |
| 41 |
.hy |
| 42 |
|
| 43 |
.TP |
| 44 |
"inline" funkce |
| 45 |
Dokonce i moderní GCC má problémy s parametry "inline" funkcí. Může být nutné |
| 46 |
upravit systemtap skript a vložit sondy na mírně odlišná místa. Zkuste použít |
| 47 |
sondu |
| 48 |
.IR .statement() " , namísto " .function() " ," |
| 49 |
a případně ji posuňte o několik řádek níže směrem do těla "inline" funkce. |
| 50 |
Nebo zkuste vložit sondu do místa volání "inline" funkce. Také je možno využít |
| 51 |
konstrukce |
| 52 |
.nh |
| 53 |
.IR "if @defined($var) { ... }" |
| 54 |
.hy |
| 55 |
k ověření dostupnosti kontextové proměnné před jejím použitím. |
| 56 |
|
| 57 |
.TP |
| 58 |
záměna pořadí instrukcí |
| 59 |
Optimalizovaný kód často zahrnuje smíchání instrukcí z různých zdrojů. V takovém |
| 60 |
případě může být nemožné umístit sondu na potřebné místo. To se týká zejména |
| 61 |
sond |
| 62 |
.IR .statement |
| 63 |
vkládaných na dané číslo řádku. Systemtap může doporučit přesunutí sondy |
| 64 |
na přilehlý řádek, ale ani to nemusí stačit. Zvažte zavedení sondy na místo určené |
| 65 |
zástupným symbolem, nebo rozsahem řádků. |
| 66 |
|
| 67 |
.TP |
| 68 |
konfigurace elfutils |
| 69 |
Systemtap používá pro zpracování ladicích informací knihovnu elfutils. |
| 70 |
Je možné, že ladicí informace jsou zdánlivě dostupné, ale ne ve formátu |
| 71 |
přijatelném pro nainstalovanou kopii elfutils. Například lokální GCC může |
| 72 |
produkovat komprimované ladicí informace (\f2.zdebug_*\f1 ELF sekce, nebo |
| 73 |
\f2.xz\f1 soubory), zatímco nainstalovaná kopie elfutils nemá zapnuté příslušné |
| 74 |
dekompresní schopnosti. Bohužel není snadné odhalit, zda toto je skutečné |
| 75 |
jádro problému který se snažíme vyřešit. Pokud si sestavujete vlastní |
| 76 |
elfutils, ujistěte se, že všechny dekompresní knihovny/hlavičky jsou v době |
| 77 |
překladu dostupné. |
| 78 |
|
| 79 |
.TP |
| 80 |
konfigurace ladicích informací |
| 81 |
Některé nástroje mohou generovat ladicí informace v podobě nepoužitelné |
| 82 |
pro systemtap. Příčinou může být například jaderná volba CONFIG_DEBUG_INFO_SPLIT |
| 83 |
(\f2.dwo\f1 soubory). Dobrých výsledků se lze dosáhnout při použití obvyklého |
| 84 |
ELF/DWARF formátu (případně oddělených ladicích informací (stripped debuginfo) |
| 85 |
jak je obvyklé v distribuci Fedora). |
| 86 |
|
| 87 |
.SH ALTERNATIVY |
| 88 |
|
| 89 |
Pro snížení závislosti na ELF/DWARF ladicích informacích zvažte použití |
| 90 |
staticky zakompilované instrumentace jako jsou sondážní body typu "tracepoint" |
| 91 |
pro jádro, nebo značky |
| 92 |
.IR <sys/sdt.h> |
| 93 |
pro uživatelské programy. Jde o řešení s relativně nízkými náklady na |
| 94 |
systémové zdroje (v případě sdt.h, jedna NOP instrukce na značku), přičemž |
| 95 |
dostupnost parametrů/dat je téměř garantována. To vše bez závislosti na |
| 96 |
ladicích informacích. |
| 97 |
|
| 98 |
.SH VIZ TÉŽ |
| 99 |
.nh |
| 100 |
.nf |
| 101 |
.IR stap (1), |
| 102 |
.IR http://dwarfstd.org/ , |
| 103 |
.IR http://sourceware.org/systemtap/wiki/TipContextVariables , |
| 104 |
.IR http://gcc.gnu.org/wiki/Var_Tracking_Assignments , |
| 105 |
.IR warning::debuginfo (7stap), |
| 106 |
.IR error::reporting (7stap) |
| 107 |
.SH CHYBY |
| 108 |
Použijte projektovou bugzillu, nebo mailing list. |
| 109 |
.nh |
| 110 |
.BR http://sourceware.org/systemtap/ ", " <[email protected]> . |
| 111 |
.hy |
| 112 |
.PP |
| 113 |
.IR error::reporting (7stap), |
| 114 |
.BR https://sourceware.org/systemtap/wiki/HowToReportBugs |
| 115 |
.hy |