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