Diff for /wikisrc/tutorials/how_to_enable_and_run_dtrace.mdwn between versions 1.4 and 1.9

version 1.4, 2013/11/04 02:50:01 version 1.9, 2014/09/10 20:42:10
Line 1 Line 1
 DTrace is a Dynamic Tracing framework developed by Sun and ported to NetBSD. It enables extensive instrumentation of the kernel and user space. See the [DTrace Community Page](http://dtrace.org) for more information. Also see [DTrace Introduction](http://dtrace.org/guide/preface.html).   DTrace is a Dynamic Tracing framework developed by Sun and ported to NetBSD. It enables extensive instrumentation of the kernel and user space. See the [DTrace Community Page](http://dtrace.org) for more information. Also see [DTrace Introduction](http://dtrace.org/guide/preface.html). 
   
   # Current status
   
 DTrace is a work-in-progress effort and it is for x86 systems only currently (there is some arm support but it is completely untested). Two providers are available; the Statically Defined Tracing (SDT) provider and the Function Boundary Tracer (FBT) provider.   ## Supported platforms
   
   DTrace is a work-in-progress effort and it is for x86 systems and some arm boards.
   
   * i386 and amd64
   * evbarm
       * BEAGLEBONE and SHEEVAPLUG
   
   ## Supported providers
   
   * SDT: Statically Defined Tracing
   * FBT: Function Boundary Tracing
   
 You can currently run a hello world DScript.   You can currently run a hello world DScript. 
   
   ## TODO for netbsd-7
   
   * Rename provider modules to `dtrace_*.kmod`: `dtrace_fbt.kmod`, &c.
   * Measure effect of `options KDTRACE_HOOKS` on system performance.
   * Determine whether the profile module works and list it here.
   * Put a dtrace target in /dev/MAKEDEV.
   * Integrate [[riz|users/riz]]'s syscall provider patch.
   
   ## TODO for netbsd-6
   
   Need to identify changes to pull up to netbsd-6 and pull them up.
   Candidates:
   
   * Profile provider.
   
   # How to use
   
 ##  Building DTrace   ##  Building DTrace 
   
 You need the following options in your kernel:   You need the following options in your kernel: 
Line 14  You need the following options in your k Line 43  You need the following options in your k
     options         MODULAR      options         MODULAR
           
   
 You also need to build distribution with the options MKMODULAR=yes and MKDTRACE=yes.   You also need to build distribution with the options MKDTRACE=yes.
   
 ##  Running hello world   ##  Running hello world 
   
Line 59  List the dtrace probes  Line 88  List the dtrace probes 
       
   
   
 Put the following into the file hello.d   Put the following into the file hello.d:
           
     BEGIN      BEGIN
     {      {
Line 77  Run the hello world script:  Line 106  Run the hello world script: 
       0      1                           :BEGIN   Hello world        0      1                           :BEGIN   Hello world
           
   
 A more complex example that traces the execution of a sleep operation in the kernel:   A more complex example that traces the execution of a sleep operation
   in the kernel. Put it in sleep.d:
           
     #pragma D option flowindent      #pragma D option flowindent
           
Line 88  A more complex example that traces the e Line 118  A more complex example that traces the e
             printf("fd: %d", arg0);              printf("fd: %d", arg0);
     }      }
           
     fbt:::      fbt::syscall:entry /self->traceme/ {}
     /self->traceme/  
     {}  
           
     fbt::syscall:return      fbt::syscall:return
     /self->traceme/      /self->traceme/
Line 100  A more complex example that traces the e Line 128  A more complex example that traces the e
     }      }
           
   
 Start the script running (dtrace -s <scriptname.d>) and then execute a sleep 2 in another shell.   Start the script running (dtrace -s sleep.d) and then execute a "sleep 2" in another shell. 
   

Removed from v.1.4  
changed lines
  Added in v.1.9


CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb