Ralf Brown's Interrupt List

Ralf Brown's Interrupt List (aka RBIL, x86 Interrupt List, MS-DOS Interrupt List or INTER) is a comprehensive list of interrupts, calls, hooks, interfaces, data structures, CMOS settings, memory and port addresses, as well as processor opcodes for x86 machines from the 1981 IBM PC up to 2000 (including many clones), most of it still applying to IBM PC compatibles today. It also lists some special function registers for the NEC V25 and V35 microcontrollers.

Overview

The list covers operating systems, device drivers, and application software; both documented and undocumented information including bugs, incompatibilities, shortcomings, and workarounds, with version, locale, and date information, often at a detail level far beyond that found in the contemporary literature. A large part of it covers system BIOSes and internals of operating systems such as MS-DOS, OS/2, and Windows, as well as their interactions.

It has been a widely used resource by IBM PC compatible system developers, analysts, as well as application programmers in the pre-Windows era. Parts of the compiled information have been used for and in the creation of several books on systems programming, some of which have also been translated into Chinese, Japanese and Russian. As such the compilation has proven to be an important resource in developing various closed and open source operating systems, including Linux and FreeDOS.

The project is the result of the research and collaborative effort of more than 650 listed contributors worldwide over a period of 15 years, of which about 290 provided significant information (and some 55 of them even more than once). The original list was created in January 1985 by Janet Jack and others, and, named "Interrupt List for MS-DOS", it was subsequently maintained and mailed to requestors on Usenet by Ross M. Greenberg until 1986. As of October 1987, it is maintained by Ralf D. Brown, a researcher at Carnegie Mellon University's Language Technologies Institute. Information from several other interrupt listings was merged into the list in order to establish one comprehensive reference compilation. Over the years, Michael A. Shiels, Timothy Patrick Farley, Matthias R. Paul, Robin Douglas Howard Walker, Wolfgang Lierz and Tamura Jones became major contributors to the project, providing information all over the list. The project was also expanded to include other PC development-related information and therefore absorbed a number of independently maintained lists on PC I/O ports (by Wim Osterholt and Matthias R. Paul), BIOS CMOS memory contents (by Atley Padgett Peterson), processor opcodes (by Alex V. Potemkin) and bugs (by Harald Feldmann). Brown and Paul also conducted several systematic surveys on specific hard- and software details among a number of dedicated user groups in order to validate some info and to help fill some gaps in the list.

Originally, the list was distributed in an archive named INTERRUP in various compression formats as well as in the form of diffs. The distribution file name was changed to include a version in the form INTERnyy (with n = issue number, and yy = 2-digit release year) in 1988. In mid 1989 the distribution used ZIP compression to keep its size manageable. When the archive reached the size of a 360 KB floppy in June 1991, the distribution split into several files following an `INTERrrp.ZIP` naming scheme (with rr = revision starting with 26 for version 91.3, and p = part indicator of the package starting with letter A). Officially named "MS-DOS Interrupt List" and "x86 Interrupt List" (abbreviated as "INTER") by its maintainer, the community coined the unofficial name "Ralf Brown's Interrupt List" (abbreviated as "RBIL") in the 1990s.

The publication is currently at revision 61 as of 17 July 2000 with almost 8 MB of ASCII text including close to 9600 entries plus about 5400 tables, fully cross linked, which would result in more than 3700 pages (at 60 lines per page) of condensed information when printed. Of this, the interrupt list itself makes up some 5.5 MB for more than 2500 pages printed.

While the project is not officially abandoned and the website is still maintained (as of 2025), new releases have not been forthcoming for a very long time, despite the fact that information was still pending for release even before the INTER61 release in 2000. New releases were planned for at several times in 2001 and 2002, but when they did not materialize, portions of the new information on DOS and PC internals provided by Paul were circulated in preliminary form in the development community for peer-review and to assist in operating system development.

See also

Notes

  1. 1 2 3 Contents of INTER release 61 (as formatted ASCII text):
    INTERRUP.LST  5.700.679 bytes,  151.173 lines
FARCALL.LST      81.446 bytes,    2.178 lines
MEMORY.LST      144.149 bytes,    3.606 lines
PORTS.LST       879.133 bytes,   23.893 lines
CMOS.LST         77.175 bytes,    2.015 lines
I2C.LST         141.061 bytes,    3.563 lines
OPCODES.LST     624.174 bytes,   33.936 lines
MSR.LST          81.345 bytes,    2.190 lines
SMM.LST           7.939 bytes,      291 lines
86BUGS.LST      119.004 bytes,    3.004 lines

              7.856.105 bytes,  225.849 lines

References

  1. 1 2 3 4 5 Brown, Ralf D. [at Wikidata], ed. (2002-12-29) [2000-07-17, 1985]. "The x86 Interrupt List" (61 ed.). Archived from the original on 2017-08-22. Retrieved 2011-10-14.
  2. ↑ Stiller, Andreas; Paul, Matthias R. (1996-05-12). "Prozessorgeflüster". c't – magazin für computertechnik. Trends & News / aktuell - Prozessoren (in German). Vol. 1996, no. 6. Verlag Heinz Heise GmbH & Co KG. p. 20. ISSN 0724-8679. Archived from the original on 2017-08-28. Retrieved 2017-08-28.
  3. 1 2 3 4 5 6 Schulman, Andrew; Brown, Ralf D. [at Wikidata]; Maxey, David; Michels, Raymond J.; Kyle, Jim (1994) [November 1993]. Undocumented DOS: A programmer's guide to reserved MS-DOS functions and data structures - expanded to include MS-DOS 6, Novell DOS and Windows 3.1 (2 ed.). Addison Wesley. ISBN 978-0-201-63287-3. ark:/13960/t5z646257. Retrieved 2022-11-26. (xviii+856+vi pages, 3.5-inch floppy) Errata: (NB. This includes a repackaged version of INTER36. For the first edition see here. A Japanese translation exists under ISBN 4-89052-629-3.)
  4. 1 2 Vias, John P., SNOOPER documentation (SNOOPER.DOC), 1.07, An enormous listing of DOS and BIOS interrupt calls, many undocumented and program-specific. Quite simply, some of Snooper's reports wouldn't be there without it. Very useful in that it reports bugs and incompatibilities books rarely mention. And it's free!
  5. 1 2 Davis, Robert Curtis, TBONES07.DOC, Ralf Brown maintains an astounding file which is chock-full of detailed, absolutely-indispensable information for DOS programmers on Hardware, BIOS, DOS, and other interrupts. […] You should not be without this file, which is widely-known as "Ralf Brown's Interrupt List". Ask about it. You will find it."
  6. 1 2 3 4 5 Schulman, Andrew; Michels, Raymond J.; Kyle, Jim; Paterson, Tim; Maxey, David; Brown, Ralf D. [at Wikidata] (1990). Undocumented DOS: A programmer's guide to reserved MS-DOS functions and data structures (1 ed.). Addison Wesley. ISBN 978-0-201-57064-9. ark:/13960/t14n8vs6f. Retrieved 2022-11-26. (xviii+694+viii pages, two 5.25-inch floppies) Errata: (NB. Won a Jolt Productivity Award. Contains a hypertext version of INTER490 aka INTER22. A Chinese translation exist under ISBN 7-302-01071-4. A second edition is available as well.)
  7. ↑ "TURBO C: INTER.ARC". Turbo Resources. Turbo Technix - the Borland Language Journal. 1 (5). Scotts Valley, California, USA: Borland Communications / Borland International, Inc.: 157–158. July–August 1988. ISSN 0893-827X. OCLC 15650918. ark:/13960/s280w71575k. Retrieved 2023-06-23. p. 157: A cornucopia of descriptions of interrupt and function calls on the IBM PC. A great thing to have on your hard disk if you don't have a Ray Duncan or Peter Norton book handy. (NB. About the 1988-01-30 version (73728 bytes) of the interrupt list.)
  8. ↑ Szőr, Péter (2005-02-03). "Interrupt Vector Table". The Art of Computer Virus Research and Defense (1 ed.). India: Pearson Education. pp. 188–189. ISBN 0-67233390-2. LCCN 2004114972. Retrieved 2026-05-10. Information about the preceding interrupts (and many others) is available in the Ralf Brown Interrupt List, which offers 3,000 pages of further details. Initially, the available information about interrupts was minimal, but The Interrupt List became and essential guide for DOS virus researchers over the years and has increased understanding of undocumented interrupts.
  9. ↑ Brown, Ralf D. [at Wikidata]; Kyle, Jim (January 1994). PC Interrupts: A Programmer's Reference to BIOS, DOS, and Third-Party Calls (2 ed.). Addison Wesley. ISBN 0-201-62485-0. (1210 pages + floppy) Errata: (NB. This corresponds to the non-networking portions of INTER36 with some additions from INTER37. See here for the first edition.)
  10. ↑ Brown, Ralf D. [at Wikidata]; Kyle, Jim (1991). PC Interrupts: A Programmer's Reference to BIOS, DOS, and Third-Party Calls (1 ed.). Addison Wesley. ISBN 0-201-57797-6. Errata: (NB. A Russian translation of this edition is available in two volumes: 1, 2. A second edition is available as well.)
  11. ↑ Brown, Ralf D. [at Wikidata] (March 1994). Network Interrupts: A Programmer's Reference to Network APIs (1st ed.). Addison Wesley. ISBN 0-201-62644-6. (730 pages) Errata: (NB. This corresponds to the networking portions of INTER37 with some additions from INTER38.)
  12. ↑ Brown, Ralf D. [at Wikidata]; Kyle, Jim (1994-11-01). Uninterrupted Interrupts: A programmer's CD-ROM reference to network APIs and to BIOS, DOS, and third-party calls (CD-ROM). Addison Wesley. ISBN 0-201-40966-6. (NB. The CD-ROM contains the full text of both "PC Interrupts" (second edition) and "Network Interrupts", updated to include information added through INTER42.)
  13. ↑ 布朗 (1992). PC zhōngduàn fúwù cháng shì yìngyòng ruǎntǐ jièmiàn hūjiào dàquán PC中斷服務常式應用軟體介面呼叫大全 [PC interrupt services and application program interfaces: INT 00h–1Fh] (in Chinese). Vol. 1 (1 ed.). 儒林出版. ISBN 957-652-272-2. (516 pages) (NB. This translation of INTER26 is part of a three-volume set: 2, 3.)
  14. ↑ 布朗 (1992). PC zhōngduàn fúwù cháng shì yìngyòng ruǎntǐ jièmiàn hūjiào dàquán (zuòyè xìtǒng piān) PC中斷服務常式應用軟體介面呼叫大全 (作業系統篇) [PC interrupt services and application program interfaces (Operating system entries): INT 20h–30h] (in Chinese). Vol. 2 (1 ed.). 儒林. ISBN 957-652-271-4. (704 pages) (NB. This translation of INTER26 is part of a three-volume set: 1, 3.)
  15. ↑ 布朗 (1992). PC zhōngduàn fúwù cháng shì yìngyòng ruǎntǐ jièmiàn hūjiào dàquán (gōngyòng chéngshì piān) PC中斷服務常式應用軟體介面呼叫大全 (公用程式篇) [PC interrupt services and application program interfaces (Utilities): INT 31h–FFh] (in Chinese). Vol. 3 (1 ed.). 儒林. ISBN 957-652-261-7. (488 pages) (NB. This translation of INTER26 is part of a three-volume set: 1, 2.)
  16. ↑ Brown, Ralf D. [at Wikidata]; Kyle, Jim (1994). Spravochnik po preryvaniyam dlya IBM PC: V 2 t. T.1 Справочник по прерываниям для IBM РС: В 2 т. Т.1. [Interrupt handbook for IBM PCs] (in Russian). Vol. 1 (1 ed.). ISBN 5-03-002989-3. (NB. This translation of the first edition of "PC Interrupts" is part of a two-volume set.)
  17. ↑ Brown, Ralf D. [at Wikidata]; Kyle, Jim (1994). Spravochnik po preryvaniyam dlya IBM PC: V 2 t. T.2 Справочник по прерываниям для IBM РС: В 2 т. Т.2. [Interrupt handbook for IBM PCs] (in Russian). Vol. 2 (1 ed.). ISBN 5-03-002990-7. (NB. This translation of the first edition of "PC Interrupts" is part of a two-volume set.)
  18. ↑ Hall, Jim (2002-03-25). "The past, present, and future of the FreeDOS Project". Archived from the original on 2017-08-22. Retrieved 2015-01-23.
  19. ↑ Jack, Janet; Weaver, John Jr.; Cooper, John; Gilbrech, Skip; Kyle, Jim; Jack, Bob (April 1985) [January 1985]. "Interrupt Structure". Archived from the original on 2017-08-24. Retrieved 2017-08-24.
  20. ↑ Greenberg, Ross Matthew (1985-07-30). "List of DOS Interrupts (Interrupt List for MS-DOS (2.xx only - With some notes on DOS 3.xx))". Newsgroup: net.micro.pc. Retrieved 2017-09-04.{{cite newsgroup}}: CS1 maint: url-status (link)
  21. ↑ Greenberg, Ross Matthew (1985-07-30). "New DOS Interrupt List Posted". Newsgroup: net.micro.pc. Retrieved 2017-09-04.{{cite newsgroup}}: CS1 maint: url-status (link)
  22. ↑ Greenberg, Ross Matthew (1986-03-10). "Re: Help with SWITCHAR". Newsgroup: net.micro.pc. Retrieved 2017-09-04.{{cite newsgroup}}: CS1 maint: url-status (link)
  23. ↑ Brown, Ralf D. [at Wikidata], ed. (November 1987) [October 1987]. "Interrupt List (INTERRUP.TXT)". Archived from the original on 2017-09-01. Retrieved 2017-09-01.
  24. ↑ Brown, Ralf D. [at Wikidata] (2008-04-04). "Ralf Brown's Home Page". Archived from the original on 2017-08-22. Retrieved 2011-10-14.
  25. ↑ Brown, Ralf D. [at Wikidata] (1989-04-07). "Call for Information". Newsgroup: comp.sys.ibm.pc. Retrieved 2017-09-04.{{cite newsgroup}}: CS1 maint: url-status (link)
  26. 1 2 3 Paul, Matthias R. (2002-06-30). "Identifying various IBM machines for RBIL". Newsgroup: comp.sys.ibm.ps2.hardware. Retrieved 2017-09-04.{{cite newsgroup}}: CS1 maint: url-status (link)
  27. 1 2 Paul, Matthias R. (2002-02-21). "GEOS/NDO info for RBIL62?". Newsgroup: comp.os.geos.programmer. Retrieved 2019-04-20.{{cite newsgroup}}: CS1 maint: url-status (link)
  28. ↑ Brown, Ralf D. [at Wikidata] (1989-04-30). "Interrupt list diffs INTERRUP.1ST v89.1 -> v89.2". Archived from the original on 2017-09-02. Retrieved 2017-09-01.
  29. ↑ Paul, Matthias R. (2002-07-01). "Re: Tastatur-Problem" (in German). Newsgroup: de.comp.lang.assembler.x86. Retrieved 2017-09-04.{{cite newsgroup}}: CS1 maint: url-status (link)
  30. ↑ Paul, Matthias R. (2001-05-27). "Re: A real or a RAM disk?". fd-dev. Topica. Archived from the original on 2017-09-03. Retrieved 2017-09-03.
  31. 1 2 Paul, Matthias R. (2001-10-25). "Re: Change \ to / in DOS". Newsgroup: alt.msdos.programmer. Retrieved 2017-09-03.{{cite newsgroup}}: CS1 maint: url-status (link)
  32. ↑ Paul, Matthias R. (2002-02-19). "[fd-dev] FYI: RBIL62 schedule / Contributing to Ralf Brown's Interrupt List". freedos-dev. Retrieved 2017-09-03.{{cite web}}: CS1 maint: url-status (link)
  33. 1 2 Paul, Matthias R. (2002-04-03). "[fd-dev] Ctrl+Alt+Del". freedos-dev. Retrieved 2017-09-09.{{cite web}}: CS1 maint: url-status (link)
  34. ↑ Paul, Matthias R. (2002-05-15). "CP/M-86 info and ancient PC hardware stuff for RBIL62?". Newsgroup: comp.os.cpm. Retrieved 2017-09-03.{{cite newsgroup}}: CS1 maint: url-status (link)
  35. ↑ Paul, Matthias R. (2002-10-05). "Re: Remote filesystem implementation in DOS". Newsgroup: comp.os.msdos.programmer. Retrieved 2017-09-03.{{cite newsgroup}}: CS1 maint: url-status (link)
  36. ↑ Paul, Matthias R. (2001-08-18). "Re: [fd-dev] On GRAFTABL and DISPLAY.SYS (Was: Changing codepages in FreeDOS)". freedos-dev. Retrieved 2017-09-04.{{cite web}}: CS1 maint: url-status (link)
  37. ↑ Paul, Matthias R. (2002-09-06). "Re: Reading Ctrl, Alt and Shifts..." Newsgroup: alt.lang.asm. Retrieved 2017-09-03.{{cite newsgroup}}: CS1 maint: url-status (link)
  38. ↑ Paul, Matthias R. (2002-08-13). "Re: Suche freien Speicherbereich unterhalb von 1 MB, der nicht von OS überschrieben wird" (in German). Newsgroup: de.comp.lang.assembler.x86. Retrieved 2017-09-03.{{cite newsgroup}}: CS1 maint: url-status (link)
  39. ↑ Paul, Matthias R. (2002-10-07). "Re: Run a COM file". Newsgroup: alt.msdos.programmer. Retrieved 2017-09-03.{{cite newsgroup}}: CS1 maint: url-status (link)
  40. ↑ Paul, Matthias R. (2002-10-07). "Re: masm .com (PSP) related trouble". Newsgroup: alt.lang.asm. Retrieved 2017-09-03.{{cite newsgroup}}: CS1 maint: url-status (link)
  41. ↑ Paul, Matthias R. (2002-10-09). "Re: COM style files larger than 64 Kb?". Newsgroup: alt.msdos.programmer. Retrieved 2017-09-03.{{cite newsgroup}}: CS1 maint: url-status (link)
  42. ↑ Paul, Matthias R. (2002-05-14). "Re: Probleme mit INT 9h" (in German). Newsgroup: de.comp.lang.assembler.x86. Retrieved 2017-09-04.{{cite newsgroup}}: CS1 maint: url-status (link)
  43. ↑ Paul, Matthias R. (2002-11-21). "Re: [fd-dev] Codepage IDs". freedos-dev. Retrieved 2017-09-04.{{cite web}}: CS1 maint: url-status (link)
  44. ↑ Paul, Matthias R. (2002-09-05). "Re: [fd-dev] NLS and lowercase". freedos-dev. Retrieved 2017-09-04.{{cite web}}: CS1 maint: url-status (link)
  45. ↑ Paul, Matthias R. (2002-04-01). "Fix for CauseWay DOS extender under DR-DOS 7.0x EMM386.EXE". Newsgroup: comp.os.msdos.programmer. Retrieved 2018-09-19.{{cite newsgroup}}: CS1 maint: url-status (link) (NB. Details some private DPMI/VCPI functions of DR-DOS EMM386.)