README-passive-debugging.txt

changeset 4266
17c215c416ba
parent 4263
7c7cb5188773
child 4267
94496d77156b
equal deleted inserted replaced
4263:7c7cb5188773 4266:17c215c416ba
1 README for passive mode debugging
2
3 eric6 provides the capability to debug programms using the passive
4 mode. In this mode it is possible to start the debugger separate from
5 the IDE. This may be done on a different computer as well. If the
6 debugger is started on a remote machine, it is your responsibility
7 to ensure, that the paths to the script to be debugged are identical
8 on both machines.
9
10 In order to enable passive mode debugging in the IDE choose the
11 debugger tab of the preferences dialog and enable the passive mode
12 debugging checkbox. You may change the default port as well. Please
13 be aware that you have to tell the debugger the port, if it is different to the
14 default value of 42424.
15
16 On the remote computer you have to have the debugger scripts installed.
17 Use DebugClient.py to debug normal scripts or DebugClientThreads.py
18 to debug multi threaded scripts. The debuggers know about the following
19 commandline switches.
20
21 -h <hostname> -- this specifies the hostname of the machine running the IDE.
22
23 -p <portnumber> -- this specifies the portnumber of the IDE.
24
25 -w <directory> -- this specifies the working directory to be used for the script
26 to be debugged.
27
28 -t -- this enables tracing into the Python library
29
30 -n -- this disables the redirection of stdin, stdout and stderr
31
32 -e -- this disables reporting of exceptions
33
34 --fork-child -- this tells the debugger to follow the child when forking
35
36 --fork-parent -- this tells the debugger to follow the parent when forking
37
38 The commandline parameters have to be followed by '--' (double dash),
39 the script to be debugged and its commandline parameters.
40
41 Example::
42 python DebugClient -h somehost -- myscript.py param1
43
44 After the execution of the debugger command, it connects to the IDE and
45 tells it the filename of the script being debugged. The IDE will try to load it
46 and the script will stop at the first line. After that you may set breakpoints,
47 step through your script and use all the debugging functions.
48
49 Note: The port and hostname may alternatively be set through the environment
50 variables ERICPORT and ERICHOST.
51
52 Please send bug reports, feature requests or contributions to eric bugs address
53 <eric-bugs@die-offenbachs.de> or using the buildt in bug reporting dialog.

eric ide

mercurial