home *** CD-ROM | disk | FTP | other *** search
/ Software Recommendations - 1998 Season 1 / DNBCD4.iso / develop / NUMEGA / softice / Vtoolsd.dnb < prev   
Encoding:
Text File  |  1998-01-21  |  3.2 KB  |  84 lines
  1.     VtoolsD 2.04░µ▒╛
  2.  
  3.  
  4.     SoftICD VxD╡≈╩╘╣ñ╛▀
  5.   ╒Γ╨⌐╬─╝■╩╟╙├└┤╠µ┤·vtd95\include─┐┬╝╧┬╡─╢╘╙ª╬─╝■íú╒Γ╨⌐╨┬╬─╝■╓º│╓SoftICE 3.0íú
  6.   ╘╩╨φ─π╘┌╘┤┤·┬δ╝╢╡≈╩╘C/C++ VxDú¼╚τ┤µ╚í╛╓▓┐▒Σ┴┐ú¼┐╔└⌐╒╣╜ß╣╣╡╚íú
  7.   ░▓╫░ú║
  8.   1íó░╤╬─╝■┐╜▒┤╡╜vtd95\include─┐┬╝╧┬
  9.   2íó▒α╝¡vtd95\include\user.makú¼╝╙╚δ╧┬├µ╡─╨╨ú║
  10.     ú¿╞Σ╓╨ C:\ntice\nmsym.exe╓╗╩╟╕÷└²╫╙ú¼─π╥¬╕∙╛▌SoftICE╡──┐┬╝└┤╚╖╢¿╦ⁿú⌐íú
  11.  
  12. ┬╖╛╢ú║\develop\numega\softice\
  13. ╬─╝■ú║vtoolsd.zip
  14.  
  15. ==============================================
  16. Replacement VtoolsD make files for SoftICE 3.0
  17. ==============================================
  18.  
  19. These files are Copyright (C) Vireo Software Inc. Distributed by permission of
  20. Vireo Software.
  21.  
  22. These make files are designed to replace the corresponding files in the 
  23. vtd95\include directory. The new make files include support for SoftICE 3.0, 
  24. allowing you to debug your C/C++ VxD at the source level with access to local 
  25. variables, expandable structures, etc.
  26.  
  27. NOTE: These make files correspond to VtoolsD V2.04. They have not been 
  28. tested with any other version.
  29.  
  30. INSTALLATION
  31.  
  32. 1. Copy the files to the vtd95\include directory.
  33.  
  34. 2. Edit the file vtd95\include\user.mak, adding the following line :
  35.  
  36. NMSYM=c:\ntice\nmsym.exe /PROMPT /TRANSLATE:package,always /SOURCE:$(SOURCEPATH);$(VTOOLSD)\lib\source;$(VTOOLSD)\lib\classlib;$(VTOOLSD)\lib\include
  37.  
  38. The path to NMSYM shown here (c:\ntice\nmsym.exe) is only an example, and 
  39. you will need to change it to match your SoftICE installation.
  40.  
  41. Important note for Microsoft users: You *MUST* use link.exe version 
  42. 3.10.6038 or later. (This corresponds to Visual C++ V4.1). Older versions of the 
  43. linker would output incorrect debug information when producing VxDs.
  44.  
  45. Note for Borland users: MAKER.EXE will fail with the message "Fatal: Unable 
  46. to execute command: c:\ntice\nmsym.exe" because the NMSYM command line 
  47. is too long for it. Possible workarounds include (a) shorten the NMSYM 
  48. command line by removing the "/SOURCE:" part or (b) use MAKE.EXE rather 
  49. than MAKER.EXE.
  50.  
  51. Hint #1: Remove the /PROMPT option if you don't want to be prompted for 
  52. missing source files.
  53.  
  54. Hint #2: Unzip the VtoolsD source code if you want to have full source 
  55. available.
  56.  
  57. USING THE NEW MAKE FILES
  58.  
  59. The DEBUGGER flag (set in USER.MAK) indicates which debugger is 
  60. targeted:
  61.  
  62. DEBUGGER=SOFTICE3    for SoftICE 3.0, or
  63. DEBUGGER=SOFTICE2    for SoftICE 2.0 (obsolete).
  64.  
  65. Assuming DEBUGGER is set to SOFTICE3, the make files will generate a 
  66. NuMega symbol file (.NMS) containing full debug information and source 
  67. code. This .NMS file can be loaded at boot time, or dynamically with Loader32 
  68. or NMSYM. (Note: Loader32/NMSYM will not load your VxD).
  69.  
  70. In contrast to older versions of SoftICE, MAP and SYM files are not used. 
  71. Instead, debug information is extracted directly from the VxD and converted to 
  72. .NMS format.
  73.  
  74. CHANGE SUMMARY
  75.  
  76. The following is a brief summary of changes/additions made to the VtoolsD 
  77. V2.04 make files:
  78.  
  79. - Uses NMSYM rather than dbg2map/msym
  80. - Uses /Zi rather than /Zd; -v instead of -y
  81. - Uses /DEBUGTYPE:CV,MAP instead of /DEBUGTYPE:MAP
  82. - Uses -s option of PELE (the resulting .SMF is fed to NMSYM)
  83. - Acceptable DEBUGGER options are SOFTICE3, SOFTICE2, and WDEB386
  84.