cddl/contrib/dtracetoolkit/Tcl/Readme

   1 Tcl - DTracing Tcl Programs
   2
   3    These scripts trace activity of the Tcl programming language, making use
   4    of the Tcl DTrace provider which was integrated into the Tcl source in
   5    version tcl8.4.16. See the Tcl DTrace wiki page for details:
   6
   7         http://wiki.tcl.tk/19923
   8
   9    This provider was written by Daniel Steffen and is currently available
  10    by downloading and compiling the Tcl source with the --enable-dtrace
  11    option to configure.
  12
  13    Since the DTrace Tcl provider could be developed a little further, there is
  14    a chance that it has changed slightly by the time you are reading this,
  15    causing these scripts to either break or behave oddly. Firstly, check for
  16    newer versions of the DTraceToolkit; if it hasn't been updated and you need
  17    to use these scripts immediately, then updating them shouldn't take
  18    too long. The following was the state of the provider when these scripts
  19    were written - check for changes and update the scripts accordingly,
  20
  21         provider tcl {
  22             probe proc-entry(procname, argc, argv);
  23             probe proc-return(procname, retcode);
  24             probe proc-result(procname, retcode, retval, retobj);
  25             probe proc-args(procname, args, ...);
  26             probe cmd-entry(cmdname, argc, argv);
  27             probe cmd-return(cmdname, retval);
  28             probe cmd-args(procname, args, ...);
  29             probe inst-start(instname, depth, stackobj);
  30             probe inst-done(instname, depth, stackobj);
  31             probe obj-create(object);
  32             probe obj-free(object);
  33             proobe tcl-probe(strings, ...);
  34         };
  35
  36    Update: it looks like two new probes have recently been added to the
  37    provider: proc-info and cmd-info. I'll need to update these scripts to
  38    make use of these new probes.
  39