How To Windows 98 DDK: Building Symbol Files with Line Number Information (259332)



The information in this article applies to:

  • Microsoft Windows 98 Driver Development Kit (DDK)

This article was previously published under Q259332

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:
  1. 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.
  2. 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:
    1. In your SOURCES file for the driver you are building, add the following line:

      USE_MAPSYM=TRUE
      							

    2. 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:

      LINKER_DBG_TYPE = -debugtype:MAP,COFF
      							

    3. 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.
    4. 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.

Modification Type:MinorLast Reviewed:7/15/2004
Keywords:kbhowto KB259332