Debian Codegraph @

man/cs/error::sdt.7stap

raw
1 .\" t
2 .TH ERROR::SDT 7stap
3 .SH JMÉNO
4 error::sdt \- chyby značek <sys/sdt.h>
5
6 .\" macros
7 .de SAMPLE
8 .br
9 .RS
10 .nf
11 .nh
12 ..
13 .de ESAMPLE
14 .hy
15 .fi
16 .RE
17 ..
18
19
20 .SH POPIS
21
22 Značky
23 .BR <sys/sdt.h>
24
25 používané v systemtapu jsou navrženy podle dtrace USDT API, ale mají odlišnou
26 implementaci. Přidávají do "text" segmentu uživatelského programu NOP
27 instrukci a do ELF poznámky související metadata, která popisují vlastnosti
28 značky, jako její jméno a parametry. Tyto značky jsou rozpoznatelné různými
29 nástroji. Dokáže je konzumovat nejen systemtap, ale např. i GDB. Značky nesou
30 informace o typech svých parametrů, a lze do nich vložit spolehlivé sondážní
31 body nezávislé na ladicích informacích DWARF.
32
33 .PP
34
35 Dohledávání parametrů je komplikované: Protože jsou použity gcc inline-assembly
36 directivy, ukládají značky STAP_PROBE / DTRACE_PROBE pro každý operand asm
37 výraz. Kompilátoru se předá volné asm omezení "nor", které obvykle funguje
38 dobře. Toto řešení obvykle nenutí kompilátor pracovat s registry, což by
39 instrumentovaný program zpomalilo. Ovšem ne vždy toto řešení funguje zcela bez
40 chyb.
41
42 .TP
43 chyba vyhodnocení za běhu
44 GCC může emitovat řetězce které assembler korektně zpracuje (v kontextu
45 kompilovaného programu), ale ladicí nástroj může mít s jejich interpretací
46 potíž. Například se operand může odkazovat k lokálnímu symbolu, který se do
47 finálního ELF souboru nedostane. Takový operand je pak nedostupný. Pokus o
48 přístup k příslušnému parametru pak obvykle skončí chybou "SDT asm not
49 understood".
50
51 .TP
52 příliš komplikovaný výraz
53 GCC může generovat validní, ale příliš složitou adresaci založenou na
54 komplexních datových typech a složité pointerové aritmetice. Systemtap a/nebo
55 GDB nemusejí být schopny takové výrazy správně analyzovat a v případě
56 systemtapu bude pak výsledkem chyba "SDT asm not understood".
57
58 .TP
59 příliš restriktivní omezení
60 GCC nemusí být schopné program s "nor" omezením přeložit kvůli nedostatku
61 registrů nebo z jiného důvodu. V takovém případě může nastat chyba jako např.
62 "asm operand has impossible constraints".
63
64 .PP
65
66 Tyto problémy je v zásadě možno obejít dvěma cestami.
67
68 .TP
69 změnit omezení
70 Při kompilaci instrumentovaného programu nastavte makro
71 .IR STAP_SDT_ARG_CONSTRAINT
72 na jiné omezení. Různé možnosti uvádí GCC manuál. Například na mnoha
73 architekturách "r" způsobí předávání operandů přes registry a "g" ponechá
74 operandy v zásadě bez omezení.
75
76 .TP
77 použijte debuginfo
78 Pokud se instrumentovaný program zkompiluje, může být řešením ponechat v něm
79 <sys/sdt.h> značky, ale vyhnout se extrakci parametrů z nich. V nejhorším
80 připadě odstraňte <sys/sdt.h> makra zcela. Pokud byly ladicí informace
81 vygenerovány a jsou k dispozici, systemtap se může odkazovat ke kontextovým
82 proměnným namísto k parametrům značek STAP_PROBE.
83
84 .SH VIZ TÉŽ
85 .nh
86 .nf
87 .IR stap (1),
88 .IR stapprobes (3stap),
89 .IR error::dwarf (7stap),
90 .IR http://gcc.gnu.org/onlinedocs/gcc/Constraints.html ,
91 .IR http://sourceware.org/systemtap/wiki/UserSpaceProbeImplementation ,
92 .IR error::reporting (7stap)