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