Debugging

The Open Watcom Remote Debugging

This document contains notes how to use Open Watcom Debugger for remote debugging for various targets and hosts.

Debugging for DOS with DOSBOX

Below is description how you can debug DOS executable (16 and 32-bit) from Windows. You need some virtual serial port emulation software. Example is for free Open Source software "com0com".

Install com0com software and configure it if necessary. You can use default setup for COM3/COM4 In this example COM3 is used by DOSBOX and COM4 is used by OW Debugger, you can change it if necessary.

You need to configure DOSBOX to use appropriate Windows serial port and map it to selected DOS serial port (COM1). Change DOSBOX configuration file for DOS COM1 serial port as

[serial]
serial1=directserial realport:COM3

DOS 32-bit Application debugging

Wire schema for 32-bit DOS application.

+---------+ +---------+ +---+ +-----------+ +---+ +--------+ +----------+ +---------+   +---------+
| WDW.EXE | | SER.TRP | | C | |           | | C | |        | | SERSERV  | | RSI.TRP |   | APP.EXE |
|        / /          | | O | | nullmodem | | O | | DOSBOX | | .EXE    / /          |   |         |
|        \ \          | | M | |           | | M | |        | |         \ \          |   |         |
|         | |         | | 4 | |           | | 3 | | COM1   | | COM1     | |         |   |         |
+---------+ +---------+ +---+ +-----------+ +---+ +--------+ +----------+ +---------+   +---------+
                       |                         |
                       +------- com0com ---------+

Before start debugging for DOS 32-bit application you need copy following files to target DOSBOX to existing directory or create new one. This directory will be used for debugging that any other files required by application must be copied there.

• DOS4GW.EXE (from OW BINW subdirectory)
• SERSERV.EXE (from OW BINW subdirectory)
• RSI.TRP (from OW BINW subdirectory)
• RSIHELP.EXP (from OW BINW subdirectory)

On DOSBOX you need to run following command to start remote debug server.

SERSERV /trap=rsi

On host Windows system you must start OW Debugger by command

wdw -trap=ser;4 /download "application executable name"

It ensure automatic download of application executable from host to remote system to debugging directory. If you don't want this automatic download then remove option /download from this command and you must copy application executable to debugging directory manually.

DOS 16-bit Application debugging

Wire schema for 16-bit DOS application.

+---------+ +---------+ +---+ +-----------+ +---+ +--------+ +---------+ +---------+   +---------+
| WDW.EXE | | SER.TRP | | C | |           | | C | |        | | SERSERV | | STD.TRP |   | APP.EXE |
|        / /          | | O | | nullmodem | | O | | DOSBOX | | .EXE   / /          |   |         |
|        \ \          | | M | |           | | M | |        | |        \ \          |   |         |
|         | |         | | 4 | |           | | 3 | | COM1   | | COM1    | |         |   |         |
+---------+ +---------+ +---+ +-----------+ +---+ +--------+ +---------+ +---------+   +---------+
                       |                         |
                       +------- com0com ---------+

Before start debugging for DOS 16-bit application you need to copy following files to target DOSBOX to existing directory or create new one. This directory will be used for debugging that any other files required by application must be copied there.

• SERSERV.EXE (from OW BINW subdirectory)
• STD.TRP (from OW BINW subdirectory)

On DOSBOX in your debug directory (where you placed the files mentioned above) you need to run the following command to start the remote debug server.

SERSERV

On host Windows system you must start OW Debugger by command

wdw -trap=ser;4 /download "application executable name"

It ensure automatic download of application executable from host to remote system to debugging directory. If you don't want this automatic download then remove option /download from this command and you must copy application executable to debugging directory manually.