Debian Codegraph @

man/cs/error::pass4.7stap

raw
1 .\" t
2 .TH ERROR::PASS4 7stap
3 .SH JMÉNO
4 error::pass4 \- chyby procesní fáze 4
5
6 .\" macros
7 .de SAMPLE
8
9 .nr oldin \\n(.i
10 .br
11 .RS
12 .nf
13 .nh
14 ..
15 .de ESAMPLE
16 .hy
17 .fi
18 .RE
19 .in \\n[oldin]u
20
21 ..
22
23 .SH POPIS
24 Během procesní fáze 4 (compilation) dochází obvykle jen k několika málo druhům
25 chyb:
26
27 .TP
28 změny verze jádra
29 Vložený C kód, který systemtap generuje, nebo obsahuje v rámci tapset skriptů
30 by měl být portabilní napříč širokou škálou verzí linuxového jádra. Nicméně,
31 mohou se vyskytnout výjimky, jako například změna typu parametrů jaderné funkce
32 a podobně. Pokud k tomu dojde, může být řešením použít upstream verzi
33 systemtapu (git://sourceware.org/git/systemtap.git), která je na takové změny
34 obvykle rychle adaptována. Jinými slovy: \fBPro použití s velmi mladými jádry
35 sestavte systemtap ze zdrojových kódů v gitu\fP. Pokud ani upstream verze
36 systemtapu neobsahuje opravu, prosím, nahlašte chybu vývojářům systemtapu.
37
38 .TP
39 chybný vložený (embedded) C kód
40 Vložený C kód ve Vašem guru (-g) skriptu systemtap nekontroluje. Předává
41 jej kompilátoru zcela bez úprav. Chyby tohoto typu odhalí kompilátor právě v
42 procesní fázi 4 během sestavování jaderného modulu systemtapu.
43
44 .TP
45 nekompratibilní vložený C kód
46 Rozhraní mezi C kódem, který systemtap generuje a vloženým C kódem se někdy mění.
47 Například před verzí systemtap-1.8 se parametry předávaly pomocí maker
48 .IR THIS->foo " and " THIS->__retvalue
49 ale od verze 1.8 již pomocí maker
50 .IR STAP_ARG_foo " and " STAP_RETVALUE "."
51 Upravte svůj vložený C kód tak, aby vyhovoval aktuální syntaxi, nebo použijte
52 režim zpětné kompatibility
53 .IR "stap --compatible=VERSION ."
54
55 .TP
56 chyby a záhadné chování kompilátoru
57 "Internal compiler error" značí chyby kompilátoru. Takové chyby
58 by měly být nahlášeny vývojářům kompilátoru. K chybovému hlášení připojte
59 předzpracovaný
60 .IR ".i"
61 soubor spolu s kopií dané příkazové řádky kompilátoru. Pro sesbírání relevantních
62 informací, spusťte
63 .SAMPLE
64 stap -k --vp 0003 -p4 ....
65 .ESAMPLE
66 Systemtap takto uchová dočasný adresář i příkazovou řádku kompilátoru. V tomto
67 adresáři se nachází hlavní vygenerovaný soubor
68 .IR stap_NNNNN_src.c .
69 Použijte následující postup pro získání předzpracovaného výstupu:
70 .SAMPLE
71 make -C /lib/modules/`uname -r`/build M=`pwd` stap_NNNNN_src.i
72 .ESAMPLE
73 (všimněte si přípony
74 .IR .i
75 ). Příkazová řádka kompilátoru by měla být uchována v souboru
76 .IR ".stap_NNNNN_src.i.cmd" .
77
78 .SH VIZ TÉŽ
79 .nh
80 .nf
81 .IR stap (1),
82 .IR error::reporting (7stap)