Debian Codegraph @

man/cs/warning::buildid.7stap

raw
1 .\" t
2 .TH WARNING::BUILDID 7stap
3 .SH NAME
4 warning::buildid \- chyby ověření build-id
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 DESCRIPTION
21
22 Systemtap skript prochází několika fázemi zpracování, které nemusejí nutně
23 následovat bezprostředně po sobě. Někdy je nutné ověřit některé invarianty.
24 Jedním z nich je build-id, které zaručuje, že pokud systemtap skript
25 běží proti uživatelským programům, jde o ty jejich verze, proti kterým byl
26 systemtap skript skutečně zkompilován. Build-id je údaj, který moderní (2007+)
27 překladače přidávají do binárních souborů jako ELF značku
28 .IR NT_GNU_BUILD_ID .
29 Build-id lze zobrazit příkazem
30 .IR "readelf -n" .
31
32 .PP
33
34 Na build-id jsou citlivé jen skripty, které provádějí hlubokou analýzu binárních
35 souborů a jejich ladicích informací. Například skripty, které používají sondy
36 .IR .function " nebo " .statement
37 , nebo skripty, které generují backtrace.
38 Jiné skripty mohou spoléhat například na sondy
39 .IR process.mark " nebo " kernel.trace,
40 které nepotřebují ladicí informace, a ty pak na build-id citlivé nejsou. Viz
41 sekci LADICÍ INFORMACE FORMÁTU DWARF manuálové stránky
42 .IR stapprobes (3stap).
43
44 .PP
45
46 Systemtap uchovává kopii relevantních build-id uvnitř svých jaderných modulů.
47 Za běhu modulu pak dojde ke srovnání uloženého build-id se skutečnou hodnotou,
48 která je pro daný obraz binárního souboru uložena v paměti. V případě neshody
49 se vypíše chybová hláška a systemtap odmítne do daného binárního souboru vložit
50 sondy. To je důležité z bezpečnostního hlediska, kdy by vložení sond na
51 nesprávná místa mohlo způsobit pád programu.
52
53 .PP
54
55 Nesoulad build-id může být způsoben různými příčinami. Tou hlavní je situace,
56 kdy je verze nebo architektura zkoumaného binárního souboru odlišná od verze
57 nebo architektury souboru, proti kterému byl systemtap modul vytvořen.
58 Například je možné, že systemtap modul byl sestaven na stroji s mírně odlišnou
59 verzí nebo jinou distribucí OS. Mohlo dojít k "rebuildu" jádra při zachování
60 čísla verze. Mohlo také například dojít k "upgrade" jádra, po kterém obraz v
61 paměti není v souladu s obsahem souborů na disku. Nebo v případě, že Vaše
62 distribuce používá samostatné "debuginfo" balíčky, nemusí verze "debuginfo"
63 balíčku přesně odpovídat verzi hlavního balíčku.
64
65 .PP
66
67 Pokud má nesoulad build-id známou příčinu, a je zřejmé, že nedojde
68 ke škodám, je možno test na build-id obejít volbou
69 .IR -DSTP_NO_BUILDID_CHECK .
70
71 .SH VIZ TÉŽ
72 .nh
73 .nf
74 .IR http://fedoraproject.org/wiki/Releases/FeatureBuildId ,
75 .IR stap (1),
76 .IR stapprobes (3stap),
77 .IR warning::debuginfo (7stap),
78 .IR error::reporting (7stap)