| 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 |