Debian Codegraph @

man/cs/error::dwarf.7stap

raw
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