home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 15 / 15.iso / s / s158 / 1.ddi / README.1ST < prev    next >
Encoding:
Text File  |  1993-06-21  |  7.6 KB  |  192 lines
  1.         Release notes for Soft-ICE/W version 1.3
  2.  
  3.  
  4. INSTALLING Soft-ICE/W Version 1.3
  5. __________________________________
  6.  
  7. The manual supplied with this product reflects Soft-ICE/W 1.0.  The
  8. additional features are documented in a Windows help-format file called
  9. README.HLP and in this readme file.  There is no install program with this
  10. product, so the simple installation instructions are described below.
  11.  
  12. Copy all of the files from the root directory of the distribution diskette(s)
  13. to a sub-directory on your hard drive (we use \WINICE), then run ICONS.EXE 
  14. from Windows by selecting FILE followed by RUN from the program manager.  
  15. When RUN prompts for the file name, enter hard-disk-path\ICONS.EXE.  This will 
  16. automatically install the icons for Soft-ICE/W on a Soft-ICE/W menu.
  17.  
  18. One of the icons installed will be for the README.HLP file.  This file is in
  19. WINHELP format and contains documentation for all changes and new features
  20. in Soft-ICE/W version 1.1.  Changes since version 1.1 are described below.
  21.  
  22.  
  23. ----------------------------------------------------------------------------
  24.         TABLE OF CONTENTS FOR CHANGES SINCE VERSION 1.1
  25. ----------------------------------------------------------------------------
  26.      1.  New Video Support
  27.      2.  BOUNDS-CHECKER/W support
  28.      3.  BPX command on entire Windows module
  29.      4.  Additions to the VXD command
  30.      5.  Support for breakout switches
  31.      6.  Horizontal scrolling of source code window
  32.      7.  Local heap indicator for HEAP command
  33.      8.  /X Command line parameter
  34.      9.  Additions to the CR command
  35.     10.  Additions to the LHEAP command
  36.     11.  WLDR command line supports indirection file
  37.     12.  FAULTS command
  38.  
  39.  
  40.     New Video Support
  41.     -----------------
  42.  
  43.     ATI and S3 support
  44.     ------------------
  45.     Soft-ICE/W now has built in video support for the ATI Ultra, ATI
  46.     Ultra Pro and video boards based on the S3 chipset.  These boards
  47.     will be automatically identified at startup time.  This should
  48.     allow them to be run in high resolution modes and still have 
  49.     Soft-ICE/W pop up on them.  You must not have a .VID file present
  50.     for this support to work.  This feature has been implemented to work
  51.     with the boards native drivers not the Windows standard drivers.
  52.     Therefore if using the Standard VGA, Super VGA or 8514 Windows 
  53.     drivers, this support may not work.  It can be turned off by using
  54.     the DISPLAY= keyword in WINICE.DAT.
  55.  
  56.     The support for the S3 chipset is generic.  It has been tested on
  57.     the Orchid Fahrenheit 1280 and the STB WIND/X boards. 
  58.  
  59.     NOTE: This support may not work when debugging prior to Windows
  60.     starting up.  At this point the Windows video driver has not 
  61.     been loaded and the video is in a different mode than it will be
  62.     when Windows has started.  If the automatic support does not work
  63.     at this point or other points it can be turned off by using the
  64.     DISPLAY= keyword in WINICE.DAT.
  65.  
  66.  
  67.     DISPLAY= keyword in WINICE.DAT
  68.     ------------------------------
  69.     The DISPLAY= keyword can be specified in WINICE.DAT to alter the 
  70.     default video support that Soft-ICE/W provides.  The following
  71.     values are supported:
  72.         
  73.       DISPLAY=0        This turns off the automatic support for the
  74.                ATI and S3 boards.  This can be used if the
  75.                automatic support does not work correctly.
  76.  
  77.       DISPLAY=VDD       Soft-ICE/W will use the Windows virtual display
  78.                driver (VDD) to switch the display between text
  79.                and graphics mode.  This will allow Soft-ICE/W
  80.                to popup on a lot more video configurations.
  81.  
  82.                    CAUTION! When using this keyword Soft-ICE/W is
  83.                making calls to the Windows VDD to enter/exit
  84.                special message mode.  This means that there will
  85.                be places in Windows where it is no longer safe to
  86.                pop Soft-ICE/W up.  Also, not all VDD's correctly
  87.                implement special message mode, so it may not 
  88.                work at all.
  89.  
  90.       DISPLAY=S3       Force S3 support.
  91.  
  92.       DISPLAY=MACH32   Force ATI Ultra Pro Support.
  93.  
  94.       DISPLAY=MACH8       Force ATI Ultra Support
  95.  
  96.       DISPLAY=MACH8640 If using an ATI Ultra in 640x480 mode this keyword
  97.                may be necessary.
  98.  
  99.     Change in .VID file format
  100.     --------------------------
  101.     The .VID file format has been changed to support full 16 bit port
  102.     addresses.  There is a new A2V.EXE and V2A.EXE that supports this
  103.     format.  Old VID files will also still work.
  104.  
  105.  
  106.     BOUNDS-CHECKER/W support
  107.     ------------------------
  108.     Soft-ICE/W 1.3 now works with BOUNDS-CHECKER/W Version 1.03.  Any time
  109.     BOUNDS-CHECKER for Windows pops up, control can be transferred to
  110.     Soft-ICE/W through a BCHKW menu selection.    
  111.  
  112.  
  113.     BPX command on entire Windows module 
  114.     ------------------------------------
  115.     The BPX command now excepts a windows module name as a parameter.  When
  116.     a module name is entered, Soft-ICE/W will set a BPX style breakpoint on
  117.     every exported entry point in that module.  For example, BPX KERNEL will
  118.     set a breakpoint on every function in the Windows module KRNL386.EXE.
  119.     NOTE: Soft-ICE/W supports a maximum of 256 break points so it is 
  120.     possible to run out of break points when using this command.
  121.  
  122.  
  123.     Additions to the VXD command
  124.     ----------------------------
  125.     The VXD command now also displays the VXD id and the address of the
  126.     VxD's device descriptor block (DDB).  In addition, if a VxD name is
  127.     passed to the VXD command, Soft-ICE/W will display detailed information
  128.     for that VXD.  The detailed info includes the control procedure address,
  129.     the PM api address, the V86 api address and the addresses of all VxD
  130.     services.
  131.  
  132.  
  133.     Support for breakout switches
  134.     -----------------------------
  135.     To enable the support for breakout switches add the NMI keyword to the
  136.     WINICE.DAT file.  Pressing the breakout button once will pop up
  137.     Soft-ICE/W.  Pressing it again will continue Windows.
  138.  
  139.     
  140.     Horizontal scrolling of source code window
  141.     ------------------------------------------
  142.     Source code displayed in the code window can now be scrolled horizontally
  143.     using the CTRL-left arrow and CTRL-right arrow keys.
  144.  
  145.  
  146.     Local heap indicator for HEAP command
  147.     -------------------------------------
  148.     The HEAP command now displays the string 'LH' next to all heap selectors
  149.     that contain a local heap.
  150.  
  151.  
  152.     /X Command line parameter
  153.     -------------------------
  154.     If /X is present on the WINICE command line, Soft-ICE/W will ignore the
  155.     X command in the INIT string in the WINICE.DAT file.  This will pop
  156.     up Soft-ICE/W before Windows starts, without having to edit the 
  157.     WINICE.DAT file.            
  158.  
  159.  
  160.     Additions to the CR command
  161.     ----------------------------
  162.     The CR command now dumps the debug registers also.
  163.  
  164.  
  165.     Additions to the LHEAP command
  166.     ------------------------------
  167.     The LHEAP command now also displays the handle of the local heap element.
  168.  
  169.  
  170.     WLDR command line supports indirection file
  171.     -------------------------------------------
  172.     WLDR now supports an indirection file on the command line for loading
  173.     symbols for multiple DLL's.  The syntax of the command line is
  174.  
  175.         [@filename;] application-file-name application-command-line.
  176.  
  177.     filename is a text file that contains the full path name of each DLL
  178.     to load, one name per line.
  179.  
  180.  
  181.     FAULTS command
  182.     --------------
  183.     The FAULTS command has been added which allows Soft-ICE/W processor
  184.     fault trapping to be turned on or off.  This is mainly intended for
  185.     users of both Soft-ICE/W and BOUNDS-CHECKER/W.  Users who wish
  186.     processor faults to go directly into BOUNDS-CHECKER/W can do a
  187.     FAULTS OFF command.
  188.  
  189.  
  190.  
  191.  
  192.