cddl/contrib/dtracetoolkit/Ruby/Readme

   1 Ruby - DTracing Ruby
   2
   3    These scripts trace activity of the Ruby programming language, and
   4    require the DTrace Ruby provider written by Joyent.
   5
   6    Currently, the DTrace Ruby provider is a seperate download either in
   7    patch, source or binary form. Start with the "Ruby DTrace" link on
   8    http://dtrace.joyent.com/, and after getting a version running, the
   9    scripts in this directory should work.
  10
  11    Since the DTrace Ruby provider is under development, there is a chance
  12    that it has changed slightly by the time you are reading this, causing
  13    these scripts to either break or behave oddly. Firstly, check for newer
  14    versions of the DTraceToolkit; if it hasn't been updated and you need
  15    to use these scripts immediately, then updating them shouldn't take
  16    too long. The following was the state of the provider when these scripts
  17    were written - check for changes and update the scripts accordingly,
  18
  19         provider ruby {
  20             probe function-entry(class, method, file, lineno);
  21             probe function-return(class, method, file, lineno);
  22             probe raise(errinfo, file, lineno);
  23             probe rescue(file, lineno);
  24             probe line(file, lineno);
  25             probe gc-begin();
  26             probe gc-end();
  27             probe object-create-start(object, file, lineno);
  28             probe object-create-done(object, file, lineno);
  29             probe object-free(object);
  30         };
  31