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