DTRACE(1)                   General Commands Manual                  DTRACE(1)

<?><?><?> (NAME)
       dtrace - <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> DTrace <?><?><?><?><?> <?><?> SystemTap



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       dtrace -s file [OPTIONS]


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> dtrace <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> file.d <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> -h <?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> -G <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.


<?><?><?><?><?><?><?><?> (OPTIONS)
       -h     <?><?><?><?><?> <?><?><?><?> <?><?><?> systemtap.


       -G     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> systemtap. <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> C <?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> CFLAGS <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?>. <?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> -k <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> C <?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?>.


       -o file
              <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> -G <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> file.o
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?> -h <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> file.h <?><?><?> <?><?><?><?><?> <?><?><?><?>.


       -C     <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> cpp
              <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> -h.


       -I file
              <?><?><?><?> include <?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> -C
              <?><?> cpp <?><?><?><?><?> <?><?><?><?><?><?>.


       -k     <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?> C <?><?><?><?><?> <?><?> <?><?><?><?><?> -G.


<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?> Systemtap <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> dtrace
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?>.  <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> test.d
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?>:

              provider sdt_probes
              {
                probe test_0 (int type);
                probe test_1 (struct astruct node);
              };
              struct astruct {int a; int b;};

<?><?><?> <?><?><?><?><?> dtrace -s test.d -G <?><?><?><?> <?><?><?><?><?>
<?><?><?><?> test.o <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?>
<?><?><?><?><?> dtrace -s test.d -h <?><?><?><?> <?><?><?> <?><?><?><?> test.h
<?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.  <?><?><?>
<?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
<?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
<?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>:

              #include "test.h"
               ...
              struct astruct s;
               ...
              SDT_PROBES_TEST_0(value);
               ...
              if (SDT_PROBES_TEST_1_ENABLED())
                  SDT_PROBES_TEST_1(expensive_function(s));



<?><?><?><?><?><?><?><?> (SEMAPHORES)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> systemtap
       <?><?><?><?><?><?><?><?>/<?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> test.o <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> (link) <?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?> <?><?>
       <?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?> test.o <?><?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <sys/sdt.h>
       <?><?> <?><?><?> <?><?> test.h <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?>:

              #include <sys/sdt.h>
              #include "test.h"
               ...
              struct astruct s;
               ...
              SDT_PROBES_TEST_0(value);
               ...
              if (SDT_PROBES_TEST_1_ENABLED())
                 SDT_PROBES_TEST_1(cheap_function(s));

<?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> ()ENABLED <?><?><?>
<?><?><?><?><?> 1 <?><?><?><?> <?><?><?><?><?> <?><?><?>.


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       stap(1),
       stappaths(7)


<?><?><?><?><?><?><?> (BUGS)
       <?><?> <?><?><?><?><?> Bugzilla <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.  http://sourceware.org/systemtap,
       <systemtap@sourceware.org>.

       error::reporting(7stap),
       https://sourceware.org/systemtap/wiki/HowToReportBugs

                                                                     DTRACE(1)