diff options
| -rw-r--r-- | Makefile.am | 1 | ||||
| -rw-r--r-- | Makefile.in | 2 | ||||
| -rwxr-xr-x | configure | 3 | ||||
| -rw-r--r-- | configure.ac | 2 | ||||
| -rw-r--r-- | dtrace.1.in | 92 |
5 files changed, 97 insertions, 3 deletions
diff --git a/Makefile.am b/Makefile.am index a7603fb2..2523b28d 100644 --- a/Makefile.am +++ b/Makefile.am @@ -13,6 +13,7 @@ AM_CFLAGS = -D_GNU_SOURCE -fexceptions -Wall -Werror -Wunused -Wformat=2 -W AM_CXXFLAGS = -Wall -Werror man_MANS = stapprobes.3stap stapfuncs.3stap stapvars.3stap stapex.3stap \ +dtrace.1 \ staprun.8 \ man/stapprobes.iosched.3stap man/stapprobes.netdev.3stap \ man/stapprobes.nfs.3stap man/stapprobes.nfsd.3stap \ diff --git a/Makefile.in b/Makefile.in index e655f8a2..57ddff63 100644 --- a/Makefile.in +++ b/Makefile.in @@ -402,7 +402,7 @@ AM_CPPFLAGS = -DBINDIR='"$(bindir)"' -DSYSCONFDIR='"$(sysconfdir)"' -DPKGDATADIR AM_CFLAGS = -D_GNU_SOURCE -fexceptions -Wall -Werror -Wunused -Wformat=2 -W AM_CXXFLAGS = -Wall -Werror man_MANS = stapprobes.3stap stapfuncs.3stap stapvars.3stap \ - stapex.3stap staprun.8 man/stapprobes.iosched.3stap \ + stapex.3stap dtrace.1 staprun.8 man/stapprobes.iosched.3stap \ man/stapprobes.netdev.3stap man/stapprobes.nfs.3stap \ man/stapprobes.nfsd.3stap man/stapprobes.pagefault.3stap \ man/stapprobes.kprocess.3stap man/stapprobes.rpc.3stap \ @@ -9698,7 +9698,7 @@ _ACEOF ac_config_headers="$ac_config_headers config.h:config.in" -ac_config_files="$ac_config_files Makefile doc/Makefile doc/beginners/Makefile doc/SystemTap_Tapset_Reference/Makefile grapher/Makefile grapher/stapgraph.1 stap.1 stapprobes.3stap stapfuncs.3stap stapvars.3stap stapex.3stap staprun.8 stap-client.8 stap-server.8 stap-authorize-server-cert.8 stap-authorize-signing-cert.8 man/stapprobes.iosched.3stap man/stapprobes.irq.3stap man/stapprobes.netdev.3stap man/stapprobes.nfs.3stap man/stapprobes.nfsd.3stap man/stapprobes.pagefault.3stap man/stapprobes.kprocess.3stap man/stapprobes.rpc.3stap man/stapprobes.scsi.3stap man/stapprobes.signal.3stap man/stapprobes.socket.3stap man/stapprobes.tcp.3stap man/stapprobes.udp.3stap man/stapprobes.snmp.3stap initscript/systemtap initscript/stap-server" +ac_config_files="$ac_config_files Makefile doc/Makefile doc/beginners/Makefile doc/SystemTap_Tapset_Reference/Makefile grapher/Makefile grapher/stapgraph.1 stap.1 stapprobes.3stap stapfuncs.3stap stapvars.3stap stapex.3stap staprun.8 stap-client.8 stap-server.8 stap-authorize-server-cert.8 stap-authorize-signing-cert.8 man/stapprobes.iosched.3stap man/stapprobes.irq.3stap man/stapprobes.netdev.3stap man/stapprobes.nfs.3stap man/stapprobes.nfsd.3stap man/stapprobes.pagefault.3stap man/stapprobes.kprocess.3stap man/stapprobes.rpc.3stap man/stapprobes.scsi.3stap man/stapprobes.signal.3stap man/stapprobes.socket.3stap man/stapprobes.tcp.3stap man/stapprobes.udp.3stap man/stapprobes.snmp.3stap initscript/systemtap initscript/stap-server dtrace.1" @@ -10481,6 +10481,7 @@ do "man/stapprobes.snmp.3stap") CONFIG_FILES="$CONFIG_FILES man/stapprobes.snmp.3stap" ;; "initscript/systemtap") CONFIG_FILES="$CONFIG_FILES initscript/systemtap" ;; "initscript/stap-server") CONFIG_FILES="$CONFIG_FILES initscript/stap-server" ;; + "dtrace.1") CONFIG_FILES="$CONFIG_FILES dtrace.1" ;; "run-stap") CONFIG_FILES="$CONFIG_FILES run-stap" ;; "run-staprun") CONFIG_FILES="$CONFIG_FILES run-staprun" ;; "dtrace") CONFIG_FILES="$CONFIG_FILES dtrace" ;; diff --git a/configure.ac b/configure.ac index 12db8f80..36f23374 100644 --- a/configure.ac +++ b/configure.ac @@ -678,7 +678,7 @@ test "$stap_prefix" = NONE && stap_prefix=$ac_default_prefix AC_DEFINE_UNQUOTED(STAP_PREFIX, "$stap_prefix", [configure prefix location]) AC_CONFIG_HEADERS([config.h:config.in]) -AC_CONFIG_FILES(Makefile doc/Makefile doc/beginners/Makefile doc/SystemTap_Tapset_Reference/Makefile grapher/Makefile grapher/stapgraph.1 stap.1 stapprobes.3stap stapfuncs.3stap stapvars.3stap stapex.3stap staprun.8 stap-client.8 stap-server.8 stap-authorize-server-cert.8 stap-authorize-signing-cert.8 man/stapprobes.iosched.3stap man/stapprobes.irq.3stap man/stapprobes.netdev.3stap man/stapprobes.nfs.3stap man/stapprobes.nfsd.3stap man/stapprobes.pagefault.3stap man/stapprobes.kprocess.3stap man/stapprobes.rpc.3stap man/stapprobes.scsi.3stap man/stapprobes.signal.3stap man/stapprobes.socket.3stap man/stapprobes.tcp.3stap man/stapprobes.udp.3stap man/stapprobes.snmp.3stap initscript/systemtap initscript/stap-server) +AC_CONFIG_FILES(Makefile doc/Makefile doc/beginners/Makefile doc/SystemTap_Tapset_Reference/Makefile grapher/Makefile grapher/stapgraph.1 stap.1 stapprobes.3stap stapfuncs.3stap stapvars.3stap stapex.3stap staprun.8 stap-client.8 stap-server.8 stap-authorize-server-cert.8 stap-authorize-signing-cert.8 man/stapprobes.iosched.3stap man/stapprobes.irq.3stap man/stapprobes.netdev.3stap man/stapprobes.nfs.3stap man/stapprobes.nfsd.3stap man/stapprobes.pagefault.3stap man/stapprobes.kprocess.3stap man/stapprobes.rpc.3stap man/stapprobes.scsi.3stap man/stapprobes.signal.3stap man/stapprobes.socket.3stap man/stapprobes.tcp.3stap man/stapprobes.udp.3stap man/stapprobes.snmp.3stap initscript/systemtap initscript/stap-server dtrace.1) AC_CONFIG_SUBDIRS(testsuite) if test $enable_translator == "yes"; then AC_CONFIG_FILES([run-stap], [chmod +x run-stap]) diff --git a/dtrace.1.in b/dtrace.1.in new file mode 100644 index 00000000..0452cab7 --- /dev/null +++ b/dtrace.1.in @@ -0,0 +1,92 @@ +.\" -*- nroff -*- +.TH DTRACE 1 @DATE@ "Red Hat" +.SH NAME +dtrace \- Dtrace compatibile user application static probe generation tool. + +.SH SYNOPSIS + +.br +.B dtrace \-s \fIfile\fR [\fBOPTIONS\fR] + +.SH DESCRIPTION + +The dtrace command converts probe descriptions defined in \fIfile.d\fR +into a probe header +file via the \fB-h\fR option +or a probe description file via the \fB-G\fR option. + +.SH OPTIONS +.PP +.TP +.B \-h +generate a systemtap header file. + +.TP +.B \-G +generate a systemtap probe definition object file. + +.TP +.B \-o \fIfile\fR +is the name of the output file. If the \fB\-G\fR option is given then +the output file will be called \fIfile.o\fR; if the \fB-h\fR option is +given then the output file will be called \fIfile.h\fR. + +.TP +.B \-C +run the cpp preprocessor on the input file when the \fB\-h\fR option +is given. + +.TP +.B \-I \fIfile\fR +give this include path to cpp when the \fB\-C\fR option is given. + +.TP +.B \-k +keep temporary files, for example the C language source for the +\fB\-G\fR option. + +.TP +.B \-\-types +generate probe argument typedef information when the \fB\-h\fR +option is given. + +.SH EXAMPLES + +Systemtap is source compatible with dtrace user application static +probe support. +Given a file \fItest.d\fR containing: +.RS +.in +2 +.nf +provider sdt_probes +{ + probe test_0 (int type); + probe test_1 (struct astruct node); +}; +struct astruct {int a; int b;}; +.fi +.in +.RE +Then the command \fI"dtrace\ -s\ test.d\ -G"\fR +will create the probe definition file \fItest.o\fR +and the command \fI"dtrace\ -s\ test.d\ -h"\fR +will create the probe header file \fItest.h\fR +Subsequently the application can define probes using +.in +2 +.nf +#include "test.h" + \.\.\. +struct astruct s; + \.\.\. +SDT_PROBES_TEST_0(value); + \.\.\. +SDT_PROBES_TEST_1(s); +.fi +.in + +The application is linked with \fI"test.o"\fR when it is built. + +.SH SEE ALSO + +\fBstap(1)\fR + |