Using WDEB386

Before you start WDEB386, you must prepare for debugging by doing the following:

• Connect a serial terminal or other computer to the serial port on your debugging computer.
• Create symbols files for the application, DLL, or VxD you intend to debug. See Using MAPSYM.
• Install the debugging versions of the system DLLs and VxDs. These files are available in the Windows 95 Device Driver Development Kit (DDK).

The following is the command-line syntax for WDEB386:

wdeb386 [/A] [/B] [/C:comport] [/D:"commands"] [/E] [/F:filename] [/H] [/I] [/L] [/N] [/R:dddd] [/T:hhhh] [/S:symfile] [/V[P]] [/X] winfile [parameters]
 

/A

Specifies that symbol files should not be automatically loaded.

/B

Specifies that the debugger should stop just prior to VMM initialization, after all virtual devices have been loaded and the processor is running in protected mode.

/C:comport

Specifies a COM port for debugger output. You can specify "1", "2", "3", or "4" for comport. If this option is not specified, The debugger checks first for COM2. If COM2 is not found, the debugger then checks for COM1. If neither COM1 nor COM2 exists, the debugger checks for any other COM port in the read-only memory (ROM) data area (40:0).

/D:"commands"

Carries out the debugger command line specified by the string enclosed in quotation marks after symbols are loaded. Spaces, semicolons (;), and other punctuation can be included in the command string. To use a single quote (') on the command line, use double quotation marks (") before and after the single quotation mark.

/E

Specifies that the debugger should stop at real-mode entry.

/F: filename

Specifies a file containing command-line options for the debugger. Maximum file size is 4K, and the input file cannot contain the /F option.

/H

Specifies that the debugger should be loaded as a VxD.

/I

Specifies that the debugger should be invisible to int 41.

/L

Specifies that line numbers should not be included in the .SYM file. This can make a large difference in memory use, and may be required on a machine with 4 megabytes of RAM.

/N

Sets the following options:

dislwrcodebytessymaddrsint3linenewvecnewregnewprompt

For more information on these options, see the y command.

/R:dddd

Sets the baud rate for the debugging terminal.

/S: symfile

Specifies a symbol file to be loaded. This option can be repeated to load more than one symbol file. If the symbol files are not in your current directory, you must supply a full path, because the debugger does not use the PATH environment variable to locate any of the files supplied on the command line.

/T:hhhh

Sets the port number for the timing card. The default is 0250h.

/V

Enables verbose mode, which displays messages indicating which segments are being loaded.

/VP

Enables verbose mode, which displays messages indicating which application segments are being loaded.

/X

Causes symbols to be loaded into Extended Memory Specification (XMS) memory.

winfile

Specifies the Windows application to run under debugger control. You will usually specify WIN.COM.

parameters

Specifies any parameters to be passed to the application.