Komodo can be used to debug Tcl programs locally or remotely. The following
instructions describe how to configure Tcl debugging. For
general information about using the Komodo debugger, see Komodo Debugger Functions.
Debugger commands can be accessed from the Debug menu, by
shortcut keys, or from the Debug Toolbar. For a summary of debugger commands, see
the Debugger
Command List.
|
|
Specify the Tcl interpreter Komodo uses to debug and run Tcl
programs:
- On the Edit menu, select Preferences.
- In the Preferences dialog box under Languages, click
Tcl. Komodo searches for Tcl interpreters in the system
PATH and lists all tclsh and
wish interpreters available in separate drop-down lists. If no
Tcl interpreters are displayed in the list, check that the location of the
interpreters is specified in your PATH environment variable.
- If the preferred interpreters are in these lists, click to select them. If
they are not, click Browse to locate them.
- Click OK.
To start a local Tcl debugging session, click Go/Continue
or Step In on the Debugger menu or toolbar. See
Komodo Debugger Functions for
full instructions on using Komodo's debugging functionality.
When debugging a Tcl program remotely, the program is executed on the remote
machine and the debug output is sent to Komodo. Komodo controls the debugging
session (e.g. stepping, breakpoints, and spawnpoints) once the session has been
started on the remote machine.
To debug a Tcl program remotely, the Tcl debugger application,
dbgp_tcldebug.exe (Windows) or dbgp_tcldebug (Linux and OS X),
must be installed on the remote machine. This file is installed in the
tcl subdirectory of the Komodo installation directory for your platform.
Windows
<komodo-install-directory>\lib\support\tcl
Linux
<komodo-install-directory>/lib/support/tcl
Mac OS X
<komodo-install-directory>/Contents/SharedSupport/tcl
This application is also available for download from the Komodo
Remote Debugging page.
To install the Tcl debugger application on the remote machine:
To debug a Tcl script on a remote machine:
- In Komodo, select Listen for Debugger Connections
from the Debug menu.
- Log in to the remote machine.
- On the remote machine, run the dbgp_tcldebug executable
from the command line. To specify command line arguments for the script
that you are debugging, simply add those arguments to the end of the
command, after the dbgp_tcldebug arguments.
dbgp_tcldebug -dbgp <komodo_host:port>
-app-file <tcl_program>
-app-shell </path/to/tclsh_or_wish>
The following options are available:
- -dbgp: Sets the hostname (or IP address) and port where Komodo or the
DBGP Proxy is running.
In Komodo, select Debug|Listener Status to check the current
port setting.
- -app-file: Specifies the Tcl program to debug. Program
arguments should follow a "--" delimiter after the Tcl program name (e.g.
... -app-file test.tcl -- arg_0 arg_1 ).
- -app-shell: Sets the path to the Tcl interpreter
(
tclsh or wish ).
- -help: Displays a complete list of options.
- A Tcl Debug tab opens in Komodo. Click Step In,
or Go/Continue) to run to the first breakpoint (see Komodo Debugger
Functions for full instructions).
Example
Remote Machine (Windows):
- The file dbgp_tcldebug.exe has been copied into the
C:\remote_debug directory.
- The Tcl file to be debugged is called
test.tcl and is located
in the current working directory.
- The Tcl interpreter is
C:\Tcl\bin\wish.exe .
Local Machine:
- The hostname is "mybox".
- The Komodo remote debugging listener port is set to 9000.
In this scenario, the following command is entered on the remote machine:
C:\remote_debug\dbgp_tcldebug.exe -dbgp mybox:9000
-app-file test.tcl -app-shell C:\Tcl\bin\wish.exe
|