readme.si

DriverStudio V2.70

	  SOFT-ICE FOR DOS OPERATING PROBLEMS FILE
		   Updated 11/08/94

	  List of subjects within this file

  1.  SOURCE OUT OF SYNCH OR NO SOURCE DISPLAY
  2.  EXE NOT FOUND
  3.  NO SOURCE DISPLAY OR CANNOT FIND SOURCE
  4.  CTRL-ALT-DEL DOESN'T WORK
  5.  STRUCTURES NOT DISPLAYED
  6.  NETWORK TIMEOUT
  7.  VCPI DOESN'T WORK
  8.  SOFT-ICE HANGS AFTER BEING ENTERED AND EXITED
  9.  OUT OF SYMBOL SPACE
  10. ALT-SYS-RQ HANGS ON EXIT
  11. BPINT 2 BYTES OFF IN CODE
  12. ACTION NMI DOESN'T TRANSFER TO CV
  13. BACK TRACE DOESN'T WORK
  14. KEYBOARD LOCKS AFTER NUM-LOCK OR CAPS-LOCK
  15. LONG PATH TO .EXE FILE IS TRUNCATED
  16. .COM FILE
  17. PRT-SC NOT WORKING ON OLD-STYLE KEYBOARD
  18. "INT 10 DOES NOT POINT TO..."
  19. VERTICAL LINES ON SCREEN
  20. TAPE BACKUP DOESN'T WORK WHEN S-ICE INSTALLED
  21. OLIVETTI LAPTOP KYBD LOCKS UP
  22. KEYBOARD 1 CHAR OFF
  23. PROGRAM BLOWS UP WHEN LOADED WITH LDR
  24. BPAND DOESN'T WORK
  25. LOAD HI AREA IS NOT CLEARED ON WARM BOOT
  26. COMPAQ ProSignia 486 WITH EISA SCSI DRIVE (VIRTUAL DMA)
  27. USING SOFT-ICE WITH AN ADAPTEK SCSI DRIVE
  28. MIXED BC/SI SCREEN OR BPM ON STACK DOESN'T WORK
  29. USING FOREIGN KEYBOARDS
  30. DEBUGGING DOS-EXTENDED OR PROTECTED MODE PROGRAMS
  31. SOFT-ICE REBOOTS 
  32. INVALID OP-CODE REPORTED BY Soft-ICE
  33. GP FAULT REPORTED BY Soft-ICE
  34. GP FAULT WHILE LOADING MSC 7/8 PROGRAM
  35. BOUNDS-CHECKER "STACK" GIVES GP FAULT WHEN SOFT-ICE IS LOADED
  36. USING WITH CODEVIEW 4.0
  37. RUNNING IN A DOS BOX
  38. TRYING TO DISPLAY FLOATING POINT NUMBERS
  39. RUNNING OUT OF MEMORY WITH BORLAND 4.0 IDE
  40. HOT KEY FAILS TO POP UP Soft-ICE
  41. USING MEMORY ABOVE 16 MEG
  42. "NO HIGH MEMORY AVAILABLE" MESSAGE 
  43. "CAN'T FIND S-ICE.EXE" MESSAGE WHEN RUNNING UPDATESI.EXE
  44. USING WITH OVERLAYED PROGRAMS
  45. USING WITH SPAWNED PROGRAMS
  46. LOADING DOUBLESPACE HIGH
  47. "Error Loading A Source File"
  48. FAULT WHILE TRYING TO DISPLAY A GLOBAL SYMBOL
  49. ALTSCR DOES NOT WORK IN VERSION 2.7
  50. GPF ON PUSH FD OR POP FD ( using back door command/BREAK ON )
  51. LDR OF TSR CAUSES A BLOW UP THE NEXT TIME THE TSR IS RUN
  52. WINDOWS WONT'T LOAD WHEN SI-DOS IS PRESENT	
  53. REGISTER WINDOW OVEWRITTEN WITH DS:XXXX IN LOWER RIGHT	
  54. SOFT-ICE DOES NOT POP UP PROPERLY WHEN RUNNING BRIEF
  55. USING SOFT-ICE WITH QL10DOS.SYS
  
  The following apply to Versions 2.62 and EARLIER ONLY !!!!

  56. FLOPPY HANGS WHEN SOFT-ICE INSTALLED (GP ERROR IN CACHE)
  57. TURBO DEBUGGER IN 43-LINE MODE
  58. WRONG LINE #'S IN "STACK" COMMAND
  59. GP ERROR DISASSEMBLING OR STEPPING THRU CODE
  60. "ENTER PATH..." FOR BORLAND C++
  61. USING SOFT-ICE 2.60 & EARLIER WITH MSVC or BORLAND 3.1
  62. USING SOFT-ICE 2.5x & EARLIER WITH MICROSOFT C/C++ 7.00
  63. BPM BREAKPOINT REBOOTS (SOFT-ICE VERSION 2.60-2.62)
  64. BORLAND 4.0 PROGRAMS DO NOT LOAD INTO SOFT-ICE
  65. SNOW ON SCREEN WHEN USING WINDOWS (REAL MODE)
  66. LOADING IN OVER 16M MEMORY OR 16M MEMORY NOMINAL
  67. COMPAQ REBOOTS WHEN TRYING TO LOAD SOFT-ICE
  68. USING SOFT-ICE ON A PENTIUM SYSTEM
  69. LDR HANGS WHEN LOADING SYMBOLS
  70. BAD PRINTOUT OF SOURCE LINES IN BACK TRACE
  71. BACK TRACE PRINTOUT HAS LONG BLOCKS OF SPACES
  
  -------------------------------------------------------------------
  1.  SOURCE OUT OF SYNCH OR NO SOURCE DISPLAY
  -------------------------------------------------------------------
  Problem: Source display is out of synchronism or no source is
  displayed.
  Solution: There are 3 reasons why this happens:
   A header file (.h) has code or data within it. These files
   should contain definitions and declarations only. This is the only
   reason which applies to C language programs.
   A module has no public symbol at the start, or has no public
   symbols. This can occur in Pascal, Assembly and some other
   languages.
   A code module is not class "CODE". The linker will put this
   module after the Data, separated from the rest of the Code. This
   only applies to Assembly language programs.

  -------------------------------------------------------------------
  2.  EXE NOT FOUND
  -------------------------------------------------------------------
  Problem: Message ".EXE not found" displayed when doing LDR xxx.SYM 
  on a driver.
  Solution: make a .EXE file by copying the .SYM file.

  -------------------------------------------------------------------
  3.  NO SOURCE DISPLAY OR CANNOT FIND SOURCE
  -------------------------------------------------------------------
  Problem: no source display or cannot find source files

  Reasons why no source display:
	  1: no debug data in the .EXE file, and no .SYM file
	  2: not enough /SYM space reserved
	  3. no source line # info in debug data
	  4. used LDR program-name.EXE
  Reasons why cannot find source files:
	  1. used path to LDR (becomes default path)
	  2. did not SET SRC=....
	  3. source files not in current directory

  -------------------------------------------------------------------
  4.  CTRL-ALT-DEL DOESN'T WORK
  -------------------------------------------------------------------
  Problem: Ctrl-Alt-Del won't reboot on IBM Model 55SX, Dell,
  Northgate, DTK, AST and some other systems.
  Solution: The keyboard controller on these systems does not
  recognize the reboot command (send FE to port 64). To fix this,
  change s-ice.exe as follows:

  ren s-ice.exe s-ice.bin
  debug s-ice.bin
  -s cs:0 lffff b0 fe e6 64
  (prints 2 addresses in xxxx:yyyy format)
  -e address1 90 90 90 90 bb 01
  -e address2 90 90 90 90 bb 01
  -w
  -q
  ren s-ice.bin s-ice.exe

  -------------------------------------------------------------------
  5.  STRUCTURES NOT DISPLAYED
  -------------------------------------------------------------------
  Problem: Soft-ICE does not display members of structures
  Solution: You must find the base of the structure, then calculate
  the offset of the member you wish to display, then dump that 
  address.

  -------------------------------------------------------------------
  6.  NETWORK TIMEOUT
  -------------------------------------------------------------------
  Problem: Network disconnects when Soft-ICE is used.
  Solution: When the Soft-ICE screen is popped up, all interrupts
  are disabled. If it is left up too long, the server may disconnect
  your workstation from the network. You should exit Soft-ICE every
  10 minutes to allow the network to access your computer.
  Alternatively, you may be able to increase the timeout. For
  Netware 3.x, you can control the timeout with SET statements from
  the console command line, or in AUTOEXEC.NCF.

  -------------------------------------------------------------------
  7.  VCPI DOESN'T WORK
  -------------------------------------------------------------------
  Problem: VCPI client programs like LOTUS, ORACLE, BORLAND IDE etc. 
  don't work.
  Solution: VCPI programs require the /EMM switch with at least
  500K.

  -------------------------------------------------------------------
  8.  SOFT-ICE HANGS AFTER BEING ENTERED AND EXITED
  -------------------------------------------------------------------
  Problem: On systems with a JET Keyboard Controller chip, the
  keyboard hangs after Soft-ICE is entered and exited.
  Solution: Patch Soft-ICE as follows:
	ren s-ice.exe s-ice.bin
	debug s-ice.bin
	-s 0 lffff b0 d0 e6 64
	(prints address in xxxx:yyyy format)
	-e yyyy+1 ee   (change d0 to ee)
	-e yyyy+3 60   (change 64 to 60)
	-w
	-q
	ren s-ice.bin s-ice.exe

  -------------------------------------------------------------------
  9.  OUT OF SYMBOL SPACE
  -------------------------------------------------------------------
  Problem: LDR prints "out of symbol space"
  Solution: This results when the LDR.EXE for version 2.0/2.1 is
  used when version 2.5 or higher of S-ICE.EXE is loaded.

  -------------------------------------------------------------------
  10. ALT-SYS-RQ HANGS ON EXIT
  -------------------------------------------------------------------
	  Problem: On some systems, when Alt-Sys-Rq key is assigned to pop
  up Soft-Ice, the system hangs upon exit.
  Solution: there is a timing problem in some systems because of
  the length of time it takes to complete the analysis of this key,
  and so the system gets stuck in the "Alt On" state. The user either
  must press the Alt key to release this state before exiting, or
  must assign a different key to pop up Soft-ICE.

  -------------------------------------------------------------------
  11. BPINT 2 BYTES OFF IN CODE
  -------------------------------------------------------------------
  Problem: BPINT breakpoint displays code 2 bytes ahead of actual
  INT.
  Solution: "BREAK ON" is set in S-ICE.DAT. Delete it.

  -------------------------------------------------------------------
  12. ACTION NMI DOESN'T TRANSFER TO CV
  -------------------------------------------------------------------
  Problem: ACTION NMI doesn't transfer control to CodeView
  Solution: BPX won't work with NMI, must use BPM-X. Also must set
	up CodeView to intercept NMI.

  -------------------------------------------------------------------
  13. BACK TRACE DOESN'T WORK
  -------------------------------------------------------------------
  Problem: Back Trace operation doesn't work
  Solution: When Soft-ICE is run with Bounds-Checker, BC monopolizes 
  the Paging hardware, so the BPR commands in Soft-ICE do not work. 
  The "BOUNDS OFF" command does not help. The only solution is to run
  Soft-ICE separately.

  -------------------------------------------------------------------
  14. KEYBOARD LOCKS AFTER NUM-LOCK OR CAPS-LOCK
  -------------------------------------------------------------------
  Problem: Keyboard locks up after keying NUM-LOCK or CAPS-LOCK
  Solution: Some early AMI BIOS ROM's have a timing problem in the
  keyboard controller. Boot the system and read the BIOS serial
  number: if it ends with KA,KB,KC,KD,KE or KF, this is one of the
  bad chips. Even though AMI has not made these chips since 1986,
  some computer manufacturers still have them in stock. The only
  solution is to replace the keyboard controller chip. AMI contact:
  Sam on 404-263-8181.

  -------------------------------------------------------------------
  15. LONG PATH TO .EXE FILE IS TRUNCATED
  -------------------------------------------------------------------
  Problem: Using LDR with long path to .EXE file, can't find file,
  prints truncated path.
  Solution: Use the SUBST command to create a virtual drive for a
  long path.

  -------------------------------------------------------------------
  16. .COM FILE
  -------------------------------------------------------------------
  Problem: .COM file will not load properly
  Solution: Delete the .EXE file if there is one. Note that because a 
  .COM file does not contain debug info, you should run MSYM on the 
  MAP file, LDR the program, and then do a SYMLOC CS to align. 

  -------------------------------------------------------------------
  17. PRT-SC NOT WORKING ON OLD-STYLE KEYBOARD
  -------------------------------------------------------------------
  Problem: Print Screen doesn't work with old (100) keyboard.
  Solution: change s-ice.exe as follows:
	 ren s-ice.exe s-ice.bin
	 debug s-ice.bin
	 -s cs:0 lffff 80 fc 47
	 (prints address)
	 -u address
	 kkkk:nnnn      CMP AH,47
	  .
	  .
	  .
	 kkkk:mmmm      TEST BYTE PTR [ZZZZ],20
	  .
	  .
	  .
	 kkkk:nnnn      CMP AL,2A
	 kkkk:pppp      JZ XXXX
	 kkkk:qqqq      CMP BYTE PTR [YYYY],00
	 kkkk:rrrr      JZ WWWW
   Change last two lines to:
	 kkkk:qqqq      TEST BYTE PTR [ZZZZ],20
	 kkkk:rrrr      JNZ WWWW
   Typically this is f6 06 19 0a 20 75 (ZZZZ = 0A19)
	 -w
	 -q
	 ren  s-ice.bin s-ice.exe

  -------------------------------------------------------------------
  18. "INT 10 DOES NOT POINT TO..."
  -------------------------------------------------------------------
  Problem: displays message "INT 10 does not point to E000"
  Solution: This message is displayed when the Video card is a
  Hercules graphics adapter or some monochrome cards. Patch Soft-ICE
  as follows:
	 ren s-ice.exe s-ice.bin
	 debug s-ice.bin
	 -r        (get CS)
	 -s cs+2000:0 lffff b8 00 e0
	 (prints address in xxxx:yyyy format)
	 -e xxxx:yyyy+2 ff   (change e0 to ff)
	 -w
	 -q
	 ren s-ice.bin s-ice.exe


  -------------------------------------------------------------------
  19. VERTICAL LINES ON SCREEN
  -------------------------------------------------------------------
  Problem: Vertical lines on the screen when running graphics
  programs.
  Solution: EMM Map is set up for backfilling; run EMMSETUP and
  restore A000 block to VVVV so video memory is not being accessed
  incorrectly.

  -------------------------------------------------------------------
  20. TAPE BACKUP DOESN'T WORK WHEN S-ICE INSTALLED
  -------------------------------------------------------------------
  Problem: The tape backup fails.
  Solution: This is caused by the time that Soft-ICE takes up
  during an interrupt call. It can result from Soft-ICE being loaded
  into 16-bit memory. Try loading Soft-ICE into 32-bit extended
  memory and see if that works. Also, unload Soft-ICE thru "S-ICE /U"
  on the command line. Then do the tape backup and reload Soft-ICE
  thru "S-ICE".

  -------------------------------------------------------------------
  21. OLIVETTI LAPTOP KYBD LOCKS UP
  -------------------------------------------------------------------
  Problem: Keyboard locks up on SCROLL LOCK, NUM LOCK or CAPS LOCK
  on an Olivetti laptop (M316) with Olivetti BIOS.
  Solution: Install Lantistic's KBFLOW program. This is public
  domain software.

  -------------------------------------------------------------------
  22. KEYBOARD 1 CHAR OFF
  -------------------------------------------------------------------
  Problem: Keyboard is 1 character behind the actual keystrokes.
  Solution: This problem occurred when the program LAN MAN REDIRECTOR
  was installed.

  -------------------------------------------------------------------
  23. PROGRAM BLOWS UP WHEN LOADED WITH LDR
  -------------------------------------------------------------------
  Problem: Program loads OK, but blows up when loaded with LDR.
  Solution: LDR changes the stack by 1 word. If the initialization
  code uses absolute offsets to read data from the stack, it will
  read the wrong locations.

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