Readme
1Tcl - 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
40