home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / SOFTIC~1.ZIP / DOC-TXT.ZIP / CHAP1 < prev    next >
Text File  |  1992-05-24  |  5KB  |  134 lines
  1.   CHAPTER 1
  2.  
  3.  Introduction
  4.     1.1 Product Description
  5.     1.2 Using This Manual
  6.     1.3 System Requirements
  7.  
  8.            1
  9.  
  10.  1.1 Product Description
  11.  
  12. Soft-ICE is a software debugging tool that provides hardware-level
  13. debugging capabilities to PCDOS and MSDOS debuggers.
  14.  
  15. Soft-ICE uses 80386 protected mode to run DOS in a virtual machine. This
  16. gives Soft-ICE complete control of the DOS environment. Soft-ICE uses
  17. 80386 protected mode features, such as paging, I/O privilege level, and
  18. break point registers, to add hardware-level break points your existing
  19. DOS debugger.
  20.  
  21. Soft-ICE was designed with three goals in mind:
  22.     1. To utilize the 80386 virtual machine capability to
  23.         debugging features that are impossible or
  24.         prohibitively slow with software-only debuggers
  25.         (e.g., real time hardware-level break points,
  26.         memory protection, breaking out of hung
  27.         programs, etc.).
  28.     2. To work with existing debuggers. We wanted to
  29.         provide a tool that worked with existing tools. We
  30.         designed Soft-ICE in such a way that you don't
  31.         have to learn a new debugger to get powerful
  32.         hardware debugging capabilities.
  33.     3. To be a user-friendly program with a window that
  34.         pops up instantly and does not get in the way. All
  35.         of the Soft-ICE commands were designed to fit in a
  36.         small window so that information on the screen
  37.         behind Soft-ICE could still be viewed. Dynamic
  38.         on-line help assists users who only use Soft-ICE
  39.         occasionally.
  40.  
  41. The Soft-ICE program features:
  42.      * real time break points on memory reads/writes,
  43.         port reads/writes, memory ranges, and interrupts
  44.  
  45.      2
  46.  
  47.      * back trace history ranges
  48.      * symbolic and source level debugging
  49.      * an environment that works with existing debuggers
  50.      * full EMM 4.0 support
  51.      * backfilling to raise base memory past 640K for
  52.           monochrome systems
  53.      * a window that can pop up at any time
  54.      * the ability to break out by keystroke even if
  55.           interrupts are disabled
  56.      * debugger code that is isolated by 80386 protected
  57.           mode. This prevents an errant program from
  58.           modifying or destroying Soft-ICE; even if DOS
  59.           clobbered, Soft-ICE will still work
  60.      * the ability to configure Soft-ICE to use no memory
  61.           in the lower 640K if the system has more than 640K
  62.      * user-friendly dynamic help
  63.      * the ability to be used as a stand-alone debugger.
  64.           This ability is useful if you are debugging loadable
  65.           device drivers, interrupt handlers, or boot
  66.           sequences where traditional debuggers can't go,
  67.           if your debugger suffers from re-entrancy problems
  68.      * a soft boot capability that allows debugging with
  69.           non-DOS operating systems or self-booting
  70.           programs
  71.      * a simple installation, with no DIP switches to set
  72.           no I/O ports taken up, and no memory address
  73.           space conflicts
  74.      3 
  75.  
  76. NOTE:
  77.    Soft-ICE will work with real address mode programs
  78.    only. It will not work with programs that use 80286 or
  79.    80386 protected mode instructions.
  80.  
  81. 1.2 Using This Manual
  82.  
  83. The Soft-ICE manual is divided into four main sections:
  84.     Learning Soft-ICE (Section I)
  85.     Commands (Section II)
  86.     Support Features (Section lII)
  87.     Advanced Topics (Section IV)
  88.  
  89. Soft-ICE can be used for most debugging problems after reading Section I,
  90. "Learning Soft-ICE", and a little experimentation. Soft-ICE's user-
  91. friendly on-line help can be used to reference command descriptions and
  92. syntax.
  93.  
  94. The "Learning Soft-ICE" section contains installation instructions, a
  95. description of the user interface, and a tutorial. The tutorial is
  96. designed to get you up and running quickly.
  97.  
  98. The "Commands" section describes all of the Soft-ICE commands. The command
  99. descriptions are organized by functional group with an alphabetic index
  100. for reference.
  101.  
  102. The "Support Features" section covers advanced loading options, symbolic
  103. and source level debugging, and EMM 4.0 capability.
  104.  
  105. The "Advanced Topics" section covers topics such as using Soft-ICE with
  106. DOS loadable drivers and using Soft-ICE with non-DOS operating systems.
  107.  
  108. Throughout the manual, especially in the tutorial and the command section,
  109. examples are given that require you to give data to Soft-ICE. When the
  110. directions specify that you
  111.  
  112.      4
  113.  
  114. "press" a key, such as the  key, you should press the key labelled . When
  115. the directions tell you to "enter" a phrase, such as WIN, you should type
  116. in the specified letters, then press the ENTER key.
  117.  
  118.  1.3 System Requirements
  119.  
  120. Soft-ICE works with the IBM Series II Model 70 and 80, Compaq 80386 and
  121. 80386SX computers, AT compatible and 80386 co-processor cards. Soft-ICE
  122. will only work with 80386 XT co-processors if they are AT compatible.
  123.  
  124. Soft-ICE works best with extended memory, but works fine with conventional
  125. memory systems.
  126.  
  127. Soft-ICE does not use DOS or ROM BIOS for its video output and keystroke
  128. input. Therefore the video must be compatible with one of the following:
  129. MDA, Hercules, CGA, EGA, or VGA. Soft-ICE also has support for a two-
  130. monitor configuration, which can be very helpful when debugging video-
  131. intensive programs.
  132.  
  133.      5
  134.