home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1996 February / PCWK0296.iso / sharewar / dos / program / interupt / winhelp / i2wtest / interrup.lst < prev    next >
Encoding:
File List  |  1994-07-14  |  13.4 KB  |  310 lines
  1. Interrupt List        Release 41            Last change 6/5/94
  2. This compilation is Copyright (c) 1989,1990,1991,1992,1993,1994 Ralf Brown
  3. --------!---FILELIST-------------------------
  4.  
  5. Note: This is a truncated file used only for test purposes.
  6.  
  7. Please redistribute the following files unmodified as a group, in a trio of
  8. archives named INTER41A through INTER41C (preferably the original authenticated
  9. PKZIP archives):
  10.     INTERRUP.1ST    the read-me file, containing credits, availability info
  11.     INTERRUP.A    INT 00 through INT 13      \
  12.     INTERRUP.B    INT 14 through INT 15/7F   \
  13. ...
  14. --------!---CONTACT_INFO---------------------
  15. If you notice any mistakes or omissions, please let me know!  It is only with
  16. YOUR help that the list can continue to grow at the current rate.  Please send
  17. all changes to me rather than distributing a modified version of the list.
  18.  
  19. Please read the file INTERRUP.1ST before asking me any questions.  You may find
  20. that they have already been addressed.
  21.  
  22.      Ralf Brown
  23.  
  24. Internet: ralf@telerama.lm.com
  25. UUCP: {uunet,harvard}!telerama.lm.com!ralf
  26. FIDO: Ralf Brown 1:129/26.1
  27.     or post a message to me in the DR_DEBUG echo (I probably won't see it
  28.     unless you address it to me)
  29. CIS:  >INTERNET:ralf@telerama.lm.com
  30.  
  31. I reply to all e-mail submissions and inquiries, but some of my replies bounce
  32. because of bad return paths.  If you don't get a response from me within a
  33. reasonable period of time, send it again with a better return path (starting at
  34. harvard or ucbvax for UUCP, from the Internet for others).
  35. --------!------------------------------------
  36. See INTERRUP.1ST for the key to system abbreviations and a list of the
  37. trademarks mentioned here.
  38. --------!---DISCLAIMER-----------------------
  39. DISCLAIMER:  THIS MATERIAL IS PROVIDED "AS IS".     I verify the information
  40. contained in this list to the best of my ability, but I cannot be held
  41. responsible for any problems caused by use or misuse of the information,
  42. especially for those functions not officially documented.  If it is marked
  43. "internal" or undocumented, you should check it carefully to make sure it
  44. works the same way in your version of the software (and please let me know
  45. whether or not it works the same way).    Information marked with "???" is
  46. known to be incomplete or guesswork.
  47. --------!---FLAGS----------------------------
  48. The use of -> instead of = signifies that the indicated register or register
  49. pair contains a pointer to the specified item, rather than the item itself.
  50. One or more letters may follow the interrupt number; they have the following
  51. meanings:  U - undocumented function, u - partially documented function,
  52. P - available only in protected mode, R - available only in real or V86 mode,
  53. C - callout or callback (usually hooked rather than called),
  54. O - obsolete (no longer present in current versions)
  55. --------!---CATEGORIES-----------------------
  56. The ninth column of the divider line preceding an entry usually contains a
  57. classification code (the entry has not been classified if that character is
  58. a dash).  The codes currently in use are:
  59.     A - applications, a - access software (screen readers, etc),
  60.     B - BIOS, b - vendor-specific BIOS extensions,
  61.     C - CPU-generated, c - caches/spoolers,
  62.     D - DOS kernel, d - disk I/O enhancements,
  63.     E - DOS extenders, e - electronic mail, F - FAX,
  64.     f - file manipulation, G - debuggers/debugging tools, g - games,
  65.     H - hardware, h - vendor-specific hardware,
  66.     I - IBM workstation/terminal emulators, i - system info/monitoring
  67.     J - Japanese, j - joke programs,
  68.     K - keyboard enhancers, k - file compression,
  69.     l - shells/command interpreters,
  70.     M - mouse/pointing device, m - memory management,
  71.     N - network, n - non-traditional input devices,
  72.     O - other operating systems,
  73.     P - printer enhancements, p - power management,
  74.     Q - DESQview/TopView and Quarterdeck programs,
  75.     R - remote control/file access, r - runtime support,
  76.     S - serial I/O, s - sound/speech,
  77.     T - DOS-based task switchers/multitaskers, t - TSR libraries
  78.     U - resident utilities, u - emulators,
  79.     V - video, v - virus/antivirus,
  80.     W - MS Windows, X - expansion bus BIOSes,
  81.     y - security, * - reserved (and not otherwise classified)
  82. --------C-00---------------------------------
  83. INT 00 - CPU-generated - DIVIDE ERROR
  84. Desc:    generated if the divisor of a DIV or IDIV instruction is zero or the
  85.       quotient overflows the result register; DX and AX will be unchanged.
  86. Notes:    on an 8086/8088, the return address points to the following instruction
  87.     on an 80286+, the return address points to the divide instruction
  88.     an 8086/8088 will generate this interrupt if the result of a division
  89.       is 80h (byte) or 8000h (word)
  90. SeeAlso: INT 04
  91. --------G-00---------------------------------
  92. INT 00 - Zenith - ROM DEBUGGER
  93. Desc:    invokes the ROM Debugger when at the BIOS level; equivalent to
  94.       pressing Ctrl-Alt-Ins on booting.
  95. Note:    since DOS revectors INT 00, it is necessary to restore this vector to
  96.       its original ROM BIOS value in order to invoke the debugger once DOS
  97.       loads
  98. SeeAlso: INT 03"Columbia"
  99. --------C-01---------------------------------
  100. INT 01 - CPU-generated - SINGLE STEP
  101. Desc:    generated after each instruction if TF (trap flag) is set; TF is
  102.       cleared on invoking the single-step interrupt handler
  103. Notes:    interrupts are prioritized such that external interrupts are invoked
  104.       after the INT 01 pushes CS:IP/FLAGS and clears TF, but before the
  105.       first instruction of the handler executes
  106.     used by debuggers for single-instruction execution tracing, such as
  107.       MS-DOS DEBUG's T command
  108. SeeAlso: INT 03
  109. --------C-01---------------------------------
  110. INT 01 - CPU-generated (80386+) - DEBUGGING EXCEPTIONS
  111. Desc:    generated by the CPU on various occurrences which may be of interest
  112.       to a debugger program
  113. Note:    events which may trigger the interrupt:
  114.       Instruction address breakpoint fault - will return to execute inst
  115.       Data address breakpoint trap - will return to following instruction
  116.       General detect fault, debug registers in use
  117.       Task-switch breakpoint trap
  118.       undocumented 386/486 opcode F1h - will return to following instruc
  119. SeeAlso: INT 03
  120. --------H-02---------------------------------
  121. INT 02 - external hardware - NON-MASKABLE INTERRUPT
  122. Desc:    generated by the CPU when the input to the NMI pin is asserted
  123. Notes:    return address points to start of interrupted instruction on 80286+
  124.     on the 80286+, further NMIs are disabled until the next IRET
  125.       instruction, but one additional NMI is remembered by the hardware
  126.       and will be serviced after the IRET instruction reenables NMIs
  127.     maskable interrupts may interrupt the NMI handler if interrupts are
  128.       enabled
  129.     although the Intel documentation states that this interrupt is
  130.       typically used for power-failure procedures, it has many other uses
  131.       on IBM-compatible machines:
  132.         Memory parity error: all except Jr, CONV, and some machines
  133.                   without memory parity
  134.         Breakout switch on hardware debuggers
  135.         Coprocessor interrupt: all except Jr and CONV
  136.         Keyboard interrupt: Jr, CONV
  137.         I/O channel check: CONV, PS50+
  138.         Disk-controller power-on request: CONV
  139.         System suspend: CONV
  140.         Real-time clock: CONV
  141.         System watch-dog timer, time-out interrupt: PS50+
  142.         DMA timer time-out interrupt: PS50+
  143.         Low battery: HP 95LX
  144.         Module pulled: HP 95LX
  145. --------C-03---------------------------------
  146. INT 03 - CPU-generated - BREAKPOINT
  147. Desc:    generated by the one-byte breakpoint instruction (opcode CCh)
  148. Notes:    used by debuggers to implement breakpoints, such as MS-DOS DEBUG's G
  149.       command
  150.     also used by Turbo Pascal versions 1,2,3 when {$U+} specified
  151.     return address points to byte following the breakpoint instruction
  152. SeeAlso: INT 01
  153. --------G-03---------------------------------
  154. INT 03 - Columbia PCs (desktop,VP portables) - ROM DEBUGGER
  155. Desc:    invokes the ROM Debugger if INT 03 has not been revectored; equivalent
  156.       to pressing Esc on booting.
  157. SeeAlso: INT 00"Zenith",INT 03"Realia"
  158. --------G-03---------------------------------
  159. INT 03 - Realia COBOL - DEBUGGER SUPPORT
  160. Note:    Realia COBOL checks for a signature eight bytes prior to the interrupt
  161.       handler when it starts up
  162. BUG:    if the offset of the INT 03 vector is less than 8, the compiler and
  163.       all executables generated by it will crash the system
  164. SeeAlso: INT 03"Columbia"
  165. --------G-030910-----------------------------
  166. INT 03 - Soft-ICE - BACK DOOR COMMANDS - DISPLAY STRING IN Soft-ICE WINDOW
  167.     AX = 0910h
  168.     SI = magic value 4647h ('FG')
  169.     DI = magic value 4A4Dh ('JM')
  170.     DS:DX -> ASCIZ string to display (max 100 bytes, 0Dh OK)
  171. Program: Soft-ICE is a debugger by Nu-Mega Technologies, Inc.
  172. --------G-030911-----------------------------
  173. INT 03 - Soft-ICE - BACK DOOR COMMANDS - EXECUTE Soft-ICE COMMAND
  174.     AX = 0911h
  175.     SI = magic value 4647h ('FG')
  176.     DI = magic value 4A4Dh ('JM')
  177.     DS:DX -> ASCIZ command string (max 100 bytes, 0Dh OK)
  178. --------G-030912-----------------------------
  179. INT 03 - Soft-ICE - BACK DOOR COMMANDS - GET BREAKPOINT INFORMATION
  180.     AX = 0912h
  181.     SI = magic value 4647h ('FG')
  182.     DI = magic value 4A4Dh ('JM')
  183. Return: BH = entry number of last breakpoint set
  184.     BL = type of last breakpoint set (see #0001)
  185.     DH = entry number of last breakpoint to be triggered
  186.     DL = type of last triggered breakpoint (see #0001)
  187. Program: Soft-ICE is a debugger by Nu-Mega Technologies, Inc.
  188. SeeAlso: AX=0913h,AX=0914h
  189.  
  190. (Table 0001)
  191. Values for Soft-ICE breakpoint type:
  192.  00h    BPM (breakpoint register types)
  193.  01h    I/O
  194.  02h    INTerrupt
  195.  03h    BPX (INT 03h-style breakpoint)
  196.  04h    reserved
  197.  05h    range
  198. --------G-030913-----------------------------
  199. INT 03 - Soft-ICE v2.5x - BACK DOOR COMMANDS - SET Soft-ICE BREAKPOINT
  200.     AX = 0913h
  201.     SI = magic value 4647h ('FG')
  202.     DI = magic value 4A4Dh ('JM')
  203.     DS:DX -> breakpoint structure (see #0002)
  204. Return: AX = status
  205.         00h successful
  206.         BX = breakpoint number
  207.         03h breakpoint table full
  208.         06h memory limit error
  209.         07h I/O limit error
  210.         09h range limit error
  211.         16h duplicate breakpoint
  212. SeeAlso: AX=0912h,AX=0914h
  213.  
  214. Format of Soft-ICE breakpoint structure:
  215. Offset    Size    Description    (Table 0002)
  216.  00h    BYTE    breakpoint type (see #0003)
  217.  01h    DWORD    breakpoint address 1
  218.         (lower range limit for memory BPs,
  219.         interrupt number for interrupt BPs,
  220.         address of BP for execution BPs,
  221.         I/O address (only word)    for I/O BPs)
  222.  05h    DWORD    breakpoint address 2
  223.         (upper range limit for memory BPs,
  224.         optional value to check for for interrupt BPs,
  225.         overlay number (0 = root) for execution BPs)
  226.  09h    DWORD    breakpoint address 3
  227.  0Dh    BYTE    breakpoint mode 1 (see #0004)
  228.         (for interrupt BPs = register to check
  229.             00h  no value checking
  230.             01h  check AL
  231.             02h  check AH
  232.             03h  check AX)
  233.  0Eh    BYTE    breakpoint mode 2 (see #0004)
  234.  0Fh    BYTE    breakpoint size (00h byte, 01h word, 03h dword)
  235.  10h    BYTE    breakpoint pass count before program stop
  236.  11h    BYTE    breakpoint state
  237. Note:    all unused fields should contain zeros
  238.  
  239. (Table 0003)
  240. Values for Soft-ICE breakpoint type:
  241.  00h    memory location
  242.  01h    memory range
  243.  03h    I/O
  244.  04h    interrupt
  245.  05h    execution break
  246.  
  247. (Table 0004)
  248. Values for Soft-ICE breakpoint mode:
  249.  01h    read
  250.  02h    write
  251.  04h    execution
  252. --------G-030914-----------------------------
  253. INT 03 - Soft-ICE v2.5x - BACK DOOR COMMANDS - REMOVE Soft-ICE BREAKPOINT
  254.     AX = 0914h
  255.     SI = magic value 4647h ('FG')
  256.     DI = magic value 4A4Dh ('JM')
  257.     BX = breakpoint number (returned by AX=0913h)
  258. Return: BX = ???
  259. Program: Soft-ICE is a debugger by Nu-Mega Technologies, Inc.
  260. SeeAlso: AX=0912h,AX=0913h
  261. --------C-04---------------------------------
  262. INT 04 - CPU-generated - INTO DETECTED OVERFLOW
  263. Desc:    the INTO instruction will generate this interrupt if OF (Overflow Flag)
  264.       is set; otherwise, INTO is effectively a NOP
  265. Note:    may be used for convenient overflow testing (to prevent errors from
  266.       propagating) instead of JO or a JNO/JMP combination
  267. SeeAlso: INT 00
  268. --------B-05---------------------------------
  269. INT 05 - PRINT SCREEN
  270. Desc:    dump the current text screen to the first printer
  271. Notes:    normally invoked by the INT 09 handler when PrtSc key is pressed, but
  272.       may be invoked directly by applications
  273.     byte at 0050h:0000h contains status used by default handler
  274.       00h not active
  275.       01h PrtSc in progress
  276.       FFh last PrtSc encountered error
  277.     default handler is at F000h:FF54h in IBM PC and 100%-compatible BIOSes
  278. SeeAlso: INT 10/AH=12h/BL=20h
  279. --------C-05---------------------------------
  280. INT 05 - CPU-generated (80186+) - BOUND RANGE EXCEEDED
  281. Desc:    generated by BOUND instruction when the value to be tested is less than
  282.       the indicated lower bound or greater than the indicated upper bound.
  283. Note:    returning from this interrupt re-executes the failing BOUND instruction
  284. --------P-05454A-----------------------------
  285. INT 05 U - PSPS v2.01 - EJECT PAGE
  286.     AX = 454Ah ('EJ')
  287. Program: PSPS is shareware PostScript PrintScreen utility by A.N.D.
  288.       Technologies
  289. Note:    sends a ^D to the current printer
  290. SeeAlso: AX=4E57h,AX=5053h,AX=554Eh
  291. --------P-054E57-----------------------------
  292. INT 05 U - PSPS v2.01 - SET PARAMETERS
  293.     AX = 4E57h ('NW')
  294.     ES:SI -> 11-byte buffer containing new settings
  295. Return: buffer filled
  296. SeeAlso: AX=454Ah,AX=5053h,INT 17/AH=63h
  297. --------P-055053-----------------------------
  298. INT 05 U - PSPS v2.01 - GET PARAMETERS
  299.     AX = 5053h ('PS')
  300.     ES:SI -> 11-byte buffer for settings
  301. Return: buffer filled
  302. SeeAlso: AX=4E57h,AX=554Eh,INT 17/AH=64h
  303. --------P-05554E-----------------------------
  304. INT 05 U - PSPS v2.01 - UNINSTALL
  305.     AX = 554Eh ('UN')
  306. Program: PSPS is shareware PostScript PrintScreen utility by A.N.D.
  307.       Technologies
  308. SeeAlso: AX=454Ah,AX=4E57h,INT 17/AH=62h
  309. --------!---Section--------------------------
  310.