addendum.280

DriverStudio V2.70

                 ADDENDUM FOR SOFT-ICE (DOS) VERSION 2.8

This addendum contains all new commands, features and bug fixes in Soft-ICE
for DOS since version 2.64.


			INSTALLATION
			------------

To install the new version of Soft-ICE for DOS on your system, insert the
floppy disk into your disk drive and: 

	-Copy all the files from the disk to the destination directory on
  	 your hard drive.

	-Run EMMSETUP on S-ICE.EXE to configure the memory manager.
	 Syntax:
		EMMSETUP S-ICE.EXE

	-Create a new CONFIG.SYS file for Soft-ICE for DOS.  A sample
	 one is included and is entitled CONFIG.ICE.



			NEW/MODIFIED COMMANDS
			---------------------

---------------------------------------------------------------------

			P

P -- Program Step

Syntax:
	P [ RET ]

Comments:

The P command is a logical program step.  One instruction at the current
CS:IP is executed unless the instruction is a call, interrupt, loop, or 
repeated string instruction.  In those cases, the entire routine or 
iteration is completed before control is returned to Soft-ICE.

The P command uses a one-time execution break point.  The non-sticky
execution break point uses an 80386 break point register, unless
all break point registers have been allocated to sticky break points.  In
that case, and INT 3 style break point is implemented.  When this case occurs, 
the P and G commands will not work correctly in ROM.  An error message
will be displayed if this is attempted.

In source mode, the P command steps to the next source statement.  If the 
current statement is a procedure or function call, the P command steps over
it.

If RET is specified, the P command will step until the next RET or IRET
instruction.

----------------------------------------------------------------------

			LINES


LINES -- Change number of lines of the Soft-ICE display.

Syntax:
	LINES [ 25 | 43 | 50 ]

Comments:

The LINES command changes Soft-ICE's character display mode.  It allows
three different display modes: 25 line, 43 line, or 50 line mode.
43-line mode is only valid on VGA or EGA display adapters and 50-line
mode is only valid on VGA adapters.

The default number of display lines is 25.  If your Soft-ICE display is
on another computer connected by a serial cable, the display is fixed at 
25 lines.

----------------------------------------------------------------------

			SERIAL


SERIAL -- Redirect console to serial teminal.

Syntax:
	SERIAL [ ON [ com-port] [ baud rate] | OFF ]

	com-port		This is a number from 1 to 4 that 
				corresponds to COM1 COM2, COM3, or COM4.
				The default is COM1.

	baud-rate		This is the baud rate to use for serial
				communications.  The default is to have
				Soft-ICE automatically determine the fastest
				possible baud rate that can be used.

Comments:
	
Debugging on a serial console requires a second IBM compatible PC running
MSDOS.  Any PC will do, including 8088, 8086 or 80286 machines.  You must
first attach the computer to your host machine with a null modem cable.
Before using the SERIAL command, you must run the REMOTE.EXE program on the
second PC.  The syntax of REMOTE.EXE is as follows:

	REMOTE ON com-port baud-rate

-----------------------------------------------------------------------

			WATCH

WATCH -- Add a watch expression.

Syntax:
	WATCH [ size ] expression

	size		B,W,D,I,E,U,F,S,L,A

          		B - display a byte in hexadecimal format
        	  	W - display a word in hexadecimal format
	          	D - display a dword in hexadecimal pointer format
          		I - display a word in decimal (int) format
        	  	E - display a dword in decimal (long int) format
	          	U - display a word in unsigned decimal format
          		F - display a dword in unsigned decimal format
          		S - display a 4-byte (float) FP real
          		L - display an 8-byte (double) FP real
			A - display a string of ASCII characters ( max 33 )

Comments:

The WATCH commands are used to display the results of expressions.  The 
results of expression are displayed in the format of the size specified.
If no size is specified, byte will be assumed.  The expressions being
watched are displayed in the watch windows.  There can be up to eight
watch expressions at a time.  Every time Soft-ICE screen is popped up,
the watch window will display the expressions' current values.

Each line in the watch windows contains the following information:

	A watch number from 0 to 7.
	
	The hexadecimal address of the expression.

	The current value of the expression displayed in the appropriate
	format.

	The expression being evaluated.

Examples:

	WATCHW FooVariable
	WATCHD DS:ESI

----------------------------------------------------------------------

			CWATCH

CWATCH -- Clear a watch expression.

Syntax:
	CWATCH list | *

	list		This is a list of watch numbers from 0-7 seperated
			by commas.  Watch-numbers are the numbers displayed
			on the beginning of each line in the watch window.

	*		Clear all watch expressions.

Comments:

The CWATCH command is used to clear one or more watch expressions from the 
watch window.  After clearing the expressions, the ones still remaining in
the window are renumbered sequentially starting at 0.  If there are no more
watch expressions, the window disappears.

-----------------------------------------------------------------------

			STKWIN

STKWIN -- Show or clear stack window

Syntax:
	STKWIN [ ON | OFF ]

Comments:

The STKWIN command adds a stack window to the Soft-ICE screen.  Each line
shows a 4 digit ( hex ) displacement from BP and the 4 digit ( hex ) value
of the word at that address. You can scroll the stack window using the
ALT-Down-Arrow keys.  You can only edit the higlighted line.  To change a
value in the stack window, use the ES command.

-------------------------------------------------------------------------

			ES

ES -- Change highlighted value in stack window

Syntax:
	ES [ hex value ]

	hex value			4 digit address to change

Comments:

The ES command will allow you to change stack values relative to BP in the
stack window.  Similar to the E command.

--------------------------------------------------------------------------

			XRSET

XRSET -- Reset back trace history buffer

Syntax:
	XRSET [ A | I | R ]

	A		Logs addresses only.
	I		Logs addresses and opcodes.
	R		Logs addresses, opcodes, and registers. 

Comments:

The XRSET command resets the back trace history buffer.  This command
should be executed before setting a back trace range if there is 
unwanted instruction information in the back trace buffer.

When using the I and R parameters, significantly more memory will be
needed for the back trace buffer to store the information.  This memory
is allocated on the Soft-ICE device line in CONFIG.SYS.

A program (BTLOG.EXE) was added to write the back trace buffer to a file
in ASCII text. The amount of information written depends on the option
chosen in the XRSET command used to set up the back trace. The syntax of
this program is similar to the SHOW command:

                  BTLOG file-name start-line L length

-------------------------------------------------------------------------

			COLORS

COLORS -- Change the colors of the information windows in Soft-ICE

Syntax:
	COLORS [ color | * ]

	color		A hex number representing a color to change to

	*		Skip changing the color for this field.

Comments:

The COLOR command accepts up to 12 parameters in the following order:

	normal - highlight - reverse		for Register Window
	normal - highlight - reverse		for Data Window
	normal - highlight - reverse		for Code Window
	normal - highlight - reverse		for Command Window

The colors will only stay the way you change them until the computer is
rebooted.  At that time, the colors will revert to the default colors.
To change the colors on a permament basis, see the color line in
S-ICE.DAT.

Example:

	COLORS * * * 4f 40 74 * * * 5d

        Would leave the register and code window attributes the 
        same, would change the data window attributes to 4F for 
        normal, 40 for highlight, and 74 for reverse, and would 
        change the command window normal attribute to 5D, leaving 
        the highlight and reverse attributes unchanged.

	
	COLORS * * * * * * * * * 5d 40 74

	Would leave colors in all windows except the command window the
	same.  Would change the normal color of the command window to