home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / SOFTIC~1.ZIP / DOC-TXT.ZIP / CHAP6 < prev    next >
Text File  |  1992-05-24  |  14KB  |  345 lines
  1.  
  2.    SECTION III - Support Features
  3.  
  4.        CHAPTER 6
  5.  
  6.  Soft-ICE Initialization Options
  7.  
  8.    6.1 Introduction
  9.    6.2 Loading from the DOS Prompt
  10.    6.3 Loading Soft-ICE as a Loadable Device Driver
  11.    6.3.1 Soft-ICE Loading Switches
  12.    6.4 The Soft-ICE Initialization File S-ICE.DAT
  13.    6.4.1 Configuration Options
  14.    6.4.2 Function Key Assignments
  15.    6.4.3 Initialization Command Sequence
  16.  
  17.      165 
  18.  
  19. 6.1 Introduction
  20.  
  21. The Soft-ICE program file (S-ICE.EXE) can be loaded as a loadable device
  22. driver in CONFIG.SYS or as a program from the DOS command line. To get the
  23. full power of Soft-ICE, it must be initially loaded as a device driver in
  24. CONFIG.SYS. However, there may be circumstances when you might want to run
  25. Soft-ICE from the DOS prompt or a batch file, such as:
  26.  
  27.     * You do not have extended memory in your system
  28.         Soft-ICE can only load as a loadable device driver
  29.         if you have extended memory.
  30.     * You want to take up ZERO bytes of conventional
  31.         memory. When loaded as a device driver,
  32.         Soft-ICE occupies approximately 2K of
  33.         conventional memory.
  34.     * You only need to use Soft-ICE occasionally and
  35.         there are no other programs using extended
  36.         memory.
  37.  
  38. In some cases you may need some of the features that require Soft-ICE to
  39. be loaded in CONFIG.SYS but do not want Soft-ICE to be resident all of the
  40. time. In this case Soft-ICE can be loaded in CONFIG.SYS to reserve
  41. extended memory, and then disabled, by using the /UN switch, until Soft-
  42. ICE is required. See section 6.3.1 for more information about the /UN
  43. switch.
  44.  
  45.  6.2 Loading Soft-ICE from the DOS Prompt
  46.  
  47. You can NOT enable all of Soft-ICE's features when loading from the DOS
  48. prompt. If you will be using Soft-ICE as a stand-alone debugger, it is
  49. recommended you load Soft-ICE in the CONFIG.SYS file.
  50.  
  51.      166 
  52.  
  53. To load Soft-ICE from the DOS prompt type:
  54.  
  55.          S-ICE
  56.  
  57. In systems with no extended memory present, Soft-ICE loads itself at the
  58. highest memory location possible. The memory used by Soft-ICE is then
  59. 'mapped out', making it invisible to DOS programs. Since the total memory
  60. visible to DOS and its programs is less after Soft-ICE loads, it is
  61. recommended that you load Soft-ICE before any TSR's control programs.
  62.  
  63. In systems with extended memory, you should only load Soft-ICE from the
  64. DOS prompt if you are not using extended memory for anything else (e.g.,
  65. VDISK, CACHE, HIMEM...). When you initially load Soft-ICE from the command
  66. line or from a batch file, Soft-ICE will prompt you with a warning
  67. message. This warning message is just to remind you that Soft-ICE will
  68. overwrite the highest portion of extended memory when it loads. You can
  69. suppress this warning prompt with the EXTENDED option in the Soft-ICE
  70. configuration file S-ICE.DAT. For more information about the EXTENDED
  71. option, see section 6.4.1.
  72.  
  73. 6.3 Loading Soft-ICE as a Loadable Device Driver
  74.  
  75. In order to use all of the Soft-ICE features, you must first load Soft-ICE
  76. as a loadable device driver in your CONFIG.SYS file. The features this
  77. makes possible are:
  78.  
  79.     * Coexisting with other software that uses extended
  80.         memory.
  81.         Loading as a device driver allows Soft-ICE to
  82.         manage extended memory so you can run Soft-ICE
  83.         with programs that use extended memory, such
  84.         VDISK, CACHE and HIMEM.
  85.  
  86.      167
  87.  
  88.     * Symbolic and source level debugging
  89.         Loading as a device driver allows Soft-ICE to
  90.         allocate an extended memory buffer for symbols
  91.         and source information.
  92.     * Back trace ranges and the SNAP command
  93.         Loading as a device driver allows Soft-ICE to
  94.         allocate an extended memory buffer for a back
  95.         trace buffer. This buffer is also used for the
  96.         Soft-ICE SNAP command.
  97.     * Enabling Soft-ICE's EMM 4.0 capability
  98.     * Running Soft-ICE with MagicCV or MagicCVW
  99.  
  100. Note :
  101. When loaded as a device driver in CONFIG.SYS, Soft-ICE allocates the
  102. highest portion of extended memory for itself and its associated
  103. components, so there can be no memory conflicts. S-ICE.EXE must be loaded
  104. in CONFIG.SYS before any other driver that allocates extended memory
  105. loaded (e.g., VDISK.SYS, RAMDRIVE.SYS). Generally Soft-ICE works best if
  106. it is the first loadable device driver installed in CONFIG.SYS.
  107.  
  108.  6.3.1 Soft-ICE Loading Switches
  109.  
  110. One or more loading switches can follow S-ICE.EXE in CONFIG.SYS. These
  111. switches allow you to customize the way extended memory will be reserved
  112. by Soft-ICE. The switches all must begin with a / character. The loading
  113. switches are:
  114.  
  115.    * /EXT XXXX -- Informs S-ICE.EXE to reserve
  116.        XXXX Kilobytes of extended memory for other
  117.        DOS programs that use extended memory (e.g.,
  118.        VDISK, CACHE, HIMEM,...). If the /EXT
  119.  
  120.      168 
  121.  
  122. switch is not present, then any extended memory not used by Soft-ICE and
  123. its associated components will be left as standard extended memory, but
  124. the amount can not be guaranteed. The /EXT switch is useful because it is
  125. sometimes difficult to determine exactly how much memory being used by
  126. Soft-ICE and its associated components. Using the /EXT switch will
  127. guarantee a specified amount is available for other programs that use
  128. extended memory.
  129.  
  130.    * /SYM XXXX -- Informs S-ICE.EXE to reserve
  131.      XXXX Kilobytes of extended memory for symbols
  132.      and source usage. If XXXX is not specified, then
  133.      all remaining extended memory is used for
  134.      symbols. Enough memory must be allocated for
  135.      your .SYM file and all source files. For more
  136.      information about using symbols and source, see
  137.      chapter 7.
  138.    * /TRA XXXX -- Informs S-ICE.EXE to reserve
  139.      XXXX Kilobytes of extended memory for a back
  140.      trace history buffer. This buffer is used for back
  141.      trace ranges and for the SNAP command. If
  142.      XXXX is not specified, then 10K of extended
  143.      memory is automatically reserved for the buffer. If
  144.      you do not want any memory reserved for a back
  145.      trace buffer, use /TRA 0. For more information
  146.      about using back trace ranges, see chapter 9.
  147.    * /MCV XXX -- Informs S-ICE.EXE to reserve
  148.      XXX Kilobytes of extended memory for MagicCV
  149.      or MagicCVW. The minimum amount of extended
  150.      memory you can specify is 280K and the maximum
  151.      is 620K. If XXX is not specified, S-ICE.EXE will
  152.      reserve the remaining memory, between 280K and
  153.      620K. See chapter 10 for more information about
  154.      running Soft-ICE with MagicCV or MagicCVW.
  155.      */EMM XXXX -- Informs S-ICE.EXE to turn
  156.      XXXX Kilobytes of extended memory into EMM
  157.  
  158.      169 
  159.  
  160.        4.0 conforming expanded memory. If XXXX is
  161.        specified, then all remaining memory is used as
  162.        expanded. See chapter 8 for more information
  163.        about expanded memory support.
  164.     * /UN -- Informs S-ICE.EXE to enter protected
  165.        mode, reserve any needed extended memory, then
  166.        exit protected mode and unload itself. This switch
  167.        should be used when you are loading S-ICE.EXE
  168.        as a loadable device driver, but you don't want
  169.        your system to remain in protected mode. This
  170.        switch will reserve memory for Soft-ICE, and you
  171.        must execute S-ICE.EXE from the DOS prompt
  172.        when you are ready to use Soft-ICE.
  173.  
  174. Soft-ICE reserves extended memory in the following order, regardless of
  175. the order the switches are specified:
  176.  
  177.        Reserve approximately 120K for S-ICE.EXE.
  178.        Reserve memory for the /EXT switch if present.
  179.        Reserve memory for the /SYM switch if present.
  180.        Reserve memory for the /TRA switch if present.
  181.              if it is not present, default to reserve 10K for
  182.              the back trace buffer.
  183.        Reserve memory for the /MCV switch if present.
  184.        Reserve memory for the /EMM switch if present.
  185.  
  186. If available memory runs out while trying to reserve memory for a switch
  187. in the above sequence, then S-ICE.EXE does the following:
  188.  
  189.     1. The remaining extended memory is allocated to
  190.          switch being processed when memory runs out.
  191.     2. No memory will be reserved for the remaining
  192.          switches.
  193.  
  194.      170
  195.  
  196.  Note: 
  197. If the /MCV or /EMM switch is present, a additional 64K of extended memory
  198. is reserved for a DMA holding buffer.
  199.  
  200. The switches can be placed in any order following DEVICE = S-ICE.EXE.
  201. example is:
  202.  
  203.  DEVICE = S-ICE.EXE /TRA50 /EMM 500 /SYM 2048
  204.  
  205. If four megabytes of extended memory are available, this example will
  206. reserve approximately 120K for Soft-ICE, 2 megabytes for symbols, 50K for
  207. a back trace history buffer, 500K for expanded memory and leave
  208. approximately 1.3 megabytes for other extended memory programs. Note that
  209. Soft-ICE will load into the highest portion of extended memory, leaving
  210. the remaining memory starting at 100000H (one megabyte mark).
  211.  
  212.  6.4 The Soft-ICE Initialization File S-ICE.DAT
  213.  
  214. Soft-ICE has several load options. These options are specified by placing
  215. special commands in an initialization file named S-ICE.DAT.
  216. S-ICE.DAT is an ASCII text file that Soft-ICE parses at load time. This
  217. file can contain function key assignment an auto-start string and various
  218. configuration options. The file can be created and edited with any DOS
  219. text editor. When loading Soft-ICE from the command line, S-ICE.DAT must
  220. be placed in the current directory or in a directory that is accessible
  221. through your current PATH. When Soft-ICE is loaded as a device driver in
  222. CONFIG.SYS, S-ICE.DAT must be in the same directory where S-ICE.EXE is
  223. located.
  224.      
  225.      171 
  226.  
  227. There are three categories of commands that can be included in the S-
  228. ICE.DAT initialization file:
  229.  
  230.      * Special configuration options
  231.      * Function key assignments
  232.      * Initialization command sequence
  233.  
  234. 6.4.1 Special Configuration Options
  235.  
  236. Any of the following configuration options that are needed should each be
  237. placed on a separate line in the S-ICE.DAT file.
  238.    * COMPAQ -- Compaq 386 and 386SX computer
  239.        and some Compaq compatible computers
  240.        (including computers containing Micronix
  241.        motherboards) have 384K of non-contiguous
  242.        extended memory. The COMPAQ option is
  243.        necessary if you want Soft-ICE to use this memory.
  244.        Note that the COMPAQ option is the same as the
  245.        /C command line parameter in Soft-ICE 1.X.
  246.    * NOLEDS -- The NOLEDS option tells Soft-ICE
  247.        not to set and clear the keyboard LEDs while the
  248.        Soft-ICE window is up. On some keyboards the
  249.        are timing problems that will cause Soft-ICE to
  250.        lose synchronization with the keyboard. If
  251.        Soft-ICE hangs when you are in the Soft-ICE
  252.        window use this option. Note that the NOLEDS
  253.        option is the same as the /L command line
  254.        parameter in Soft-ICE 1.X.
  255.   * NOTVGA -- The NOTVGA option allows
  256.        Soft-ICE to run on BIOS compatible VGA cards.
  257.        Many VGA cards are not compatible with IBM
  258.        VGA at the hardware level. These cards support
  259.        VGA at the BIOS level only. Use this switch if you
  260.        have one of those video adapters. Note that the
  261.  
  262.      172 
  263.  
  264.        NOTVGA option is the same as the /V command
  265.        line parameter in Soft-ICE 1.X.
  266.    * EXTENDED -- The EXTENDED option causes
  267.        Soft-ICE to load directly into extended memory
  268.        without prompting the user with a warning
  269.        message. It should be used if you are loading
  270.        Soft-ICE initially from the DOS prompt and do
  271.        want to be prompted, and you know nothing else
  272.        using extended memory. Note that the
  273.        EXTENDED option is the same as the /E
  274.        command line parameter in Soft-ICE 1.X.
  275.  
  276. 6.4.2 Function Key Assignments
  277.  
  278. One or more Soft-ICE commands can be assigned to any function key at load
  279. time. See the description of the FKEY command in section 5.8 (Debugger
  280. Customization Commands) for a description of assigning function keys from
  281. the Soft-ICE command line.
  282.  
  283. The syntax for assigning a function key name in S-ICE.DAT is :
  284.  
  285.    function-key-name = "string"
  286.    function-key-name -- F1, F2... F12.
  287.    string -- The string may consist of any valid
  288.                    Soft-ICE commands and the special
  289.                    characters ^ and ;. A ^ is placed in
  290.                    the string to make a command
  291.                    invisible. A ; is placed in the string
  292.                    denote a carriage return. The string
  293.                    must be enclosed in double quotes.
  294.  
  295. An example function key assignment in S-ICE.DAT is:
  296.      F12 = "D 100;"
  297.  
  298.      173 
  299.  
  300. This will assign the Soft-ICE dump command to function key 12. When F12 is
  301. pressed Soft-ICE will dump at offset 100H in the current data segment. The
  302. semi-colon following the 100 represents the ENTER key.
  303.  
  304. 6.4.3 Initialization Command Sequence
  305.  
  306. A sequence of commands can be automatically executed when Soft-ICE loads.
  307. This is useful for customizing Soft-ICE to meet your needs. For example,
  308. you might set up windows and change the default hot key sequence.
  309. The syntax for setting up an initialization command sequence in S-ICE.DAT
  310. is:
  311.  
  312.    INIT = "assignment-string"
  313.    assignment string -- The string consists of any valid
  314.                      Soft-ICE commands and the special
  315.                      characters ^ and ;. A ^ is placed in
  316.                      the string to make a command
  317.                      invisible. A; is placed in the string
  318.                      denote a carriage return. The string
  319.                      must be enclosed in double quotes.
  320.  
  321. An example initialization command sequence in S-ICE.DAT is:
  322.  
  323.    INIT = "WIN; WR; WD 1; WC 12; ALTKEY CTRL X;"
  324.  
  325. This example will put the Soft-ICE window in full screen mode, create a
  326. register window, create a data window one line long, create a code window
  327. 12 lines long, and change the hot key sequence to CTRL X.
  328.  
  329. Sample S-ICE.DAT
  330.  
  331. A sample S-ICE.DAT initialization file is included on the distribution
  332. diskette. This sample assigns the function keys
  333.  
  334.      174  
  335.  
  336. so they are used in a similar manner as the function keys in Microsoft's
  337. CodeView debugger. This sample S-ICE.DAT should also be used as is for the
  338. tutorial in chapter 3.
  339.  
  340.      175
  341.  
  342.  Page 176 is blank
  343.  
  344.      176
  345.