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