Debian Codegraph @

man/cs/dtrace.1

raw
1 .\" -*- nroff -*-
2 .TH DTRACE 1
3 .SH JMÉNO
4 dtrace \- Nástroj pro generování statických sondážních bodů kompatibilní s Dtrace.
5
6 .\" macros
7 .\" do not nest SAMPLEs
8 .de SAMPLE
9 .br
10
11 .nr oldin \\n(.i
12 .RS
13 .nf
14 .nh
15 ..
16 .de ESAMPLE
17 .hy
18 .fi
19 .RE
20 .in \\n[oldin]u
21
22 ..
23
24 .SH POUŽITÍ
25
26 .br
27 .B dtrace \-s \fIfile\fR [\fBOPTIONS\fR]
28
29 .SH POPIS
30
31 Příkaz dtrace převádí definici sondážních bodů předanou ve \fIfile.d\fR na
32 odpovídající hlavičkový soubor, pokud je použit přepínač \fB\-h\fR, nebo na
33 odpovídající objektový soubor, pokud je použit přepínač \fB\-G\fR.
34
35 .SH VOLBY
36 .PP
37 .TP
38 .B \-h
39 generuje hlavičkový soubor pro systemtap.
40
41 .TP
42 .B \-G
43 generuje objektový soubor pro systemtap.
44
45 .TP
46 .B \-o \fIfile\fR
47 určuje výstupní soubor. Při volbě \fB\-G\fR, je výchozí název výstupního
48 souboru \fIfile.o\fR; při volbě \fB\-h\fR pak \fIfile.h\fR.
49
50 .TP
51 .B \-C
52 spusť nad vsstupním souborem cpp preprocesor, pokud je dán přepínač \fB\-h\fR.
53
54 .TP
55 .B \-I \fIfile\fR
56 použij danou "include" cestu, pokud je dán přepínač \fB\-C\fR .
57
58 .TP
59 .B \-k
60 Zachovej dočasné soubory, například C zdrojový kód v případě, že je dán přepínač
61 \fB\-G\fR.
62
63 .SH PŘÍKLADY
64
65 Systemptap je kompatibilní se specifikací statických dtrace sond na úrovni
66 zdrojového kódu. Mějme soubor \fItest.d\fR s následujícím obsahem:
67 .SAMPLE
68 provider sdt_probes
69 {
70 probe test_0 (int type);
71 probe test_1 (struct astruct node);
72 };
73 struct astruct {int a; int b;};
74 .ESAMPLE
75
76 Pak příkaz \fI"dtrace\ \-s\ test.d\ \-G"\fR vygeneruje objektový soubor s
77 definicí sondážních bodů \fItest.o\fR a příkaz \fI"dtrace\ \-s\ test.d\ \-h"\fR
78 vytvoří hlavičkový soubor \fItest.h\fR. Následně může aplikace využívat
79 vygenerovaná makra takto:
80
81 .SAMPLE
82 #include "test.h"
83 \.\.\.
84 struct astruct s;
85 \.\.\.
86 SDT_PROBES_TEST_0(value);
87 \.\.\.
88 if (SDT_PROBES_TEST_1_ENABLED())
89 SDT_PROBES_TEST_1(expensive_function(s));
90 .ESAMPLE
91
92 .SH SEMAFORY
93 Semafory jsou logické proměnné, které systemtap využívá k přeskočení nákladné
94 inicializace sondy (příprava argumentů) v případech, kdy je to možné.
95 Systemtap hodnotu semaforů nastavuje automaticky, když příslušný skript běží.
96 Semafory jsou definovány v rámci objektového souboru \fI"test.o"\fR, který
97 tudíž musí být slinkován s aplikací.
98
99 .PP
100 V některých případech ovšem nejsou semafory nutné ani užitečné. V tom případě
101 lze vynecháním \fI"test.o"\fR zjednodušit sestavování aplikace. K přeskočení
102 závislostí na semaforech vložte include \fI"<sys/sdt.h>"\fR do aplikace před
103 \fI"test.h"\fR takto:
104
105 .SAMPLE
106 #include <sys/sdt.h>
107 #include "test.h"
108 \.\.\.
109 struct astruct s;
110 \.\.\.
111 SDT_PROBES_TEST_0(value);
112 \.\.\.
113 if (SDT_PROBES_TEST_1_ENABLED())
114 SDT_PROBES_TEST_1(cheap_function(s));
115 .ESAMPLE
116 V tomto případě se nejdříve upraví ENABLED() test.
117
118 .SH VIZ TAKÉ
119 .nh
120 .nf
121 .IR stap (1),
122 .IR stappaths (7)
123
124 .SH CHYBY
125 Použijte projektovou bugzillu, nebo mailing list.
126 .nh
127 .BR http://sourceware.org/systemtap/ ", " <[email protected]> .
128 .hy
129 .PP
130 .IR error::reporting (7stap),
131 .BR https://sourceware.org/systemtap/wiki/HowToReportBugs
132 .hy