home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / SICE-DOC.ZIP / DOC-TXT.ZIP / CHAP2 < prev    next >
Encoding:
Text File  |  1992-05-24  |  7.9 KB  |  216 lines
  1.  
  2.   SECTION I - - Learning Soft-ICE
  3.   CHAPTER 2
  4.  
  5.  Getting Started
  6.    2.1 The Diskettes
  7.    2.2 Loading Soft-ICE
  8.    2.2.1 Loading Without Extended Memory
  9.    2.2.2 Loading With Extended Memory
  10.    2.2.3 Configuring Soft-ICE for a Customized
  11.                  Installation
  12.    2.3 Unloading Soft-ICE
  13.    2.4 Reloading Soft-ICE
  14.      
  15.      7 
  16.  
  17. 2.1 The Diskettes
  18.  
  19. Soft-ICE comes on either a 5 1/4" diskette or a 3 1/2" diskette.
  20.  
  21. When you run Soft-ICE, the name of the person that your copy of Soft-ICE
  22. is licensed to is displayed on the screen as a deterrent to software
  23. pirates. The Soft-ICE diskette is not physically copy-protected for your
  24. convenience. For our convenience, we appreciate your high regard for our
  25. licensing agreement. It is important to make a duplicate copy to be used
  26. only for backup in case the original diskette is damaged.
  27.  
  28. A directory of a Soft-ICE diskette will show the following files:
  29.    S-ICE.EXE
  30.    S-ICE.DAT
  31.    LDR.EXE
  32.    MSYM.EXE
  33.    EMMSETUP.EXE
  34.    UPTIME.EXE
  35.    README.SI
  36.    SAMPLE.EXE
  37.    SAMPLE.ASM
  38.    SAMPLE.SYM
  39.  
  40. S-ICE.EXE is the Soft-ICE program.
  41. S-ICE.DAT is the Soft-ICE initialization file.
  42. LDR.EXE is the Soft-ICE program and symbol file loader.
  43. MSYM.EXE is the Soft-ICE symbol file creation program.
  44. EMMSETUP.EXE is a program that allows you to customize the way your system
  45. will use expanded memory.
  46. UPTIME.EXE sets the time to that of the real time clock.
  47.  
  48.      8
  49.  
  50. README.SI is a text file containing information about Soft-ICE that did
  51. not make it into this manual.
  52. SAMPLE.EXE is a short demonstration program that is used with the
  53. tutorial.
  54. SAMPLE.ASM is the assembly language source file for the demonstration
  55. program.
  56. SAMPLE.SYM is the symbol file for the demonstration program.
  57.  
  58. 2.2 Loading Soft-ICE
  59.  
  60. Before running Soft-ICE, copy all of the files on the distribution
  61. diskette to your hard disk.
  62.  
  63. These files should be placed in a directory that is accessible through
  64. your alternate path list.
  65.  
  66. S-ICE.EXE can be loaded as a device driver in CONFIG.SYS or can be run as
  67. a program from the command line. To use many of Soft-ICE's features, S-
  68. ICE.EXE must be loaded as a device driver in CONFIG.SYS.
  69.  
  70. Note :
  71. If you do not have extended memory, Soft-ICE can NOT loaded as a device
  72. driver. Instead, it must be run from the DOS prompt.
  73.  
  74. 2.2.1 Loading Without Extended Memory
  75.  
  76. When no extended memory is present, Soft-ICE loads it at the highest
  77. memory location possible. The memory used by Soft-ICE is then 'mapped
  78. out', making it invisible to DOS programs. Since the total memory visible
  79. to DOS its programs is less after Soft-ICE loads, it is recommended
  80.  
  81.      9
  82.  
  83. that you load Soft-ICE before any TSR's or control programs.
  84. If you do not have extended memory, simply enter:
  85.  
  86.     S-ICE
  87.  
  88. 2.2.2 Loading With Extended Memory
  89.  
  90. Loading Soft-ICE with extended memory can be done in one of two ways:
  91.   1. Install S-ICE,EXE as a driver in CONFIG,SYS,
  92.       This method is necessary if you will be using one
  93.       the following capabilities:
  94.       * Sharing memory with programs that use
  95.          extended memory by using ROM BIOS calls
  96.          (VDISK,SYS, RAMDRIVE.SYS,
  97.          HIMEM.SYS, cache programs, etc.).
  98.       * Using Soft-ICE's EMM 4,0 capability,
  99.       * Using Soft-ICE for symbolic or source level
  100.           debugging.
  101.       * Using back trace ranges.
  102.       * Using Soft-ICE with other Nu-Mega products
  103.           such as MagicCV,
  104.       When loaded as a driver, Soft-ICE allocates a
  105.       portion of extended memory for itself and its
  106.       associated components so there can be no memory
  107.       conflicts. S-ICE.EXE must be loaded in
  108.       CONFIG.SYS before any other driver that
  109.       allocates extended memory is loaded (e.g.,
  110.       VDISK.SYS, RAMDRIVE.SYS). Generally
  111.       Soft-ICE works best if it is the first loadable device
  112.       driver installed in CONFIG.SYS.
  113.  
  114.      10
  115.  
  116.       For users that are new to Soft-ICE it is advisable to
  117.       load Soft-ICE as the first driver in CONFIG.SYS
  118.       with the following statement:
  119.  
  120.     device = drive: \path\S-ICE.EXE /SYM 50
  121.  
  122.       Drive and path specify the directory where
  123.       S-ICE.EXE is located. This statement will load
  124.       Soft-ICE at system initialization and will be
  125.       adequate for the tutorial. However, Soft-ICE will
  126.       not be installed for some of its more powerful
  127.       features such as EMM 4.0. You can reconfigure
  128.       Soft-ICE with those features enabled after you
  129.       have experimented a bit. If you already have
  130.       experience with Soft-ICE or would like to set up
  131.       Soft-ICE with those features immediately, please
  132.       read chapter 6 (Soft-ICE Initialization Options).
  133.  
  134. Caution:
  135. When installing any new device driver for the first time on your system,
  136. it is advisable to have a boot diskette available This precautionary
  137. measure is for the unlikely event that The default setup of the device
  138. driver is not compatible with your system.
  139.  
  140.       If you are not sure how to edit your CONFIG.SYS
  141.       file, refer to your system user's guide or your text
  142.       editor user's guide for instructions. After you have
  143.       modified your CONFIG.SYS file, you must reboot
  144.       your system to have the changes take effect.
  145.  
  146.    2. Run Soft-ICE from the DOS Prompt by typing
  147.       S-ICE. Before actually loading, Soft-ICE will
  148.       display a loading message and prompt. To prevent
  149.       this prompt, place the word EXTENDED in the
  150.       S-ICE.DAT file. See section 6.4 for more
  151.       information on the S-ICE.DAT file. Using this
  152.  
  153.      11
  154.  
  155.      method, S-ICE.EXE is automatically loaded into
  156.      the top of extended memory, whether or not
  157.      anything else is already there. If you know you will
  158.      not have any other programs using extended
  159.      memory, this method is acceptable. When loaded
  160.      with this method, Soft-ICE occupies ZERO bytes
  161.      of conventional memory. The command you use is:
  162.      
  163.   S-ICE
  164.  
  165. Notes:
  166. You can NOT enable all of Soft-ICE's features when Loading from the
  167. command line. If you will be using Soft-ICE as a stand-alone debugger, it
  168. is recommended to Load Soft-ICE from CONFIG.SYS.
  169.  
  170. If you want to load Soft-ICE as a device driver, but don't want Soft-ICE
  171. to be resident all of the time, you should use the /UN loading switch.
  172. Refer to section 6.3.1 for more information.
  173.  
  174.  2.2.3 Configuring Soft-ICE for a Customized Installation
  175.  
  176. You can customize Soft-ICE with Soft-ICE loading switches in CONFIG.SYS
  177. and with the Soft-ICE initialization file S-ICE.DAT. The CONFIG.SYS
  178. loading switches allow you to customize how the extended memory will be
  179. reserved by Soft-ICE. The initialization file S-ICE.DAT allows you to
  180. specify configuration options, assign commands to function keys, and
  181. define an auto-start string. An auto-start string is used to execute a
  182. series of commands that you use every time you install Soft-ICE. for more
  183. information about customizing Soft-ICE, refer to chapter 6.
  184.  
  185.      12
  186.  
  187.  2.3 Unloading Soft-ICE
  188.  
  189. Occasionally you may need to unload Soft-ICE. A typical reason for
  190. unloading Soft-ICE is to run a program that uses 80286 or 80386 protected
  191. mode instructions. To unload Soft-ICE, enter:
  192.  
  193.   S-ICE /U
  194.  
  195. This command places the machine back in real address mode. If Soft-ICE was
  196. initially loaded from CONFIG.SYS When the memory is still reserved for
  197. Soft-ICE and can not be used by other software. If Soft-ICE was initially
  198. loaded from the command line, unloading frees up the memory consumed by S-
  199. ICE.EXE.
  200.  
  201. Caution:
  202. If you have any backfilled memory in your system, or if expanded memory is
  203. currently being used, unloading Soft-ICE could crash your system.
  204.  
  205.  2.4 Reloading Soft-ICE
  206.  
  207. Soft-ICE can be re-loaded at any time even if it had initially been loaded
  208. in CONFIG.SYS. If Soft-ICE had initially  been loaded in CONFIG.SYS then
  209. the original configuration options (EMM 4.0, symbols and source...) are
  210. still in effect. To reload Soft-ICE, enter:
  211.  
  212.   S-ICE
  213.  
  214.          13
  215.  
  216.