NAME

       warning::buildid - chyby ověření build-id

DESCRIPTION

       Systemtap  skript  prochází  několika  fázemi  zpracování, které nemusejí nutně následovat
       bezprostředně po sobě. Někdy je nutné ověřit některé invarianty. Jedním z nich  je  build-
       id,  které zaručuje, že pokud systemtap skript běží proti uživatelským programům, jde o ty
       jejich verze, proti kterým byl systemtap skript skutečně zkompilován.  Build-id  je  údaj,
       který   moderní  (2007+)  překladače  přidávají  do  binárních  souborů  jako  ELF  značku
       NT_GNU_BUILD_ID. Build-id lze zobrazit příkazem readelf -n.

       Na build-id jsou citlivé jen skripty, které provádějí hlubokou analýzu binárních souborů a
       jejich  ladicích  informací.  Například  skripty,  které  používají  sondy  .function nebo
       .statement , nebo skripty, které generují backtrace. Jiné skripty mohou spoléhat například
       na  sondy  process.mark nebo kernel.trace, které nepotřebují ladicí informace, a ty pak na
       build-id citlivé nejsou. Viz  sekci  LADICÍ  INFORMACE  FORMÁTU  DWARF  manuálové  stránky
       stapprobes(3stap).

       Systemtap  uchovává  kopii  relevantních  build-id  uvnitř svých jaderných modulů. Za běhu
       modulu pak dojde ke srovnání uloženého build-id se skutečnou hodnotou, která je  pro  daný
       obraz  binárního  souboru  uložena  v paměti. V případě neshody se vypíše chybová hláška a
       systemtap  odmítne  do  daného  binárního  souboru  vložit  sondy.  To   je   důležité   z
       bezpečnostního  hlediska,  kdy  by  vložení  sond  na  nesprávná  místa mohlo způsobit pád
       programu.

       Nesoulad build-id může být způsoben různými příčinami. Tou hlavní je situace, kdy je verze
       nebo architektura zkoumaného binárního souboru odlišná od verze nebo architektury souboru,
       proti kterému byl systemtap modul vytvořen. Například je možné,  že  systemtap  modul  byl
       sestaven  na  stroji  s  mírně  odlišnou  verzí  nebo  jinou  distribucí OS. Mohlo dojít k
       "rebuildu" jádra při zachování čísla verze. Mohlo také například dojít k "upgrade"  jádra,
       po  kterém  obraz  v  paměti není v souladu s obsahem souborů na disku. Nebo v případě, že
       Vaše distribuce používá samostatné "debuginfo" balíčky, nemusí verze  "debuginfo"  balíčku
       přesně odpovídat verzi hlavního balíčku.

       Pokud  má  nesoulad  build-id  známou příčinu, a je zřejmé, že nedojde ke škodám, je možno
       test na build-id obejít volbou -DSTP_NO_BUILDID_CHECK.

VIZ TÉŽ

       http://fedoraproject.org/wiki/Releases/FeatureBuildId,
       stap(1),
       stapprobes(3stap),
       warning::debuginfo(7stap),
       error::reporting(7stap)

                                                                          WARNING::BUILDID(7stap)