interrup.1st

A Programmer s Reference to BIOS, DOS, and Third-Party Calls

Interrupt List			Release 61		Last change 16jul00
Copyright (c) 1989-1999,2000 Ralf Brown
--------!---FILELIST-------------------------
Please redistribute the following files unmodified as a group, in a quartet of
archives named INTER61A through INTER61D (preferably the original authenticated
PKZIP archives):
	INTERRUP.1ST	this file
	INTERRUP.A	INT 00 through INT 10/BE  \
	INTERRUP.B	INT 10/BF through INT 15/0F\
	INTERRUP.C	INT 15/10 through INT 15/E7 \
	INTERRUP.D	INT 15/E8 through INT 1A/B0  \
	INTERRUP.E	INT 1A/B1 through INT 1F      \	  total 2520 pages at
	INTERRUP.F	INT 20 through INT 21/43       \  60 lines per page,
	INTERRUP.G	INT 21/44 through INT 21/5E	\ 2684 with INTPRINT -p
	INTERRUP.H	INT 21/5F through INT 21/E2	 >(8754 entries)
	INTERRUP.I	INT 21/E3 through INT 21/F1	/ (4135 tables)
	INTERRUP.J	INT 21/F2 through INT 25       /
	INTERRUP.K	INT 26 through INT 2F/15      /
	INTERRUP.L	INT 2F/16 through INT 2F/79  /
	INTERRUP.M	INT 2F/7A through INT 2F/D9 /
	INTERRUP.N	INT 2F/DA through INT 50   /
	INTERRUP.O	INT 51 through INT 61	  /
	INTERRUP.P	INT 62 through INT 6A	 /
	INTERRUP.Q	INT 6B through INT 91   /
	INTERRUP.R	INT 92 through INT FF  /
	INTERRUP.PRI	a brief primer on interrupts
	INTPRINT.COM	a simple formatter that also generates a list summary
	INTPRINT.DOC	instructions for INTPRINT
	OVERVIEW.LST	brief listing of major uses of each interrupt
	86BUGS.LST	a listing of CPU bugs and undocumented features
	BIBLIO.LST	bibliography of information sources for the list
	CMOS.LST	a description of the CMOS RAM data bytes
	FARCALL.LST	APIs available through FAR CALLs
	GLOSSARY.LST	a glossary of terms, abbreviations, and acronyms
	MEMORY.LST	format of the BIOS data area and other memory regions
	MSR.LST		a listing of Model-Specific Registers
	OPCODES.LST	a listing of recent and undocumented CPU instructions
	PORTS.A		a listing of I/O ports 0000h-013Fh
	PORTS.B		a listing of I/O ports 0140h-0AD5h
	PORTS.C		a listing of I/O ports 0AD6h-FFFFh
	CATEGORY.KEY	descriptions of divider-line category letters
	COMBINE.COM	combine the pieces of the list into a single file
	COMBINE.DOC	documentation for COMBINE
The following files should be distributed in an archive called INTER61E:
	86BUGSnn.ZIP	programs to test for CPU bugs
	COMBINE.ASM	source code for COMBINE.COM
	INT.*		invoke interrupts from commandline
	INTHLP??.ZIP	Interrupt Helper viewer for the interrupt list
	INTLIST.E	Epsilon extension for handling list
	INTPRINT.C	source code for INTPRINT
	INTSUM??.ZIP	interrupt list browser (Interrupt Summary)
	IVIEW.ZIP	another interrupt list browser
	VIEWINTL.ZIP	list viewer by Sly Golovanov
Finally, the following should be distributed in an archive called INTER61F:
	INT2RTF.ZIP	Slava Gostrenko's Windows Help converter
	INT2WHLP.ZIP	convert list into Windows Help database
	HINTSRCH.ZIP	WinHelp DLL for full-text searches of interrupt list
	IL2ME???.ZIP	convert list into Multi-Edit help database
	INT2GUID.*	convert list into TurboPower GUIDE or POPHELP database
	INT2HLP.ZIP	convert list into QuickHelp database
	INT2QH.*	program to convert list into QuickHelp database
	INT2TPH.ZIP	convert to Turbo/Borland Pascal help file (.TPH)
	INTHELP.*	convert list into TurboPower GUIDE database
	RB2NG???.ZIP	convert list into Norton Guides database
	WH_ED*.ZIP	WinHelp-file editor

Concatenate INTERRUP.A, .B, ...  with COMBINE.COM to create an interrupt
list file identical to my master copy.

Use INTPRINT to generate a one-line-per-call summary file and/or a file
containing only data structure formats.	 See INTPRINT.DOC for details.

Note: in addition to the archives mentioned above, you may also find other
archives named INTERrrx containing additional files generated from the
original distribution for your convenience.  These other archives are
maintained by other people, so please do not ask me any questions about them
(all I'll do is refer you to the creator).  The additional distributions
I am currently aware of contain a ready-made Quick Help database (compiled
by Brad Willcott <[e-mail]>), a ready-made Norton Guides
database (compiled by Michael Gallias <[e-mail]> and distributed
as RBNGrr.*), and a ready-made WinHelp database (compiled by Ron Loewy
<[e-mail]> and occasionally distributed as INTWIN*.*).
--------!---COPYRIGHT------------------------
	NOTICE		NOTICE		NOTICE		NOTICE

(c) Copyright 1989,1990,1991,1992,1993,1994,1995,1996,1997,1998,1999 Ralf Brown
Permission is granted to use and redistribute the files comprising the
interrupt listing in any way (including conversion to another format),
provided that my name and addresses and the names of all contributers
are preserved, as well as the information on how to obtain new releases.
The above requirement to give credit is waived for excerpts totaling
less than 2000 lines (although common courtesy indicates that you
should give some form of acknowledgment).

Some of the archives in the distribution contains programs contributed
by others; these programs are included as a service to users of the
interrupt list and the authors retain the rights to their programs.

Please send corrections/additions to the interrupt list me rather than
distributing a modified version of the list, so that all may benefit from
your contribution.  Corrections to programs contributed by others should
be sent directly to their authors.

Beitr刧e werden auch gerne in Deutsch angenommen!
--------!---DISCLAIMER-----------------------
DISCLAIMER:  THIS MATERIAL IS PROVIDED "AS IS".	 I verify the information
contained in this list to the best of my ability, but I cannot be held
responsible for any problems caused by use or misuse of the information,
especially for those functions not officially documented.  If it is marked
"internal" or undocumented, you should check it carefully to make sure it
works the same way in your version of the software (and please let me know
whether or not it works the same way).	Information marked with "???" is
known to be incomplete or guesswork.
--------!---AVAILABILITY---------------------
If the list is three or more months old by the time you get it, there
is probably a newer release out already (R56 is planned for mid-December,
R57 for early March 1998).  Each release supersedes all previous versions, so
there is no need to keep old versions.

The newest release of this list is available in these places (please do not
ask me to email it, at over two megs compressed it is much too large for that):

On the Internet, by standard anonymous FTP from FTP.CS.CMU.EDU [128.2.206.173].
	Change directly to directory
		/afs/cs.cmu.edu/user/ralf/pub/interrupt-list
	and get the files inter??a.zip thruough inter??g.zip.  You MUST change
	directory first and in a single command because of the way CMU's
	anonymous FTP works.  Don't forget to set mode "binary" or "type L 8"!

If connected to AFS, you can simply perform standard Unix/VMS/whatever
	directory listing and file copies from the above directory.

On the World-Wide Web, from http://www.pobox.com/~ralf/files.html

On FIDOnet, from SoundingBoard BBS 1:129/26 1-412-621-4604 HST/V.32/V.34
	as files INTERrrA.ZIP to INTERrrG.ZIP (rr stands for the release
	number), in file area #8.  First-time callers may download.
	File Requests.

Alternate Distribution Points (the list will typically be available here
within 24 hours of release):
Internet: on the SimTel.Net mirrors as files interRRa.zip to
	interRRg.ZIP in directory /pub/msdos/info, where RR stands for the
	release number. Note that you must use a binary transfer mode
	("tenex" or "type L 8" for most people) to successfully FTP the files.
	The SimTel.Net mirrors include oak.oakland.edu [141.210.10.117],
	wuarchive.wustl.edu [128.252.135.4], ftp.uu.net [137.39.1.9],
	nic.funet.fi [128.214.6.100], src.doc.ic.ac.uk [146.169.3.7], and
	archie.au [139.130.4.6].

Additional Distribution Points:
BITnet: you may retrieve the copy on SimTel via the following automated mail
	servers:
	(in the US) LISTSERV@RPITSVM (alias VM.ITS.RPI.EDU)
		    LISTSERV@NDSUVM1 (alias VM1.NODAK.EDU)
	(in Europe) TRICKLE@AWIWUW11 (Austria)
		    TRICKLE@BANUFS11 (Belgium)
		    TRICKLE@DKTC11   (Denmark)
		    TRICKLE@FRMOP11  (France)
		    TRICKLE@DEARN    (Germany)
		    TRICKLE@IMIPOLI  (Italy)
		    TRICKLE@HEARN    (Netherlands)
		    TRICKLE@EB0UB011 (Spain)
		    TRICKLE@SEARN    (Sweden)
		    TRICKLE@TREARN   (Turkey)
	(elsewhere) TRICKLE@UNALCOL  (Colombia)
		    TRICKLE@TAUNIVM  (Israel)
FIDO:	boards belonging to the PDN (Programmer's Distribution Network) system
	Madrid, Spain: 2:341/70 (93:341/110), [phone].	24 hours.
	  28800 V.FC/V.34.  File requests from all nodes, including unlisted
	  points (magic filename INTER for newest release).
CompuServe: in the IBM Programming Forum (GO IBMPRO), Library 6, as INTrrA.*,
	INTrrB.*, INTrrC.*, INTrrD.*, INTrrE.*, INTrrF.*, and INTrrG.*.
--------!---ABBREVIATIONS--------------------
Key to system abbreviations
(unless otherwise indicated, a function is available on all systems)
	PC	IBM PC
	XT	IBM PC XT
	PORT	IBM PC Portable (uses same BIOS as XT)
	Jr	IBM PCjr
	AT	IBM PC AT
	XT2	IBM PC XT 2
	XT286	IBM PC XT/286
	CONV	IBM Convertible
	PS	IBM PS/2, any model
	PS30	IBM PS/2 Model 30 and below
	PS50+	IBM PS/2 Models 50,60,70,80
	CDP	Compaq Deskpro
	CLTE	Compaq LTE
	CP386	Compaq Portable 386
	CSLT	Compaq SLT
	CSYS	Compaq Systempro
	CGA	Color Graphics Adapter
	EGA	Enhanced Graphics Adapter
	VGA	Video Graphics Array
	MCGA	Multi-Color Graphics Array
	TopView TopView/DESQview/TaskView/OmniView/other compatibles
	ConcCP/M Concurrent CP/M by Digital Research, now DR Multiuser DOS
--------!---CREDITS--------------------------
This list is the result of the time and effort of a large number of people:

 1/85 Janet Jack  (original list)
 1/85 J. Weaver Jr.
 2/85 John Cooper
 2/85 Skip Gilbrech
      Bob Jack
 4/85 Jim Kyle	       [e-mail]
 8/85 John Ruschmeyer  moncol![e-mail]
 8/85 Bill Frolik      [e-mail]
 8/85 Ross M. Greenberg [e-mail]

   87 Mike Morearty    [e-mail]	  \   early 1987
      Ed Nather	       [e-mail]	   >  several undocumented DOS
      Peter Holzmann   [e-mail]		  /   calls in another list

   87 Dan Lanciani     [e-mail]	      various, incl. NetBIOS
 7/87 Ralf Brown       [e-mail]		      INT 24h and DOS func 59h
10/87 Ralf Brown       [e-mail]		      become list maintainer
11/87 Dan Davison      [e-mail]		      DOS 3.3 function calls
11/87 Bill White       [e-mail]  DOS 3.3
11/87 Richard Hargrove harvard!killer!richardh	      EGA
12/87 Vincent Broman   [e-mail]	      Cordata BIOS/Minix
12/87 Dennis Grinberg  [e-mail]	      MCGA/VGA
 1/88 Brad Davis       [e-mail]	      GSS, DGIS
 2/88 Diomidis Spinellis [e-mail]	      Herc GRAFIX Dev Toolkit
 3/88 Michael A. Moran [e-mail]	      VGA INT 10h
 3/88 Ralf Brown       [e-mail]		      DESQview API
 4/88 Richard Marks    [e-mail]	      undoc dir search fields
 5/88 Robert Goldsmith [e-mail]		      AT&T DEB adapter
 7/88 Gary E. Miller   [e-mail]		      Paradise VGA
 8/88 John Lefor       [e-mail]	      XMS spec
 9/88 Dan Lanciani     [e-mail]	      miscellaneous
 9/88 Howard Johnson   [e-mail]  NetWare overview
 9/88 Finn Thoegerson  via [e-mail]	      10-NET, miscellaneous
 9/88 Michael Shiels   [e-mail]   FOSSIL spec
 9/88 Ralf Brown       [e-mail]		      Microsoft CD-ROM API
10/88 Michael Shiels   [e-mail]	      ATI VIP INT 10h
		       BMB Compuscience Canada Ltd.
10/88 Michael Shiels   [e-mail]	      FTP Driver spec
10/88 Helmut Waelder   [e-mail]	      data structures, misc
10/88 Helmut Waelder   [e-mail]	      more 10-NET functions
10/88 Ge van Geldorp   [e-mail]	      Novell NetWare
10/88 Ralf Brown       [e-mail]		      INT 2F/AH=12h
11/88 Clarence A Dold  [e-mail]     Compaq386 speed settings
11/88 Ralf Brown       [e-mail]		      TesSeRact API
12/88 Ying-Kuen K. Hwang  [e-mail]	      ESDI fixed disk calls
 1/89 Ari Huttunen     [e-mail]	      additional INT 33 calls
 1/89 Duncan Murdoch   [e-mail]      undoc fields in DOS data
 2/89 Ralf Brown       [e-mail]		      VCPI API