home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / SOFTIC~1.ZIP / DOC-TXT.ZIP / INDEX < prev   
Text File  |  1992-05-24  |  7KB  |  209 lines
  1.  
  2.  Soft-ICE User's Guide
  3.  
  4.  
  5.  By Nu-Mega Technologies P.0. Box 7780 Nashua, NH 03060-7780 (603) 889-
  6. 2386
  7.  Copyright Nu-Mega Technologies @, 1987 - 1989. All rights reserved. No
  8. part of this publication or the enclosed software may be reproduced or
  9. distributed in any form or by any means without the prior written
  10. permission of Nu-Mega Technologies. It is permitted to make copies of the
  11. Soft-ICE diskette to be used solely for backup in case of destruction of
  12. the original.
  13. We welcome your suggestions and comments regarding improvements to Soft-
  14. ICE or this publication. Changes will be incorporated in new editions of
  15. this publication and in new versions of Soft-ICE software. Nu-Mega
  16. Technologies reserves the right to make improvements of changes to this
  17. product at any time without notice.
  18. While every reasonable precaution has been taken in the preparation of
  19. this publication and software, Nu-Mega Technologies assumes no
  20. responsibility or liability of any kind for errors or omissions, or for
  21. the consequences of a such errors. The program is provided "as is" without
  22. warranty of any kind. The entire risk as to the quality and performance of
  23. this program is to you. Should the program prove defective, you assume the
  24. entire cost of all necessary servicing, repair or correction.
  25.  
  26.  
  27.  
  28.      i
  29.  
  30.  The following trade names are referenced throughout this Manual:
  31.     IBM, PCDOS, Personal Series II, AT, MDA, CGA,
  32.     EGA, and VGA are trademarks of International
  33.     Business Machines Corporation.
  34.     MSDOS, DEBUG, SYMDEB, CODEVIEW,
  35.     Microsoft Windows, Ramdrive and Microsoft are
  36.     trademarks of Microsoft Corporation.
  37.      8086, 80286, 80386 and Intel are trademarks of Intel
  38.      Corporation.
  39.      CP/M is a trademark of Digital Research.
  40.      Soft-ICE, MagicCV, and MagicCVW are
  41.      trademarks of Nu-Mega Technologies.
  42.      Compaq is a trademark of Compaq Computer
  43.      Corporation.
  44.  
  45.      ii CONTENTS 
  46.  
  47.   CHAPTER 1                                    Page
  48.  
  49.  Introduction
  50.         1.1 Product Description...................2
  51.         1.2 Using This Manual.....................4
  52.         1.3 System Requirements...................5
  53.         
  54.            SECTION I -- Learning Soft-ICE
  55.  
  56. CHAPTER 2
  57.  
  58.  Getting Started
  59.         2.1 The Diskettes.........................8
  60.         2.2 Loading Soft-ICE......................9
  61.         2.3 Unloading Soft-ICE...................13
  62.         2.4 Reloading Soft-ICE...................13
  63.  
  64. CHAPTER 3
  65.  
  66.  Debugging in 30 Minutes
  67.         3.1 Introduction..........................16
  68.         3.2 Popping Up the Window.................16
  69.         3.3 Returning From the Window.............16
  70.         3.4 Changing the Window Size..............16
  71.         3.5 Moving the Window.....................17
  72.         3.6 Line Editing Keystrokes...............17
  73.         3.7 Interactive Status Line...............18
  74.         3.8 Command Syntax........................19
  75.         3.9 Function Keys.........................21
  76.         3.10 Help.................................22
  77.         3.11 Tutorial.............................23
  78.  
  79.      iii
  80.  
  81.            SECTION II -- Commands
  82.  
  83.  Notational Conventions ......................... 49
  84.  
  85. CHAPTER 4
  86.  
  87.  Using Break Point Commands
  88.         4.1 Introduction ........................ 52
  89.         4.2 Setting Break Points ................ 53
  90.         4.3 Manipulating Break Points ........... 67
  91.  
  92. CHAPTER 5
  93.  
  94.  Using Other Commands
  95.        5.1 Display and Edit Commands ............ 76
  96.        5.2 I/O Port Commands .................... 89
  97.        5.3 Transfer Control Commands ............ 92
  98.        5.4 Debug Mode Commands .................. 103
  99.        5.5 Utility Commands ..................... 109
  100.        5.6 Specialized Debugging Commands ....... 116
  101.        5.7 Windowing Commands ................... 130
  102.        5.8 Debugger Customization Commands ...... 137
  103.        5.9 Screen Control Commands .............. 148
  104.        5.10 Symbol and Source Line Commands ..... 158
  105.                     
  106.            SECTION III -- Support Features
  107.  
  108. CHAPTER 6
  109.  
  110.  Soft-ICE Initialization Options
  111.        6.1 Introduction ......................... 166
  112.        6.2 Loading Soft-ICE from the DOS Prompt . 166
  113.        6.3 Loading Soft-ICE as a Loadable
  114.                   Device Driver ................. 167
  115.        6.4 The Soft-ICE Initialization File
  116.                   S-ICE.DAT ..................... 171
  117.  
  118.      iv
  119.  
  120. CHAPTER 7
  121.  
  122.  Symbolic and Source Level Debugging Page
  123.       7.1 Introduction .......................... 178
  124.       7.2 Preparing for Symbolic or Source
  125.             Debugging ........................... 178
  126.       7.3 Reserving Memory for Symbols and
  127.             Source Files ........................ 181
  128.       7.4 Loading Programs and Symbol Files ..... 181
  129.       7.5 Debugging With Symbols ................ 184
  130.       7.6 Debugging With Source ................. 185
  131.  
  132. CHAPTER 8
  133.  
  134.  Expanded Memory Support
  135.       8.1 Introduction .......................... 190
  136.       8.2 Configuring the EMM Environment ....... 191
  137.       8.3 Other EMM Features .................... 194
  138.       8.4 EMM Debugging ......................... 195
  139.  
  140. CHAPTER 9
  141.  
  142.  Back Trace Ranges
  143.       9.1 Introduction .......................... 198
  144.       9.2 Using Back Trace Ranges ............... 199
  145.       9.3 Special Notes ......................... 201
  146.  
  147. CHAPTER 10
  148.  
  149.  Using Soft-ICE with MagicCV or MagicCVW
  150.       10.1 Introduction ......................... 204
  151.       10.2 Running Soft-ICE with MagicCV or
  152.             MagicCVW ............................ 204
  153.       10.3 Special Considerations ............... 205
  154.       10.4 The Soft-ICE ACTION command .......... 207
  155.  
  156.      v
  157.  
  158.        SECTION IV -- Advanced Topics
  159.  
  160. CHAPTER 11
  161.  
  162.  Advanced Features
  163.       11.1 Using Soft-ICE with other Debuggers .. 210
  164.       11.2 User-Qualified Break Points .......... 212
  165.       11.3 The Window in Graphics Mode .......... 216
  166.       11.4 Expanded Memory Debugging Features ... 216
  167.       11.5 Extended Memory Debugging Features ... 218
  168.  
  169. CHAPTER 12
  170.  
  171.  Special Debugging Problems
  172.       12.1 Loadable Device Drivers .............. 222
  173.       12.2 Boot Loaders ......................... 223
  174.       12.3 Interrupt Routines ................... 224
  175.       12.4 Non-DOS Operating Systems ............ 225
  176.  
  177. CHAPTER 13
  178.  
  179.  Theory of Operation
  180.       13.1 Activating Other Debuggers ........... 228
  181.       13.2 Virtual Machine Basics ............... 228
  182.  
  183. APPENDIX A
  184.  
  185.  Functional Command List ........................ 233
  186.  
  187. APPENDIX B
  188.  
  189.  Alphabetic Command List ........................ 237
  190.    
  191.      vi
  192.  
  193. APPENDIX C
  194.  
  195.     Keystroke Function List ..................... 241
  196.  
  197. APPENDIX D
  198.  
  199.     Error Messages and Descriptions ............. 243
  200.  
  201. APPENDIX E
  202.  
  203.     Troubleshooting Guide ....................... 251
  204.  
  205. INDEX ........................................... 257
  206.  
  207.      vii
  208.  
  209.