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

Article translations Article translations
Article ID: 259332 - View products that this article applies to.
This article was previously published under Q259332
This article has been archived. It is offered "as is" and will no longer be updated.
Expand all | Collapse all

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.

Properties

Article ID: 259332 - Last Review: October 20, 2013 - Revision: 1.2
APPLIES TO
  • Microsoft Windows 98 Driver Development Kit (DDK)
Keywords: 
kbnosurvey kbarchive kbhowto KB259332

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com