Debian Codegraph @

man/cs/warning::debuginfo.7stap

raw
1 .\" t
2 .TH WARNING::DEBUGINFO 7stap
3 .SH JMÉNO
4 warning::debuginfo \- varování ohledně chybějících ladicích informací
5
6 .\" macros
7 .de SAMPLE
8
9 .nr oldin \\n(.i
10 .br
11 .RS
12 .nf
13 .nh
14 ..
15 .de ESAMPLE
16 .hy
17 .fi
18 .RE
19 .in \\n[oldin]u
20
21 ..
22
23 .SH POPIS
24 Pro mnoho symbolických sondážních operací potřebuje systemtap ladicí informace
25 DWARF generované kompilátorem při použití \fICFLAGS \-g\fP. Obvykle jsou ladicí
26 informace potřeba pro nalezení sond pro funkce, příkazy, nebo kontextové proměnné.
27 Ladicí informace se mohou nacházet buď přímo v binárních souborech, nebo mohou
28 být odděleny do samostatných souborů, které se hledají v závislosti na nastavení
29 proměnné prostředí
30 .IR SYSTEMTAP_DEBUGINFO_PATH .
31 .PP
32
33 Ověřte zda jsou pro vaši distribuci dostupné "debuginfo" balíčky s ladicími
34 informacemi. Pokud tyto balíčky k dispozici nemáte, může být nutné programy,
35 které chcete analyzovat, znovu sestavit tak, aby obsahovaly také ladicí
36 informace DWARF.
37 .PP
38 Systemtap používá knihovnu
39 .IR elfutils
40 ke zpracování ELF/DWARF souborů. Použitá verze elfutils odpovídá číslu za
41 lomítkem ve výstupu příkazu
42 .IR stap \-V
43 output:
44 .SAMPLE
45 % stap -V
46 Systemtap translator/driver (version 2.3/0.156, rpm 2.3-1.fc19)
47 Copyright (C) 2005-2014 Red Hat, Inc. and others
48 [...]
49 .ESAMPLE
50 Ukazuje, že systemtap byl sestaven s elfutls verze 0.156.
51
52 .TP
53 ladicí informace jádra
54 Pro skripty, které analyzují linuxové jádro, může systemtap potřebovat příslušný
55 soubor
56 .IR vmlinux
57 vzniklý při sestavování jádra. Poznamenejme, že zde nejde o zkomprimovaný soubor
58 .IR vmlinuz
59 , na který se odkazuje boot loader, a ze kterého byly ladicí informace
60 odstraněny. Soubor vmlinux je značně větší, než vmlinuz. Pokud sestavujete jádro
61 ručně, ujistěte se, že máte zapnutou volbu
62 .IR CONFIG_DEBUG_INFO=y .
63 Navíc některé linuxové distribuce mohou poskytovat více variant jádra a pro
64 každou variantu samostatný balíček s ladicími informacemi. Příkladem takové
65 varianty je \fIkernel-debug\fR, varianta s matoucím názvem, která má vlastní
66 \fIkernel-debug-debuginfo\fR balíček (což není totéž jako
67 \fIkernel-debuginfo\fR obsahující ladicí informace pro balíček \fIkernel\fR).
68 Program
69 .IR stap\-prep
70 může pomoci s instalací správných balíčků.
71
72 .TP
73 ladicí informace pro uživatelské procesy
74 Pro SystemTap skripty, které analyzují uživatelské procesy, může systemtap
75 potřebovat příslušné ladicí informace také. Pokud analyzujete ručně sestavený
76 program, použijte pro jeho překlad
77 .IR "CFLAGS=-g -O2 ."
78
79 .TP
80 minidebuginfo
81 Na některých systémech mohou binární soubory obsahovat podmnožinu obvyklých
82 ladicích informací pro sledování funkcí a generovaní výpisů 'backtrace'. Tohle
83 tzv. 'MiniDebugInfo' představuje xz zkomprimovanou ELF sekci .gnu_debugdata.
84 MiniDebugInfo je podporováno elfutils 0.156, nebo novější verze.
85
86 .TP
87 komprimované debuginfo
88 Na některých systémech mohou být ladicí informace dostupné v komprimované
89 formě v rámci sekcí
90 .IR .zdebug_* .
91 Elfutils 0.153 a novější verze obsahují podporu podporu pro tyto komprimované
92 ladicí informace.
93
94 .TP
95 nepotřebné ladicí informace
96 V některých případech lze skript upravit tak, aby ladicí informace nepotřeboval.
97 Například skript, který používá
98 .IR "probe syscall.*"
99 lze obvykle přepsat na skript založený na
100 .IR "probe nd_syscall.*" ,
101 non-DWARF sondách, které používají složitější (ale také křehčí) mechanizmus pro
102 přístup k argumentům systémových volání. Další možností je použití
103 zakompilovaných značek typu 'tracepoint', které jsou dostupné v linuxovém jádře,
104 nebo využít značky
105 .IR <sys/sdt.h>
106 pro uživatelské procesy. Ty nejsou založeny na ladicích informacích.
107 Pokud jsou ladicí informace potřebné k vyhodnocení složitějších výrazů typu
108 .IR $var->foo->bar
109 mělo by být možné použít zápis
110 .IR @cast(var,"foo","foo.h")->foo->bar
111 čímž dojde k syntéze ladicích informací z hlavičkových souborů.
112
113 .SH AUTOMATIZACE
114 Na některých platformách může systemtap doporučit, které příkazy spustit pro
115 stažení ladicích informací. Také je možné použít přepínač
116 .IR \-\-download\-debuginfo
117 flag.
118 Program
119 .IR stap\-prep
120 může být schopen potřebné balíčky stáhnout a nainstalovat. Další možností je
121 použít
122 .IR stap\-server
123 pro kompilaci na vzdáleném stroji, kde mohou být ladicí informace
124 centralizovány. V tomto případě použijte volbu
125 .IR "stap --use-server" .
126
127 .SH VIZ TÉŽ
128 .nh
129 .nf
130 .IR gcc (1),
131 .IR stap (1),
132 .IR stappaths (7),
133 .IR stap-server (8),
134 .IR stap-prep (1),
135 .IR strip (1),
136 .IR warning::symbols (7stap),
137 .IR error::dwarf (7stap),
138 .IR error::reporting (7stap),
139 .IR error::contextvars (7stap),
140 .IR http://elfutils.org/ ,
141 .IR http://fedoraproject.org/wiki/Features/MiniDebugInfo