Microsoft KB Archive/259332

HOWTO: Windows 98 DDK: Building Symbol Files with Line Number Information

Q259332

The information in this article applies to:

Microsoft Windows 98 Driver Development Kit (DDK)

SUMMARY

By default, the Windows 98 DDK Checked Build Environment does not build symbol files that contain line number information. To use WDEB98/RTERM98 source-level debugging, the symbol file must contain line number information.

MORE INFORMATION

To build symbol files that contain line-number information, modify the following files:

Modify the Makefile.def file in the Win98\Inc folder to cause the linker to use the correct linker options to build a .map file with line-number information.

Use the Mapsym.exe file, once the correct link options are used, to build a .sym file with line-number information that matches your .sys file. Follow these steps:

In your SOURCES file for the driver you are building, add the following line:
Edit the DDK\Inc\Makefile.def file and make the following changes:

Change the line that reads as follows (should be line 1138)
```
LINKER_DBG_SECTION=-debug:notmapped,FULL 
```
to the following:
```
LINKER_DBG_SECTION=-debug:FULL 
```
Change the line that reads as follows (should be line 1276)
```
LINKER_DBG_TYPE = -debugtype:both 
```
to the following:
Rebuild the driver. You should see a (driver_Name).map file in the Win98ddk\Lib\i386\Checked folder. You can check for line-number information by opening the .map file and checking to see if it contains line numbers near the bottom of the file.
With line-number information, you can specify a code search path in RTERM98. You should then see the source window open when a breakpoint is hit in the driver.

REFERENCES

See the Windows 98 DDK for more information on building and debugging drivers.

Additional query words:

Keywords : kbDDK kbDSupport kbGrpDSWin9xDDK
Issue type : kbhowto
Technology : kbAudDeveloper kbWin98search kbWinDDKSearch kbWin98DDKSearch kbWin98DDK