Debian Codegraph @

man/cs/stapref.1

raw
1 .\" -*- nroff -*-
2 .TH STAPREF 1
3 .SH JMÉNO
4 stapref \- referenční příručka pro skriptovací jazyk systemtapu
5
6 .\" macros
7 .\" do not nest SAMPLEs
8 .de SAMPLE
9 .br
10 .nr oldin \\n(.i
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 POUŽiTÍ
24
25 .br
26 .B stapref
27
28 .SH POPIS
29
30 Referenční příručka pro skriptovací jazyk systemtapu.
31
32 .SH JAZYK
33 Klíčová slova
34 .SAMPLE
35 \[bu] \fBbreak\fR
36 \[bu] \fBcontinue\fR
37 \[bu] \fBdelete\fR
38 \[bu] \fBelse\fR
39 \[bu] \fBexit\fR
40 \[bu] \fBforeach\fR
41 \[bu] \fBfor\fR
42 \[bu] \fBfunction\fR
43 \[bu] \fBglobal\fR
44 \[bu] \fBprivate\fR
45 \[bu] \fBif\fR
46 \[bu] \fBin\fR
47 \[bu] \fBnext\fR
48 \[bu] \fBprobe\fR
49 \[bu] \fBreturn\fR
50 \[bu] \fBtry/catch\fR
51 \[bu] \fBwhile\fR
52 .ESAMPLE
53
54 Datové typy a operátory
55 .SAMPLE
56 Celá čísla
57 \[bu] var1 = 5
58 \[bu] \fBglobal\fR var2 = 10
59
60 Řetězce
61 \[bu] var1 = "string1"
62 \[bu] \fBglobal\fR var2 = "string2"
63
64 Asociativní pole
65 \[bu] \fBglobal\fR array1[]
66 \[bu] \fBglobal\fR array2[SIZE]
67 \[bu] array[index] = 5
68
69 Kontextové proměnné
70 \[bu] \fB$\fRvar
71 \[bu] \fB$\fRvar\fB$\fR ("pěkný výpis" řetězce)
72
73 Binární číselné operátory
74 \[bu] \fB* / % + \- << >> & ^ | && ||\fR
75
76 Binární řetězcové operátory
77 \[bu] \fB.\fR (spojení řetězců)
78
79 Operátory pro číselné přiřazení
80 \[bu] \fB= += -= *= /= %= >>= <<= &= ^= |= \fR
81
82 Přiřazovací operátory pro řetězce
83 \[bu] \fB= .= \fR
84
85 Unární číselné operátory
86 \[bu] \fB+ \- ! ~ ++ \-\- \fR
87
88 Operátory pro porovnávání čísel a řetězců
89 \[bu] \fB< > <= >= == != \fR
90
91 Operátory pro srovnání proti regulárnímu výrazu
92 \[bu] \fB=~ !~ \fR
93
94 Ternární operátor
95 \[bu] cond \fB?\fR exp1 \fB:\fR exp2
96
97 Seskupovací operátor
98 \[bu] \fB(\fR expression \fB)\fR
99
100 Operátory nad poli
101 \[bu] array\fB[\fRindex\fB]\fR (array read/write)
102 \[bu] [index] \fB\in\fR array
103
104 Agregační operátor.
105 \[bu] var \fB<<<\fR value
106 .ESAMPLE
107
108 Příkazy
109 .SAMPLE
110 Skok
111 \[bu] \fBcontinue\fR
112 \[bu] \fBbreak\fR
113 \[bu] \fBnext\fR
114 \[bu] \fBreturn\fR expression
115 \[bu] \fBtry\fR přikaz \fBcatch\fR (zpráva)
116 .ESAMPLE
117 .SAMPLE
118 Příkazy větvení
119 \[bu] \fBif\fR (výraz) příkaz
120 \[bu] \fBelse\fR příkaz
121 .ESAMPLE
122 .SAMPLE
123 Příkazy pro iterování
124 \[bu] \fBforeach\fR (proměnná \fBin\fR pole) příkaz
125 \[bu] \fBforeach\fR ([var1,var2,...] \fBin\fR pole) příkaz
126 \[bu] \fBfor\fR (výraz; výraz; výraz) příkaz
127 \[bu] \fBwhile\fR (výraz) příkaz
128 .ESAMPLE
129 .SAMPLE
130 Deklarace
131 \[bu] \fBfunction\fR jméno (proměnná : type, ...) { příkaz }
132 \[bu] \fBfunction\fR jméno : type (proměnná : type, ...) { příkaz }
133 \[bu] \fBfunction\fR jméno : type (proměnná : type, ...) %{ c_příkaz %}
134 \[bu] \fBprobe\fR sondážní_bod { příkaz }
135 \[bu] \fBprobe\fR label = sondážní_bod { příkaz }
136 .ESAMPLE
137
138 Lexikální struktury
139 .SAMPLE
140 Komentáře
141 \[bu] \fB#\fR ... komentář
142 \[bu] \fB//\fR ... komentář
143 \[bu] \fB/*\fR ... komentář ... \fB*/\fR
144 .ESAMPLE
145 .SAMPLE
146 Značky pro preprocesor
147 \[bu] \fB%(\fR výraz \fB%?\fR true_tokens \fB%:\fR false_tokens \fB%)\fR
148 \[bu] \fB@define\fR značka (proměnná, ...) %{ příkaz %}
149 .ESAMPLE
150
151 Vestavěné funkce
152 .SAMPLE
153 Vestavěné agregační funkce
154 \[bu] \fB@avg\fR (proměnná)
155 \[bu] \fB@count\fR (proměnná)
156 \[bu] \fB@hist_linear\fR (proměnná, N, N, N)
157 \[bu] \fB@hist_log\fR (proměnná)
158 \[bu] \fB@max\fR (proměnná)
159 \[bu] \fB@min\fR (proměnná)
160 \[bu] \fB@sum\fR (proměnná)
161 .ESAMPLE
162 .SAMPLE
163 Vestavěné funkce pro výstup
164 \[bu] \fBprint\fR (proměnná)
165 \[bu] \fBprintf\fR (formát:řetězec, proměnná, ...)
166 \ kde formát má tvar: %[flags][šířka][.přesnost][délka]specifiáktor
167 \[bu] \fBprintd\fR (oddělovač:řetězec, proměnná, ...)
168 \[bu] \fBprintdln\fR (oddělovač:řetězec, proměnná, ...)
169 \[bu] \fBprintln\fR ()
170 \[bu] \fBsprint\fR:řetězec (proměnná)
171 \[bu] \fBsprintf\fR:řetězec (formát:řetězec, proměnná, ...)
172 .ESAMPLE
173 .SAMPLE
174 Vestavěné funkce pro přístup k proměnným
175 \[bu] \fB@cast\fR (variable, "type_name"[, "module"])
176 \[bu] \fB@defined\fR (variable)
177 .ESAMPLE
178
179 Sondážní body
180 .SAMPLE
181 Některé běžné sondážní body
182 \[bu] kernel.function(PATTERN) kernel.function(PATTERN).call
183 \[bu] kernel.function(PATTERN).return
184 \[bu] kernel.FUNCTION (PATTERN).return.maxactive(VALUE)
185 \[bu] kernel.FUNCTION (PATTERN).inline
186 \[bu] kernel.FUNCTION (PATTERN).label(LPATTERN)
187 \[bu] module(MPATTERN).FUNCTION (PATTERN)
188 \[bu] module(MPATTERN).FUNCTION (PATTERN).call
189 \[bu] module(MPATTERN).FUNCTION (PATTERN).return.maxactive(VALUE)
190 \[bu] module(MPATTERN).FUNCTION (PATTERN).inline
191 \[bu] kernel.statement(PATTERN)
192 \[bu] kernel.statement(ADDRESS).absolute
193 \[bu] module(MPATTERN).statement(PATTERN)
194 \[bu] kprobe.FUNCTION (FUNCTION)
195 \[bu] kprobe.FUNCTION (FUNCTION).return
196 \[bu] kprobe.module(NAME).FUNCTION (FUNCTION)
197 \[bu] kprobe.module(NAME).FUNCTION (FUNCTION).return
198 \[bu] kprobe.statement(ADDRESS).absolute
199 \[bu] process.begin process("PATH").begin
200 \[bu] process(PID).begin process.thread.begin
201 \[bu] process("PATH").thread.begin
202 \[bu] process(PID).thread.begin
203 \[bu] process.end
204 \[bu] process("PATH").end
205 \[bu] process(PID).end
206 \[bu] process.thread.end
207 \[bu] process("PATH").thread.end
208 \[bu] process(PID).thread.end
209 \[bu] process("PATH").syscall
210 \[bu] process(PID).syscall
211 \[bu] process.syscall.return
212 \[bu] process("PATH").syscall.return
213 \[bu] process(PID).syscall.return
214 \[bu] process("PATH").FUNCTION ("NAME")
215 \[bu] process("PATH").statement("*@FILE.c:123")
216 \[bu] process("PATH").FUNCTION ("*").return
217 \[bu] process("PATH").FUNCTION ("myfun").label("foo")
218 \[bu] process("PATH").mark("LABEL")
219 \[bu] java("PNAME").class("CLASSNAME").method("PATTERN")
220 \[bu] java("PNAME").class("CLASSNAME").method("PATTERN").return
221 \[bu] java(PID).class("CLASSNAME").method("PATTERN")
222 \[bu] java(PID).class("CLASSNAME").method("PATTERN").return
223 \[bu] python2.module("MODULENAME").function("PATTERN")
224 \[bu] python2.module("MODULENAME").function("PATTERN").return
225 \[bu] python3.module("MODULENAME").function("PATTERN")
226 \[bu] python3.module("MODULENAME").function("PATTERN").return
227 .ESAMPLE
228
229 Funkce standardního tapsetu
230 .SAMPLE
231 Některé běžnější funkce standardního tapsetu
232 \[bu] addr:long ()
233 \[bu] backtrace:string ()
234 \[bu] caller:string ()
235 \[bu] caller_addr:long ()
236 \[bu] cmdline_arg:string (N:long)
237 \[bu] cmdline_args:string (N:long,m:long,delim:string)
238 \[bu] cmdline_str:string ()
239 \[bu] env_var:string (name:string)
240 \[bu] execname:string ()
241 \[bu] int_arg:long (N:long)
242 \[bu] isinstr:long(s1:string,s2:string)
243 \[bu] long_arg:long (N:long)
244 \[bu] modname:string ()
245 \[bu] module_name:string ()
246 \[bu] pid:long ()
247 \[bu] pn:string ()
248 \[bu] pointer_arg:string (N:long)
249 \[bu] pp:string ()
250 \[bu] print_backtrace ()
251 \[bu] probefunc:string ()
252 \[bu] register:long(name:string)
253 \[bu] str_replace:string(prnt_str:string,srch_str:string,rplc_str:string)
254 \[bu] stringat:long(str:string,pos:long)
255 \[bu] strlen:long(str:string)
256 \[bu] strtol:long(str:string,base:long)
257 \[bu] substr:string(str:string,start:long,length:long)
258 \[bu] user_long:long(addr:long)
259 \[bu] user_string:string(addr:long)
260 .ESAMPLE
261
262 .SH VIZ TÉŽ
263 .nh
264 .nf
265 .IR stap (1)
266
267 .SH CHYBY
268 Použijte projektovou bugzillu, nebo mailing list.
269 .nh
270 .BR http://sourceware.org/systemtap/ ", " <[email protected]> .
271 .hy
272 .PP
273 .IR error::reporting (7stap),
274 .BR https://sourceware.org/systemtap/wiki/HowToReportBugs
275 .hy
276