NAME
tuba - Tcl/Tk source code debugger, version 2.4
SYNOPSIS
tuba [options] application [application arguments]
DESCRIPTION
The tuba tool allows the user to debug Tcl and Tk programs without
having to make any modifications to the application source code. Code is
instrumented on the fly when it is sourced; the instrumentation makes calls
back to the debugger so the user can perform basic debugging tasks such
as setting breakpoints and single statement stepping.
This reference only covers the command line options. For a more detailed
description of how to use tuba, please see the user's
guide.
OPTIONS
-version | -V
Prints out the tuba version and exits.
-T
Use the Tcl-based parser.
-C
Use the C++-based parser if available. If not, use the Tcl-based parser.
This is the default.
-X
Use the experimental parser. Use this in conjunction with the -C or
-T options. The experimental parser is slightly faster and will eventually
replace the default parser.
-R
Specifies run-time instrumentation. Although slower, run-time instrumenting
is very handy for Tcl/Tk code that uses a lot of dynamic code creation,
code that cannot easily be parsed at load-time. If tuba croaks on
your application due to a parsing error, then try the -R option.
-i interp
Sets the interpreter to interp. Default is tclsh8.0 (tclsh80
on Windows). This does not have to have a path if the command is in your
PATH environment.
-p port
Use port port for the socket. The default is 1090.
-c cachedir
Sets the directory for caching instrumented source files. The default
is tubadir/cache, where tubadir is the directory tuba
is installed in.
-nc
No caching. This turns off reading and writing caches instrument files.
-purge
Purges the cache directory before continuing.
-w workingdir
Sets the working directory to be in when debugging your application.
If workingdir is set to "", then it will default to the same directory
the application resides in.
-e exclusionfile
Specifies a file that contains proc exclusion expressions.
-s sessionfile
Open the specified session file.
-help
Prints out brief help on options and exits.
SEE ALSO
testinstrumenter , USERS