JMÉNO

       error::sdt - chyby značek <sys/sdt.h>

POPIS

       Značky <sys/sdt.h>

       používané  v systemtapu jsou navrženy podle dtrace USDT API, ale mají odlišnou implementaci. Přidávají do
       "text" segmentu uživatelského programu NOP instrukci  a  do  ELF  poznámky  související  metadata,  která
       popisují vlastnosti značky, jako její jméno a parametry. Tyto značky jsou rozpoznatelné různými nástroji.
       Dokáže  je konzumovat nejen systemtap, ale např. i  GDB. Značky nesou informace o typech svých parametrů,
       a lze do nich vložit spolehlivé sondážní body nezávislé na ladicích informacích DWARF.

       Dohledávání parametrů je komplikované: Protože  jsou  použity  gcc  inline-assembly  directivy,  ukládají
       značky  STAP_PROBE  /  DTRACE_PROBE  pro  každý operand asm výraz. Kompilátoru se předá volné asm omezení
       "nor", které obvykle funguje dobře. Toto řešení obvykle nenutí kompilátor pracovat  s  registry,  což  by
       instrumentovaný program zpomalilo. Ovšem ne vždy toto řešení funguje zcela bez chyb.

       chyba vyhodnocení za běhu
              GCC  může  emitovat řetězce které assembler korektně zpracuje (v kontextu kompilovaného programu),
              ale ladicí nástroj může mít s jejich interpretací potíž. Například se  operand  může  odkazovat  k
              lokálnímu  symbolu, který se do finálního ELF souboru nedostane. Takový operand je pak nedostupný.
              Pokus o přístup k příslušnému parametru pak obvykle skončí chybou "SDT asm not understood".

       příliš komplikovaný výraz
              GCC může generovat validní, ale příliš složitou adresaci založenou na komplexních datových  typech
              a  složité  pointerové aritmetice. Systemtap a/nebo GDB nemusejí být schopny takové výrazy správně
              analyzovat a v případě systemtapu bude pak výsledkem chyba "SDT asm not understood".

       příliš restriktivní omezení
              GCC nemusí být schopné program s "nor" omezením přeložit kvůli nedostatku registrů nebo  z  jiného
              důvodu. V takovém případě může nastat chyba jako např. "asm operand has impossible constraints".

       Tyto problémy je v zásadě možno obejít dvěma cestami.

       změnit omezení
              Při  kompilaci  instrumentovaného programu nastavte makro STAP_SDT_ARG_CONSTRAINT na jiné omezení.
              Různé možnosti uvádí GCC manuál. Například na mnoha architekturách "r" způsobí předávání  operandů
              přes registry a "g" ponechá operandy v zásadě bez omezení.

       použijte debuginfo
              Pokud  se  instrumentovaný program zkompiluje, může být řešením ponechat v něm <sys/sdt.h> značky,
              ale vyhnout se extrakci parametrů z nich. V nejhorším připadě odstraňte <sys/sdt.h>  makra  zcela.
              Pokud  byly  ladicí  informace  vygenerovány  a  jsou  k dispozici, systemtap se může odkazovat ke
              kontextovým proměnným namísto k parametrům značek STAP_PROBE.

VIZ TÉŽ

       stap(1),
       stapprobes(3stap),
       error::dwarf(7stap),
       http://gcc.gnu.org/onlinedocs/gcc/Constraints.html,
       http://sourceware.org/systemtap/wiki/UserSpaceProbeImplementation,
       error::reporting(7stap)

                                                                                               ERROR::SDT(7stap)