Debian Codegraph @

man/cs/stapex.3stap

raw
1 .\" -*- nroff -*-
2 .TH STAPEX 3stap
3 .SH JMÉNO
4 stapex \- příklady
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 ZÁKLADY SKRIPTOVACÍHO JAZYKA
24 Následující příklady demonstrují základy syntaxe a řídicích struktur
25 skriptovacího jazyka systemtapu.
26
27 .SAMPLE
28 global odds, evens
29
30 probe begin {
31 # "no" and "ne" are local integers
32 for (i=0; i<10; i++) {
33 if (i % 2) odds [no++] = i
34 else evens [ne++] = i
35 }
36 delete odds[2]
37 delete evens[3]
38 exit ()
39 }
40
41 probe end {
42 foreach (x+ in odds) {
43 printf ("odds[%d] = %d\\n", x, odds[x])
44 }
45 foreach (x in evens\-) {
46 printf ("evens[%d] = %d\\n", x, evens[x])
47 }
48 }
49 .ESAMPLE
50 Výstupem výše uvedeného skriptu bude:
51 .SAMPLE
52 odds[1] = 1
53 odds[3] = 5
54 odds[4] = 7
55 odds[5] = 9
56 evens[5] = 8
57 evens[4] = 6
58 evens[2] = 2
59 evens[1] = 0
60 .ESAMPLE
61 Poznamenejme, že datové typy všech proměnných jsou automaticky odvozené, a že
62 všechny globální proměnné jsou automaticky inicializovány.
63
64 .PP
65 Následující skript vypíše prvočísla mezi 0 a 49.
66 .SAMPLE
67 function isprime (x) {
68 if (x < 2) return 0
69 for (i=2; i<x; i++) {
70 if (x % i == 0) return 0
71 if (i * i > x) break
72 }
73 return 1
74 }
75 probe begin {
76 for (i=0; i<50; i++)
77 if (isprime (i)) printf("%d\\n", i)
78 exit()
79 }
80 .ESAMPLE
81
82 .PP
83 Tento skript je ukázkou použití rekurzivních funkcí.
84 .SAMPLE
85 function fibonacci(i) {
86 if (i < 1) error ("bad number")
87 if (i == 1) return 1
88 if (i == 2) return 2
89 return fibonacci (i\-1) + fibonacci (i\-2)
90 }
91 probe begin {
92 printf ("11th fibonacci number: %d\\n", fibonacci (11))
93 exit ()
94 }
95 .ESAMPLE
96 Při pokusu o generování větších čísel bychom narazili na limity MAXACTION,
97 nebo MAXNESTING a výsledkem by byla chyba.
98
99 .SH SONDOVÁNÍ
100
101 Pro sledování vstupu do funkce a výstupu z ní použijte následující pár sond:
102 .SAMPLE
103 probe kernel.function("sys_mkdir") { println ("enter") }
104 probe kernel.function("sys_mkdir").return { println ("exit") }
105 .ESAMPLE
106
107 Pro vypsání jaderných funkcí do kterých lze vložit sondu použijte režim
108 výpisu -l:
109
110 .SAMPLE
111 % stap \-l \[aq]kernel.function("*")\[aq]
112 .ESAMPLE
113
114 Pro výpis jaderných funkcí a v nich přístupných lokálních proměnných
115 použijte režim výpisu -L:
116
117 .SAMPLE
118 % stap \-L \[aq]kernel.function("*")\[aq]
119 .ESAMPLE
120
121 .SH VÍCE PŘÍKLADŮ
122
123 Adresář s příklady je zmíněn v manuálové stránce stappaths (7), případně online
124 na adrese:
125 .nh
126 .BR http://sourceware.org/systemtap/examples/
127 .hy
128
129 .SH VIZ TÉŽ
130 .nh
131 .nf
132 .IR stap (1)
133 .IR stapprobes (3stap)
134 .IR stappaths (7)
135