home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 15 / 15.iso / s / s159 / 1.ddi / README.SI < prev    next >
Encoding:
Text File  |  1989-11-05  |  6.8 KB  |  195 lines
  1.  
  2. ***************************************************************************
  3. The following section are ommisions from the Soft-ICE 2.0 User's Guide
  4. ***************************************************************************
  5.  
  6. -- WATCHV --
  7.  
  8.     WATCHV is turned on in the default S-ICE.DAT file.  WATCHV allows
  9.     Soft-ICE to better follow programs that go into graphics mode
  10.     without using the BIOS calls. WATCHV also will slow down the
  11.     video display some.  You may want to take WATCHV out of the
  12.     S-ICE.DAT file to speed up your video response.
  13.  
  14. -- BACK TRACE --
  15.  
  16.     Range break points that overlap a back trace range will not trigger
  17.     properly.  Do not overlap range break points.
  18.  
  19. -- Soft-ICE 1.X user READ THIS --
  20.  
  21.     When upgrading from Soft-ICE 1.X to Soft-ICE 2.0 you should take
  22.     S-ICE.SYS (NUMEGA.SYS for MCV users) OUT of your CONFIG.SYS and
  23.     replace it with S-ICE.EXE.
  24.     See Chapter 6 for all of the installation options.
  25.  
  26. -- REMOTE DEBUGGING --
  27.  
  28.     Soft-ICE is capable of displaying all of the information from the
  29.     command window over a serial port.  The hot key is still activated
  30.     via the system keyboard but once Soft-ICE is popped up, both the system
  31.     and the remote keyboard will be active.  To activate remote debugging
  32.     use the following sequence.
  33.  
  34.         1) Set the BAUD rate with the DOS MODE command to the
  35.         same baud rate as the remote terminal.
  36.         2) Within Soft-ICE, set PRN to the correct serial port.
  37.               Example: PRN COM1
  38.         3) Within Soft-ICE, enter SERIAL ON
  39.         4) You will probably want to get rid of your Code, Data and
  40.         Register windows as these will not be displayed across to the
  41.         remote terminal.
  42.         5) If you do not want the Soft-ICE screen up on the host
  43.         machine then turn ALTSCR ON from within Soft-ICE.
  44.  
  45.  
  46. **************************************************************************
  47.            *** NEW FEATURES in version 2.1 ***
  48. This section lists the differences between Soft-ICE version 2.0 and version 2.1.
  49. The user manual was not changed between Soft-ICE 2.0 and 2.1.
  50. **************************************************************************
  51.  
  52. * VCPI (Virtual Control Program Interface) support is now included in
  53.   Soft-ICE.  VCPI is automatically enabled when you use the /EMM switch
  54.   on the S-ICE.EXE line in CONFIG.SYS.    VCPI support allows the running
  55.   of VCPI applications that use DOS extenders when Soft-ICE is loaded.
  56.   It does not allow debugging of these applications in protected mode.
  57.   VCPI conforming applications include Lotus 123 version 3.0 and Autocad.
  58.  
  59.   VCPI support does NOT enable Soft-ICE to run with other VCPI control
  60.   programs.  These include Quarterdeck's QEMM and Qualitas's 386MAX.
  61.  
  62. * The FILE command has been enhanced.  FILE * will display all source
  63.   files that have been loaded into memory.  To switch files you no longer
  64.   have to type the path or file extension.  For example to switch to
  65.   file FOO.C; enter FILE FOO.
  66.  
  67. * A length argument was added to SHOW when displaying information
  68.   from the trace buffer.  If this form of SHOW is used, you can
  69.   use CTRL P to dump the dis-assembled source to the printer.
  70.  
  71. * An example of a user qualifed break point has been included on the relase
  72.   diskette.  It is called IOSIM.ASM, it will take a BPIO break point and log
  73.   all the values that where written to or read from that port.
  74.  
  75. NEW BACK DOOR COMMANDS
  76.  
  77. * Back-door calls have been added to Soft-ICE.    This allows your
  78.   program to control Soft-ICE directly.
  79.  
  80. These calls all have the following calling sequence:
  81.  
  82.     MOV    AH,09
  83.     MOV    AL,SUB-FUNCTION
  84.     MOV    SI,'FG'
  85.     MOV    DI,'JM'
  86.     INT    3
  87.  
  88. SUB-FUNCTIONS
  89.  
  90. AL=10H - Display information in the Soft-ICE window.
  91.  
  92. This is usefull for diagnostic writes - especially from within
  93. interrupt routines and other areas that may have re-entrancy concerns.
  94.  
  95. DS:DX -> Zstring of text characters to be displayed
  96.  
  97. The Zstring can be a maximum of 100 characters and can contain
  98. carriage returns (0DH).
  99.  
  100.  
  101. AL=11H - Do a Soft-ICE command.
  102.  
  103. This allows you to generate a Soft-ICE command from your program.
  104. It is usefull for setting & clearing breakpoints under program control
  105. among other things.
  106.  
  107. DS:DX -> Zstring that contains a Soft-ICE command.
  108.  
  109. The Zstring can be a maximum of 100 characters.  Each Soft-ICE command
  110. in the string should end with a carriage returns (0DH)
  111.  
  112. AL=12H - Get break point information
  113.  
  114. Returns the break point number of the last break point set and the
  115. last break point that went off.
  116.  
  117. This is usefull when setting break points from hardware control
  118. or doing hardware simulation.
  119.  
  120.  
  121. Returns:        DH - entry number of last BP that went off
  122.             DL - type of last break point
  123.             BH - entry number of last BP set
  124.             BL - type of last BP set
  125.  
  126. The entry number is the same as is displayed in the BL command.
  127.  
  128. The types are:
  129.  
  130.             0 - BPM (break point register types)
  131.             1 - I/O
  132.             2 - INT
  133.             3 - BPX (int 3 style BP)
  134.             4 - Reserved
  135.             5 - Range
  136.  
  137. **************************************************************************
  138.              *** BUG FIXES ***
  139. **************************************************************************
  140.  
  141. S-ICE.EXE
  142.  
  143. * Model 70 Mice (plugged into the mouse port) work now.
  144.  
  145. * Range break points on some 20 Mhz 386 chips had problems in
  146.   release 2.0.    This was due to an old B-stepping bug that seems
  147.   to have re-apeared in the 20Mhz part.  We have put in a work-around.
  148.  
  149. * Systems with more than 8 Megabytes of memory will now work properly.
  150.  
  151. * Control chars in source files now work.
  152.  
  153. * Symbol and source information of combined size of more than
  154.   1 megabyte would cause random and strange problems.  These
  155.   problems have been solved.
  156.  
  157. * GROUP names in the MAP file are now recognized and take precedence
  158.   over the segment names.
  159.  
  160. * If multiple code segments are present, Soft-ICE will only load
  161.   the source files once.
  162.  
  163. * Tracing through certain C calls with the T command would cause the
  164.   program to run to completion.  This has been corrected.
  165.  
  166. * BPX can now be used when debugging with other debuggers.
  167.  
  168. * BPX count was eliminated in the on line help.  A count is not valid for BPX.
  169.  
  170. * BPAND now works.
  171.  
  172. * SHOW of addresses greater than 1 megabyte deep in the buffer now work
  173.   properly.
  174.  
  175. * Soft-ICE now can synchronize better while scrolling through
  176.   code dis-assembly.  Whenever a symbol or the current instruction
  177.   are encountered, dis-assembly synchs to that address.
  178.  
  179. MSYM.EXE
  180.  
  181. * If the 1st char of a symbol name in a MAP file started on a 32K boundry
  182.   relative to the start of the MAP file, MSYSM would quit.
  183.  
  184. * File names with path's longer than 16 characters were garbled.
  185.  
  186. LDR.EXE
  187.  
  188. * The INT 22 exit address is updated properly.
  189.  
  190. * arg[0] now points to the entire path name including the drive letter,
  191.   for MSDOS compatibility.
  192.  
  193. * .COM files with symbols are now located properly.  You do not have to
  194.   use SYMLOC after loading.
  195.