First steps towards system programming under MS-DOS 7/Appendix

Appendices

A.01 PC's main data structures

edit

Both BIOS and DOS store their important data in especially devoted areas of computer's memory. Data placement inside these areas is not fixed for ever and may depend on version of BIOS and DOS. Therefore data in system structures should not be addressed directly, but rather should be accessed via special functions, described in chapter 8 of this book. One more reason is that data can't be updated properly unless the corresponding service function is called for.

Nevertheless direct access to system data structures may be necessary. It enables to get more information than you are allowed to know via service functions. For debugging purposes you may need to see data "as they were", without being updated. You may need to intervene, to change certain settings in order to provoke desirable consequences. Of course, each such action is done exclusively at your own risk, but it may give you a chance, which otherwise would be lost.

A.01-1. BIOS data area

edit

Just when computer is switched on its BIOS system begins to gather data and arrange its data area. In AT-compatible computers the BIOS data area occupies 100h bytes at 0040:0000h–0040:00FFh. The table below gives general disposition of selected data items with references to separate data tables for floppy drives (A.08-1), video system (A.10-6), keyboard (A.02-3) and other hardware (A.11-1).

Offset Size Description
00h 2 Port COM-1 base I/O address
02h 2 Port COM-2 base I/O address
08h 2 Port LPT-1 base I/O address
0Eh 2 Auxiliary BIOS data segment (0000h if absent)
10h 2 Installed hardware word (A.11-1)
12h 1 Status of POST self-test
13h 2 Base memory size in kilobytes
17h 39 Keyboard's buffer and flags (A.02-3)
3Eh 7 Floppy drive status registers (A.08-1)
49h 22 Current video mode data (A.10-6)
67h 4 Restart address after CPU reset [Note 4 to A.12-1]
6Ch 4 Timer ticks, counted since midnight
70h 1 Count of days, reset after INT 1A\AH=00h call
71h 1 Bit 7 set after Ctrl-Break keystroke
72h 2 Prescribed action of POST test [Note 1]
74h 1 HDD's last operation error code (A.06-01)
75h 1 Number of hard disk drives
77h 1 Hard disk drive I/O port address
78h 1 Port LPT-1 timeout counter
7Ch 1 Port COM-1 timeout counter
7Dh 1 Port COM 2 timeout counter
80h 4 Keyboard buffer's start and end offsets (A.02-3)
84h 8 Video control registers (A.10-6)
8Ch 3 HDD controller's status registers
8Fh 7 Floppy drive controller's information (A.08-1)
96h 2 Keyboard's status bytes (A.02-3)
98h 4 Pointer to wait-complete flag (INT 15\AX=8300h)
9Ch 4 Timer's wait count in microseconds
A0h 1 System timer's flags:
bit 0: a call for INT 15\AH=86h has occurred
bit 7: waiting time has elapsed
CEh 2 Count of days since last boot
F0h 16 Intra-application communication area
Notes
  1. ^ a b After a reboot, initiated by a jump far to F000:FFF0h address,[Note 4 to A.12-1] POST test performance depends on contents, preserved in 0040:0072h memory cell :
    0000h – "cold" boot (full POST with memory test)
    1234h – "warm" boot (bypass memory test)
  2. Since data disposition in BIOS data area may depend on BIOS version, it is for you to decide, whether the data item at any particular offset is indeed the one you expect to find there.

A.01-2 Selected entries in DOS' list-of-lists

edit

List-of-lists is the basic data structure, created by IO.SYS loader at start of DOS loading procedure. A pointer to first byte of DOS's list-of-lists is returned by INT 21\AH=52h function (8.02-59). Fig.10 (in appendix A.03-3) illustrates process of access to list-of-lists. Selected information about data items in DOS's list-of-lists is given in the following table.

Offset Size Description
– 02h 2 Segment address of the first MSB (A.12-7)
00h 4 Pointer to the first DPB block [Note 1]
04h 4 Pointer to SFT (System File Table, A.01-4)
0Ch 4 Pointer to active CON (Console) device driver
10h 2 Maximum bytes per sector on any drive
16h 4 Pointer to first record in CDS structure (A.03-3)
20h 1 Number of registered drives (block devices)
21h 1 Number of records in CDS structure (A.03-3)
22h 18 Actual NUL device driver header [Note 2]
34h 1 Number of virtual drives created by JOIN.EXE
37h 4 Pointer to SETVER's table (0000:0000h if none)
3Dh 2 PSP segment of the last executed program
43h 1 Boot drive (01h = A:, 03h = C:, and so on)
45h 2 Extended memory size (in kilobytes).
Notes
  1. ^ DPB blocks (Drive Parameter Blocks, A.03-1) are arranged in a chain, so that a pointer to the next DPB is at offset 19h in the previous DPB.
  2. ^ NUL device driver header at offset 22h is the first in a chain of driver headers. First dword in each header is a pointer to the next header. Another way to obtain a pointer to the second driver header is via INT 2F\AX=122Ch. Last header in the chain begins with word FFFFh.

A.01-3. Selected items in DOS's swappable data area

edit

Current address and size of DOS's swappable data area (SDA) are returned by INT 21\AX=5D06h function (8.02-70). SDA stores continuously updated data, including main DOS's system stacks. These data reflect ever changing DOS's status at each current moment. Total size of swappable area may be as large as several kilobytes, it depends on size of the stacks.

The SDA area is named "swappable", because its swapping is the main mechanism of obtaining DOS's re-enterability, i.e. opportunity to call DOS's functions by TSRs and handlers, which themselves may be called while execution of previous DOS's function hasn't been finished. If interrupt handler reveals that either critical error flag (at offset 00h in SDA) or InDOS flag (at offset 01h in SDA) have a non-zero value, hence a call for this handler has interrupted execution of a DOS's function, and then the next call for any DOS's function can change data in SDA area so that a return back to proper resumption of the interrupted program will become impossible. Though sometimes resumption of interrupted program is possible (8.02-28, 8.02-87), nevertheless the most radical solution is to save contents of SDA before any DOS's function is called, and to restore SDA state afterwards on basis of the saved data. It also should be taken into account that INT 21\AX=5D06h function itself (8.02-70) is non-reentrant; therefore a call for SDA's address should be performed beforehand, during handler's initialization, so that at the moment of interrupt the handler may read a prepared SDA address without a new call for INT 21\AX=5D06h.

The table below shows selected data items inside swappable data area

Offset Size Description
00h 1 Critical error flag ("ErrorMode")
01h 1 InDOS flag (INT 21\AH=34h, 8.02-28)
02h 1 Drive, caused critical error, or FFh if no error
03h 1 Locus of the last error (A.06-4)
04h 2 Extended code of the last error (A.06-1)
06h 1 Suggested action after the last error (A.06-3)
07h 1 Class of the last error (A.06-2)
08h 4 ES:DI pointer at the moment of last error
0Ch 4 Current address of DTA (8.02-16)
10h 2 Current program's PSP segment (process identifier)
14h 2 Errorlevel value from last program's termination
16h 1 Current logical disk number
17h 1 The BREAK flag (3.01, 4.02, 8.02-25)
2Ah 1 Flag of FAIL response to INT 24 (8.02-84) call
2Bh 1 Allowable INT 24 actions (8.02-84)
30h 1 Day of month
31h 1 Month
32h 2 Year, counted from 1980
34h 2 Number of days since 01-01-1980
36h 1 Day of week (0 = Sunday)

A.01-4 System File Table structure

edit

Associations between access handles and the corresponding "opened" objects are stored by DOS in a chain-like queue of tables, named SFT (System File Tables). This name is not quite correct, because "opened" objects may be not files only, but also allotted XMS areas, driver's access channels and other objects, known as "character devices".

A pointer to the first SFT is at offset 04h in the list-of-lists (A.01-2). Each SFT begins at offset 00h with a dword pointer to the next SFT, except the last one, which is marked with word FFFFh at offset 00h. Such structure can easily be traced through from the first SFT to the last. A word at offset 04h in each SFT declares number of entries in this particular SFT. Each entry corresponds to one "opened" object. Total number of SFT entries is limited by FILES specification in CONFIG.SYS file (4.12).

Numbers of SFT entries, which are "opened" to a given program, are stored in JFT at offset 18h inside PSP (A.07-1), belonging to this program. The corresponding "opened" objects are addressed to with handles (INT 21\AH=3Dh, 8.02-33), which identify SFT entries according to disposition order of their numbers in JFT. The number of SFT entry, corresponding to a given handle, can be found also with INT 2F\AX=1220h (8.03-11). Then INT 2F\AX=1216h function (8.03-09), being given the SFT entry number, returns a pointer to this entry. Some information about active SFT entries and corresponding objects can be obtained via INT 21\AX=4400h function (8.02-40).

The first three SFT entry numbers have fixed default associations: 00h – AUX channel (COM1 port), 01h – the CON device (console), 02h – the PRN device (LPT1 port). These 3 SFT entry numbers are automatically written into JFT table of each program. Order of their disposition in JFT (01h, 01h, 01h, 00h, 02h) defines associated handles: 0000h – for STDIN channel, 0001h – for STDOUT channel, 0002h – for STDERR channel, 0003h – for COM1 port, 0004h – for LPT1 port. SFT entries for handles 0005h and on are created on requests by INT 21\AH=3Dh (8.02-33) and by INT 21\AX=6C00h (8.02-78) functions.

The first entry in each SFT table starts at offset 06h. As far as each entry has fixed length 3Bh, start points of the following entries can be easily calculated. The table below specifies selected data items inside each entry with offsets counted from start point of that entry. The first column "CDE" of the table corresponds to "character device" entries, the second column "OFE" – to entries, associated with ordinary files.

CDE OFE Size Description
00h 00h 2 Number of handles to the object (FFFFh if none)
02h 02h 1 Access and sharing conditions (A.09-4)
  03h 1 Flags [Note 1]
  04h 1 File's attributes (A.09-2)
05h 05h 2 Object's info word (A.04-2 for files, A.05-2 for others)
07h 07h 4 Pointer to DPB (A.03-1) for files or pointer to driver's header (A.05-1) for other objects
  0Bh 2 Starting cluster number (for local files only)
  0Dh 2 File's packed time (INT 21\AX=5700h, 8.02-63)
  0Fh 2 File's packed date (INT 21\AX=5700h, 8.02-63)
  11h 4 File's size
  15h 4 File's pointer position (INT 21\AH=42h, 8.02-38)
  19h 2 Relative number of the last cluster accessed
19h   4 Pointer to IFS redirector records
  1Bh 4 Number of directory sector containing file's entry
  1Fh 1 Number of file's entry in directory sector
20h 20h 11 Name in FCB-format (A.09-5) of file or other object
  31h 2 Identifier (PSP segment) of file's owner process
  35h 2 Absolute number of the last accessed cluster
37h   4 Pointer to IFS-driver or 0000:0000h for ordinary files
Notes
  1. ^ Flags byte at 03h includes all BH register settings, specified for INT 21\AX=6C00h function (8.02-78). Besides this, set state of bit 7 in flags byte marks files opened by means of FCB.

A.02 Keyboard codes and national adaptation

edit

A.02-1 Key codes

edit

User's control over PC via keyboard must be enabled always, even when operating system isn't loaded yet. Therefore motherboard's hardware and BIOS system are responsible for compatibility with different types of keyboards. Just when PC is switched on, its BIOS system loads INT 09 and INT 16 handlers, providing various keyboard functions.

Keyboard signals are received and transformed by keyboard controller. It responds to each change of key's state (press or release) with preparing code for port 60h and sending a request via IRQ 01 interrupt request line. Request invokes the INT 09 handler. Some keys induce keyboard controller to send a succession of codes, so that INT 09 handler is invoked several times. The code, read by INT 09 handler from port 60h, is most often the scan code of some key, but it may be a service code. Codes from E0h to FFh, and also 00h and AAh are interpreted as service codes. Service codes, charged with a special keystroke identification mission, are known as prefixes :

E0h – prefix for discrimination between those keys, which for the sake of compatibility with obsolete 84-key keyboards have been given identical scan codes.
E1h – prefix for keys having a two byte scan code. In ordinary keyboards there is only one such key: Pause/Break.[Note 6]

Reading of a prefix from port 60h makes INT 09 handler prepared to a specific interpretation of that scan code, which will be received by the next call for INT 09. In the second column (INT 09) of the table below hexadecimal scan codes of keystrokes are shown, read by INT 09 handler from port 60h. Key release codes are not shown in the table, because release codes can be easily derived from keystroke codes by making its 7th bit set. For example, key "A" sends keystroke (press) code 1Eh, hence its release code is 9Eh. But those scan codes, which are sent preceded by a prefix either E0h or E1h, are shown in the second table's column together with this prefix. Naturally, release codes of the same keys are preceded by the same prefix.

"Raw" scan code, read from port 60h, is translated by INT 09 and INT 16 handlers into a new pair — a unified scan code and ASCII value, corresponding to the pressed (or released) key. Just this data pair will be presented to program, sending a request for keyboard input via INT 16. Unified scan-code most often is equal to press scan code, but may be altered, if at the same time a "functional" key is kept pressed: SHIFT, CTRL, or ALT. Each "functional" key has its own scan code (in second column of the table below). Scan codes of "functional" keys are taken into account by INT 09 handler, but are not stored in keyboard buffer. States of "functional" keys are expressed otherwise: via a status word, returned by INT 16\AH=12 function (8.01-85).The following table represents keys of the most widely used 104-key "enhanced" keyboard. The word "num" before a key name in the first table's column denotes keys of a numeric keypad at the right side of keyboard. The shown codes for such keys correspond to turned OFF state of NUMLOCK switch.[Note 6] Data order is defined by key's scan codes values in the second table's column.

Hexadecimal numbers in columns 3–6 of the table below represent the data, returned in AX register by INT 16\AH=10h function (8.01-83). Left two digits in each number define unified scan-code, returned in AH register, and the right two digits — ASCII code of corresponding character, returned in AL register. Data in the 3rd column (AX) correspond to keystrokes, not accompanied by keeping pressed any "functional" key. Data in the 4th column (SHIFT) correspond to the case when SHIFT key is kept pressed, data in the 5th column (CTRL) — to the case of keeping pressed the CTRL key, data in the 6th column (ALT) — to the case of keeping pressed the ALT key. Blank space in place of any particular value means that corresponding key or key combination is sensed by BIOS, but isn't reported via INT 16 handler.

Keys INT09 AX SHIFT CTRL ALT Comments
Esc 01 011B 011B 011B 0100 [Note 1]
1 ! 02 0231 0221   7800
2 @ 03 0332 0340 0300 7900
3 # 04 0433 0423   7A00
4 $ 05 0534 0524   7B00
5 % 06 0635 0625   7C00
6 ^ 07 0736 075E 071E 7D00
7 & 08 0837 0826   7E00
8 * 09 0938 092A   7F00
9 ( 0A 0A39 0A28   8000
0 ) 0B 0B30 0B29   8100
_ 0C 0C2D 0C5F 0C1F 8200
= + 0D 0D3D 0D2B   8300
Backspace 0E 0E08 0E08 0E7F 0E00 [Note 1]
Tab 0F 0F09 0F00 9400 A500 [Note 1][Note 2]
Q 10 1071 1051 1011 1000
W 11 1177 1157 1117 1100
E 12 1265 1245 1205 1200
R 13 1372 1352 1312 1300
T 14 1474 1454 1414 1400
Y 15 1579 1559 1519 1500
U 16 1675 1655 1615 1600
I 17 1769 1749 1709 1700
O 18 186F 184F 180F 1800
P 19 1970 1950 1910 1900
[ { 1A 1A5B 1A7B 1A1B 1A00 [Note 1]
] } 1B 1B5D 1B7D 1B1D 1B00 [Note 1]
Enter 1C 1C0D 1C0D 1C0A 1C00 [Note 1]
num Enter E0 1C E00D E00D E00A A600 [Note 1][Note 3]
Left Ctrl 1D         [Note 4]
Right Ctrl E0 1D         [Note 4]
A 1E 1E61 1E41 1E01 1E00
S 1F 1F73 1F53 1F13 1F00
D 20 2064 2044 2004 2000
F 21 2166 2146 2106 2100
G 22 2267 2247 2207 2200
H 23 2368 2348 2308 2300
J 24 246A 244A 240A 2400
K 25 256B 254B 250B 2500
L 26 266C 264C 260C 2600
; : 27 273B 273A   2700 [Note 1]
' " 28 2827 2822   2800 [Note 1]
` ~ 29 2960 297E   2900 [Note 1]
Left Shift 2A         [Note 4]
SysRq E0 2A     7200   [Note 5]
\ | 2B 2B5C 2B7C 2B1C 2B00 [Note 1]
Z 2C 2C7A 2C5A 2C1A 2C00
X 2D 2D78 2D58 2D18 2D00
C 2E 2E63 2E43 2E03 2E00
V 2F 2F76 2F56 2F16 2F00
B 30 3062 3042 3002 3000
N 31 316E 314E 310E 3100
M 32 326D 324D 320D 3200
, < 33 332C 333C   3300 [Note 1]
. > 34 342E 343E   3400 [Note 1]
/ ? 35 352F 353F   3500 [Note 1]
num / E0 35 E02F E02F 9500 A400 [Note 1][Note 2][Note 3]
Right Shift 36         [Note 4]
num * 37 372A 372A 9600 3700 [Note 1][Note 2]
Left Alt 38         [Note 4]
Right Alt E0 38         [Note 4]
Spacebar 39 3920 3920 3920 3920
Caps Lock 3A         [Note 4]
F1 3B 3B00 5400 5E00 6800
F2 3C 3C00 5500 5F00 6900
F3 3D 3D00 5600 6000 6A00
F4 3E 3E00 5700 6100 6B00
F5 3F 3F00 5800 6200 6C00
F6 40 4000 5900 6300 6D00
F7 41 4100 5A00 6400 6E00
F8 42 4200 5B00 6500 6F00
F9 43 4300 5C00 6600 7000
F10 44 4400 5D00 6700 7100
NumLock 45         [Note 4]
Pause E1 1D 45         [Note 4][Note 6]
ScrollLock 46         [Note 4]
num 7 47 4700 4737 7700 0007 [Note 7]
Home E0 47 47E0 47E0 77E0 9700 [Note 1][Note 3]
num 8 48 4800 4838 8D00 0008 [Note 2][Note 7]
Arrow Up E0 48 48E0 48E0 8DE0 9800 [Note 1][Note 2][Note 3]
num 9 49 4900 4939 8400 0009 [Note 7]
PgUp E0 49 49E0 49E0 84E0 9900 [Note 1][Note 3]
num − 4A 4A2D 4A2D 8E00 4A00 [Note 1][Note 2]
num 4 4B 4B00 4B34 7300 0004 [Note 7]
LeftArrow E0 4B 4BE0 4BE0 73E0 9B00 [Note 1][Note 3]
num 5 4C 4C00 4C35 8F00 0005 [Note 2][Note 7]
num 6 4D 4D00 4D36 7400 0006 [Note 7]
RightArrow E0 4D 4DE0 4DE0 74E0 9D00 [Note 1][Note 3]
num + 4E 4E2B 4E2B 9000 4E00 [Note 1][Note 2]
num 1 4F 4F00 4F31 7500 0001 [Note 7]
End E0 4F 4FE0 4FE0 75E0 9F00 [Note 1][Note 3]
num 2 50 5000 5032 9100 0002 [Note 2][Note 7]
ArrowDown E0 50 50E0 50E0 91E0 A000 [Note 1][Note 2][Note 3]
num 3 51 5100 5133 7600 0003 [Note 7]
PgDn E0 51 51E0 51E0 76E0 A100 [Note 1][Note 3]
num 0 52 5200 5230 9200   [Note 2][Note 7]
Ins E0 52 52E0 52E0 92E0 A200 [Note 1][Note 2][Note 3]
num . 53 5300 532E 9300   [Note 2][Note 7]
Del E0 53 53E0 53E0 93E0 A300 [Note 1][Note 2][Note 3]
F11 57 8500 8700 8900 8B00 [Note 8]
F12 58 8600 8800 8A00 8C00 [Note 8]
LeftWin E0 5B B6E0 C2E0 CEE0 DAE0 [Note 8]
RightWin E0 5C B7E0 C3E0 CFE0 DBE0 [Note 8]
Menu E0 5D B8E0 C4E0 D0E0 DCE0 [Note 8]
Notes
  1. ^ The INT16\AH=00h function doesn't respond to this keystroke when "functional" key ALT is kept pressed.
  2. ^ The INT16\AH=00h function doesn't respond to this keystroke when "functional" key CTRL is kept pressed.
  3. ^ The INT16\AH=00h function returns 00h instead of ASCII code E0h, except for two keystrokes : after "num /" it returns ASCII code 35h, after "num Enter" keystroke it returns ASCII code 1Ch.
  4. ^ Code of this key is not written into keyboard buffer, but it does affect translation of other key's codes by INT 09 handler.
  5. ^ Keyboard controller responds to SysRq keystroke with "E0 2A E0 37" codes succession, and to SysRq key release — with inverse succession "E0 B7 E0 AA". Some INT 16 handlers may return other response to CTRL-SysRq key combination.
  6. ^ a b c d Release of Pause/Break key is not registered separately. After each Pause/Break keystroke its press code is immediately followed by release code, forming a succession "E1 1D 45 E1 9D C5". Having received such succession of codes, the INT 09 handler resets keyboard buffer and calls for INT 1B (8.01-95).
  7. ^ The shown codes for this key correspond to turned OFF state of Numlock switch. When NumLock switch is turned ON, codes shown in 3rd and in 4th columns of the table get exchanged.
  8. ^ The INT 16\AH=00h function gives no response to these keys.
  9. Several models of keyboards have three auxiliary keys for power control : "Power", "Sleep" and "Wake Up". Corresponding scan codes for these keys are E0 5E, E0 5F, E0 63.

A.02-2 Keyboard layouts and national codepages

edit

The following table comprises data for MS-DOS 7 national adaptation by those means, which are supplied in Microsoft's Windows 95/98 release. These means include data file COUNTRY.SYS, three files with keyboard layouts (KEYBOARD.SYS, KEYBRD2.SYS and KEYBRD3.SYS), and four files with fonts for different codepages (EGA.CPI, EGA2.CPI, EGA3.CPI and ISO.CPI).

The first column (Abbr) in this table contains literal country codes, the third column (ID) – keyboard layout identifiers. Both these items are needed for KEYB.COM driver's (5.02-04) command line composition. Layout identifier is necessary for those countries only, where more than one keyboard's layout is used, for other countries it may be omitted.

The 4th column (Keyb) of the table specifies which file with keyboard layout should be loaded : digit 1 corresponds to KEYBOARD.SYS, digit 2 – to KEYBRD2.SYS, digit 3 – to KEYBRD3.SYS, word "Any" – to either of these three files.

The 5th column (Code) of the table shows numeric country code, used for loading COUNTRY.SYS data file (5.02-01) with COUNTRY command (4.05).

Last 7th column of the table shows codepages used in various countries. Number of a codepage is needed for MORE.COM utility (6.18), which has to select one font from a group of fonts in each *.CPI file (example in 9.01-02). The ISO.CPI file supplies fonts, recommended by International Standards Organization. Proprietary Microsoft's fonts are in EGA*.CPI files, about 5 fonts in each. Therefore 6th table's column (Ega*) specifies which one of EGA*.CPI files should be loaded: digit 1 corresponds to file EGA.SYS, digit 2 – to EGA2.CPI, digit 3 – to EGA3.CPI, word "Any" – to either of these files.

Abbr Country ID Keyb Code Ega* Codepage
GR Austria Any 043 Any CP850
BE Belgium 1,2 032 Any CP850
BG Bulgaria 442 2 359 3 CP855
BR Brazil 274, 275 1,2 055 Any CP850
CF Canada French 058 1,2 002 1 CP863
CZ Czech Republic 243 Any 042 Any CP852
DK Denmark 1,3 045 1 CP865
SU Finland Any 358 Any CP850
FR France 120, 189 1,3 033 Any CP850
GR Germany Any 049 Any CP850
GK Greece 319 2 030 2 CP737, 869
HU Hungary Any 036 Any CP852
IS Iceland 161 2 354 2 CP861
IT Italy 141,142 Any 039 Any CP850
LA Latin America 1 003 Any CP850
NL Netherlands 1,3 031 Any CP850
NO Norway 1,2 047 1 CP865
PL Poland Any 048 Any CP852
PO Portugal 1 351 1 CP860
RO Romania 333 2 040 Any CP852
RU Russia 441 2,3 007 3 CP866
SL Slovakia 245 Any 421 Any CP852
SP Spain 1,3 034 Any CP850
SV Sweden Any 046 Any CP850
SF Switzerland French 1,3 041 Any CP850
TR Turkey 440, 179 2 090 2 CP857
UK Britain + Ireland 166, 168 Any 044 Any CP850
US USA + Australia Any 001 1,3 CP437
YC Yugoslavia Cyrillic 118 2 038 3 CP855
YU Yugoslavia Latin 234 Any 038 Any CP852

Note 1: KEYBOARD.SYS is the only file, which supports typewriter mode of keyboard layout.

Note 2: Microsoft's files for national adaptation are not compatible with KEYRUS.COM driver (5.02-05). The latter uses internal code tables and keyboard layouts.

Note 3: fonts for some other countries (China, Israel, Japan, etc.) are supplied exclusively with special national versions of Microsoft's operating systems.

A.02-3 Keyboard data fields in BIOS data area

edit

The following table shows disposition of keyboard data in BIOS data area. All offsets are given relative to segment address 0040h, where BIOS data area starts.

Offset Size Description
17h 2 Flags, returned in AX by INT 16\AH=12h (8.01-85)
19h 1 Character input via ALT followed by ASCII code
1Ah 2 Pointer to the next character in keyboard buffer
1Ch 2 Pointer to the first free cell in keyboard buffer
1Eh 32 Keyboard's circular buffer
71h 1 Flag: bit 7 set if Ctrl-Break has been pressed
80h 2 Keyboard buffer's start offset (normally 1Eh)
82h 2 Keyboard buffer's END+1 offset (normally 3Eh)
96h 1 Flags: bit 0 set: last code read was E1h prefix
      bit 1 set: last code read was E0h prefix
      bit 2 set: right CTRL key has been pressed
      bit 3 set: right ALT key has been pressed
      bit 4 set: "enhanced" keyboard is installed
      bit 6 set: 1st byte is received of 2-byte scan-code
97h 1 Status: bit 0 set: the Scroll Lock LED is switched ON
      bit 1 set: the Num Lock LED is switched ON
      bit 2 set: the Caps Lock LED is switched ON
      bit 7 set: keyboard has sent error flag

Note 1: presented data disposition may depend on BIOS version (A.01-1).

A.02-4 National adaptation parameters block

edit

Data block with currently active national adaptation parameters is returned by INT 21\AX=6501h function (8.02-74). Data block of the same structure is accepted by INT 21\AX=7002h function (note 3 to 8.02-74), defining national adaptation for MS-DOS 7.

Offset Size Description
00h 1 = 01h on return [Note 1]
01h 2 Table size on return [Note 1]
03h 2 Country code in hexadecimal form (A.02-2)
05h 2 Hexadecimal codepage number (A.02-2)
07h 2 Date format:
= 0000h – American (mm dd yy)
= 0001h – European (dd mm yy)
= 0002h – Japanese (yy mm dd)
09h 5 ASCII currency name, ending with 00h byte
0Eh 2 Thousands separator for numbers
10h 2 Integer and fractional parts separator
12h 2 ASCII date separator character
14h 2 ASCII time separator character
16h 1 bit 0 set: currency symbol follows value (else precedes)
    bit 1 set: space between value and currency symbol
    bit 2 set: currency symbol replaces decimal point
17h 1 Number of digits after decimal point in currency
18h 1 bit 1 set: 24-hour clock, else 12-hour clock
19h 4 Entrance address of case map routine [Note 2]
2Dh 2 ASCII data-list separator character
Notes
  1. ^ When data block is sent to INT 21\AX=7002h function, then this item is ignored.
  2. ^ Case map routine translates national characters (with ASCII codes larger than 80h) into upper case and back. The case map routine should be called for with CALL FAR command (7.03-08). AL register is used for both sending ASCII code of the character to be translated and for returning the result back.

A.02-5 Country-dependent restrictions for filenames

edit

A pointer to this table is returned by INT 21\AX=6505h function (note 1 to 8.02-74).

Offset Size Description
00h 2 Table's size (this word shouldn't be counted)
03h 1 Lowest permissible character value for filenames
04h 1 Highest permissible character value for filenames
06h 1 First character's value of prohibited range
07h 1 Last character's value of prohibited range
09h 1 Number ("N") of filenames terminating codes
0Ah N ASCII codes used to terminate filenames

A.02-6 Information about available code pages

edit

The following table shows structure of DISPLAY.SYS (5.02-02) driver's data block ; a pointer to this block is returned by INT 2F\AX=AD03h function (8.03-27).

Offset Size Description
00h 2 number M of codepages, specified by configuration
04h 2 number N of codepages, loaded by default
06h 2N identifiers of codepages, loaded by default
06h+2N 2M identifiers of codepages, specified by configuration (or = FFFFh if configuration isn't prepared yet)

A.02-7 Definition of "hot" keys in AMIS specification

edit

Common practice for TSR programs is assignment of functions to predetermined "hot" keys irrespective to which keys have been charged yet with other missions by previously loaded TSR programs. The least harmful outcome of this practice is a loss of opportunities to invoke functions of previously loaded TSR programs and drivers. A real chance to prevent interception of "hot" key functions is suggested by AMIS specification (A.07-6). According to AMIS specification, resident modules must respond to calls for multiplex interrupt INT 2D with operation code AL = 05h, returning in DX:BX registers a pointer to a list of their active "hot" keys. Any program, which intends to arrange its own "hot" keys, should be given access to data about previous "hot" key assignments.

The first byte, at offset 00h from the start of "hot" keys list, informs about "hot" calls interception method.[Note 1] The second byte at offset 01h is a number of "hot" keys, kept active by responding resident module. This number also defines total length of the returned list, because after the second byte, starting at offset 02h, a group of "hot" key descriptors follows, each 6 bytes long. Structure of these descriptors is shown in table below. Offsets in the table are counted from start of each descriptor.

Offset Size Description Comments
00h 1 Scan-code of the "hot" key [Note 2]
01h 2 Required shift states [Note 3]
03h 2 Disallowed shift states [Note 4]
05h 1 Auxiliary key's flags [Note 5]
Notes
  1. ^ Byte at offset 00h in "hot" keys list informs about "hot" calls interception method. Bit 7 in this byte must be cleared; other bits have the following meaning :
    bit 0 set : interception before INT 09 handler
    bit 1 set : interception after INT 09 handler
    bit 2 set : interception before INT 15\AH=4Fh
    bit 3 set : interception after INT 15\AH=4Fh
    bit 4 set : interception of INT 16\AH=00h,01h,02h calls
    bit 5 set : interception of INT 16\AH=10h,11h,12h calls
    bit 6 set : interception of INT 16\AH=20h,21h,22h calls.
  2. ^ If the most significant bit of scan-code is clear, hence actuation is registered when the key is pressed; if the most significant bit of scan code is set, hence actuation is registered when the key is released. If actuation is caused exclusively by a specific states combination of "functional" keys, then 00h or 80h values should be specified instead of scan code.
  3. ^ A word of required shift states is almost identical to the word of keyboard flags, returned by INT 16\AH=12h function (8.01-85). The only difference is the meaning of bit 7: in a word of required shift states it corresponds to keeping pressed either (left or right) SHIFT key. Set state of any bit in a word of required shift states specifies a necessary condition for "hot" key actuation.
  4. ^ Bits in a word of disallowed shift states have the same meaning, as in a word of required shift states,[Note 3] but their set state expresses the opposite condition : prevention of "hot" key actuation. Combination of required and disallowed conditions helps to decrease probability of false actuations.
  5. ^ The last byte in each "hot" key descriptor is a byte of auxiliary flags. Bits 6 and 7 in this byte must be cleared; states of other bits have the following meaning :
    bit 0 set: – actuation before module's execution
    bit 1 set: – actuation after module's execution
    bit 2 set: – monitoring interception is allowed
    bit 3 set: – actuation is blocked by other keys
    bit 4 set: – role of this "hot" key is redefined
    bit 5 set: – actuation depends on execution conditions.

A.02-8. ASCII service marks and commands

edit

Positions 0–31 in American Standard Code for Information Interchange (ASCII) are devoted to service marks and commands. All DOS's codepages have inherited these 32 service codes. Under MS-DOS 7 most part of these service codes is ignored, but some are executed as commands.

Some service codes can be entered by key combinations, described in article 1.05. Another way to input service codes is by their decimal ASCII number (0–31) with keys in numeric keypad while the ALT key is kept pressed.

First response to entered service code may be got from input module of the CON (console) device driver. Further response may be given by command interpreter. When a service code is sent to output, BIOS system enables to execute it as a command (8.01-21, 8.01-33) or to avoid its execution (8.01-17) as well. By default the output module of the CON (console) device driver doesn't attempt to avoid execution of some service codes. Such behavior may be altered by sending a parameters string (8.02-41) to the CON device driver, but there is no reason to do this because DOS programs are allowed to output data directly via desirable BIOS function(s).

Sometimes ASCII service codes may be useful, but it must be known beforehand, where and how each particular service code will be interpreted. Therefore the following table shows a list of those service codes, which are active under MS-DOS 7, with description of actions, associated with these codes.

Code Number Description
00h 0 End marker of interpreted lines, including lines with names and with environmental variable's values.
03h 3 "End of Text" marker, terminates execution of command files (example in article 3.21).
07h 7 "Beep" code. Being sent to output, it causes a short sound signal.
08h 8 Shifts cursor one character cell leftwards. Being sent via CON device driver, erases the last character.
09h 9 Horizontal tabulation code. Being sent to display, it is automatically expanded into 8 spaces.
0Ah 10 "Line feed" code, causes transition to the next line without cursor's return to start of line.[Note 1]
0Ch 12 Command "Eject Sheet" for printers. Both BIOS and CON device driver ignore this command.
0Dh 13 "Carriage Return" code, returns cursor to start of a line. Also marks end of line in DTA region (8.02-16).
1Ah 26 Optional end mark for textual files; at this mark copying of a file may be disrupted (3.06).
1Bh 27 "Escape" code is used as marker for commands, addressed to ANSI.SYS driver (if installed).
Notes
  1. ^ Service codes 0Dh 0Ah together are used as end-of-line marker in all textual files typed under DOS.
  2. There is a non-zero probability to encounter resident modules, responding to some service codes, which are not shown here and normally are ignored under DOS.

A.03 Disks access databases

edit

A.03-1. Structure of Drive Parameters Blocks (DPB)

edit

DOS stores disk access parameters in DPB blocks – one per each available logical disk of any kind, and in one more copy of such block for default (current) drive. The INT 21\AX=7302h function (8.02-79) enables to copy any DPB block into a prepared buffer. Pointers to DPB blocks are returned by INT 21\AH=1Fh and by INT 21\AH=32h functions (8.02-24), documented in previous versions of DOS. In fig.8 below the whole access path to disk's C: DPB block is shown, including a call for INT 21\AH=32h function, reading block's address 00C9:13C0h from DS:BX registers and display of DPB block's dump. In the displayed dump at offset 19h there is address 00C9:13FDh of the next DPB block, related to next logical disk D:. A dump of DPB block for disk D: is also shown in fig.8.

 
Fig. 8

The mentioned legal functions of access to DPB blocks automatically attempt to read the requested disk in order to update data in DPB block. This makes program's execution slower and sometimes can't be applied to removable media, which may be absent in the drive at that moment. Alternative is to read DPB block's address from a cell at offset 45h in CDS entry (A.03-3) of the same disk.

All DPB blocks have the same structure as that shown below. Bytes up to offset 20h are the same as in previous DOS versions, but bytes beyond offset 20h are specific for extended DPB blocks in MS-DOS 7.

Offset Size Description
00h 1 Logical disk number (00h = A:, 02h = C:, and so on)
01h 1 Disk's number in driver's list of disks
02h 2 Sector size (in bytes)
04h 1 Highest sector number in a cluster
05h 1 Shift count to convert clusters into sectors
06h 2 Number of reserved sectors (preceding FAT)
08h 1 Number of FAT tables
09h 2 Maximum number of root directory entries
0Bh 2 Number of first sector containing user data
0Dh 2 Highest cluster number (number of clusters + 1)
0Fh 2 Number of sectors per FAT table
11h 2 Sector number of root directory first sector
13h 4 Pointer to disk's driver header (A.05-1)
17h 1 Media ID byte (INT 21\AH=1Ch, 8.02-17)
18h 1 Flags (= 00h if disk was accessed, or = FFh if not)
19h 4 Pointer to DPB block for the next disk
1Dh 2 Cluster at which to start search for free space
1Fh 2 Number of free clusters on disk (FFFFh if unknown)
21h 2 Most significant word of free cluster count
23h 2 – bits 0–3 : zero-based FAT number of active FAT
    – bit 7 : don't copy active FAT to inactive FATs
25h 2 Number of FAT information sector [Note 2]
27h 2 Sector number of backup boot-sector
29h 4 First sector number of the first disk's cluster
2Dh 4 Number of the last disk's cluster
31h 4 Number of sectors occupied by FAT
35h 4 Cluster number where root directory starts
Notes
  1. Data in DPB block are translated from BPB block (A.03-4) of the same disk by means of INT 21\AH=53h function.
  2. ^ a b A word FFFFh at offset 25h means that there is no FAT information sector on a requested disk. If FAT information sector is present, it contains at offset 00h a fixed double-word signature 61417272h, the second double word at offset 04h is number of free clusters (or FFFFFFFFh if unknown), the third double word at offset 08h is a number of the most recently allocated cluster.

A.03-2 Disk data tables (DDT)

edit

DDT tables represent a special database for block device drivers, integrated into DOS's core. DDT tables correspond to local disks, which are properly detected and supported by BIOS, including those emulated by BIOS from disk's images on bootable CD/DVD-ROMs. There are no DDT tables for IFS drives, dummy disks, RAM-disks and all other disks, opened for access by drivers, specified in configuration files.

DDT tables are arranged as a chain-like queue of tables, each 96h bytes long. A pointer to the first table is returned by INT 2F\AX=0803h function (8.03-04). This is enough to trace the whole queue, since the first double word in each table is a pointer to DDT table for the next logical disk. The table having the first word FFFFh is the last one in the chain.

 
Fig. 9

Fig.9 illustrates access to DDT tables for disks A:, B: and C:, including a call for INT 2F\AX=0803h function, reading the returned address (0B52:0000h) of the first DDT table from DS:DI registers, display of a partial dump of DDT table for disk A:, reading from the first 4 bytes of that dump the address (0B52:0096h) of DDT table for the next disk B:, display of a partial dump of DDT table for disk B:, and repetition of the last two operations relative to DDT table for disk C:.

The table below shows data structure in one DDT table. The same data structure is accepted by INT 2F\AX=0801 function (8.03-02), appending a chain of DDT tables with a one more table for a new logical disk.

Offset Size Description
00h 4 Pointer to next DDT table (or FFFFh if the last table)
04h 1 Corresponding physical drive number :
from 00h and on for floppy disk drives
from 80h and on for hard (fixed) disk drives
05h 1 Logical disk number in a list of disks, accessed by DOS's core drivers. If disk's letter-names were not reassigned, then 00h = A:, 02h = C:, and so on.
06h 25 Current disk's BPB block (up to offset 19h, A.03-4)
3Bh 1 – bit 6 : file system FAT-16,
    – bit 7 : disk must return "Not Ready" to all appeals
3Ch 2 Counter of opened files belonging to this disk
3Eh 1 Device type (as byte at offset 01h in table A.04-3)
3Fh 2 – bit 0 : fixed hard disk
    – bit 1 : door lock ("changeline") supported
    – bit 2 : changes of current BPB are not allowed
    – bit 3 : all sectors in a track have the same size
    – bit 4 : LUN number must be specified [Note 1]
    – bit 5 : several logical disks on that physical drive
    – bit 6 : disk change detected
    – bit 7 : disk's parameters were changed [Note 2]
    – bit 8 : disk reformatted, media's BPB was changed
    – bit 9 : access ban flag [Note 3]
43h 25 Default disk's BPB (A.03-4) block [Note 4]
7Dh 12 11-byte long volume label, terminated with 00h
89h 4 Disk's serial number
8Dh 9 File system type name, terminated with 00h.
Notes
  1. ^ a b c d LUN (Logical Unit Number) is used for discrimination between devices, sharing the same number on a bus. In particular, this is necessary for optical DVD-RAM drives, which present themselves with different LUN numbers either as removable HDD or as CD/DVD-ROM disk. Flash card adapters also represent flash cards in different slots as disks with different LUN numbers.
  2. ^ If disk's parameters were changed, data in DDT table must be reset by INT 21\AX=440Dh\CX=4840h function (8.02-46).
  3. ^ Access ban flag disables both reads and writes. It is applied to HDDs only, in particular, to other primary partitions beyond the first primary partition. Inverse state of access ban flag is reported by INT 21\AX=440Dh\CX=4867h function and may be set anew by INT 21\AX=440Dh\CX=4847h function (8.02-46).
  4. ^ The BPB data block (A.03-4) at offset 43h corresponds not to the current media, but to default type of removable media for this drive. Normally default media is the highest capacity media.

A.03-3 Current Directory Structure (CDS)

edit

CDS table is an array of data blocks (entries). Each CDS entry corresponds to one logical disk and specifies several parameters of that disk, including a path to the current (default) directory.

A pointer to the first CDS entry is stored at offset 16h in DOS's list of lists (A.01-2). Just there a byte at offset 21h stores total number of entries in CDS table, defined by LASTDRIVE specification in CONFIG.SYS file (4.17). Each CDS entry is 58h bytes long.

 
Fig. 10

Access to CDS table is illustrated by fig.10. The first step is a call for INT 21\AH=52h function (8.02-59), returning address of DOS's list-of-lists (00C9:0026h) in registers ES:BX. The next step is display of memory contents dump, starting at returned address. Length of the displayed dump is chosen so that the last 4 bytes at offsets 16h–19h show the address of CDS table (D203:0000h). Memory contents dump, starting at that address, presents CDS entry for disk A:. 58h bytes behind each previous CDS entry a next CDS entry follows, representing data for the next logical disk.

Among CDS table entries there are dummy entries, having no corresponding logical disks. Dummy entries reserve letter-names for those logical disks, which may be created or become accessible later: RAM-disks, IFS disks, network disks, etc. CDS table is created by IO.SYS loader during commands interpretation in CONFIG.SYS file. Later CDS table can't be appended with new entries. Therefore a sufficient number of dummy entries must be ordered beforehand by means of LASTDRIVE command (4.17).

Data structure of one CDS entry is shown in the table below.

Offset Size Description
00h 67 Path to the current directory.[Note 1][Note 2]
43h 2 Attribute word of this logical disk :
      bit 7 : hide disk's letter-name from assign-list
      bit 12 : virtual disk created by SUBST.EXE [Note 2]
      bit 13 : virtual disk created by JOIN.EXE [Note 2]
      bit 14 : disk is on a physical drive [Note 3][Note 4]
      bit 15 : disk is accessed via network redirector [Note 4]
45h 4 Pointer to DPB block for this disk (A.03-1)
49h 2 Starting cluster of current directory [Note 5]
4Fh 2 Number of characters to hide [Note 6]
52h 4 pointer to redirector or to IFS driver (or zero if none)
Notes
  1. ^ For local disks a path to the current directory includes disk's letter-name, colon, backslash, and the rest part of path. End of path must be marked with byte 00h.
  2. ^ If either bit 12 or bit 13 in attribute word is set, then the path at offset 00h isn't a real path.
  3. ^ A zero value of both attribute bits 14 and 15 means that this entry is a dummy or is disabled. Such disks are kept hidden.
  4. ^ If both bits 14 and 15 in attribute word are set, hence this disk represents an IFS file system.
  5. ^ This cluster number is counted from the start of logical disk. Therefore for the root directory cluster number is 0000h. If disk hasn't been accessed yet, cluster field is filled with FFFFh.
  6. ^ DOS may report only the final part of the path to current directory, if a word at offset 4Fh defines a non-zero number of characters, which are to be hidden.
  7. In early DOS versions CDS entry was 51h byte long; bytes 51h–57h have been added since MS-DOS 4 for IFS and network drivers.

A.03-4 BIOS Parameter Block (BPB) for a disk

edit

BPB is a part of boot sector on disk media. When DOS starts, BPB data are used to fill internal DOS's tables: DPB (A.03-1) and DDT (A.03-2). This procedure is repeated each time a media change is detected, so that data are always kept updated.

In disk's partitions with FAT-16 file system the BPB is 39h bytes long; its structure is shown in the first column ("F16") of the table below. BPB data inside DDT table have a slightly different "standard" structure, shown in third column ("STD"). Standard BPB blocks are accepted by INT 21\AX=440Dh\CX=0840h function and are returned by INT 21\AX=440Dh\CX=0060h function (8.02-46). Both these functions can be applied to disks with FAT-12 or FAT-16 file systems only.

In disk's partitions with FAT-32 file system the BPB is 5Ah bytes long; its structure is shown in the second column ("F32") of the table below. The same data inside DDT table are arranged according to new "extended" structure, shown in the fourth column ("EXT") of the table. For these data structures MS-DOS 7 provides other functions (8.02-46), which were not available in previous DOS versions: INT 21\AX=440Dh\CX=4840h to refresh BPB data in DDT and INT 21\AX=440Dh\CX=4860h to read BPB data in DDT. Both these new functions should be applied to disks formatted with FAT-32 file system.

F16 F32 Std Ext Size Description
00h 00h     3 Jump command EBh 3Ch 90h for FAT-16
          or EBh 5Ah 90h for FAT-32
03h 03h     8 ID of program, which formed BPB block
0Bh 0Bh 00h 00h 2 Sector's size (in bytes)
0Dh 0Dh 02h 02h 1 Sectors per cluster (FFh if unknown)
0Eh 0Eh 03h 03h 2 Reserved sectors preceding first FAT
10h 10h 05h 05h 1 Number of FATs (normally 2)
11h 11h 06h 06h 2 Number of entries in the root directory
13h   08h 08h 2 = 0000h [Note 1]
15h 15h 0Ah 0Ah 1 Media ID byte [Note 2]
16h 16h 0Bh 0Bh 2 Number of sectors per FAT [Note 3]
18h 18h 0Dh 0Dh 2 Number of sectors per track
1Ah 1Ah 0Fh 0Fh 2 Number of heads
1Ch 1Ch 11h 11h 4 Starting sector number [Note 4]
20h 20h 15h 15h 4 Total number of sectors [Note 1]
  24h   19h 4 Number of sectors per FAT [Note 3]
  28h   1Dh 2 Same as word 23h in DPB (A.03-1)
    1Fh   2 Number of cylinders [Note 5]
  2Ah   1Fh 2 Version of file system
    21h   1 Device type (as byte 01h in A.04-3)
  2Ch   21h 4 Root directory's first cluster number
    22h   2 Attributes (as word 02h in A.04-3)
24h 40h     1 Physical drive number
      25h 2 Information sector [Note 2 to A.03-1]
26h 42h     1 Extended boot-sector signature (= 29h)
27h 43h   27h 4 Disk's serial number (in binary form)
2Bh 47h   2Bh 11 Volume's label (or "NO NAME ")
36h 52h   36h 8 File system type name
Notes
  1. ^ For partitions smaller than 32 Mb a double word at offset 15h must be zero, the number of sectors in such partitions must be specified in a word at offset 08h.
  2. ^ Media ID byte corresponds to specification of INT 21\AH=1Ch function (8.02-17). If type of removable media is not identified, then the 00h value is assigned to media ID byte.
  3. ^ In "extended" BPB blocks a cell at offset 0Bh has 0000h value, and number of sectors, occupied by FAT table, is expressed by a double word value in a cell at offset 19h.
  4. ^ In BPBs of HDD's partitions the starting sector number is the same as that specified in corresponding partition's descriptor (A.13-5) at offset 08h.
  5. ^ A word at 1Fh and following bytes 21h, 22h of the standard BPB block are not included in extended BPB block and in BPB blocks inside DDT table (A.03-2).

A.04 I/O control data tables

edit

A.04-1 Data block for IOCTL serial number functions

edit

This data block is returned by functions INT 21\AX=440Dh\CX=4866h (8.02-46) and INT 21\AX=6900h (8.02-77), reading serial number from storage media. Data block of the same structure is accepted by functions INT 21\AX=440Dh\CX=4846h (8.02-46) and INT 21\AX=6901h (8.02-77) in order to assign new serial number to a disk.

Offset Size Description
00h 2 = 0000h
02h 4 Disk's serial number (in binary form)
06h 11 Disk's volume label (or "NO NAME    ", if none)
11h 8 On return only : filesystem type name [Note 1]
Notes
  1. ^ Name "CDROM   " corresponds to High-Sierra CD-ROM file system, name "CD001   " corresponds to ISO 9660 CD-ROM file system.

A.04-2 File handle's information word

edit

Handle's information word, read at offset 05h in SFT entry (A.01-4), is returned by INT 21\AX=4400h function (8.02-40). If specified handle refers to SFT entry, related to a non-file object, then returned information word should be interpreted according to table A.05-2. If specified handle refers to SFT entry, related to an opened file, then returned information word should be interpreted according to the table below. Distinctive feature of file handle's information word is clear state of its 7th bit.

Bits Description
15 File is not local, it is accessed via a redirector (network)
14 Don't set file date/time when file is closed
11 File is stored on a fixed (non-removable) media
7 Clear state of bit 7 is a distinctive feature of file's handle
6 Writing operation has not been performed yet
5-0 disk number (000000b = A:, 000001b = B:, 000010b = C:, and so on)

A.04-3 Data block for disk parameters specification

edit

A pointer to this data block should be prepared in DS:DX registers before subfunction INT 21\AX=440Dh\CX=4840h (8.02-46) is called for in order to update BPB data in tables DPB (A.03-1) and DDT (A.03-2). Data block of the same structure is returned by INT 21\AX=440Dh\CX=4860h subfunction (8.02-46). Buffer's address for the returned data block should be prepared in advance in DS:DX registers. A byte of flags at offset 00h is not returned, it defines request conditions and should be specified before the call.

Offset Size Description
00h 1 Flags (bits 3–7 must be zero) :
bit 0 : apply operation to current BPB [Note 1]
bit 1 : use track layout fields only [Note 2]
bit 2 : sectors are of the same size [Note 2]
01h 1 Device type :
= 00h – 320 kb or 360 kb floppy drive
= 01h – 1.2 Mb floppy drive
= 02h – 720 kb floppy drive
= 05h – fixed (hard) disk drive
= 06h – tape drive storage device
= 07h – other devices (including 1.44 Mb floppy)
= 08h – optical disc drive
= 09h – 2.88 Mb floppy drive
02h 2 Storage device attributes (bits 2–15 must be zero) :
bit 0 : device with non-removable medium
bit 1 : media change registration supported
04h 2 Number of cylinders (or number of tracks)
06h 1 Media flags :
= 01h – 320kb/360kb diskette
= F8h – compressed logical disk
= 00h – all other types of media
07h 31 BPB data block [Note 3]
Notes
  1. ^ If bit 0 in flag's byte is set, then updating or copying of BPB block (A.03-4) causes an attempt of access to physical storage media. But when bit 0 in flag's byte is clear, then access to physical storage media wouldn't be attempted: subject of operation will be a copy of BPB block inside DDT table (A.03-2) at offset 43h, which specifies the default type of storage media for this particular device.
  2. ^ Bits 1 and 2 in flag's byte specify interpretation of optional sub-table, defining sector allocation in a track. This sub-table up to 256 bytes long may start at offset 26h for subfunction CX=0840h and at offset 5Ch for subfunction CX=4840h. Media with non-equal sector sizes are not considered in this book, though. For subfunction CX=4860h bit 1 in flag's byte must be clear.
  3. ^ For subfunction CX=0840h the BPB table at offset 07h must have standard BPB structure (A.03-4). Final 6 bytes of BPB block are accepted by subfunction CX=0840h if flag's byte at offset 00h has its bit 0 set, otherwise bytes after offset 1Eh are ignored. For subfunction CX=4840h the BPB table at offset 07h must be 53 bytes long according to extended BPB structure (A.03-4).

A.04-4 Structure of data block for read/write functions

edit

A pointer to this data block is accepted by INT 21\AX=440Dh\CX=4861h reading function and by INT 21\AX=440Dh\CX=4841h writing function (8.02-46). These functions can't be executed inside "DOS box" under WINDOWS OS unless the addressed logical disk is locked in advance (8.01-58).

Offset Size Description
00h 1 = 00h
01h 2 Requested number of drive's head
03h 2 Requested number of drive's cylinder
05h 2 Number of the sector to start reading or writing
07h 2 Number of sectors to be read or written
09h 4 Pointer to a buffer with data or for data

A.04-5 Structure of data block for format/verify functions

edit

A pointer to this data block is accepted by INT 21\AX=440Dh\CX=4842h function for formatting and by INT 21\AX=440Dh\CX=4862h verifying function (8.02-46). These functions can't be executed inside "DOS box" under Windows OS unless the addressed logical disk is locked in advance (8.01-58).

Offset Size Description
00h 1 bit 0 : query for status code, don't actually format
    bit 1 : format multiple tracks (for HDDs only)
01h 2 Drive's head to be activated
03h 2 The cylinder where the heads should be driven
05h 2 Number of tracks to be formatted or verified

Note 1: for format function a word at 05h is ignored, if byte at offset 00h has its bit 1 clear: only one track would be formatted in this case.

Note 2: for verification function a number of tracks in word 05h should correspond to no more than 255 sectors, bit 0 set in byte at offset 00h specifies verification of multiple tracks, bit 1 must be zero.

Note 3: on return the byte at offset 00h is replaced with status code :

00h – this function is supported by BIOS,
01h – this function is not supported by BIOS,
02h – given specifications don't suit for this logical disk,
03h – there is no media in the drive.

Returned status code 00h doesn't confirm successful outcome : success should be confirmed by returned clear state of CF flag.

A.05 Driver's data structures

edit

A.05-1 Driver's header structure

edit

The table below shows data offsets for 3 types of DOS driver's headers :

column "B" – for "block" devices, i.e. disk and tape storage drives ;
column "C" – for 'character" devices, i.e. communication channels ;
column "D" – for CD-ROM drivers, cooperating with MSCDEX.EXE.

A pointer to disk driver header is given in a double word at offset 13h in Drive Parameter Block for the corresponding disk (A.03-1). "Character" device drivers may be identified by a signature at offset 0Ah in their header while tracing a chain of header's addresses. Tracing start address may be got at offset 22h in DOS's List-of-Lists (A.01-2), or else may be obtained by means of INT 2F\AX=122Ch function (8.03-12).

B C D Size Description
00h 00h 00h 4 Next driver's address field [Note 1]
04h 04h 04h 2 Driver's attributes (A.05-2)
06h 06h 06h 2 Offset of strategy routine entry point
08h 08h 08h 2 Offset of interrupt routine entry point
  0Ah 0Ah 8 Driver's signature field
    14h 1 First disk, controlled by the driver [Note 2]
0Ah   15h 1 Number of disks, controlled by driver
Notes
  1. ^ The next driver's address field must be initialized as FFFF:FFFFh; later DOS will fill this field with address of the next driver. If no next driver would be loaded, then remaining FFFFh value at start of current driver's header will signify the end of driver's addresses reference chain.
  2. ^ Byte at offset 14h must be initialized with 00h value. Later MSCDEX.EXE program (5.08-03) or SHSUCDX.EXE program (5.08-04) will replace initial zero value with number (note 1 to 8.02-17) of the first disk, controlled by this driver.

A.05-2 Driver's attributes

edit

Driver's attribute word is at offset 04h in driver's header (A.05-1). But meaning of most bits in attribute word is different for "character" device drivers (in second column of the table below) and for "block" devices drivers (in the third column). CD/DVD-ROM device drivers, cooperating with programs MSCDEX.EXE (5.08-03) or SHSUCDX.EXE (5.08-04), and also drivers of virtual disks, created by SUBST.EXE program (6.23), formally belong to "character" device drivers, as far as bit 15 in their attribute word is set.

Character device driver's attribute word is used as a basis of channel handle's information word, which is stored at offset 05h in corresponding SFT entry (A.01-4) and is returned by INT 21\AX=4400h function (8.02-40) in response to channel handle requests (about file's handle requests in A.04-2). Differences between "character" device driver's attribute word and channel's handle information word evince themselves in bits 4–7 in the second column of the table below: these bits in "character" device driver's attribute word normally are clear. In channel handle's information words bit 7 is set: it is their main distinctive feature from file handle's information words.

Bit "Character" devices (channels) "Block" devices (disks, tapes)
0 STDIN channel [Note 1] = 0 (reserved)
1 STDOUT channel [Note 1] 32-bit addresses support
2 NUL channel [Note 1] = 0 (reserved)
3 CLOCK channel [Note 1] = 0 (reserved)
4 Output via INT 29 supported = 0 (reserved)
5 Raw output [Note 2] = 0 (reserved)
6 Channel adds EOF on input IOCTL support [Note 3]
7 = 1 (as a non-file handle) IOCTL support [Note 4]
9 = 0 (reserved) No direct I/O [Note 5]
11 Lock support [Note 6] Lock support [Note 6]
12 = 0 (reserved) CD-ROM or remote device
13 Output until busy supported Non-IBM's format
14 IOCTL support [Note 7] IOCTL support [Note 7]
15 = 1 – "character" device symptom = 0 – "block" device symptom
Notes
  1. ^ Among attribute bits 0–3 for character device drivers one bit only may be set (or none).
  2. ^ Raw (binary) output means that neither of output characters is interpreted by driver as a command (as it is shown in A.02-8).
  3. ^ Set state of bit 6 signifies support for functions INT 21\AX=440Ch, 440Dh, 440Eh, 440Fh.
  4. ^ Set state of bit 7 signifies support for functions INT 21\AX=4410h, 4411h.
  5. ^ Set state of bit 9 means that disks, controlled by this driver, are inaccessible to functions of BIOS's INT 13 handler. Set state of bit 9 is typical for drivers, providing access to remote disks, to IFS disks and to disks with parameters, substituted by DRIVPARM command (4.09).
  6. ^ Set state of bit 11 means that driver is able to transfer slot lid lock signals for removable disk drives.
  7. ^ a bSet state of bit 14 means that driver is able to cope with control parameters, sent via INT 21\AX=4403h and INT 21\AX=4405h functions (8.02-41).
  8. Driver's attribute bits, not mentioned in this table, are considered reserved and normally must be clear.

A.05-3 Selected requests to device drivers

edit

Interaction between DOS and any device driver is performed by sending an address of request data block in ES:BX registers with a CALL FAR command to driver's strategy routine. The driver receives code of operation and initiates its execution. After some time DOS sends another call for driver's interrupt routine, which fills the same request data block with requested results of performed operation. DOS accepts the result, if successful termination of operation is confirmed by status byte in returned data block (A.05-4).

The same forms of request data blocks are accepted by INT 2F\AX=0802h function (8.03-03), which implicitly sends requests to block device drivers, integrated into DOS's core. These drivers control logical disks, having parameters registered in corresponding DDT tables (A.03-2). Only these logical disks can be addressed by INT 2F\AX=0802h function.

The first column of the table below specifies size of request data block, the second column – code of the requested operation, the fourth column shows which driver type this operation can be applied to. The fifth column shows whether the operation can be requested via INT 2F\AX=0802h function.

Size Code Operation Device type 802 Comments
19h 00h Initialization both types N A.05-5
0Fh 01h Media change check "block" type Y [Note 2]
14h 03h Store IOCTL string [Note 1] N A.05-7
1Eh 04h Read data both types Y A.05-6
0Eh 05h Nondestructive read character type N [Note 3]
0Dh 06h Input status request character type N A.05-4
0Dh 07h Flush input buffer character type N A.05-4
1Eh 08h Write (send) data both types Y A.05-6
1Eh 09h Write to disk & verify "block" type Y A.05-6
0Dh 0Ah Output status request character type N A.05-4
0Dh 0Bh Flush output buffer character type N A.05-4
14h 0Ch Receive IOCTL string [Note 1] N A.05-7
0Dh 0Dh Device open both types N A.05-4
0Dh 0Eh Device close both types N A.05-4
0Dh 0Fh Detect removable disk "block" type Y A.05-4
14h 10h Send data until busy character type N A.05-7
0Dh 17h Get disk's number "block" type Y A.05-4
Notes
  1. ^ Requests for sending or receiving IOCTL string can be addressed to those drives only (of either type), which have bit 14 set in their attribute word (A.05-2).
  2. ^ Command 01h (media check) accepts media identifier at offset 0Dh in request data block and returns in the same data block a status byte at offset 0Eh. Value of status byte should be interpreted as follows :
    FFh – media has not been changed;
    01h – media has been changed;
    00h – media change state can't be determined.
  3. ^ Command 05h (nondestructive read) returns one data byte at offset 0Dh in request data block, if BUSY bit in status byte at offset 04h (A.05-4) isn't set on return.

A.05-4 Format of a request header

edit

Presented header format is used in request data blocks, sent to drivers either with CALL FAR command (A.05-3) or via a call for INT 2F\AX=0802h function (8.03-03). In both cases a pointer to request data block must be in ES:BX registers. The header occupies bytes at offsets 00h–0Ch in request data block. For a number of operations (06h, 07h, 0Ah, 0Bh, 0Dh, 0Eh, 0Fh, 17h) the request data block is nothing else but a header. Structure of a header, common for all requests to drivers, is shown in the table below.

Offset Size Description
00h 1 Length of request block (table A.05-3, column 1)
01h 1 Addressed logical disk's number [Note 2]
02h 1 Code of operation (table A.05-3, column 2)
03h 1 Error code [Note 3][Note 4]
04h 1 Returned status byte:
01h – operation is done successfully
02h – addressed device is busy
80h – error, operation has failed
Notes
  1. If operation 0Fh (detect removable drive) returns status 02h (busy), this means the addressed drive is a fixed drive.
  2. ^ Here a logical disk is defined by its number in a list of disks, controlled by the addressed driver. When a request is sent via INT 2F\AX=0802h function (8.03-03), then these logical disk numbers are identical to absolute logical disk numbers: 00h = A:, 02h = C:, and so on, but for those logical disks only, which have their parameters specified in DDT tables (A.03-2).
  3. ^ Error code is returned only when status byte at offset 04h has the 80h value, i.e. confirms erroneous outcome. Then error code should be interpreted according to records for INT 2F in table A.06-1.
  4. ^ In case of success the 17h operation (Get disk number) returns absolute number of the requested logical disk at offset 03h. If requested number is beyond the list of logical disks, controlled by the addressed driver, then the 00h value is returned. In any case disk's type and media presence are not checked.

A.05-5 Initialization request data block

edit

Only once, just when driver is installed by IO.SYS loader, DOS sends to this driver a request for initialization procedure. Request is sent by CALL FAR command with a pointer to request data block in registers ES:BX. Code 00h of initialization procedure is specified in a header of request data block (A.05-03). Having accepted initialization request, the driver explores the available hardware it is responsible for. Some initial data as well as data, returned by the driver, are transferred in the rest part of request data block, beyond its header. Data disposition in this part of request data block (offsets 0Dh–18h) is shown in the table below.

Offset Size Description
0Dh 1 On return: number of logical disks controlled by this driver.
0Eh 4 On call : pointer to byte past the end of that memory space which may be occupied by this driver.
    On return: pointer to the first free byte past the memory space actually occupied by TSR part of this driver.
12h 4 On call : pointer to command line parameters.
    On return for "block' device drivers only : pointer to BPB data array (A.03-4).
16h 1 On call : zero based number of the first logical disk controlled by this driver (i.e. A: = 00h, C: = 02h and so on).
17h 2 On return: error message flag [Note 2]
Notes
  1. "character" device drivers must return zero in a double word at offset 12h.
  2. ^ Error message flag value 0000h at offset 17h doesn't cause error message display. But if driver returns error message flag value 0001h, then DOS displays message: "There is an error in your CONFIG.SYS file in line..."

A.05-6 Structure of I/O request data block

edit

I/O request data block is used for driver's data transfer operations called either directly with CALL FAR command (A.05-3) or via INT 2F\AX=0802h function (8.03-03). Address of request data block is presented in ES:BX registers, and header of this request data block specifies code of the requested operation: 04h, 08h or 09h. Data reading operation (code 04h) transfers data from a media into a prepared buffer in memory. Data writing operations (codes 08h and 09h) send data from buffer to disk or to output channel. All mentioned data transfer operations use request data block of the same structure, including a header (A.05-4) and the rest part with access parameters. Disposition of these parameters beyond the header is shown in the table below.

Offset Size Description
0Dh 1 Media identifier (for block devices only)
0Eh 4 Address of buffer with data or for data
12h 2 Length of data packet [Note 1]
14h 2 Starting sector number [Note 2]
16h 4 Pointer to volume identifier [Note 3]
1Ah 4 32-bit starting sector number [Note 2]
Notes
  1. ^ Length of data packet for channel drivers is counted in bytes. Length of data packet for disks ("block" device) drivers is expressed in number of sectors.
  2. ^ Some other DOS versions use another data format with a 4-byte starting sector number at offset 14h; a distinctive feature of this data format is length 18h of request data block, specified in the first byte of header (A.05-4). MS-DOS 7 sends a 4-byte starting sector number to those drivers only, which declare their support for 32-bit addressing by setting bit 1 in driver's attribute word (A.05-2). Starting sector number for these drivers is specified at offset 1Ah, and then a cell at offset 14h is filled with FFFFh.
  3. ^ A pointer to volume identifier is returned by driver when error 0Fh occurs (improper change of media).

A.05-7 Request data block for string operations

edit

This data block is used for driver's byte string transfer operations called by CALL FAR command (A.05-3). Address of data block is specified in ES:BX registers, and header (A.05-4) of that data block specifies code of the requested operation: 03h, 0Ch or 10h. Operation with code 10h sends data string to a channel. Requests with operation codes 03h, 0Ch can be addressed to those drivers only, which declare IOCTL support by having bit 14 set in their attribute word.[Note 7 to A.05-2] Request with operation code 03h suggests to take into account new values of control parameters, sent via INT 21\AX=4403h or INT 21\AX=4405h function (8.02-41). Operation 0Ch is an offer to the driver to report its actual control parameters, requested either via INT 21\AX=4402h or via INT 21\AX=4404h function (8.02-41).

Request data block for the mentioned operations must have the same structure, including a header (A.05-4) and the rest part; data disposition in this rest part of request data block is shown in the table below.

Offset Size Description
0Dh 1 Media identifier (for "block" device drivers only)
0Eh 4 Address of buffer area (with data or for data)
12h 2 On call : number of bytes to read or to write
    On return : actual number of bytes read or written

A.06 Error codes

edit

A.06-1 Summary table of error codes

edit

After any fault both BIOS and DOS functions return error code. Functions of MS-DOS 7 usually leave error code in AL. After BIOS's operations error code may be returned in AH. Interpretation of many error codes depends on which handler has left this error code. For convenience reasons the presented summary table comprises almost all error code interpretations, which may be encountered under MS-DOS 7. Being given the whole variety of alternatives, you'll easily choose the appropriate one according to the handler, which has returned the error code.

Code Handler Description
00h INT 24-2F write-protection violation attempt
  other no error, successful completion of operation
01h INT 13 invalid parameter or requested disk doesn't exist
  INT 15 parity error
  INT 16 keyboard buffer is full yet
  INT 24-2F disk number unknown to the driver
  other invalid function number or operation number
02h INT 13 address mark not found
  INT 15 interrupt error
  INT 24-2F drive is not ready
  other file not found
03h INT 13 disk is write-protected
  INT 15 address line A20 gating failed
  INT 24-2F command is unknown to the driver
  other path error or path not found
04h INT 13 sector not found or read error
  INT 24-2F data error (bad CRC)
  other too many opened files (no place for more handles)
05h INT 13 reset failed
  INT 24-2F bad length of request data block
  other access denied
06h INT 13 no media in the drive or media has been changed
  INT 24-2F seek error
  other invalid handle
07h INT 13 drive parameter activity failed
  INT 24-2F unknown media type
  other memory control block (MCB) destroyed
08h INT 13 DMA overrun
  INT 24-2F sector not found
  other insufficient memory
09h INT 13 DMA attempt across 64K or more than 80h sectors
  INT 15 invalid identifier of APM device
  INT 24, 2F printer is out of paper
  other invalid memory block address
0Ah INT 13 bad sector flag detected
  INT 24-2F write attempt failure
  other invalid environment
0Bh INT 13 bad track detected
  INT 15 specified device is not under APM control
  INT 24-2F read fault
  other invalid format
0Ch INT 13 unsupported track format or invalid media
  INT 24-2F general failure
  other invalid access mode
0Dh INT 13 invalid number of sectors on format
  INT 24-26 sharing violation
  other invalid data
0Eh INT 13 control data address mark detected
  INT 24-2F lock violation or media unavailable
0Fh INT 13 DMA arbitration level out of range
  INT 24-2F invalid disk change
  other invalid drive
10h INT 13 uncorrectable CRC or ECC error on read
  INT 24 FCB is unavailable
  other attempt to remove the current directory
11h INT 13 data have been ECC-corrected
  INT 24-26 sharing buffer overflow
  other it is not the same device
12h INT 24 code page mismatch
  other no more files, file index is out of range
13h INT 24-26 out of input
  other disk is write-protected
14h INT 24, 26 insufficient disk space
  other unknown unit
15h   drive not ready
16h   unknown command
17h   data CRC error
18h   bad length of request data block
19h   seek error
1Ah   unknown media type (non-DOS disk)
1Bh   sector not found
1Ch   printer is out of paper
1Dh   write fault
1Eh   read fault
1Fh   general failure
20h INT 13 controller failure
  other sharing violation
21h   lock violation
22h   disk change invalid [Note 2]
23h   FCB (File Control Block) unavailable
24h   sharing buffer overflow
25h   code page mismatch
26h   cannot complete file operation (out of input)
27h   insufficient disk space
30h INT 13 drive has no media sensor
31h INT 13 no media in the drive
32h INT 13 non-default media
  other network request not supported
33h   remote computer not listening
34h   duplicate name on network
35h   network name not found
36h   network is busy
37h   network device no longer exists
38h   network BIOS command limit exceeded
39h   network adapter hardware error
3Ah   incorrect response from network
3Bh   unexpected network error
3Ch   incompatible remote adapter
3Dh   print queue full
3Eh   queue not full
3Fh   not enough space to print file
40h INT 13 seek failed
  other network name was deleted
41h   access to network is denied
42h   network device type incorrect
43h   network name not found
44h   network name limit exceeded
45h   network BIOS session limit exceeded
46h   temporarily pause
47h   network request not accepted
48h   network print/disk redirection paused
50h   file exists
52h   cannot make directory
53h   fail on INT 24h
54h   too many redirections
55h   duplicate redirection
56h   invalid password
57h   invalid parameter
58h   network write fault
59h   this function is not supported on network
5Ah   required system component not installed
60h INT 15 requested APM mode is unavailable (blocked)
64h Mscdex.exe unknown error
65h Mscdex.exe not ready
66h Mscdex.exe EMS memory no longer valid
67h Mscdex.exe not High Sierra or ISO-9660 format
68h Mscdex.exe slot door is opened
80h INT 13 timeout, no response (drive may be not present)
  INT 67 internal error
  other invalid command or function not implemented
81h INT 67 hardware malfunction
  Himem.sys VDISK driver was detected
82h Himem.sys an A20 line error has occurred
83h INT 67 invalid handle
84h INT 67 undefined function requested by application
85h INT 67 no more handles available
86h INT 67 error in save or restore of mapping context
  other requested function is not supported
87h INT 67 insufficient number of memory pages is present
88h INT 67 insufficient number of memory pages is available
89h INT 67 zero number of pages requested
8Ah INT 67 invalid logical page number encountered
8Bh INT 67 invalid physical page number encountered
8Ch INT 67 page-mapping hardware state save area is full
8Dh INT 67 save of mapping context failed
8Eh INT 67 restore of mapping context failed
  Himem.sys a general XMS driver error
8Fh INT 67 undefined subfunction
  Himem.sys an unrecoverable XMS driver error
90h INT 67 undefined attribute type
  Himem.sys HMA does not exist or is not managed by XMS provider
91h INT 67 this feature is not supported
  Himem.sys HMA is already in use
92h INT 67 success, but a portion of source region is overwritten
  Himem.sys DX is less than the /HMAMIN parameter (5.04-01)
93h INT 67 length of data exceeds space allocated to the handle
  Himem.sys HMA is not allocated
94h INT 67 conventional and expanded memory regions overlap
  Himem.sys A20 line is still enabled
95h INT 67 offset within logical page exceeds size of logical page
96h INT 67 region length exceeds 1 Mb
97h INT 67 source and destination have same handle and overlap
98h INT 67 memory source or destination type undefined
9Ah INT 67 specified map register or DMA register set not supported
9Bh INT 67 all map register or DMA register sets are allocated
9Ch INT 67 map register or DMA register sets not supported
9Dh INT 67 undefined or unallocated map or DMA register sets
9Eh INT 67 dedicated DMA channels not supported
9Fh INT 67 specified dedicated DMA channel not supported
A0h INT 67 no such handle name
  Himem.sys all extended memory is allocated
A1h INT 67 a handle found had no name, or duplicate handle name
  Himem.sys all available extended memory handles are allocated
A2h INT 67 attempt to wrap around 1 M conventional address space
  Himem.sys invalid handle
A3h INT 67 source array corrupted
  Himem.sys source handle is invalid
A4h INT 67 operating system denied access
  Himem.sys source offset is invalid
A5h Himem.sys destination handle is invalid
A6h Himem.sys destination offset is invalid
A7h Himem.sys length is invalid
A8h Himem.sys copy operation has an invalid overlap
A9h Himem.sys parity error occurred
AAh INT 13 drive not ready
  Himem.sys block is not locked
ABh Himem.sys block is locked
ACh Himem.sys block lock count overflowed
ADh Himem.sys lock failed
B0h Himem.sys only a smaller UMB is available
  INT 13 volume is not locked in drive
B1h Himem.sys no UMBs are available
  INT 13 volume is locked in drive
B2h Himem.sys UMB segment number is invalid
  INT 13 volume is not removable
B3h INT 13 volume is in use, write cache isn't empty
B4h INT 13 lock count has been exceeded
B5h INT 13 a valid eject request failed
B6h   media is write-protected
BBh INT 13 undefined hard disk error
CCh INT 13 write fault on hard disk
E0h INT 13 status register error on hard disk
FFh INT 13 sense operation failed on hard disk
  INT 15 error enabling address line A20
  other matching file not found, or no more files, or bad FCB.
Notes
  1. If error code is returned in AX register, its most significant byte (in AH register) is zero.
  2. ^ Together with error code 22h, a pointer to media identifier is returned in ES:DI registers. This media identifier includes :
    at offset 00h – 12 bytes : disk's volume label, ending with 00h ;
    at offset 0Ch – 1 double word : disk's serial number (in binary form).
  3. The HIMEM.SYS driver (5.04-01) returns error codes in BL register.
  4. Error code, returned by the latest executed DOS's function, is stored in DOS's swappable data area SDA (A.01-3) at offset 04h. BIOS' functions write their error code into BIOS data area (A.01-1), most probably in cell 0040:0074h.

A.06-2 Error class codes

edit

Error class code, returned in BH register by INT 21\AH=59h function (8.02-65), is stored at offset 07h in DOS's swappable area SDA (A.01-3). Interpretation of error class codes is shown in the table below.

Code Description
01h out of resource (storage space or I/O channels)
02h temporary situation (file or record lock)
03h authorization (denied access)
04h internal (system software bug)
05h hardware failure
06h system failure (configuration file missing or incorrect)
07h application program error
08h object not found
09h bad format
0Ah object is locked
0Bh media error
0Ch object already exists
0Dh unknown error class

A.06-3 Codes of suggested action

edit

Code of suggested action is returned in BL register by INT 21\AH=59h function (8.02-5) and is stored at offset 06h in DOS's swappable area SDA (A.01-3).

Code Recommended action
01h retry
02h retry after some time
03h prompt user to reenter input
04h close opened files, delete temporary files and abort
05h immediate abort
06h ignore this error
07h retry after user intervention

A.06-4 Error locus codes

edit

Error locus code is returned in CH register by INT 21\AH=59h function (8.02-65) and is stored at offset 03h in DOS's swappable area SDA (A.01-3).

Code Probable locus of the error
01h unknown or not appropriate
02h block device (disk error)
03h network related
04h device connected to serial port (channel timeout)
05h memory related

A.06-5 I/O error status codes

edit

Error status code is returned in AH register by INT 25 and INT 26 handlers (8.02-85).

Code Description
01h invalid command
02h invalid address mark
03h disk is write-protected (for INT 26 only)
04h requested sector not found
08h DMA failure
10h data error (bad CRC)
20h controller failure
40h seek operation failure
80h device failed to respond (timeout)

A.07 Execution service structures

edit

A.07-1 Program Segment Prefix

edit

When a program is loaded for execution into an allotted memory segment, executable code of the program is placed at offset 100h and on. Preceding part of the segment (offsets 00h–FFh) is known as PSP, i.e. Program Segment Prefix. It is filled with important service data, which are used by DOS functions and may be used by the program itself.

By means of DEBUG.EXE that PSP can be peeped most easily, which is formed by COMMAND.COM interpreter for DEBUG.EXE itself. A procedure of displaying a part of that PSP is shown in fig.11. The rest part of that PSP is filled with zeros.

 
Fig. 11

The program under test in fig.11 is file CJPEG.EXE. Parameters "-baseline" and "VC01.BMP" are transferred to program under test in order to present an example of filling the first and the second FCB blocks, starting at offsets 5Ch and 6Ch correspondingly. Contents of these and some other PSP data fields are explained in the table below.

Offset Size Description
00h 2 INT 20 command (for CP/M compatibility)
02h 2 First segment beyond memory allotted to the program
06h 2 Size of executable code (for *.COM files)
0Ah 4 Stored INT 22 termination address
0Eh 4 Stored INT 23 Control-Break handler address
12h 4 Stored INT 24 critical error handler address
16h 2 Segment of parent's PSP [Note 1][Note 2]
18h 20 Job File Table (JFT)[Note 3]
2Ch 2 Segment of environment for the current process
2Eh 4 Caller's SS:SP on entry to last INT 21 call
32h 2 Number of entries in JFT (default is 20)
34h 4 Pointer to JFT (default is PSP:0018h)
3Ch 1 = 00h (= 01h for hieroglyphical keyboards)
40h 2 DOS version to be reported by INT 21/AH=30h
50h 2 A call for the INT 21 functions dispatcher
5Ch 16 First FCB area [Note 4]
6Ch 16 Second FCB area [Note 4]
80h 1 Length of command line tail [Note 5][Note 6]
81h 127 Command line tail or DTA area [Note 5][Note 6]
Notes
  1. ^ If segment address of the parent's PSP at offset 16h points at current PSP, then program is regarded as having no parent or, in other terms, as being its own parent. This is a distinctive feature of permanently loaded program, for example, of command interpreter. Permanently loaded programs can't be terminated by a call for INT 20 or for INT 21\AH=4Ch function.
  2. ^ In protected mode some PSP fields, including the "parent" segment field at offset 16h, may be overwritten. Therefore tracing a chain of PSP references may get confused, unless each candidate "parent" PSP segment confirms presence of typical signatures, for example, code CD20h (INT 20) at offset 00h or code CD21h at offset 50h.
  3. ^ a b c When current program starts, its JFT (Job File Table, offset 18h) contains SFT (A.01-4) entry numbers — one byte each — for "opened" objects, which are inherited from the parent process. Free spaces in JFT are filled with FFh byte. Values 80h–FEh in JFT correspond to remote files, opened by network redirectors. Default size of JFT — 20 bytes — imposes a restriction on number of opened objects. The INT 21\AH=67h function (8.02-76) enables to overcome this restriction: it arranges a larger JFT outside PSP, replaces a pointer to JFT in PSP at offset 34h and a count of JFT entries at offset 32h. However, child processes in any case can't inherit from their parent process more than 20 "opened" objects.
  4. ^ a b Areas at offsets 5Ch and 6Ch are filled as unopened FCBs (A.09-5) with parsed data from first and second command line parameters. Parameters are parsed with INT 21\AX=2901h function (8.02-19). Count of parameters includes those that can't be parsed.
  5. ^ a b The "command tail" area 81h–FFh is filled with a copy of command line with all parameters, which follow command name. The filled part of command tail area is terminated by byte 0Dh. Length of the filled part is written at offset 80h. If the length is set to 7Fh, and byte at offset FFh is 0Dh, hence real length of command tail exceeds 126 bytes, and its non-truncated version should be found in value of CMDLINE environmental variable.
  6. ^ "command tail" area 80h–FFh is used as default DTA (data transfer area) by "find file" functions INT 21\AH=11h,12h,4Eh,4Fh. You may prevent overwriting of "command tail" by changing DTA address with INT 21\AH=1Ah function (8.02-16).

A.07-2 Data block for loading a program

edit

The table below shows structure of a data block, used by INT 21\AX=4B00h and INT 21\AX=4B01h functions (8.02-53) in order to load a program into memory for its further execution.

Offset Size Description
00h 2 Environment segment for child process [Note 1]
02h 4 Pointer to command line [Note 2]
06h 4 Pointer to data for FCB at offset 5Ch [Note 3]
0Ah 4 Pointer to data for FCB at offset 6Ch [Note 3]
0Eh 4 On return: stack top SS:SP for loaded program [Note 4]
12h 4 On return: loaded program entrance point CS:IP [Note 4]
Notes
  1. ^ Whole environment of the parent process will be copied into this segment. If child process should be given access not to a copy, but to parent's environment itself, then the 0000h value should be assigned to a word at offset 00h in this data block.
  2. ^ Command line must include all what is to be written into PSP of the child process starting at offset 80h.[Note 5 to A.07-1] Command line string must begin with a byte, specifying its length, and must end with byte 0Dh.
  3. ^ This data string will be copied into corresponding FCB block[Note 4 to A.07-1] inside PSP for the child process. Required structure of this data string is shown in the "N" column of table A.09-5. First 12 bytes should be filled, then 4 bytes 00h must follow. If FCB should be left empty, then its first byte must be 00h, and then 11 bytes 20h must follow.
  4. ^ Double words at offsets 0Eh and 12h are returned by INT 21\AX=4B01h function only. This function loads a program, but doesn't initiate its execution. Returned stack top and entrance point enable to start execution of the loaded program later.

A.07-3 Execution state descriptor

edit

The table below shows data structure in execution state descriptor, used by INT 21\AX=4B05h function (8.02-54).

Offset Size Description
00h 2 = 0000h (reserved)
02h 2 Flags : bit 0 set : program is of *.EXE format
      bit 1 set : loaded code is an overlay
04h 4 Pointer to program's name, ending with 00h byte
08h 2 PSP segment address of the loaded program
0Ah 4 Entrance point CS:IP of the loaded program
0Eh 4 Size of the loaded program (including PSP)

A.07-4 Data block for server function

edit

As far as server function INT 21\AX=5D00h (8.02-68) enables to execute any INT 21 function as a separate process, this data block defines the states of all registers as required for execution of the selected function. Before this selected function is called for, all specified states will be copied from data block into registers automatically.

Offset Size Description
00h 2 Required contents of AX register
02h 2 Required contents of BX register
04h 2 Required contents of CX register
06h 2 Required contents of DX register
08h 2 Required contents of SI register
0Ah 2 Required contents of DI register
0Ch 2 Required contents of DS register
0Eh 2 Required contents of ES register
10h 2 = 0000h (reserved)
12h 2 Virtual machine identifier [Note 1]
14h 2 Process identifier (i.e. PSP segment address)
Notes
  1. ^ If selected function is to be executed under current MS-DOS 7, then the 0000h value should be specified as virtual machine identifier.
  2. ^ When this data block is used in order to close a process by means of INT 21\AX=5D01h function (8.02-69), then words at offsets 12h and 14h only are taken into account, all other words are ignored.

A.07-5 Interrupt sharing protocol

edit

Many drivers and TSR programs load their interrupt handlers and have to write address of this handler into a certain cell of interrupt table. However, this certain cell may be occupied yet by an address of another handler, which has been loaded beforehand. If new handler has to replace the former one, then a problem arises how to release memory, occupied by the former handler. If new handler complements functions of the former one, then a problem arises how to arrange their interaction. In both cases a solution is that each resident module must provide data, necessary for other resident modules, which may be loaded later.

The first step in arranging resident modules interaction was IBM's Interrupt Sharing Protocol (ISP), stipulating presence of 16-byte data block with fixed placement relative to call address for corresponding resident module. The ISP protocol enables to form a traceable chain of references to all the modules, sharing a common interrupt number. ISP protocol gives an opportunity to alter the order of references in the chain and to remove certain references from the chain. The latter is a necessary condition for unloading resident modules.

According to ISP protocol the call address, written into interrupt table, must point at a command of a short jump 16 bytes ahead, where executable code of resident module starts. The jumped over 16 bytes is just a place for data block. Structure of this data block is shown in the table below. All offsets in the table are counted from resident module's call address.

Offset Size Description
00h 2 Short jump command (EBh 10h) to executable code
02h 4 Address of previous handler in handler's chain
06h 2 Signature 4Bh 42h (= "KB")
08h 1 = 00h – this handler is not the first
    = 80h – this handler is the first in the chain
09h 2 Pointer to module unloading subroutine with RETF command at the end
0Bh 7 Reserved (must be zeros)

Note 1: many resident modules don't conform to ISP protocol. It may be intentionally ignored in order to prevent references chain tracing or resident module unloading.

A.07-6 Alternative Multiplex Interrupt Specification (AMIS)

edit

Multiplex interrupt INT 2F, described in part 8.03, has a serious drawback: coincident identifiers sometimes are appointed to different TSR modules due to inconsistent decisions of their developers. In order to avoid such conflicts an idea has been suggested to assign identifiers not beforehand by the will of module's developers, but automatically just in course of module's loading. Authorship of this idea is known to belong to Ralf Brown. Idea has been institutionalized by Alternative Multiplex Interrupt Specification (AMIS) and has been implemented by multiplex interrupt INT 2D. Contents of this article are based on version 3.6 of AMIS specification. Besides that, each resident module using multiplex interrupt INT 2D must conform to IBM's Interrupt sharing protocol ISP (A.07-5).

According to AMIS specification an identifier for resident module should be searched in a cycle of calls for multiplex interrupt INT 2D with operation code AL = 00h and with successive incrementation of candidate identifiers in AH register, starting from AH = 00h. If anyone of loaded resident modules considers a particular candidate identifier in AH register as its own, it must set AL = FFh, must return in CH:CL registers its version number and must return in DX:DI registers a pointer to a signature up to 80 bytes long, ending with byte 00h. Search cycle should terminate on condition of returned zero value in AL register: it means that neither loaded resident module has appropriated the last specified candidate identifier. Hence, the latter is free, and current resident module can assign this identifier to itself.

A similar cycle, but with other termination condition, should be arranged in order to find out whether a particular resident module is loaded or not. For this purpose the main role belongs to signature, pointed at by address returned in DX:DI registers. 16 bytes of this signature must be sufficient for identification of resident module. First 8 bytes must specify company or developer's name, the following 8 bytes — a name of program or a driver, which has loaded the responding resident module. Abridged names are allowed. If a name is shorter than 8 bytes, it should be appended with spaces (bytes 20h). The rest part of signature beyond 16 bytes is optional, but it may specify version and other useful data. Signature check enables to prevent repetitive loading of the same resident modules. Search cycle for a signature check also reveals identifier, assigned to the requested resident module. When the identifier is known, then other functions of this resident module can be called for.

As far as calls for multiplex interrupt imply a search through a chain of references and are performed slowly, hence repetitive calls for module's specific functions via INT 2D are not expedient (though are allowed with operation codes above 10h). Direct addressing to module's functions with a CALL FAR command (7.03-08) is preferable. In order to obtain direct address, the INT 2D interrupt should be called once with operation code AL = 01h and with particular module's identifier in AH register. Address for direct calls, returned in DX:BX registers, should be saved, and then later more calls for multiplex interrupt wouldn't be needed.

Beside the mentioned operations with operation codes AL = 00h and AL = 01h, AMIS specification stipulates several other operations, listed in the table below. Unified codes of these operations, shown in the first column of the table, enable to apply identical services for all resident modules. Some operations are optional. If addressed resident module returns in AL register the status code value 00h, hence it doesn't support the requested operation. On the contrary, returned status code value FFh confirms that the requested operation is supported and is done successfully. Several operations may return other status code values, informing about specific features of resident module. These and some other peculiarities of AMIS operation execution are explained in notes after the following table.

Code Description Comments
00h Installation check
01h Request for direct address [Note 1]
02h Uninstall resident module [Note 2]
03h Request for TSR program activation [Note 3]
04h Report about chained interrupts [Note 4]
05h Request for a list of "hot" keys [Note 5]
06h Request for device driver information [Note 6]
  1. ^ Returned status value AL = 00h means that requested resident module can't be addressed with CALL FAR command. Validity of the address returned in DX:BX registers must be confirmed by returned status code value AL = FFh.
  2. ^ A request to uninstall resident module must supply in DX:BX registers an address for return after completion of uninstall operation, though resident module may ignore this address. Returned in AL register status code values (except 00h and FFh) have the following meaning :
    01 – uninstall attempt failure ;
    02 – uninstall operation will be completed later ;
    03 – module has no uninstaller and stays active ;
    04 – the same, as 03, but module is deactivated ;
    05 – uninstall attempt should be repeated later ;
    06 – module is deactivated, but can't be uninstalled ;
    07 – the same, as 03, plus driver unloading required.
    Return of status code values 03, 04 or 07 means a necessity to launch a special uninstaller program. For this program the addressed resident module must return in BX register that segment address, where its executable code is loaded.
  3. ^ Returned in AL register status code values (except 00h and FFh) have the following meaning :
    01 – activation attempt should be repeated later ;
    02 – program will be activated later ;
    03 – program is active yet ;
    04 – activation attempt has failed.
    After successful activation, confirmed by status code FFh, some programs may report extra information in BX register. After a failure, confirmed by status code 04h, extra information may be returned in BX and CX registers. If the cause of failure remains unknown, BX and CX registers should return zeros.
  4. ^ Requests for operation 04h must specify in BL register a number of that interrupt (except INT 2D), which is to be checked. Returned in AL register status code values (except 00h) have the following meaning :
    01 – check result can't be determined ;
    02 – specified interrupt has been intercepted ;
    03 – the same as 02 plus handler's address – in DX:BX ;
    04 – in DX:BX – pointer to a list of interceptions ;
    FF – specified interrupt is not intercepted.
    Status code value 04 means that interrupt number, specified in BL register, is ignored. Returned list is composed of 3-byte groups per each interrupt: the first byte, the interrupt number ; the following 2 bytes, the offset (inside DX segment) of that interrupt handler's entrance address. End of list is marked with code 2Dh in a place for interrupt number.
  5. ^ After successful outcome, confirmed by status code FFh, in DX:BX registers a pointer to a list of "hot" keys is returned. Structure of this list is described in appendix A.02-7.
  6. ^ Operation 06h returns in AL register number of drivers, installed by addressed resident module, and in DX:BX registers – a pointer to header of the first of these installed drivers (A.05-1). In AH register a byte of flags is returned; bits 3–7 in this byte are reserved and must be clear. Set state of the rest flags should be interpreted as follows:
    bit 0 – drivers can't be unloaded from memory;
    bit 1 – drivers are not included in DOS's drivers chain;
    bit 2 – installed drivers are not reenterable.
    If addressed TSR program didn't install drivers, it has to return AL = 00h value. On return the contents of AH, BX and DX registers may be arbitrary altered.

A.08 Floppy drive's data structures

edit

A.08-1 Floppy drive's data in BIOS data area

edit

The table presents that information in BIOS data area, which relates to floppy drive(s). All offsets are counted from segment address 0040h, i.e. from the start of BIOS data area.

Offset Size Description
10h 2 Flags : bit 0 : floppy is able to boot the PC
      bits 6–7 : number of floppy drives minus one
3Eh 1 Bit 7 set by IRQ6 handler marks completion of FDD's job
3Fh 1 Motor's status in floppy drive(s)
40h 1 Floppy motor OFF timeout count
41h 1 Status : bits 0–4 : last operation error [Note 2]
      bit 5 : general controller failure
      bit 6 : seek error
      bit 7 : drive isn't ready
42h 3 Registers of floppy drive controller
8Bh 1 Floppy drive data rate control
8Fh 1 Floppy drive registration :
      bit 0 : drive 0 supports 80 tracks
      bit 2 : presence of drive 0 is confirmed
      bit 4 : drive 1 supports 80 tracks
      bit 6 : presence of drive 1 is confirmed
90h 1 Floppy drive 0 media status :
      bits 0–2 =111b for 3.5" disks
      bit 3 : diskette 2.88 Mb
      bit 4 : media type has been determined
      bits 6–7 : current data transfer rate
91h 1 Floppy drive 1 media status (just as for drive 0)
94h 1 Floppy drive 0 current track number
95h 1 Floppy drive 1 current track number
Notes
  1. Data placement in BIOS data area may depend on BIOS version (A.01-1).
  2. ^ Particular values of last error byte at offset 41h should be interpreted as it is shown in table A.06-1 for INT 13.

A.08-2 Access and formatting parameters

edit

Computer's BIOS system stores access and formatting parameters for each floppy disk drive in separate 11-byte tables. A pointer to such table for any particular floppy drive can be obtained with INT 13\AH=00h function (8.01-49). Besides that, one more similar 11-byte table is created for the default ("current") floppy drive; a pointer to the latter table is stored in a cell 0000:0078h (also known as INT 1E) inside interrupt table.

Access and formatting parameters can be changed by INT 13\AH=18h function (8.01-54), but the changes wouldn't come into effect until floppy controller is reset by a call for INT 13\AH=00h (8.01-44).

Offset Size Description
00h 1 Parameters, first byte :
      bits 7–4 : step rate of head shift
      bits 3–0 : head unload time (0Fh = 0.24 s)
01h 1 Parameters, second byte :
      bits 7–1 : head load time (01h = 0.004 s)
      bit 0 : set state means data transfer via DMA
02h 1 Delay until motor turned off (in clock ticks 1/18 s)
03h 1 Bytes per sector :
      =00h 128 bytes,
      =01h 256 bytes,
      =02h 512 bytes,
      =03h 1024 bytes.
04h 1 Number of sectors per track
05h 1 Gap length between sectors :
      =2Ah for diskettes 5.25",
      =1Bh for diskettes 3.5".
07h 1 Gap length between sectors for formatting :
      =50h for diskettes 5.25",
      =6Ch for diskettes 3.5".
08h 1 Format filler byte (default is F6h)
09h 1 Head settle time in milliseconds
0Ah 1 Motor start time in ticks (1 tick = 1/18 second)

A.08-3 Floppy drive types registered by BIOS

edit

BIOS Setup program stores data about registered floppy drives in a cell 10h of CMOS memory. In order to read these data the cell address 10h has to be sent with OUT command (7.03-66) into port 70h, and after that the required data byte can be read by IN command (7.03-26) from port 71h (more about that in note 1 to A.14-1). The required data byte occurs in AL register; bits 4–7 in that byte specify features of the first floppy drive, bits 0–3 specify features of the second floppy drive, if it exists. Hexadecimal values, expressed by each of these 4-bit groups, should be interpreted independently according to the table below.

Value Type of floppy disk drive
0 Floppy disk drive isn't present
1 Drive for 360 kb 5.25" diskettes
2 Drive for 1.2 Mb 5.25" diskettes
3 Drive for 720 kb 3.5" diskettes
4 Drive for 1.44 Mb 3.5" diskettes
5 Drive for 2.88 Mb 3.5" diskettes

A.09 Directories and file's data tables

edit

A.09-1 Directory records and file's data

edit

Data concerning files, volume labels and subdirectories are stored in corresponding directory records. Data structure in ordinary 32-byte directory record for an object with a "short" name is shown in the first column "D" of the table below. DOS's "find file" functions INT 21\AH=4E00h (8.02-57) and INT 21\AH=4Fh (8.02-58) read directory records and return the found data in DTA area (8.02-16); format of data, returned by these functions, is shown in second column "F4E" of the table below. Other "find file" functions INT 21\AH=11h (8.02-11) and INT 21\AH=12h (8.02-12) also return found data in DTA area, but in other formats. Third column "F1N" of the table below shows format of data, returned after a search request with normal FCB block (column "N" in appendix A.09-5). But when search request is presented in a form of extended FCB block (column "E" in appendix A.09-5), then the same functions return other data structure, which is shown in the fourth column "F1E" of the table below.

D F4E F1N F1E Size Description
      00h 1 = FFh – signature of extended FCB
      06h 1 Attributes for a search (A.09-2)
  00h 00h 07h 1 Disk : 01h = A:, 03h = C:, …[Note 1]
00h 01h 01h 08h 8 Name, appended with spaces to 8 bytes
08h 09h 09h 10h 3 Suffix, appended with spaces to 3 bytes
  0Ch     1 Attributes for a search (A.09-2)
  0Dh     2 Ordinal number of directory record
  0Fh     2 Number of the first directory cluster
0Bh 15h 0Ch 13h 1 Actual attributes (A.09-2) of the object
0Ch       1 Auxiliary attribute byte [Note 2][Note 3]
0Dh   0Eh 15h 1 Time in 0.01-second units [Note 2]
0Eh   0Fh 16h 2 Object creation time [Note 2]
10h   11h 18h 2 Object creation date [Note 2]
12h   13h 1Ah 2 Date of the last access
14h   15h 1Ch 2 Starting cluster number [Note 4]
16h 16h 17h 1Eh 2 Time of the last update
18h 18h 19h 20h 2 Date of the last update
1Ah   1Bh 22h 2 Starting cluster number [Note 4]
1Ch 1Ah 1Dh 24h 4 Object's size in bytes (binary form)
  1Eh     13 Object's name and suffix [Note 5]
Notes
  1. ^ Search functions INT 21\AX=4E00h (8.02-57) and INT 21\AH=4Fh (8.02-58) return this byte with its 7th bit set, if disk is accessed via a network.
  2. ^ If object is created under DOS, then this data field is not filled. Copying procedures under DOS don't copy those data, which may be present in this field.
  3. ^ This data field is used by operating systems Windows-2000/XP, but the author has no information about role of these data.
  4. ^ Object's starting cluster number in FAT-16 volumes is a word at offset 1Ah; field at offset 14h is not used. But cluster number in FAT-32 volumes is a double word. The most significant two bytes of this double word are stored at offset 14h.
  5. ^ Search functions INT 21\AX=4E00h (8.02-57) and INT 21\AH=4Fh (8.02-58) don't overwrite name search template at offset 01h; actual name of the found object, ending with 00h byte, is returned at offset 1Eh.

A.09-2 Structure of attribute byte

edit

Attribute byte at offset 0Bh in a directory record (A.09-1) defines class of the object, associated with this record. Bitfields of attribute byte are explained in the table below.

Bit Description
0 Read-only file
1 Hidden file
2 System file
3 Volume label (must be zero for files and directories)
4 Directory (must be zero for files and volume labels)
5 File, which is to be stored in archive
6,7 Not used under MS-DOS, must be zero

Note 1: the 0Fh value of attribute byte is regarded as a signature of LFN directory records, associated with files having "long" names (A.09-3). Such records are formed by Windows-95/98/ME operating systems.

Note 2: states of bits 3 and 4 in attribute byte can't be changed by INT 21\AX=4301h function (8.02-39) or by ATTRIB.EXE utility (6.01).

Note 3: file search functions INT 21\AX=4E00h (8.02-57) and INT 21\AH=4Fh (8.02-58) ignore states of bits 0 and 5 in attribute byte.

Note 4: extended "file open" function INT 21\AX=6C00h (8.02-78) accepts in CX register an attribute word with clear bits 4 and 6-15. Role of other bits corresponds to that shown in table A.09-2.

A.09-3 Format of LFN directory records

edit

Each "long" filename, accepted by Windows-95/98/ME operating systems, occupies at least several directory records of standard 32-byte size. Truncated version of "long" filename is stored in the last of these records; its structure corresponds to that shown in table A.09-1. But the rest records, associated with the same file, store unicode characters of "long" filename. These rest LFN records have other structure, shown in the table below.

Offset Size Description
00h 1 Ordinal number of LFN record [Note 1]
01h 10 First portion of "long" filename's characters
0Bh 1 = 0Fh – signature of LFN record
0Ch 1 = 00h (reserved)
0Dh 1 Checksum for short filename [Note 2]
10h 12 Second portion of "long" filename's characters
1Ah 2 = 0000h for all LFN records
1Ch 4 Third portion of "long" filename's characters
Notes
  1. ^ The last LFN record, associated with the same "long" filename, is marked by set state of bit 6 in the first byte.
  2. ^ The short filename checksum byte is calculated by adding up the eleven bytes of the short filename, with rotating the intermediate sum right one bit before adding each next character byte.

A.09-4 Bitfields of access and sharing byte

edit

While preparing an object for access, the INT 21\AH=3Dh (8.02-33) and INT 21\AX=6C00h (8.02-78) functions accept a byte of access conditions. This byte is written into a cell at offset 02h in corresponding SFT entry (A.01-4). Role of bitfields in access and sharing conditions byte is shown in the table below.

Bits Description
1-0 Access conditions:
00b – for reading only
01b – for writing only
10b – for reading and writing
11b – for execution and transfer
2 If set, prohibits updating file's last-access time
3 = 0b (reserved)
6-4 Sharing conditions:
000b – compatibility mode
001b – prohibit access for others
010b – prohibit write access for others
011b – prohibit read access for others
100b – allow full access for others
7 If set, file's handle will not be inherited by child processes.

Note 1: sharing conditions are ignored unless SHARE.EXE utility is loaded.

Note 2: previous versions of MS-DOS require clear state of bit 2.

A.09-5 Unopened file control blocks

edit

File control block (FCB) is an obsolete form of object's properties specification. It gives no access to objects beyond current directory and to disks with FAT-32 file system. Nevertheless some functions employ partially filled (unopened) FCBs just as a template of specification for object's search, renaming and deletion. Unlike operations with completely filled (opened) FCB blocks, operations with unopened FCBs (INT 21\AH=11h, 12h, 13h, 17h) are still used and can be applied to objects in the current directory on disks with FAT-32 file system. Unopened FCB's data structure is shown in the table below.

In MS-DOS 7 two forms of FCB blocks are allowed: normal FCB blocks up to 36 bytes long and extended FCBs up to 43 bytes long. A distinctive feature of extended FCB is FFh value of its first byte. Normal FCB blocks define files only, except those having "Hidden" and "System" attributes. Extended FSBs include search attributes specification and therefore may be applied to different objects: files, volume labels and subdirectories. Both normal and extended FCBs may be completely filled (opened) and partially filled (unopened). Column "N" of the table below shows data structure in unopened normal FCB blocks, column "E" shows the same for unopened extended FCB blocks. Those FCB bytes, which are not shown in the table below, must have the 00h value.

N E Size Description
  00h 1 = FFh – signature of extended FCB
  06h 1 Attributes specification for search (A.09-2)
00h 07h 1 Logical disk number: 00h = "current" disk, 01h = A:, 03h = C:, and so on (except the FFh value).
01h 08h 8 Object's name or its search mask [Note 1]
09h 10h 3 Object's suffix or its search mask [Note 1]
0Ch 13h 1 On return: search attributes (from offset 06h)
0Dh 14h 2 On return: object's record number in directory
0Fh 16h 2 On return: current directory's cluster number
11h 18h 8 On call for INT 21\AH=17h: new name for file
15h 1Ch 1 On return: disk number (01h=A:, 03h=C:, and so on)
19h 20h 3 On call for INT 21\AH=17h: new suffix for file
Notes
  1. ^ In FCBs all characters of name and suffix must be in upper case. Name is appended with spaces (20h) to its nominal length 8 bytes, suffix is appended with spaces to its nominal length 3 bytes. If empty, both name and suffix fields must be filled with spaces. The mentioned and some other requirements to filling FCB fields can be met by means of INT 21\AH=29h function (8.02-19).
  2. Being called for the first time, functions INT 21\AH=11h (8.02-11) and INT 21\AH=13h (8.02-13) require 00h values in all fields after offset 0Ch in normal FCB and after offset 13h in extended FCB. On return these fields contain data, which must be preserved intact from each previous search call to each next search call. In the same FCB fields the INT 21\AH=17h function (8.02-14) accepts new name for the renamed file, requiring buffer 28 bytes long for normal FCB and 35 bytes long for extended FCB.
  3. Unopened FCB blocks are not subjected to restriction, imposed by FCBS command specification (4.10) in CONFIG.SYS file.

A.09-6 Canonical structure of a CD directory record

edit

High Sierra and ISO 9660 file systems implement slightly different data structures in CD directory records. Both these data structures can be translated by INT 2F\AX=150Fh function (8.03-19) to a common canonical form, which is shown below.

Offset Size Description
00h 1 Length of attribute record in logical blocks
01h 4 File's first logical block number
05h 2 Size of file in logical blocks
07h 4 File's length in bytes
0Bh 7 Date and time
12h 1 Bit flags
13h 1 Interleave size (for AVI files only)
14h 1 Interleave skip factor (for AVI files only)
15h 2 Volume set sequence number
17h 1 Length of file name
18h 38 Name of file, ending with 00h byte
3Eh 2 File version number
40h 1 Number of bytes in system data block
41h 220 System data block

A.10 Video data tables

edit

A.10-1 Selected videomodes

edit

Videomodes define screen appearance. Both BIOS and DOS use textual videomodes : color videomode 03h or monochrome videomode 07h. Each program is allowed to set the most appropriate video mode, either textual or graphic.

Available videomodes depend on PC's hardware. During hardware evolution some videomodes have become common for the sake of compatibility. Later a subset of videomodes has acquired the status of a standard. The table below lists only those videomodes, which are almost certainly supported by any modern video card. Video cards with insufficient internal memory probably will not be able to support graphic videomodes with high resolution. Obsolete PC's produced before 1991 don't support SVGA videomodes at all.

EGA and VGA videomodes are defined by one-byte code, specified in the first column of the table below. These videomodes may be set by INT 10\AH=00h function (8.01-10).

SVGA video modes are defined by 2-byte hexadecimal code, which should be specified in BX register for INT 10\AX=4F02h function (8.01-37). The table below doesn't specify the most significant half-byte of SVGA videomode code, because this half-byte (bits 15–12) is charged with another mission. Its 12th and 13th bits must be cleared, the 14th bit enables linear frame buffer access, and the 15th bit forces to retain video memory contents. For example, you may specify BX=0102h, when you want video memory to be cleared, or BX=8102h if you want video memory contents to be preserved: in both cases you'll get the same videomode, which is specified as 102h in the first column of the table below. Codes of other SVGA videomodes are shown in the same way — without specification of the most significant half-byte. Codes of non-SVGA video modes may be specified for INT 10\AX=4F02h function in the least significant byte of BX register while its bits 15 and 14 are charged with the described missions, and bits 13–8 are made clear.

Monochrome videomodes, both textual and graphic, are marked in the second column of the table as "b/w" (instead of colors number).

Textual video modes are characterized in column 3 of the table below by number of characters in a row and by number of rows per screen height. For example, definition 80x25 means that you may address rows 0–24 and character cells 0–79 in each row. All listed textual modes accept 8x16 fonts.

Graphic modes are characterized by their resolution in pixels, shown in the 4th column. For example, resolution 640x480 means that you are allowed to address screen lines 0–479 and pixels 0–639 in each line.

The 5th column in the table shows video buffer starting address for those videomodes, which use fixed video buffer in UMB address space.

Videomode Colors Text Graphics Buffer Class
01h 16 40x25   B800 VGA
03h 16 80x25   B800 VGA
06h b/w   640x200 B800 EGA,VGA
07h b/w 80x25   B000 VGA
0Eh 16   640x200 A000 EGA,VGA
0Fh b/w   640x350 A000 EGA,VGA
10h 16   640x350 A000 VGA
11h b/w   640x480 A000 VGA
12h 16   640x480 A000 VGA
13h 256   320x200 A000 VGA
100h 256   640x400 *1 SVGA
101h 256   640x480 *1 SVGA
102h 16   800x600 *1 SVGA
103h 256   800x600 *1 SVGA
104h 16   1024x768 *1 SVGA
105h 256   1024x768 *1 SVGA
108h 16 80x60   *1 SVGA
109h 16 132x25   *1 SVGA
10Ah 16 132x43   *1 SVGA
10Bh 16 132x50   *1 SVGA
10Ch 16 132x60   *1 SVGA
110h 32k   640x480 *1 SVGA
111h 64k   640x480 *1 SVGA
112h 16M   640x480 *1 SVGA
113h 32k   800x600 *1 SVGA
114h 64k   800x600 *1 SVGA
115h 16M   800x600 *1 SVGA
116h 32k   1024x768 *1 SVGA
117h 64k   1024x768 *1 SVGA
118h 16M   1024x768 *1 SVGA
119h 32k   1280x1024 *1 SVGA
11Ah 64k   1280x1024 *1 SVGA
11Bh 16M   1280x1024 *1 SVGA
120h 256   1600x1200 *1 SVGA

Note 1: position and size of video memory access "windows" in address space for SVGA videomodes may depend on PC's hardware. Video memory access parameters should be determined by call for INT 10\AX=4F01h function (8.01-36, A.10-7).

Note 2: when SVGA standard hasn't been adopted yet, then equivalent to SVGA's 102h videomode was 6Ah videomode (800x600x16). The 6Ah videomode still can be set by INT 10\AH=00h function (8.01-10).

Note 3: SVGA standard reserves BX=81FFh code for special video mode, enabling unlimited direct access to video memory.

A.10-2 Information about video adapter status

edit

The table below shows structure of 64-byte data block, returned by INT 10\AH=1Bh function (8.01-34). This block presents information about current status of video adapter.

Offset Size Description
00h 4 Address of static functionality table (A.10-3)
04h 1 Current video mode
05h 2 Number of columns or of pixels along a line
07h 2 Size of regeneration buffer in bytes
09h 2 Starting address of regeneration buffer
0Bh 16 Cursor positions (2 bytes each) for pages 0–7
1Bh 2 Cursor's start and stop scan lines
1Dh 1 Active screen page
1Eh 2 CRT controller's port address
20h 2 Last values sent to ports 03x8h and 03x9h
22h 1 Number of rows (or screen lines) minus one
23h 2 Number of bytes per font's character
25h 1 Active video adapter code
26h 1 Code of alternate video adapter (if it exists)
27h 2 Number of videomode's colors (0000h = monochrome)
29h 1 Number of screen pages supported by videomode
2Ah 1 Active scan lines [Note 1]
2Bh 1 Character generator's primary font block
2Ch 1 Character generator's secondary font block
2Dh 1 Current status flags [Note 2]
31h 1 Video memory, 00h–03h correspond to 64,128,192,256k
32h 1 Flags, just as at offset 0Eh in table A.10-3.
Notes
  1. ^ Number of active scan lines is defined by set state of one bit in a byte at offset 2Ah. Set state of bit 0, 1, 2, 3, 4, 5, 6 corresponds to numbers of lines 200, 350, 400, 480, 512, 600, 768.
  2. ^ Bits in flag's byte at offset 2Dh have the following meaning :
    bit 0 – no restrictions on videomode choice
    bit 1 – gray scale summing is on
    bit 2 – monochrome display attached
    bit 3 – default palette loading disabled
    bit 4 – cursor emulation enabled
    bit 5 – role of 7th bit in color byte (A.10-5)
    bit 6 – 9-dot wide fonts are not supported
    If 5th bit in flag's byte is cleared, then 7th bit in color byte defines brightness of background, otherwise it defines blinking.

A.10-3 Format of static functionality table

edit

Static functionality table informs about variety of capabilities, potentially supported by PC's video adapter. A pointer to static functionality table is returned by INT 10\AH=1Bh function (8.01-34) in current video adapter status table (A.10-2) at offset 00h.

Offset Size Description
00h 7 Bits 0–13h correspond to video modes 00h–13h ; if a bit is set, the corresponding video mode is supported. The rest bits are reserved for OEM videomodes.
07h 1 Bits 0, 1, 2, 3, 4, 5, 6 signify support to scan lines numbers 200, 350, 400, 480, 512, 600, 768.
08h 1 Maximum number of fonts in textual videomodes
09h 1 Maximum number of active fonts in textual videomodes
0Ah 2 Supported operations:
bit 0 – all modes on all displays supported
bit 1 – gray summing function supported
bit 2 – character font loading function supported
bit 3 – default palette loading enable/disable supported
bit 4 – cursor emulation function supported
bit 5 – internal EGA palette present
bit 6 – color palette present
bit 7 – color-register paging function supported
bit 8 – light pen supported (INT 10\AH=04h)
bit 9 – save/restore state function 1Ch supported
bit 10 – intensity/blinking switching supported (A.10-5)
bit 11 – more than one video adapter supported
0Eh 1 Fonts and palettes support:
bit 0 – 512-character sets supported
bit 1 – dynamic determination of save area supported
bit 2 – textual font override supported
bit 3 – graphics font override supported
bit 4 – palette override supported
bit 5 – video adapter code extensions supported

A.10-4 BIOS information about SVGA extensions

edit

The table below shows selected data from a data block 512 bytes long returned by INT 10\AX=4F00 function (8.01-35). These data characterize software supplied in fixed storage chip(s) of video adapter.

Offset Size Description
00h 4 Signature "VESA" or "VBE2"
04h 2 Version number of SVGA BIOS extensions
06h 4 Pointer to manufacturer's (OEM) name
0Eh 4 Pointer to list of supported videomodes (end mark FFFFh)
12h 2 Amount of video memory in 64 kb blocks

A.10-5 16-color codes

edit

Though AT-compatible computer's hardware suggests a large variety of videomodes, the default videomode for both BIOS and MS-DOS 7 is a 16-color 80x25 textual videomode 03h. For this videomode and for all other 16-color videomodes (A.10-1) colors are defined by a 4-bit code, shown in the table below.

0000 0 black 1000 8 gray
0001 1 blue 1001 9 bright blue
0010 2 green 1010 10 bright green
0011 3 cyan 1011 11 bright cyan
0100 4 red 1100 12 bright red
0101 5 magenta 1101 13 bright magenta
0110 6 brown 1110 14 yellow
0111 7 white 1111 15 bright white

Color codes are used to compose color bytes, also known as display attribute bytes. Video memory in textual videomodes is filled with alternating color bytes and character bytes. In each color byte bits 3–0 define foreground (character's) color, and bits 6–4 define background color. By default the 7th bit defines character's blinking instead of background's brightness, but role of the 7th bit may be reprogrammed by INT 10\AX=1003h function (8.01-23), and then the most significant bits in both 4-bit groups will have the same mission. By default the 3rd bit defines foreground brightness, but this role also may be reprogrammed by INT 10\AX=1103h function (8.01-28), and then bit 3 will redirect character generator to another font block, thus enabling to display characters from two fonts at the same time.

A.10-6 Video data fields in BIOS data area

edit

The table below shows those selected items in BIOS data area, which have relation to computer's video subsystem. All offsets in the table are counted from the start of BIOS data area (A.01-1) at segment address 0040h.

Offset Size Description
10h 2 Bits 5–4 define initial video mode:
00b according to video adapter settings
01b 40x25 textual CGA color mode
10b 80x25 textual CGA color mode
11b 80x25 monochrome textual mode
49h 1 Current video mode (A.10-1)
4Ah 2 Number of columns (or pixels) per screen width
4Ch 2 Video buffer's screen page size (in bytes)
4Eh 2 Current page start address in video buffer
50h 16 Cursor XY positions on each of 8 video pages
60h 2 Cursor start and end scan lines (INT 10/AH=01h)
62h 1 Active screen page number
63h 2 CRT controller base I/O port address (usually 03D4h)
65h 1 Last control byte value sent to port 03B8h/03D8h:
bit 5 – blinking control (INT 10\AX=1003h)
66h 1 Last control byte value sent to I/O port 03D9h:
bit 4 – background brightness
84h 1 Number of rows (or lines) on screen minus one
85h 2 Font height in scan lines
87h 5 Video adapter control flags:
bit 0: – cursor emulation disabled
bit 1: – monochrome display attached
bit 2: – wait for CRT display enable
bit 7: – don't clear RAM on videomode set
A8h 4 Pointer to VGA video pointers table

Note 1: presented data placement may depend on BIOS version (A.01-1).

A.10-7 Features of requested SVGA videomode

edit

This table presents selected data from a 256-byte data block, returned by INT 10\AX=4F01 function (8.01-36) in response to a request about any SVGA videomode, supported by computer's hardware.

Offset Size Description
00h 2 Flags : bit 0 – requested videomode is supported
      bit 2 – functions 8.01-21, 8.01-33 are supported
      bit 3 – set for color videomode
      bit 4 – set for graphic videomode
      bit 5 – videomode differs from VGA standard
      bit 6 – memory banks switching isn't supported
      bit 7 – linear frame buffer is supported
02h 1 Window "A" :
      bit 0 – sliding window "A" is active
      bit 1 – window "A" is readable
      bit 2 – window "A" is writable
03h 1 Window "B": the same, as at offset 02h for window "A"
04h 2 Shift step (in kb) of windows "A", "B" in video memory
06h 2 Size of sliding windows "A" and "B" (in kb)
08h 2 Segment address of window "A" in CPU's address space
0Ah 2 Segment address of window "B" in CPU's address space
0Ch 4 Direct call address for sliding windows positioning program, similar to INT 10\AX=4F05h (8.01-39)
10h 2 Number of video memory bytes per one screen line
12h 2 Screen line length in pixels for graphic videomodes or in character cells for textual videomodes
14h 2 Screen height in pixels for graphic videomodes or in character cells for textual videomodes
16h 1 Character cell width (in pixels)
17h 1 Character cell height (in pixels)
18h 1 Number of video memory planes
19h 1 Number of video memory bits per one pixel
1Ah 1 Number of video adapter's memory banks
1Bh 1 Video memory filling model:
00h textual, alternate character and color bytes
03h 16-color graphic EGA model
04h graphic model with "packed" pixels
06h 3 color bytes per pixel (HiColor)
07h luminance-chrominance model (YUV/YIQ)
1Ch 1 Video memory bank size (in kilobytes)
1Dh 1 Number of screen pages
28h 4 Physical address of linear video buffer (VBE v2.0)

A.11 PC's hardware specifications

edit

A.11-1 Hardware configuration word

edit

Hardware configuration word is returned by INT 11 handler (8.01-42); it reads this word in BIOS data area (A.01-1) at address 0040:0010h (exact address may depend on BIOS version). Bifields in hardware configuration word should be interpreted according to the following table.

Bits Description
0 PC can be booted from existing floppy drive
1 Math coprocessor is present
2 BIOS controlled pointing device (mouse) is attached
4-5 Code of initial video mode (A.10-1)
6-7 Number of floppy drives minus one (if bit 0 is set)
9-11 Number of available serial ports (COM-ports)
12 Game port is present (for joystick)
13 Internal modem is present
14-15 Number of available parallel ports (LPT-ports)

A.11-2 PC model identifiers for HIMEM.SYS driver

edit

In order to enable access to computer's extended memory, HIMEM.SYS driver (5.04-01) has to determine CPU model. However, in some computers HIMEM.SYS can't determine CPU model properly, and then computer's identifier or its numeric code should be specified explicitly in driver's command line.

The table below presents identifiers and corresponding numeric codes for computers, which don't ensure CPU determination for at least some versions of HIMEM.SYS driver. The first place in this table (code 1) is an exception: IBM AT is a determinable model, it represents the default choice. Latest versions of HIMEM.SYS driver are able to detect properly most part of PC types, specified in this table, except Acer 1100, Wyse, and IBM 7552.

Identifier Code PC model
at 1 IBM PC AT and compatible models
ps2 2 IBM PS/2
ptlcascade 3 Phoenix Cascade BIOS
hpvectra 4 HP Vectra (A & A+)
att6300plus 5 AT&T 6300 Plus
acer1100 6 Acer 1100
toshiba 7 Toshiba 1600 & 1200XE
wyse 8 Wyse 12.5 Mhz 286
tulip 9 Tulip SX
zenith 10 Zenith ZBIOS
at1 11 reserved by IBM
at2 12 reserved by IBM
css 12 CSS Labs
at3 13 reserved by IBM
philips 13 Philips
fasthp 14 HP Vectra
ibm7552 15 IBM 7552 Industrial Computer
bullmicral 16 Bull Micral 60
dell 17 Dell XBIOS

A.11-3 Keyboard controller

edit

Keyboard controller is a chip on computer's motherboard. Though types of keyboard controllers may be different, their mission and their interface in all AT-compatible computers are unified. Main interaction between CPU and keyboard controller occurs via ports 60h and 64h.

Port 64h is always opened for reading keyboard controller's current status by IN command (7.03-26). Set state of bits in status byte, read from port 64h, should be interpreted as follows:

bit 7 – an error has occurred in data sent from keyboard
bit 6 – keyboard doesn't respond to controller
bit 4 – keyboard is blocked with ADh command
bit 2 – keyboard's self-test has been successful
bit 1 – previous operation isn't completed yet
bit 0 – a key code is prepared for reading in port 60h

At each keystroke and at each key release keyboard controller exhibits transformed key code in port 60h and just after that announces its readiness for reading via bit 0 in port 64h and via bit 4 of controller's output line.[Note 1] The latter signal invokes INT 09 handler (8.01-09), which reads the prepared byte from port 60h. Each reading access to port 60h clears bit 0 in port 64h.

Besides that, port 64h receives operation codes, sent to keyboard controller with OUT command (7.03-66). As far as keyboard controller is much slower, than CPU, before sending an operation code the CPU must wait until bit 1 will be cleared in status byte, read from the same port 64h: it will signify that the keyboard controller has finished its previous operation and is ready to receive the next operation code for execution. Codes of some important operations, which may be sent to keyboard controller's port 64h, are shown in the table below.

Code Operation
ADh Block the keyboard (switch it OFF)
AEh Activate the keyboard (switch it ON)
D1h Open port 60h for data reception [Note 1]
EDh Open port 60h for data reception [Note 2]
FEh Send reset signal to CPU [Note 3]
Notes
  1. ^ a b Having received operation code D1h via port 64h, keyboard controller begins to wait for reception of data byte via port 60h and then transfers the received data byte to its output bus. Bits of data byte are distributed among output bus lines in the following way:
    bit 7 – command output to keyboard via data line;
    bit 6 – clock output to keyboard via clock line;
    bit 4 – a call for INT 09 (8.01-09) via line IRQ 1;
    bit 1 – to gate of CPU's address line A20;
    bit 0 – to CPU's reset pin.
    Active state of controller's output lines corresponds to cleared states of bits in data byte; hence, sending a data byte with clear bit 0 is not allowed – CPU will get blocked. Because of the same reason for opening A20 line gate a data byte FFh should be sent to port 60h, and for closing access to HMA – data byte FDh.
  2. ^ Having received operation code EDh via port 64h, keyboard controller begins to wait for reception of data byte via port 60h and then transfers bit states of the received data byte to control lines of keyboard's LED indicators, in particular :
    bit 2 – to Caps Lock indicator;
    bit 1 – to Num Lock indicator;
    bit 0 – to Scroll Lock indicator.
    Indicator will be lit, if corresponding bit in data byte is set. Not mentioned bits in this data byte must be cleared.
  3. ^ Having received operation codes F0h–FFh via port 64h, keyboard controller sends four least significant bits of this operation code to lines 3–0 of its output bus. Unlike to response on reception of operation code D1h, after reception of operation codes F0h–FFh the imposed states of output lines are not fixed for ever, but are kept for about 6 milliseconds as a solitary pulse. In particular, operation code FEh causes a pulse sent to CPU's reset pin, just as after a press on RESET button on a face panel of computer's system block. Some ways to affect further events after CPU's reset are described in [Note 4 to A.12-1].

A.11-4. CPU's flags register

edit

Former 16-bit flags register in modern processors, starting from model 80386, has been expanded to 32 bits; besides that, control registers CR0, CR2 and CR3 have been introduced. Later, starting from Pentium CPU, one more control register CR4 has been added. Flags are present in all of the mentioned control registers, except CR2: it stores linear address of that last command, which requested access to a forbidden memory page. Missions of flags in flags register, and also of some flags in control registers are shown in the table below.

Register Bit Description Comments
FLAGS 00h CF – carry flag [Note 1]
FLAGS 02h PF – bit's parity in the least significant byte [Note 1]
FLAGS 04h AF – intermediate carry flag [Note 1]
FLAGS 06h ZF – zero (or equality) flag [Note 1]
FLAGS 07h SF – sign flag [Note 1]
FLAGS 08h TF – trace (step-by-step) flag
FLAGS 09h IF – interrupt enable flag [Note 1]
FLAGS 0Ah DF – index count direction flag [Note 1]
FLAGS 0Bh OF – overflow flag [Note 1]
FLAGS 0Ch I/O privilege level 2-bit field [Note 2]
FLAGS 0Eh Nested task flag [Note 3]
FLAGS 0Fh Distinctive feature of CPU 8086 [Note 3]
EFLAGS 10h Ignore debugging flag (A.11-5) [Note 4]
EFLAGS 11h VM – V86 mode flag [Note 4][Note 5]
EFLAGS 12h AC – alignment check enable flag [Note 4][Note 6]
EFLAGS 13h VIF – virtual interrupt flag [Note 4]
EFLAGS 14h VIP – virtual interrupt pending [Note 4]
EFLAGS 15h ID – CPU identification flag [Note 3][Note 4]
CR0 00h PE – protection enable flag [Note 7]
CR0 01h Coprocessor synchronization (7.02-05) [Note 7]
CR0 02h Coprocessor emulation via INT 07 [Note 7]
CR0 03h TS – task switched flag [Note 7]
CR0 04h Coprocessor's commands support [Note 7]
CR0 05h Exception enable on coprocessor's errors [Note 7]
CR0 10h WP – write protection [Note 7][Note 8]
CR0 12h AM – alignment mask [Note 7][Note 6]
CR0 1Dh NW – not write-through cache [Note 7]
CR0 1Eh CD – cache disable [Note 7]
CR0 1Fh PG – paging enabled [Note 7]
CR3 03h Cache write-through [Note 7][Note 9]
CR3 04h Page caching disabled [Note 7][Note 9]
CR4 00h VME – V86 mode extensions enabled [Note 7]
CR4 01h PVI – virtual interrupts enabled [Note 7]
CR4 02h TSD – time stamp disabled [Note 7]
CR4 03h Debugging: allow INT 01 on port calls [Note 7]
Notes
  1. ^ Mission and states of this flag are described in article 6.05-15.
  2. ^ Bits 0Ch and 0Dh in flags register express required privilege level for performing I/O operations. By default under DOS both bits 0Ch and 0Dh are set: hence, direct I/O operations are allowed for all processes. But only processes with the highest (zero) privilege level are allowed to alter states of 0Ch and 0Dh bits with POPF command (7.03-68). The latter feature enables to determine whether the current process indeed is performed at the highest privilege level.
  3. ^ Flags register enables to perform a coarse identification of CPU type. Inability to clear the 0Fh flag is a distinctive feature of obsolete 8086 CPU. Inability to set the 0Eh flag is specific for 16-bit processors. If CPU is able to set the 0Eh flag, hence it is a 32-bit CPU and is equipped with extended EFLAGS register. In the latter case bit 15 in EFLAGS register will show, whether this CPU is able to respond properly to CPU identification command (CPUID, machine code 0Fh A2h)
  4. ^ a b c EFLAGS is a 32-bit extension of 16-bit flags register. In real mode access to EFLAGS's bits 31–16 can be provided by PUSHF and POPF commands, preceded by prefix 66h, as it is described in article 7.02-06.
  5. ^ An opportunity to set V86 mode with POPF command is blocked by hardware. Nevertheless V86 mode can be set from stack with IRET command, if CPU is in protected mode and if at the same time the 06 bit in segment descriptor allows 32-bit addressing (A.12-2).
  6. ^ Here alignment implies that address of each operand in memory must be a multiple of this operand's size (in bytes). Alignment check can be performed at the lowest (the third) privilege level only, when CPU is in protected mode (note 1 to 8.01-42). Alignment mask bit in CR0 enables alignment exceptions even if these are not enabled by AC flag in EFLAGS register.
  7. ^ Control registers can be accessed with MOV command (note 1 to 7.03-58). Besides that, contents of CR0 register can be read by INT 67\AX=DE07h function (8.03-72).
  8. ^ Bit 10h is used in order to protect application programs segments from being accessed for writing to operating system or to other processes, which may have higher privilege level.
  9. ^ 20 most significant bits of CR3 register store base address of page directory. This base address must be a multiple of page size (normally 4 kb). Each writing operation to CR3 register causes updating of TLB buffer contents; this should be done after every change in page address translation table(s).

A.11-5 CPU's debugging registers

edit

Debugging registers enable to call for INT 01 handler (8.01-02) each time a particular target is addressed: a port or a prescribed memory region, including non-writable regions of address space, where breakpoints can't be stored. All modern processors of x86 platform, starting from model 80386, are equipped with debugging registers DR0–DR7. Access to debugging registers is provided by INT 67\AX=DE08h-DE09h functions (8.03-73), and also by MOV command (note 1 to 7.03-58).

Registers DR0–DR3 store four 32-bit absolute linear addresses of prescribed target points. The DR7 register defines conditions of access event enrolment. The DR6 register stores some circumstances of happened access event (programmable and external interrupts don't affect DR6 contents). Missions of selected bitfields in DR6 and DR7 registers are shown in the following table.

Register Bit Description Comments
DR6 00h Event has occurred at DR0 address [Note 1]
DR6 01h Event has occurred at DR1 address [Note 1]
DR6 02h Event has occurred at DR2 address [Note 1]
DR6 03h Event has occurred at DR3 address [Note 1]
DR6 0Dh Breakpoint debug access detected [Note 1]
DR6 0Eh BS – single step state detected [Note 1]
DR6 0Fh TS – task switch state detected [Note 1]
DR7 00h 2-bit permission field for DR0 [Note 2]
DR7 02h 2-bit permission field for DR1 [Note 2]
DR7 04h 2-bit permission field for DR2 [Note 2]
DR7 06h 2-bit permission field for DR3 [Note 2]
DR7 0Dh GD – general detect enabled [Note 3]
DR7 10h 4-bit control field for DR0 [Note 4]
DR7 14h 4-bit control field for DR1 [Note 4]
DR7 18h 4-bit control field for DR2 [Note 4]
DR7 1Ch 4-bit control field for DR3 [Note 4]
Notes
  1. ^ Access event is fixed in bits 01h–03h of DR6 register even when exception generation is not permitted by bit 0Dh in DR7 register or by bit 10h in EFLAGS register (A.11-4). Bit 0Eh in DR6 register fixes state of TF flag at the moment of access event ; bit 0Fh, the state of task switch. Set state of bit 0Dh in DR6 register reminds that exception hasn't been generated yet, though access event has happened (bit 0Dh is cleared by exception).
  2. ^ Permission field defines either local or global permission to enroll access events. The first of bits in permission field acts locally within current task only and is turned off at each task change. The second bit in permission field is imparted with global property and enables to enroll access events beyond the current task.
  3. ^ Bit 0Dh in DR7 register doesn't affect access event enrolment, but rather allows exception generation, caused by access event. State of 0Dh bit in DR7 can't be changed unless the process either has the highest privilege level or is executed in real mode.
  4. ^ The first pair of bits in each control field defines purpose of those access events, which should be intercepted :
    00 – attempt to execute machine code
    01 – attempt of writing into memory
    10 – I/O address to a port (for CPUs Pentium+)
    11 – both reading and writing attempts.
    The second pair of bits in each control field defines size of the monitored address space: a byte, a word or a double word. Attempt of access to either byte within monitored address space is equally enrolled as access event.

A.12 Memory allocation and management

edit

A.12-1 General memory map

edit

This table shows general allocation of memory space below 1 Mb, typical for AT-compatible computers, controlled by DOS operating system. However, memory allocation depends on BIOS version, on BIOS Setup settings, on particular computer's configuration. Therefore some features of memory allocation in your computer may differ from those shown below.

Address Size Description
0000:0000 400h Interrupt table for real mode
0000:0074 4 Pointer to video register's default settings
0000:0078 4 Pointer to default floppy data table (A.08-2)
0000:007C 4 Pointer to 8x8 graphic font characters 80–FFh
0000:0104 4 Pointer to 1st HDD parameters table (A.13-1)
0000:010C 4 Pointer to current graphic font (8.01-30)
0000:0118 4 Pointer to 2nd HDD parameters table (A.13-1)
0040:0000 100h BIOS data area (A.01-1)
0050:0000 1 Printer's status for INT 05 (8.01-06)
0050:0004 1 Floppy drive choice (A: or B:)
0050:0040 BCh Selected pointers to original interrupt handlers [Note 6]
0000:7C00 200h Default area to load and execute boot record
9000:FFFF Upper boundary of "conventional" memory [Note 1]
A000:0000 10000h Video memory access "window" [Note 2]
B000:0000 10000h Video memory access "window" [Note 2]
B800:0000 8000h Video buffer for textual videomodes EGA+
C000:0000 8000h Video adapter's BIOS area [Note 3]
C000:0070 7 "EXTMODE" signature: SVGA videomodes support
C800:0000 4000h Hard disk's BIOS area
D000:0000 10000h Default area for UMBs, arranged by EMM386.EXE
E000:0000 10000h Default area for expanded memory pages
F000:0000 FFFFh Relocated copy of PC's ROM BIOS [Note 3]
F000:FFF0 Reboot program's entrance point [Note 4]
F000:FFF5 8 BIOS date
F000:FFFD 1 BIOS code checksum
F000:FFFE 1 Computer's model code
FFFF:0010 FFEFh High memory area [Note 5]
Notes
  1. ^ The 640 kb boundary of conventional memory is hardware defined by dynamic memory controller chip in motherboard's chipset. Above this boundary the next 384 kb of address space are reserved for video memory and for BIOS ROM chips. Free space in this area normally is made accessible in protected mode due to address translation mechanism in CPU.
  2. ^ a b Address space area A000:0000–B000:FFFF provides access to video memory. Particular usage of this area depends on videomode (A.10-1). SVGA BIOS of modern video adapters arranges in this area one or two "sliding" windows, providing "sliding" access to selected part(s) of large video memory (details in section 8.01-39).
  3. ^ a b Access via the same areas of address space may be arranged either directly to BIOS and video BIOS codes in ROM chips or to copies of these codes in a more fast RAM. A choice of a particular alternative depends on "shadowing" parameters settings for corresponding memory areas, set by BIOS Setup program.
  4. ^ a b c d e Reset program's entrance point address F000:FFF0h is hardware defined by CPU : at power-on the initial state of its address bus is just FFFF0h. Further booting process depends on value written in byte 0Fh in BIOS's CMOS RAM[Note 1 to A.14-1]:
    00h – ordinary booting with POST test
    04h – reboot with a call for INT 19 (8.01-90)
    05h – reset and jump to address in 0040:0067 cell (A.01-1)
    0Ah – jump to address prepared in 0040:0067 cell (A.01-1)
    Unlike booting after power-on, POST test after reboot depends on a word at address 0040:0072h.[Note 1 to A.01-1] Alternatives 05h and 0Ah are used after reboot only and differ in that whether interrupt controller will be reset or not.
  5. ^ High memory area is accessed, when segment address summation with offset produces a carry bit, directed into A20 line of address bus. High memory area is accessible in real mode, but needs HIMEM.SYS driver (5.04-01) to be installed, which provides control over A20 line gate.
  6. ^ The 0050:0040–0050:00FB area stores copies of selected interrupt handler's addresses (INT 00 – INT 1F, INT 40 – INT 43, INT 46, INT 70 – INT 77), prepared by BIOS for subsequent loading of operating system. In main interrupt table these addresses may be overwritten by addresses of other handlers, installed later either by MS-DOS 7 itself, or by TSR programs, or by drivers.

A.12-2 Segment descriptors

edit

Segment boundaries and access rights in protected mode are defined by segment descriptors. A number of most important segment descriptors constitute global descriptor table (GDT). CPU transition to protected mode implies presence of a GDT, at least partially prepared beforehand, while CPU is in real mode. Order and selection of descriptors in the prepared GDT depend on requirements of that procedure, which should control CPU transition to protected mode.

Examples of GDT tables for different procedures are shown in articles 8.01-76, 8.01-78 and 9.10-01. In all GDT tables the first descriptor must be filled with zeros: it is a template for non-requested segments and memory pages. All descriptors have the same internal structure, shown in the following table. Least

Offset Size Description
00h 2 Less significant 2 bytes of segment size, the least first
02h 3 Less significant 3 bytes of base address, the least first
05h 1 Access rights byte [Note 2]:
    bit 0: = 0 – segment hasn't been accessed yet
      = 1 – segment has been accessed
    bit 1: = 0 – data reading or code execution only
      = 1 – data writing and code reading allowed
    bit 2 : – direction of expansion [Note 3]
    bit 3 : = 0 – segment contains data
      = 1 – segment contains executable code
    bit 4 : = 0 – system descriptor's marker
      = 1 – application descriptor's marker
    bits 5–6 : – privilege level :
      = 00 – highest
      = 11 – lowest
    bit 7 : = 0 – segment must be read from disk
      = 1 – segment is present in RAM
06h 1 bits 0–3 : – most significant 4 bits of segment size
    bit 4: – free bit [Note 4]:
    bit 5: = 0 (reserved)
    bit 6: – address and operand's size [Note 5]:
      = 0 – 16-bit addressing and operands
      = 1 – 32-bit addressing and operands
    bit 7: – granularity bit:
      = 0 – segment size count in bytes
      = 1 – segment size count in 4 kb units
07h 1 Most significant byte of base address
Notes
  1. ^ Bytes 06h and 07h of segment descriptor are taken into account by CPU models 80386 and higher. If program is expected to be executed by CPU 80286, then bytes 06h and 07h must be cleared. Zero values of bytes 06h and 07h are a distinctive feature of protected mode 16-bit programs, enabling their proper execution by 32-bit CPU models.
  2. ^ Interpretation of bits 0–3 in access rights byte depends on bit 4. The shown interpretation of bits 0–3 relates to application programs, including their data segments and executable code segments. In system descriptors bits 0–3 define 16 types of different descriptor's subtypes.
  3. ^ Interpretation of bit 2 in access rights byte depends on bit 3. In code segments cleared state of bit 2 means that code can be executed by programs of the same privilege level (otherwise code also can be executed by programs having higher privilege level). For data segments cleared state of bit 2 means normal expansion direction upwards, whereas set state of bit 2 means reverse expansion direction — downwards, as used in stack segments.
  4. ^ Bit 4 in byte 06h is available to programmer's regulation. In memory page descriptors this bit is used as a redefinition ban mark, for example, for mapping I/O address space into memory.
  5. ^ a b c d Size bit 6 in byte 06h of code segment descriptors defines sizes of both addresses and operands. In system segments, bits 4–6 of byte 06h must be cleared.

A.12-3 Selected subfunctions of XMS-driver

edit

XMS subfunctions are performed by extended memory driver HIMEM.SYS (5.04-01). Before these subfunctions can be used, two preliminary operations have to be done. First is to check with INT 2F\AX=4300h function (8.03-22) whether HIMEM.SYS driver is installed. The second operation is to find out with INT 2F\AX=4310h function (8.03-23) an address of XMS driver's entrance point. Returned double-word address should be specified for a CALL FAR command (7.03-08). On call the subfunction to be executed is defined by value in AX register, shown in the first column of the table below. DX register's mission is shown in second column, returned AX contents – in the fourth column. If AX returns status, AX=0001h means success, AX=0000h means failure. In case of failure, almost all subfunctions (except AH=00h) return error code (A.06-1) in BL register. Query subfunctions AH=08h and AH=88h return error code in BL register in any case.

AH DX Subfunction AX on return Comments
00h   Report XMS version XMS version [Note 1]
05h   Turn ON the A20 line gate status
06h   Turn OFF the A20 line gate status
08h   Report free XMS-memory largest block [Note 2]
09h size Allot XMS-memory block status [Note 3]
0Ah handle Release XMS-memory block status
0Bh   Copying in XMS-memory status A.12-4
0Ch handle Lock XMS-memory block status [Note 4]
0Dh handle Unlock XMS-memory block status
0Eh handle Get XMS handle information status [Note 5]
0Fh handle Resize XMS-memory block status [Note 6]
10h size Allot UMB memory block status [Note 7][Note 8]
11h segment Release UMB memory block status [Note 7]
12h segment Resize UMB memory block status [Note 7][Note 8]
88h   Report free XMS memory largest block [Note 2][Note 9]
89h size Allot XMS-memory block status [Note 3][Note 9]
8Eh handle Get XMS handle information status [Note 5][Note 9]
8Fh handle Resize XMS-memory block status [Note 6][Note 9]
Notes
  1. ^ This subfunction returns status of HMA area in DX register: DX=0001h signifies that HMA area is in use, DX=0000h – that HMA area is not used.
  2. ^ On call subfunction 08h needs BL=00h. On return size of free XMS memory (in kilobytes) is reported in DX register, and size of the largest available XMSmemory block is reported in AX register. The 88h subfunction does the same, but returns similar results in 32-bit registers EDX and EAX. Besides that, subfunction 88h in ECX register returns maximum physical address, corresponding to furthermost available byte of XMS-memory.
  3. ^ Both 09h and 89h subfunctions accept requested size of XMS-memory block in kilobytes, but 09h subfunction accepts requested size from DX register, whereas 89h subfunction accepts requested size from 32-bit EDX register. Both 09h and 89h subfunctions return a handle for allotted XMS-memory block in DX register.
  4. ^ In case of success registers DX:BX return 32-bit physical address of that memory block, which has been locked.
  5. ^ The 0Eh subfunction returns in BH register a number of lock counts for the requested XMS block, in BL register – number of free handles, in DX register – size in kilobytes of XMS block, opened for access by the specified handle. The 8Eh subfunction does the same, but returns number of free handles in CX register, and size of XMS block – in EDX register.
  6. ^ a b Resizing subfunction 0Fh accepts new size (in kilobytes) for the requested memory block from BX register. The 8Fh subfunction does the same, but accepts new size from EBX register. Requested memory block must not be locked.
  7. ^ For CPU models 80386 and higher the 10h–12h subfunctions usually are implemented by means of address translation in CPU's TLB buffer. Therefore execution of these subfunctions is relegated to EMM386.EXE driver (5.04-02), which arranges address translation and intercepts address of direct calls for HIMEM.SYS driver. However, subfunctions 10h–12h don't necessarily require switching CPU to protected mode and can be implemented in real mode by UMBPCI.SYS driver (5.04-04).
  8. ^ Both 10h and 12h subfunctions operate with UMB block size specifications in 16-byte units (paragraphs). Resizing subfunction 12h accepts requested new size from BX register. Allocation subfunction 10h in case of successful termination returns segment address of UMB block in BX register, and actual size of UMB block — in DX register. In case of a failure, marked by AX=0000h value, both 10h and 12h subfunctions return size of the largest available UMB block in DX register.
  9. ^ Unlike 0xh subfunctions, the 8xh subfunctions can't be implemented by obsolete 16-bit processors and require HIMEM.SYS driver's version not less than 3.07.

A.12-4 Format of XMS copy request

edit

A pointer to this request data block is accepted from DS:SI registers by subfunction AH = 0Bh (A.12-3) of XMS driver HIMEM.SYS (5.04-01). Subfunction AH = 0Bh copies a group of bytes from one XMS block, addressed via source handle, to another XMS block, addressed via destination handle.

Offset Size Description
00h 4 Number of bytes to copy (must be even)
04h 2 Source handle
06h 4 Offset in source block
0Ah 2 Destination handle
0Ch 4 Offset in destination block

Note 1: if source and destination overlap, only forward copying (source base less than destination base) is guaranteed to work properly.

Note 2: if either handle in the request is 0000h, then the corresponding offset double-word is interpreted as ordinary address (segment: offset) inside directly addressable conventional memory.

A.12-5 Format of EMS copy descriptor

edit

EMS copy descriptor specifies source and destination for copying and exchange functions INT 67\AX=5700h-5701h (8.03-69), performed by EMM386.EXE driver (5.04-02). Both source and destination may belong either to EMS memory page(s) or to conventional memory. In the latter case 0000h value should be written instead of corresponding handle number, and location should be specified by segment address in place of EMS logical page number.

Offset Size Description
00h 4 Length in bytes of the data block to be copied/exchanged
04h 1 = 00h: source block is in conventional memory
    = 01h: source block is in EMS-memory page
05h 2 Source handle (0000h if source in conventional memory)
07h 2 Source offset in page or in conventional memory segment
09h 2 Source logical page or segment in conventional memory
0Bh 1 = 00h: destination block is in conventional memory
    = 01h: destination block is in EMS-memory page
0Ch 2 Destination handle (0000h if destination in conventional memory)
0Eh 2 Destination offset in page or in conventional memory segment
10h 2 Destination logical page or segment in conventional memory

Note 1: for move operation the source and destination may overlap, but then only one direction of copying provides proper result.

A.12-6 Data block for jumps inside EMS memory

edit

The shown data block specifies parameters of a call for subroutine inside EMS memory, performed by INT 67\AH=56h function (8.03-68) of EMM386.EXE driver (5.04-02). A far jump operation inside EMS memory, performed by INT 67\AH=55h function (8.03-68), uses a part of the shown data block up to offset 09h.

Offset Size Description
00h 4 Target address (segment: offset)
04h 1 Length of new page mapping list
05h 4 Pointer to new page mapping list
09h 1 Length of current page mapping list
0Ah 4 Pointer to current page mapping list
0Eh 8 (reserved for EMM386.EXE driver's data)

Note 1: internal structure of page mapping lists is described in note 3 to article 8.03-66. Data about current page mapping list, which is to be replaced, are needed for return to current program execution when subroutine's execution terminates.

A.12-7 Memory control descriptors

edit

Computer's memory allocation is a prerogative of operating system. Each memory block, allotted by DOS, is preceded by a 16 bytes long memory control descriptor. These descriptors are also known as MCB (Memory Control Blocks). MCBs are easy to find: segment address of MCB descriptor is always a unity less, than segment address of allotted memory block, associated with this MCB descriptor.

DOS traces the whole available memory via a chain of MCB descriptors.[Note 3] Free memory space beyond the allocated memory areas is considered by DOS as a separate memory block: it also must be preceded by MCB descriptor. A distinctive feature of MCB descriptor(s), associated with free memory space(s), is code 0000h instead of segment address of the owner program. All data about available free memory and about disposition of particular free memory areas DOS acquires from a traceable chain of MCB descriptors.

Data structure inside a MCB descriptor is shown in the following table.

Offset Size Description Comments
00h 1 = 4Dh (= M) – not-the-last MCB [Note 1]
    = 5Ah (= Z) – the last MCB in a chain
01h 2 Segment address of owner program [Note 2]
03h 2 Size of associated memory block [Note 3]
05h 3 Not used
08h 8 Program filename [Note 4]
Notes
  1. ^ Memory block with main DOS's system data is divided into subblocks, each having its own MCB descriptor, but with other identifiers in a byte at offset 00h :
    42h (= B) – subblock with buffers (4.03)
    44h (= D) – subblock for DOS's drivers
    45h (= E) – data subblock for DOS's drivers
    46h (= F) – subbblock with SFT table (4.12)
    49h (= I) – subblock for IFS data
    4Ch (= L) – subblock with CDS table (4.17)
    53h (= S) – subblock for DOS's stacks (4.27)
    54h (= T) – subblock for transition code(s)
    58h (= X) – subblock for FCBS (4.10)
  2. ^ If associated memory space is free, then in MCB descriptor a word at offset 01h is filled with zeros. If associated memory block is allocated by DOS to itself, then code 0008h is written in a word at offset 01h instead of segment address of the owner program.
  3. a b Size of associated memory block is specified in 16-byte units (paragraphs). Segment address of each next MCB descriptor is a unity greater than a sum of a number, specified at offset 03h in current MCB descriptor, with segment address of current MCB descriptor. On basis of this formula DOS traces a chain of MCB descriptors. Tracing starts from the first MCB descriptor; segment address of this first MCB descriptor is stored in a word just preceding DOS's List-of-Lists. This word is marked in table A.01-2 as having offset −02h.
  4. ^ Name of program's file is specified in those MCB descriptors, which are associated with PSP memory blocks, with driver's subblocks and with IFS subblocks. At offset 08h in several other MCB descriptors there are signatures with the following meaning :
    SC – associated block contains DOS's executable code;
    SD – associated block contains DOS's data;
    SM – associated block is the last in UMB area;
    UMB – associated block is the first in UMB area.
    Bytes 08h–0Fh in MCB descriptors, associated with other memory blocks, are not used and may contain "garbage".
  5. ^ Program files with *.COM suffix have no headers, which specify the required memory space for other types of executable files. This is why for programs with *.COM suffix DOS allocates the whole free memory space, following previously allocated memory areas. When DOS has no more free memory space, then computer may get hanged at each next request for memory space, which may come from unexpectedly activated resident program of from a handler, invoked by external interrupt. In order to avoid a threat of hanging the programs with *.COM suffix must call for INT 21\AH=4Ah function (8.02-52), forming a separate MCB descriptor for unused part of memory and thus announcing it free. Examples of such calls are shown in the first 6 lines of assembler texts in articles 9.06, 9.10-01 and 9.10-02.

A.13 Hard disk data structures

edit

A.13-1 BIOS tables of physical HDD parameters

edit

BIOS systems in obsolete computers, produced before 1996, addressed HDDs with parameters CHS (Cylinder-Head-Sector). HDD's storage space, available for CHS addressing, is limited to 528 Mb. BIOS system stored CHS parameters of first and second physical HDDs in data tables; addresses of these tables were written in memory cells 0000:0104h and 0000:0118h correspondingly. Both these cells are inside interrupt table (A.12-1) and sometimes are referred to as INT 41 and INT 46. If computer was equipped with more than two HDDs, then the only way to obtain CHS parameters of the rest HDDs was a call for INT 13\AH=08h function (8.01-49).

In 1995 capacities of HDDs have reached 1 Gb. The 528 Mb limit, inherent to CHS addressing, had to be overcame. For newer BIOS systems LBA addressing[Note 4 to A.13-6] and extended INT 13 functions (8.01-55 – 8.01-60) have been developed. But compatibility with former programs had to be preserved. Therefore in newer BIOS systems the INT 13\AH=08h function (8.01-49) has been "taught" to yield not the real, but transformed CHS parameters. When programs call for "old" INT 13 functions (8.01-46 – 8.01-54) and specify transformed CHS parameters, then BIOS system automatically performs reverse transformation so that HDD's storage space, available for CHS addressing, is expanded to 8.4 Gb (some detail in note 2 to A.13-6).

Data blocks, addressed by pointers stored in cells 0000:0104h and 0000:0118h, may have different data structures: it depends on whether there are real or transformed CHS parameters. Both kinds of data structures are shown in the table below. Real data offsets are shown in the first column (Std). Offsets in the second column (Trs) correspond to transformed CHS data, conforming to Phoenix-1995 specification for HDDs with more than 1024 cylinders. Though described data blocks are supported by modern BIOS systems, nevertheless for programs being developed now usage of parameters from these data blocks is not recommended.

Std Trs Size Description
00h 00h 2 Number of HDD's cylinders [Note 1]
02h 02h 1 Number of HDD's heads [Note 1]
  03h 1 Signature A0h — distinctive feature of blocks, conforming to Phoenix-1995 specification.
  04h 1 Number of sectors per track [Note 2]
05h 05h 2 Cylinder number, where write precompensation should start [Note 3]
08h 08h 1 Flags : bit 2 – no recalibration;
        bit 3 – more than 8 heads;
        bit 5 – defect map is present[Note 4];
        bit 6 – disable ECC reading retries;
        bit 7 – disable access retries.
  09h 2 Number of tracks (up to 65536)[Note 2]
  0Bh 1 Number of heads (up to 16)[Note 2]
0Ch 0Ch 2 Cylinder number of landing zone[Note 3]
0Eh 0Eh 1 Number of sectors per track [Note 1]
  0Fh 1 Data checksum
Notes
  1. ^ CHS parameters in these positions are for "old" functions of INT 13 handler (8.01-46 – 8.01-54). Nevertheless there are some BIOS versions, which specify in these positions a number of cylinders exceeding 1024, inadmissible for "old" functions.
  2. ^ These positions are filled with real HDD's parameters for programs, appealing not to INT 13 handler, but directly to HDD controller's port. These positions are not filled in those data blocks, which supply real parameters for "old" functions of INT 13 handler.
  3. ^ Modern disk drives perform landing and write precompensation independently. Attempts to affect these operations are ignored.
  4. ^ The track number, where surface defect map is written, is usually a unit greater than the number of cylinders, specified at offset 00h in BIOS tables of physical HDD's parameters.

A.13-2 Extended table of HDD's parameters

edit

Extended table of HDD's parameters is written into a prepared buffer by INT 13\AH=48h function (8.01-60).

Offset Size Description
00h 2 On call: length of prepared buffer (8.01-60)
    On return: actual length of returned data
02h 2 Flags : bit 0 : DMA boundary errors handled transparently
      bit 1 : CHS data (A.13-1) are valid
      bit 2 : this is a removable drive, bits 4–6 are valid
      bit 3 : writing with verification is supported
      bit 4 : drive provides change-line support
      bit 5 : drive provides locking and unlocking
      bit 6 : media isn't present, default CHS data reported
04h 4 Number of physical cylinders on the drive [Note 1]
08h 4 Number of physical heads on the drive [Note 1]
0Ch 4 Number of physical sectors per track (counted from 1)
10h 8 Total number of sectors (number of the last sector plus 1)
18h 2 Bytes per sector
1Ah 4 Pointer to auxiliary DPTE table [Note 2]
1Eh 2 = BEDDh: signature confirming path data presence
20h 1 = 2Ch: size of path data, including the signature
24h 4 Bus type (ISA or PCI) appended with a space (20h)
28h 8 Interface type [Note 3]
30h 8 Interface path field [Note 4]
38h 16 Device path field [Note 5]
49h 1 Complement checksum for bytes at offsets 1Eh–48h
Notes
  1. ^ Valid numbers of tracks, cylinders and heads are counted from zero, therefore the last valid number is a unity less than the value specified in this field. A value in this field is a real value. Therefore this value shouldn't be specified in calls for "old" INT 13 functions: these functions require transformed parameters, returned by INT 13\AH=08h function (8.01-49).
  2. ^ BIOS INT 13 extensions below version 2.x don't return DPTE table, and fill DPTE pointer field with FFFFh:FFFFh value. Structure of DPTE table is shown in appendix A.13-3. DPTE table is presented in a temporary buffer; its contents are not preserved after next calls for BIOS functions.
  3. ^ Interface type field may be filled with the following words: 1394, ATA, ATAPI, SCSI, USB. Words are appended with spaces up to nominal field length 8 bytes.
  4. ^ For ISA bus the path field contains a 2-byte base I/O port address, bytes at offsets 32h–37h are zeros. For PCI bus a byte at offset 30h presents bus number ; byte at offset 31h, slot number ; byte at offset 32h, function number ; byte at offset 33h, controller number ; bytes at offsets 34h–37h are zeros.
  5. ^ For 1394 (Firewire) interface a 8-byte extended unique identifier (EUI-64) is specified at offset 38h. For ATA (IDE) interface the 00h value at offset 38h signifies master device, the 01h value at offset 38h signifies slave device. Byte at offset 38h has the same meaning for ATAPI interface, but byte at offset 39h represents logical unit number (LUN). For SCSI interface a 2-byte device identifier (SCSI ID) is specified starting at offset 38h, and a 8-byte logical unit number (LUN) is specified starting at offset 3Ah. For USB interface a 8-byte serial number is written starting at offset 38h. Not mentioned bytes at offsets 3Ah–48h are reserved and must be cleared.

A.13-3 Auxiliary device parameters table DPTE

edit

BIOS INT 13 version 2.0 and higher supplement extended HDD's parameters table (A.13-2) with auxiliary device parameters table DPTE. A pointer to DPTE table is returned by INT 13\AH=48h function (8.01-60) at offset 1Ah inside extended HDD's parameters table (A.13-2). DPTE address points at a temporary buffer, which doesn't preserve its contents after following BIOS functions calls. Data in DPTE table are consigned for those programs, which intend to appeal directly to ports of HDD controller. DPTE data structure is shown in the table below.

Offset Size Description
00h 2 Physical I/O port base address for the device
02h 2 Disk drive control registers port address
04h 1 Flags : bits 0–3 are cleared, bits 5 and 7 are set
      bit 4 : cleared if master device, set if slave
      bit 6 : set if LBA addressing is enabled
06h 1 Bits 0–3 : IRQ number, bits 4–7 are cleared
07h 1 Blocks (sectors) count for multi-block transfers
08h 1 Bits 0–3 : DMA channel number, bits 4–7: DMA type according to ATA-2 specification.
09h 1 Bits 0–3 : PIO type, if in a word at offset 0Ah bit 0 is set.
0Ah 2 Flags : bit 0 : fast PIO enabled, byte 09h is valid
      bit 1 : fast DMA access enabled
      bit 2 : multi-sector transfers enabled
      bit 3 : CHS parameters translation enabled
      bit 4 : LBA translation enabled
      bit 5 : drive uses removable media
      bit 6 : ATAPI interface device (probably CD-ROM)
      bit 7 : 32-bit transfer mode enabled
      bit 8 : ATAPI signal readiness for packet transfers
      bits 9–10 : CHS parameters translation type:
= 00 – bit-shifting translation
= 01 – LBA-assisted translation
= 10, 11 – proprietary translation
      bit 11 : ultra DMA access enabled.
0Eh 1 INT 13 extension version number
0Fh 1 Complement checksum of bytes 00h–0Eh

A.13-4 Disk address packet

edit

This form of data packet is used by extended reading function INT 13\AH=42h (8.01-56) and by extended writing function INT 13\AH=43h (8.01-57). Before applying these functions a check for their BIOS support should be made with a call for INT 13\AH=41h (8.01-55).

Offset Size Description
00h 1 Size of address packet [Note 1]
02h 1 Number (up to 7Fh) of data blocks to transfer [Note&nbsp21]
04h 4 Pointer to data transfer buffer [Note 3]
08h 8 LBA absolute number of the first data block [Note 4]
10h 8 64-bit pointer to data transfer buffer [Note 3]
18h 8 Number of data blocks to transfer [Note&nbsp21]
Notes
  1. ^ If extended disk address packet is supported, then size is 20h, otherwise size is 10h. Set state of bit 3 in CX register, returned by INT 13\AH=41h function (8.01-55), signifies that extended disk address packet is supported.
  2. ^ If extended disk address packet is supported, and if the FFh value is written into a byte at offset 02h, then number of blocks to transfer will be read from a quad word at offset 18h. On return this number at offset 18h is replaced with number of blocks, which actually have been transferred.
  3. ^ If extended disk address packet is supported, and if FFFF:FFFFh value is written into a double word at offset 04h, then pointer to data buffer will be read from a quad word at offset 10h.
  4. ^ For disk drives, not supporting LBA addressing,[Note 4 to A.13-6] absolute number of starting block is calculated according to formula
    (C×N + H)×T + S − 1
    where: C – number of the selected cylinder, N – number of heads (by 1 greater than maximum head number), H – number of the selected head, T – number of sectors per track, S – number of the selected sector on a track.

A.13-5 HDD's partition descriptors

edit

In sector 01h of bootable physical HDD's head 00 cylinder 00 is the master boot record (MBR), containing up to 446 bytes of executable code, 4-byte identifier (at offsets 1B8h–1BBh) and partition table. Identifier is written by operating systems Windows-NT/2000/XP only and may be absent. In order to view MBR sector it should be copied into a file, as it is explained in article 9.02-02. Non-textual file can be opened by a viewer of Volkov Commander file manager (6.25) or else by debugger DEBUG.EXE (6.05). Fig.12 shows fragments of MBR sector, copied from a real physical disk.

 
Fig. 12

The first fragment presents starting part of executable code (proprietary OnTrack's MBR version). The second fragment presents final part of that executable code with a prepared error message. The third fragment presents partition table, defining division of HDD's writable surface into partitions in a particular computer.

Partition table consists of 4 partition descriptors, each 16 bytes long. If offsets are counted from start of MBR sector, then partition descriptor's offsets are 1BEh, 1CEh, 1DEh, 1EEh correspondingly. However, MBR sector's copy, shown in fig.12, is loaded from offset 100h and on; therefore in fig.12 partition descriptor's offsets are 2BEh, 2CEh, 2DEh, 2EEh. The last word in MBR sector is a signature AA55h, marking the end of bootable disk's MBR.

Four partition descriptors enable to create up to four primary partitions in any physical HDD drive. If there is less than 4 partitions, the rest descriptors are filled with zeros. In fig.12 the first descriptor in partition table is filled with zeros. Hence, this particular HDD is divided into three valid primary partitions.

On a bootable HDD one primary partition must be marked as active (potentially bootable) with a 80h mark in the first descriptor's byte. In fig.12 the 80h mark is present at offset 02CEh, which is the first byte of the second partition descriptor. Hence, active partition in this particular HDD is the second partition.

Missions of the mentioned and of other bytes in partition descriptors are shown in the table below. Offsets in the first column of the table are counted from the start of each partition descriptor.

Offset Size Description
00h 1 Status indicator (80h – active partition)
01h 1 Partition's start HDD's head
02h 1 Partition's first sector [Note 1]
03h 1 Partition's first track [Note 1]
04h 1 Partition's file system identifier (A.13-6)
05h 1 Partition's final HDD's head
06h 1 Partition's last sector [Note 2]
07h 1 Partition's last track [Note 2]
08h 4 Number of sectors preceding the partition
0Ch 4 Length of the partition (in sectors)
Notes
  1. ^ In a byte at offset 02h bits 5–0 express number of partition's first sector on a track, but bits 6 and 7 represent most significant bits of partition's 10-bit first track number. 8 least significant bits of partition's 10-bit first track number are stored in a byte at offset 03h.
  2. ^ In a byte at offset 06h bits 5–0 express number of partition's last sector on a track, but bits 6 and 7 represent most significant bits of partition's 10-bit last track number. 8 least significant bits of partition's 10-bit last track number are stored in a byte at offset 07h.
  3. Descriptors to partitions with LBA addressing[Note 4 to A.13-6] may contain invalid CHS parameters (numbers of tracks, heads and sectors). Nevertheless data in bytes at offsets 08h–0Fh must be valid.

A.13-6 Selected file system identifiers

edit

In each partition descriptor (A.13-5) a byte at offset 04h is file system identifier. Operating system reads file system identifier and "decides" whether it can ensure access to this partition. If file system identifier is not "known" to operating system, then access to this partition will not be attempted. Most probably such partition even wouldn't be shown to user. Some file system identifiers denote hidden partitions, which can be accessed for system purposes, but stay hidden for the user. The table below presents interpretation of selected file system identifiers.

ID Description
00h Free disk's space
01h File system FAT-12 for volumes 16 Mb and less
04h Obsolete FAT-16 up to 32 Mb without cluster structure
05h Extended partition with CHS addressing [Note 1][Note 2]
06h FAT-16 up to 2 Gb with CHS addressing [Note 2]
07h NTFS file system [Note 3]
0Bh FAT-32 with CHS addressing [Note 2]
0Ch FAT-32 with LBA addressing [Note 4]
0Eh FAT-16 up to 2 Gb with LBA addressing [Note 4]
0Fh extended partition with LBA addressing [Note 1][Note 4]
11h Hidden FAT-12 partition (for OS/2 boot manager)
14h Hidden FAT-16 partition (for OS/2 boot manager)
1Bh Hidden FAT-32 with CHS addressing [Note 2]
1Ch Hidden FAT-32 with LBA addressing [Note 4]
3Ch PowerQuest's Partition Magic recovery partition
42h Dynamic partition of Windows Vista OS
43h PTS DOS boot manager's (BootWizard's) partition
4Dh-4Fh QNX OS partitions
54h OnTrack Disk Manager's DDO (Dynamic Drive Overlay)
64h-65h Novell Netware OS partitions
82h Linux OS swap partition
83h Ext2fs file system of Linux OS
84h Partition for power supply state recovery
85h Linux OS extended partition [Note 1]
A0h Partition for portable PC's state recovery
A5h FreeBSD OS partition
A6h OpenBSD OS partition
A8h UFS file system of MacOS
A9h Net BSD OS partition
ABh Bootable partition of MacOS
BEh Bootable partition of Solaris OS
D8h, DBh CP/M OS partitions
EBh BFS1 file system of BeOS
EEh GPT partition of 64-bit Windows OS versions [Note 5]
FDh RAID partition of Linux OS
Notes
  1. ^ Extended partition is a formal specification of disk's space for placement of several non-primary partitions (logical disks). Descriptors of non-primary partitions are written not in MBR, but in separate dedicated sectors, traced via a chain of references. MS-DOS doesn't allow this chain to be closed in a loop, otherwise MS-DOS hangs in infinite cycle of finding the end of this loop.
  2. a b As far as parameters CHS (Cylinder-Head-Sector) occupy 3 bytes in partition descriptors (A.13-5), hence CHS parameters enable to address not more than 2^24 sectors 512 bytes each, equivalent to 2^23 kilobytes, or else 8 Gb. Therefore partitions with CHS addressing can't be arranged beyond first 8 Gb, counted from the start of disk's space (LBA addressing should be applied further). In table A.13-6 those only identifiers are marked with CHS, which are used as distinctive features of CHS addressing.
  3. ^ The 07h file system identifier is interpreted by Microsoft as belonging to installable file systems (IFS), file systems with transformed presentation to the user. But in fact, besides NTFS, only one rarely used IBM's HPFS file system is marked with 07h identifier.
  4. ^ a b c d e f Linear Block Addressing (LBA) is based on sectors count from start of disk's space according to data in bytes 08h–0Fh in partition descriptors (A.13-5). LBA enables to overcome the 8 Gb boundary, inherent to CHS addressing. LBA requires support for extended functions of INT 13 handler (8.01-55) from both disk drive and BIOS system. All modern computers provide such support.
  5. ^ Data about partitions GPT (= GUID Partition Table) constitute extended MBR, occupying not a single sector, but a considerable part of disk's first track. Only 64-bit versions of operating systems Windows server 2003, Windows XP and Windows Vista provide support for GPT partitions.
  6. As far as it is known, partition identifiers 21, 23, 26, 31, 33, 34, 36, 71, 73, 74, 76, 86, A1, A3, A4, A6, B1, B3, B4, B6, E5, E6, F3, F6 are reserved and are not used yet.

A.13-7 Disk's free space table

edit

This table with data about logical disk's free space is returned by INT 21\AX=7303h function (8.02-80), which may be applied to logical disks, formatted with FAT-12, FAT-16 and FAT-32 file systems.

Offset Size Description
00h 2 Size of this table (in bytes)
02h 2 Must be = 0000h on call
08h 4 Number of bytes per sector
0Ch 4 Number of free clusters
10h 4 Total number of clusters in logical disk
14h 4 Number of free physical sectors in logical disk
18h 4 Total number of physical sectors in logical disk
1Ch 4 Number of available allocation units
20h 4 Total number of allocation units in logical disk

A.14 I/O Ports

edit

A.14-1 Selected port addresses

edit

Ports represent computer's hardware and therefore should be addressed either via BIOS functions, which are adapted to a particular computer's motherboard, or via device drivers for expansion boards. Direct access to ports can't be recommended for application programs, though there are some exceptions. But knowledge of port addresses is beneficial, at least in order to avoid address conflicts with expansion boards.

The table below shows relatively steady features of general port addresses allocation in AT-compatible computers. Of course, port addresses allocation in your particular computer may somewhat differ from the one shown below.

Address ranges Target devices
0000h–001Fh 1st direct memory access controller (DMA1)
0020h–0021h 1st interrupt controller (IRQ 1 – IRQ 7, 8.01-09)
0022h–0023h Dynamic RAM controller
0060h–0064h Keyboard controller (A.11-3)
0070h CMOS RAM requests reception port [Note 1]
0071h CMOS RAM data I/O port [Note 1]
0080h Manufacturing diagnostics port
00A0h–00A1h 2nd interrupt controller (IRQ 8 – IRQ 15, 8.03-75)
00B2h–00B3h Advanced power management ports
00C0h–00DFh 2nd direct memory access controller (DMA2)
00F0h–00FFh Arithmetic coprocessor
0168h–016Fh IFS devices or expansion boards
0170h–0177h 2nd IDE HDD controller (default IRQ 15)
01E8h–01Efh PS/2 mouse or other devices (IRQ 12)
01F0h–01F7h 1st IDE HDD controller (default IRQ 14)
01F8h A20 line gate control
0200h–020Fh Game port (joystick)
0279h Plug-and-play configuration register port
02E8h–02EFh Serial port COM4
02F8h–02FFh Serial port COM2 (default IRQ 3)
0300h–031Fh NE2000-compatible Ethernet adapters
0330h–0331h Musical instrument's MIDI interface
0378h–037Ah Parallel port LPT1 (default IRQ 7)
03C0h–03CFh Ports of EGA-compatible video adapters [Note 2]
03C4h EGA sequencer's selector port [Note 3]
03C5h EGA sequencer's data port [Note 3]
03CEh Graphic register's selector port [Note 4]
03CFh Graphic register's data port [Note 4]
03DAh CGA/EGA/VGA video adapter's status port [Note 5]
03E0h–03E7h PCMCIA i82365 controller's ports
03E8h–03EFh Serial port COM3
03F0h–03F7h Floppy disk controller (default IRQ 6)
03F8h–03FFh Serial port COM1 (default IRQ 4)
0A79h Plug-and-play system data port
0CF8h–0CFFh PCI bus configuration ports
Notes
  1. ^ a b c d Some data in CMOS RAM are accessible via BIOS Setup program (1.01). Besides that, some hardware data and memory data are read by INT 11 (8.01-42) and by INT 12 (8.01-43) handlers. Direct appeals to CMOS RAM may be necessary for masking NMI (note 1 to 8.01-03), for obtaining data about floppy drives (offset 10h in A.08-03) and for defining CPU's actions after reset, dependent on a byte at offset 0Fh in CMOS RAM.[Note 4 to A.12-1] For access to data in CMOS RAM the requested byte's offset (up to 7Fh) should be sent by OUT command (7.03-66) to port 70h; then via port 71h the requested byte's value can be read by IN command (7.03-26) or altered with OUT command.
  2. ^ As far as drawing graphics with INT 10\AH=0Ch function (8.01-19) is slow, operating systems appeal directly to video memory and to ports of EGAcompatible video adapters. Therefore EGA port addresses are preserved as a standard, though EGA adapter itself has come out of use long ago.
  3. ^ Port 03C5h transfers a byte, sent by OUT command (7.03-66), to that internal register in video adapter, which is defined beforehand via port 03C4h. If a byte AL = 02h is sent in advance to port 03C4h, then the next byte, sent to port 03C5h, will be accepted as color mask (its normal value is 0Fh).
  4. ^ Port 03CFh transfers a byte, sent by OUT command (7.03-66), to that internal register in video adapter, which is defined beforehand via port 03CEh. If a byte AL = 08h is sent in advance to port 03CEh, then the next byte, sent to port 03CFh, will be accepted as a bit-mask for 8 consecutive pixels. If a byte AL = 05h is sent in advance to port 03CEh, then the next byte, sent to port 03CFh, will specify mode (00h–02h) of writing into video memory (note 3 to 8.01-39).
  5. ^ Port 03DAh is intended for data reading only. Bit 3 in a byte, read from port 03DAh, is kept set during field retrace intervals and is kept cleared outside these intervals. Therefore field retrace intervals can be registered by IN command (7.03-26) in order to avoid image disruptions, which are noticeable, if changes of the displayed image occur outside retrace intervals.

A.14-2 Status of serial port

edit

This table presents interpretation of bitfields in status byte, returned in AH register by INT 14\AH=00h – INT 14\AH=03h functions (8.01-65 – 8.01-68).

Bit Description
0 Received data are ready
1 Overrun error
2 Parity error
3 Framing error
4 Break detected
5 Transmit holding register is empty
6 Transmit shift register is empty
7 Timeout. no reply

A.14-3 Status of printer, connected to parallel port

edit

This table presents interpretation of bitfields in status byte, returned in AH register by INT 17\AH=00h – INT 17\AH=02h functions (8.01-86 – 8.01-88).

Bit Description
0 Timeout, no reply
1 EPP BIOS only: requested port is not supported
2 Unused
3 I/O error
4 Port is busy
5 Printer is out of paper
6 Acknowledge
7 Printer is ready (not busy)

Note 1: returned set state of CF flag with status byte AH = 03h means that EPP BIOS is present, but it doesn't support the requested port.

Note 2: status byte AH = 00h means that EPP data are returned in registers (A.14-4).

A.14-4 Selected functions of EPP BIOS

edit

EPP is a BIOS supplement, enabling enhanced modes of data transfer through LPT ports according to IEEE 1284 specification. Presence of EPP BIOS in your computer should be proved by INT 17\AX=0200h function (8.01-88), which also reports LPT port base address, EPP BIOS version, and address of its entrance point. The latter is used as a target address for CALL FAR command (7.03-08); being called in this way, EPP BIOS performs the operation, specified by a value in AH register at that moment. For the latest revision 7 of EPP BIOS the choice of a particular LPT port is defined by its base address in DX register; earlier EPP BIOS versions define LPT port by its number 00h–03h in DL register. Besides this, some EPP BIOS functions need other data, shown in the second column of the table below or in notes, marked by note number in fifth column. Unless specified otherwise, almost all EPP BIOS functions return status byte (A.14-7) in AH register, mark failure with set state of CF flag and don't preserve contents of BX register.

AH On call EPP BIOS function On return Comments
00h   Report configuration AL = IRQ A.14-5
01h A.14-6 Set transfer mode AX altered
02h   Report transfer mode AH altered A.14-6
03h AL=00h Enable LPT interrupts
03h AL=01h Disable LPT interrupts
04h   Reset EPP AL altered
05h AL=address Address-write I/O cycle AL altered
06h   Address-read I/O cycle AL=address
07h AL=byte Send a byte
08h   Send a block of data   [Note 1]
09h   Receive a byte AL=byte
0Ah   Receive a block of data   [Note 2]
0Bh AL=address Addressed byte reading AL=byte
0Ch AL=address Addressed byte sending   [Note 3]
0Dh AL=address Addressed block reading   [Note 2]
0Eh AL=address Addressed block sending   [Note 1]
0Fh AL=port Lock LPT port   [Note 4]
10h AL=port Unlock LPT port   [Note 4]
11h CH=00h Disable device interrupts   [Note 5]
11h CH=01h Enable device interrupts   [Note 5]
12h AL=00h Real-time device present? AL=01h if yes
12h AL=01h Add real-time device
12h AL=02h Remove real-time device
40h   Query multiplexer   [Note 6][Note 7]
41h AL=port Query multiplexer port   [Note 6][Note 8]
50h AL=port Query daisy chain   [Note 6][Note 9]
51h AL=port Reassign chain numbers   [Note 6]
Notes
  1. ^ On call a pointer to data block must be specified in DS:SI registers, length of data block (in bytes) — in CX register. Earlier versions of EPP BIOS, preceding the 7th revision, accept a pointer to data block from ES:DI registers. Function returns in CX register a number of bytes not sent yet.
  2. ^ On call a pointer to buffer for data must be specified in ES:DI registers, length of this buffer — in CX register. After successful termination function returns buffer filled, and in CX register — a number of bytes left not filled in the buffer.
  3. ^ On call the data byte to be sent must be specified in CL register. Earlier versions of EPP BIOS, preceding the 7th revision, accept data byte from DH register.
  4. ^ If external devices are connected via multiplexer, then multiplexer port number (01h–08h) should be specified in bits 3–0 of a byte in AL register. If external devices are connected as a daisy chain, then daisy chain port number (10h–80h) should be specified in bits 7–4 of a byte in AL register.
  5. ^ Multiplexer port number (01h–08h) should be specified in AL register. If multiplexer is not used, then AL register must be cleared. For interrupt enable function (CH = 01h) a pointer to interrupt event handler should be specified in ES:DI registers.
  6. ^ This function is not implemented in earlier versions, preceding EPP BIOS revision 7. This function shouldn't be applied, if external devices are not connected to a certain LPT port via multiplexer or as a daisy chain. The requested LPT port will be identified not by its number, but by its I/O base address, which should be specified in DX register.
  7. ^ The number of currently active multiplexer port is returned by this function in AL register, and a flags byte is returned in CH register. Set state of bit 0 in flags byte signifies locked state of multiplexer port, set state of bit 1 in flags byte signifies that there is an interrupt pending from this multiplexer port.
  8. ^ This function returns in CH register a byte of flags. Set state of bits in this flags byte have the following meaning :
    bit 0 – this port is selected (active)
    bit 1 – port is locked
    bit 2 – interrupts from this port are enabled
    bit 3 – interrupt is pending from this port.
  9. ^ This function returns in BH register the EPP BIOS version, in BL register — number of currently active daisy chain device, in CH register — a flags byte (as described in note 7), in CL register — number of devices constituting the daisy chain (or 00h, if there is no daisy chain), in ES:DI registers — a pointer to driver's vendor identification string.

A.14-5 EPP BIOS configuration byte

edit

The "Report configuration" function, defined on call by 00h value in AH register (A.14-4), returns in AL register a LPT port's IRQ line number, in BH register — the EPP BIOS version, in ES:DI registers — a pointer to driver's information, in CX register — LPT port's I/O base address (for versions 1.0 – 3.0 of EPP BIOS only), and in BL register returns EPP BIOS configuration byte. Interpretation of configuration byte's bitfields is given in the table below.

Bit Description
0 Multiplexer is present
1 Bi-directional data transfer is supported
2 Daisy chain is present
3 ECP specification is supported
4 EPP software emulation is supported
5 EPP BIOS functions are supported
6 "Fast Centronics" data transfer is supported
7 Standard EPP I/O map

A.14-6 Code of EPP BIOS data transfer mode

edit

The "Report transfer mode" function, defined on call by 02h value in AH register (A.14-4), returns code of current transfer mode in AL register. The "Set transfer mode" function, defined on call by 01h value in AH register (A.14-4), enables to change LPT data transfer mode according to mode's code, specified in AL register. Interpretation of bitfields in this mode's code is given in the table below.

Bit Description
0 Compatibility mode enabled
1 Bi-directional data transfer enabled
2 Data transfer according to EPP specification
3 Data transfer according to ECP specification [Note 1]
4 EPP software emulation enabled [Note 1]
5 "Fast Centronics" data transfer enabled [Note 1]
6 = 0b (reserved)
7 EPP port interrupts enabled [Note 2]
Notes
  1. ^ Modes defined by set state of bits 3–5 in mode's code cannot be implemented by earlier versions of EPP BIOS, preceding its latest 7th revision.
  2. ^ As far as device interrupts are enabled by AH = 11h function (A.11-4), set state of bit 7 is not accepted by "Set transfer mode" function (AH = 01h), but nevertheless may be reported by "Report transfer mode" EPP BIOS function (AH = 02h).

A.14-7 Status code of EPP BIOS functions

edit

Almost all EPP BIOS functions, except 01h and 02h (A.14-4), return in AH register a status byte. Interpretation of EPP BIOS status byte codes is given in the following table.

Code Description
00h Successful termination
02h Requested command or feature is not supported
03h Requested parallel port is not supported
05h Request is not supported in current mode
06h Invalid subfunction requested
07h Request is already done or set
20h LPT multiplexer isn't present (AMI BIOS versions only)
40h LPT multiplexer isn't present (other EPP BIOS versions)
41h Currently multiplexer is locked
80h I/O timeout, no response
FFh Requested function either is invalid or isn't supported

A.15 CD/DVD service tables

edit

A.15-1 Bootable CD/DVD specification packet

edit

BIOS functions INT 13\AH=4A00h and INT 13\AX=4C00h (8.01-61) emulate a logical disk on basis of its copy, read from an optical CD/DVD disc. Emulation control parameters must be prepared in a form of bootable CD/DVD specification packet. Internal data structure of this packet is shown in the following table.

Offset Size Description
00h 1 Size of this packet in bytes (=13h normally)
01h 1 Disk copy type (same as at offset 21h in A.15-3)
02h 1 Drive number to emulate (note 1 to 8.01-44)
03h 1 Drive controller number to emulate
04h 4 CD Logical Block Address where disk copy begins (the same as at offset 28h in table A.15-3)
08h 2 Bit 0 : emulate a slave IDE drive
    Bits 7–0 : LUN and SCSI ID number (for SCSI)
    Bits 15–8 : bus number (for SCSI)
0Ah 2 Segment address of prepared 3 kb read buffer (or 0000h value if no caching)
0Ch 2 Segment address to load boot sector of disk's copy (the same as at offset 22h in table A.15-3)
0Eh 2 Number of 512-byte virtual sectors in disk's copy (the same as at offset 26h in table A.15-3)
10h 1 Least significant 8 bits in number of disk's copy cylinders (as is returned by INT 13\AH=08h in CH)
11h 1 Bits 5–0 : number of last sector on a track
    Bits 7–6 : most significant bits of copy cylinders number (as is returned by INT 13\AH=08h in CL)
12h 1 Number of heads in emulated disk drive

A.15-2 Format of command packet

edit

This command packet specifies parameters for INT 13\AH=4Dh function (8.01-63), which reads sectors from optical CD/DVD discs. During boot procedure this command packet specifies reading of boot catalog from CD/DVD disc.

Offset Size Description
00h 1 Size of packet in bytes (= 08h normally)
01h 1 Number of sectors to be read
02h 4 Pointer to buffer for read data
06h 2 Number of the first sector to be read

A.15-3 Boot catalog of optical CD/DVD discs

edit

Optical discs potentially are able to implement several computer booting scenarios. Initial data, defining each booting scenario, must be present on bootable optical disc(s) in form of a hidden directory, also known as boot catalog. This directory can be read by INT 13\AH=4Dh function (8.01-63). As in ordinary directory, records in boot catalog have standard length 20h bytes. Minimal contents of boot catalog are composed of two required records: the first record is known as validation entry, the second record is a descriptor of default bootable disk's copy. The table below presents structures of both mentioned required records. Offsets 00h–1Fh correspond to validation entry record ; offsets 20h–3Fh, to descriptor of default bootable disk's copy.

Offset Size Description
00h 1 = 01h: signature of validation entry start
01h 1 Platform type:
= 00h – AT-compatible
= 01h – Power PC
= 02h – Apple Macintosh
04h 24 CD/DVD drive manufacturer (ASCII string)
1Ch 2 Complement checksum of bytes 00h–1Fh
1Eh 2 = AA55h: validation entry termination signature
20h 1 = 88h: signature of bootable disk's descriptor [Note 2]
21h 1 Bits 3-0 :
= 0000b – invalid descriptor
= 0001b – copy of 1.2 Mb diskette
= 0010b – copy of 1.44 Mb diskette
= 0011b – copy of 2.88 Mb diskette
= 0100b – copy of a hard disk
    Bit 6: – copy of a disk with ATAPI interface
    Bit 7: – copy of a disk with SCSI interface
22h 2 Segment address for loading boot sector (if = 0000h, then segment address is 07C0h by default)
24h 1 Disk's copy file system identifier (A.13-6)
26h 2 Number of 512-byte virtual sectors in disk's copy
28h 4 CD/DVD Logical Block Address where disk's copy starts
Notes
  1. Besides two required records, presented in table A.15-3, CD boot catalog may contain other 32-byte records, grouped in several sections. Each section represents a separate booting option and consists of not less than two records: a header record and a bootable disk's copy descriptor for that booting option. Header record begins with signature byte 90h, except header record in the last section, which begins with signature byte 91h. In every header record a word at offset 02h announces number of 32-byte records in this section. In each section descriptor of booting option may be followed by auxiliary records. Data structure in each descriptor of booting option is the same as that of default bootable disk's descriptor, shown in table A.13-3 at offsets 20h–3Fh.
  2. ^ Descriptors of non-bootable disks are allowed too, their distinctive feature is starting signature 00h.

A.15-4 Commands, performed by CD/DVD drivers

edit

In order to send a command to a driver, you have to obtain a handle, associated with this driver. The first step is to find a pointer to CD/DVD driver header by means of INT 2F\AX=1501h function (8.03-14), performed by TSR program either MSCDEX.EXE (5.08-03) or SHSUCDX.COM (5.08-04). Second step is to read a 8-byte name (signature) of driver's access channel inside driver's header at offset 0Ah. Driver access channel usually is named after the identifier, which follows the /D: parameter in command line, loading the driver (for example, the /D:MSCD001 identifier for CD/DVD drivers, shown in articles 5.10-01 – 5.10-03). The next third step is to use the name for obtaining a handle with INT 21\AH=3Dh function (8.02-33). The name must be uppercased and appended to 8 bytes with spaces (20h), if it is shorter. Returned handle should be placed in BX register before the desired command will be sent to the driver by INT 21\AX=4403h or by INT 21\AX=4402h function (8.02-41). Besides that, these functions need a request data block to be prepared. A pointer to request data block must be specified in DS:DX registers, and length of request data block — in CX register. Length of request data block for different commands is shown in the second column of the table below. The third column shows codes of CD/DVD driver's commands, which are to be specified at offset 00h in request data block. If command implies return of some data, driver will write these data into cells of the same request data block.

AX CX Code Operation Comments
4402h 05h 00h Report driver's header address [Note 2]
4402h 06h 01h Report drive's head location [Note 3]
4402h 09h 04h Report audio control status A.15-5
4402h 05h 06h Report CD/DVD drive status A.15-6
4402h 04h 07h Read mode, sector size [Note 4]
4402h 05h 08h Get number of sectors [Note 2]
4402h 02h 09h Report disc change status [Note 5]
4402h 07h 0Ah Get number of tracks [Note 6]
4402h 08h 0Bh Get start of track [Note 7]
4403h 01h 00h Eject the tray
4403h 02h 0100h Unlock the door
4403h 02h 0101h Lock the door
4403h 01h 02h Reset the drive [Note 1]
4403h 09h 03h Audio control A.15-5
4403h 01h 05h Pull the track in
  1. ^ After any request to CD/DVD driver sent by INT 21\AX=4402h function and before the driver is activated for any other purpose it must be reset by sending command 02h via INT 21\AX=4403h function.
  2. ^ After execution of operations 00h and 08h the requested result is written into request data block starting at offset 01h. This result is either a 4-byte number or a 4-byte address according to the requested operation.
  3. ^ After a request for drive's head location a returned byte at offset 01h in request data block represents CD/DVD addressing format :
    00h – HSG format
    01h – Red Book format (frames/seconds/minutes).
    Besides that, a double word at offset 02h in request data block is drive's head location in units according to addressing format.
  4. ^ After a request for read mode it is returned in request data block at offset 01h :
    00h – reading with error correction (cooked)
    01h – reading with ECC code, but without error correction (raw).
    Besides that, returned word at offset 02h presents sector's size.
  5. ^ After a request for disc change status driver returns status byte at offset 01h in request data block :
    00h – change status isn't determined,
    01h – disc has not been changed,
    FFh – disc has been changed.
  6. ^ After a request for number of tracks driver returns number of the first track in a byte at offset 01h, number of the last track — in a byte at offset 02h, and start address of the first track (in Red Book format) is returned as a double word at offset 04h.
  7. ^ On call for start of a track the number of requested track must be specified in byte at offset 01h in request data block. In response to this call driver writes into request data block at offset 02h a double word address of requested track's starting point (in Red Book format). Besides that, in a word at offset 06h driver returns flags, where set state of bits means the following :
    bit 12 – audio track, written with preemphasis,
    bit 13 – digital copying is permitted,
    bit 14 – this track contains data (not audio),
    bit 15 – this is a 4-channel audio track.

A.15-5 CD/DVD audio control

edit

If in CD/DVD drive status word (A.15-6) bit 8 is set, then this CD/DVD drive doesn't need audio card in order to control audio playback: this CD/DVD drive itself is able to control audio playback.

For sending a request to CD/DVD drive via INT 21\AX=4403h function (A.15-4), a pointer to data block with requested parameters must be specified in DS:DX registers. The table below presents structure of a data block with audio control parameters, which should be prepared for audio control operation 03h in order to alter audio playback. Data block of the same structure is written into a prepared buffer by INT 21\AX=4402h function in response to a request for audio control status operation (A.15-4). On call for INT 21\AX=4402h function a byte at offset 00h in prepared buffer must be filled yet : it must specify code 04h of audio control status operation.

Offset Size Description
00h 1 Function: 03h for AX=4403h or 04h for AX=4402h
01h 1 Input channel (0–3) for output channel 0
02h 1 Volume for output channel 0
03h 1 Input channel (0–3) for output channel 1
04h 1 Volume for output channel 1
05h 1 Input channel (0–3) for output channel 2
06h 1 Volume for output channel 2
07h 1 Input channel (0–3) for output channel 3
08h 1 Volume for output channel 3

Note 1: output channels 0 and 1 correspond to left and right; output channels 2 and 3 correspond to rear left and rear right. Each channel may be switched off by sending its volume value 00h.

Note 2: by default each input channel is connected to output channel with the same number, and volume is set to maximum value FFh.

A.15-6 Bitfields in optical disc drive status word

edit

This table shows meaning of bitfields in status word, returned by INT 21\AX=4402h function inside data block at offset 01h in response to CD/DVD drive status request 06h (A.15-4).

Bit Description
0 Drive's tray is ejected
1 Tray lid is unlocked
2 "Raw" reading mode is supported [Note 1]
3 Drive enables writing onto CD/DVD discs
4 CD/DVD drive is able to play audio/video tracks
5 CD/DVD drive supports interleaving [Note 2]
7 CD/DVD drive supports prefetch requests [Note 3]
8 CD/DVD drive supports audio channel control
9 Red Book addressing is supported (in addition to HSG)
10 CD/DVD drive drive is busy with playing audio
11 There is no disc in CD/DVD drive
12 CD/DVD drive has separate read and write channels
  1. ^ "raw" reading mode implies that ECC code together with data is read and sent to output, but error correction is not performed. Normal "cooked" reading mode implies that ECC code is used for error correction, but is not sent to output together with corrected data.
  2. ^ Interleaving here is related to video files, composed of alternating groups of image frames and audio frames.
  3. ^ Prefetch requests cause reading into drive's memory buffer, so that later the requested data can be obtained without waiting for access to the requested track.

A.16 Some relevant abbreviations

edit
ACPI Advanced Configuration and Power Interface specification stipulates presentation of motherboard's parameters to operating system in a form of data tables in dedicated memory areas.
AGP Accelerated Graphic Port : a slot for inserting video adapters, and also specification of video adapter's interaction with motherboard.
AH CPU's 8-bit register, representing bits 15–8 of 16-bit AX register.
AL CPU's 8-bit register, representing bits 7–0 of 16-bit AX register.
AMIS Alternate Multiplex Interrupt Specification (A.07-6)
ANSI American National Standards Institute (USA)
API Application Program Interface, i.e. OS services for programs.
APM Advanced Power Management : extension of computer's BIOS system, providing control over power supply (8.01-70 – 8.01-72)
ASCII American Standard Code for Information Interchange.
ASCIIZ a string in ASCII code terminated with at least one 00h byte.
ASPI Advanced SCSI Programming Interface : enhanced set of commands for SCSI interface (5.07-03). Nowadays many ASPI commands are implemented in ATAPI (5.07-01) and USB (5.07-05) controllers.
AT Advanced Technology : a name of IBM's PC model produced in 1984. Most modern computers inherit some features of AT model.
ATA AT Attachment : disk storage device's interface, implemented for the first time in IBM's PC AT model.
ATAPI ATA Packet Interface: packet enhancement of ATA (5.07-01).
ATX AT extension : enhanced specification of PC blocks construction features, implemented since 1998.
AUX reserved word, used to address serial port COM1.
AVI suffix of video files, composed of interleaved audio and video frames.
AX 16-bit general purpose register, associated with CPU's arithmetic unit. In 32-bit CPUs AX represents a part (bits 15–0) of 32-bit register EAX.
b binary : distinctive mark of binary numbers.
BAT suffix of batch files, interpreted by COMMAND.COM (6.04). Unlike ordinary command files, batch files are accepted by COMMAND.COM interpreter from command line without input redirection.
BH CPU's 8-bit register, representing bits 15–8 of 16-bit BX register.
BIOS Basic Input-Output System, the one supplied with PC's motherboard.
BL CPU's 8-bit register, representing bits 7–0 of 16-bit BX register.
BP Base Pointer : 16-bit register, used as a base for addressing data arrays. In 32-bit CPUs BP represents bits 15–0 of 32-bit register EBP.
BPB BIOS Parameters Block (A.03-4).
BSD Berkley Software Distribution, known for a freeware OS.
BX 16-bit general purpose register, also used as a base for addressing data. In 32-bit CPUs BX represents bits 15–0 of 32-bit register EBX.
CD Compact Disc : a one-sided 650–800 Mb optical disc.
CD-ROM a read-only compact disc or a drive for such discs.
CDS Current Directory Structure (A.03-3).
CF – (1) : CPU's Carry Flag, used to indicate carry and errors.
CF – (2) : Compact Flash — a type of removable storage cards.
CGA Color Graphic Adapter : the first IBM's model of color video adapter.
CH CPU's 8-bit register, representing bits 15–8 of 16-bit register CX.
CHS Cylinder-Head-Sector : mode of HDDs addressing.[Note 2 to A.13-6]
CL CPU's 8-bit register, representing bits 7–0 of 16-bit register CX.
CMOS Complementary Metal-Oxide Semiconductor : BIOS' memory block on CMOS chips, which doesn't lose stored data when PC is switched off.
COM – (1) : suffix of executable files, which have no header.
COM – (2) : reserved word for access to serial ports.
COM – (3) : Common Object Model — a programming technique.
CON console, i.e. keyboard for input and display for output.
CP Codepage (more about CP in articles 1.06 and A.02-2).
CP/M Control Program for Microcomputers : a prototype of DR-DOS.
CPU Central Processing Unit — the main processor chip in a PC.
CR Control Registers : 32-bit registers CR0, CR2, CR3 (A.11-4), introduced in 80386 CPU model. CR4 has been introduced later in Pentium CPU.
CRC Cyclic Redundancy Check : code for error detection only (no correction)
CRT Cathode Ray Tube.
CS Code Segment : 16-bit segment register, defining segment address of the code, executed by CPU.
CSM Compatibility Support Module supplements UEFI BIOS with features of ordinary BIOS systems, thus enabling to use DOS' software, to launch Windows-XP and many other OSes, which can't start under UEFI.
CWR Control Word Register in arithmetical coprocessor.
CX 16-bit general purpose register, often used as a counter. In 32-bit CPUs CX represents a part (bits 15–0) of 32-bit ECX register.
DAC Digital-to-Analog Converter.
dd two-digit decimal day number in a month.
DDO Dynamic Drive Overlay : OnTrack's BIOS extension for access to HDDs over 512 Mb in obsolete PCs.
DH CPU's 8-bit register, representing bits 15–8 of 16-bit register DX.
DI Destination Index : 16-bit register normally used to store target offset. In 32-bit CPUs DI represents a part (bits 15–0) of 32-bit register EDI.
DL CPU's 8-bit register, representing bits 7–0 of 16-bit register DX.
DMA Direct Memory Access.
DOS Disk-based Operating System.
DPB Drive Parameters Block (A.03-1).
DPMI DOS Protected Mode Interface : API functions for programs, designed to be executed in CPU's V86 mode. DPMI is implemented, in particular, by "DOS box" of Windows OS (more about that in 8.03-21).
DPR Data Pointer Register in arithmetical coprocessor.
DPTE Drive Parameter Table Extension (A.13-3).
DR – (1) : Digital Research — company developer of CP/M and DR-DOS.
DR – (2) : Debug Registers — CPU's registers DR0–DR7 (A.11-5).
DS Data Segment : 16-bit segment register, defining segment address of current program's data block.
DTA Data Transfer Area (8.02-16, A.09-1)
DVD Digital Versatile Disk — optical disc with 4.7 Gb of data per side.
DX 16-bit general purpose register. In 32-bit CPUs DX represents a part (bits 15–0) of 32-bit register EDX.
EAX 32-bit general purpose register in 32-bit CPUs. Least significant bits of EAX register (bits 15–0) constitute AX register.
EBIOS BIOS extension providing LBA mode of disk access in obsolete PCs.
EBP 32-bit base address register in 32-bit CPUs. Least significant bits of EBP register(bits 15–0) constitute BP register.
EBX 32-bit general purpose register in 32-bit CPUs. Least significant bits of EBX register (bits 15–0) constitute BX register.
ECC Error Correcting Code.
ECP Extended Capabilities Port : data transfer specification for LPT ports.
ECX 32-bit general purpose register in 32-bit CPUs. Least significant bits of ECX register (bits 15–0) constitute CX register.
EDI 32-bit destination offset register in 32-bit CPUs. Least significant bits of EDI register (bits 15–0) constitute DI register.
EDX 32-bit general purpose register in 32-bit CPUs. Least significant bits of EDX register (bits 15–0) constitute DX register.
EFI Extensible Firmware Interface : Intel's specification of 32-bit BIOSes, originally intended for Itanium 64-bit single-core CPU (2002). Revision of EFI for newer 32-bit multi-core CPUs is known as UEFI (2007).
EGA Enhanced Graphics Adapter : obsolete IBM's color video adapter. Modern video adapters inherit many important features from EGA.
EHCI Enhanced Host Controller Interface : controller specification for USB bus versions 2.x (more about that in 5.07-05).
EMM Expanded Memory Manager : EMM386.EXE driver (5.04-02).
EMS Expanded Memory Specification, implemented by EMM (5.04-02).
EOF End Of File : EOF mark in ASCII code is byte 1Ah.
EPP Enhanced Parallel Port : BIOS extension of LPT functions (A.14-4)
ES 16-bit segment register in CPU, defining target segment address.
ESI 32-bit source offset register in 32-bit CPUs. Least significant bits of ESI (bits 15–0) constitute SI register.
ESP 32-bit stack pointer register in 32-bit CPUs. Least significant bits of ESP (bits 15–0) constitute SP register.
EXE Executable : suffix for executable files having a header.
FASM Flat ASseMbler : modern freeware assembler for DOS, Windows, Linux and Unix. Can be downloaded from http://www.flatassembler.net/ .
FAT File Allocation Table.
FCB File Control Block (A.09-5).
FCBS command (4.10), reserving memory for FCBs.
FDD Floppy Disk Drive.
FS auxiliary 16-bit segment register, introduced since CPU 80386.
GDT Global Descriptor Table — a table of 8-byte segment descriptors, defining main system segments in protected mode. (A.12-2).
GDTR CPU's system register. Stores GDT's linear address and size.
GS auxiliary 16-bit segment register, introduced since CPU 80386.
GUI Graphical User Interface — alternative to textual command line.
GUID Globally Unique IDentifier — 32-bytes long universal identifier.
h hexadecimal : distinctive mark of hexadecimal numbers.
HDD Hard Disk Drive.
HMA High Memory Area : memory area 1024–1088 kb.
HRS Hidden, Read-only, System : a set of attributes for system files.
HSG High Sierra Group specification — prototype of ISO 9660 standard.
IBM International Business Machines company.
ID identifier.
IDE Integrated Drive Electronics : HDD interface, equivalent to ATA.
IDT Interrupt Descriptor Table : table of interrupts for protected mode. Its segment descriptor is sometimes also denoted as IDT.
IDTR CPU's system register. Stores IDT's linear address and size.
IEEE Institute of Electrical and Electronics Engineers.
IFS Installable File System : file system (5.08-01), accessed by means of installable driver.
IML Initial Machine Load system.
INT Interrupt : event or command (7.03-28), invoking interrupt handler.
I/O Input-Output, i.e. data transfer operations.
IOCTL Input-Output Control system (8.02-41).
IP Instruction Pointer : 16-bit register, defining offset of the next command. In 32-bit CPUs IP represents a part (bits 15–0) of 32-bit EIP register.
IPR Instruction Pointer Register in arithmetical coprocessor.
IRQ Interrupt ReQuest line(s).
ISA Industrial Standard Architecture : (obsolete) bus for expansion cards.
ISO International Standards Organization.
ISP Interrupt Sharing Protocol (A.07-5).
JFT Job File Table : table of opened handles.[Note 3 to A.07-1]
LAN Local Area Network.
LBA Linear Block Addressing — HDDs addressing mode.[Note 4 to A.13-6]
LCD Liquid Crystal Display.
LFN Long File Name (A.09-3).
LIM Lotus-Intel-Microsoft : the founders of EMS specification.
LPT Line PrinTer : port, also known as parallel port.
LUN Logical Unit Number : identifier for devices, sharing one bus address.[Note 1 to A.03-2]
MASM Macro ASseMbler : Microsoft's low-level code assembler.
MBR Master Boot Record (A.13-5).
MCB Memory Control Block : 16 bytes long descriptor (A.12-7).
MDA Monochrome Display Adapter, used in IBM's obsolete PCs.
mm two-digit decimal month number in a year.
MO Magneto-Optical disks or disk drives.
MS mark for objects, owned or developed by Microsoft.
MSWR Machine Status Word Register : control register in CPU 80286. In modern CPUs MSWR is a part of control register CR0.
NTFS New Technology File System for HDDs under Windows NT/2000/XP.
NUL – (1) : channel "to nowhere", as alternative to real channels.
NUL – (2) : the 00h byte value.
OEM Original Equipment Manufacturer : direct delivery of components (as antonym of retail sale).
OHCI Open Host Controller Interface : controller specification for USB bus versions 1.x (5.07-05).
OS Operating System.
PC Personal Computer.
PCI Peripheral Components Interconnect : type of bus for expansion cards.
PCMCIA PC Memory Card International Association : interface standard, originally designed for memory expansion cards (5.07-02).
PD Powerful Disk : a 650 Mb rewritable optical discs of CD-RAM type, prototype of DVD-RAM discs.
PIO Programmed I/O control for devices with ATAPI interface.
PM Protected Mode of CPU operation.
POST Power-On Self Test : performed by BIOS when PC is switched on.
PRN reserved word used to address printer port LPT1.
PSP Program Segment Prefix (A.07-1).
PS/2 Personal System/2 : IBM's PC model developed in 1987.
PS2 mouse port and connector type, first introduced in PS/2 PCs.
PTS PhysTechSoft — russian software vendor, known for its PTS-DOS
RAID Redundant Array of Inexpensive Disks : distributed storage technique, enhancing transfer speed. Under permanent qualified maintenance, some RAID versions also may reduce risk of data loss.
RAM Random Access Memory — ordinary writable memory, as alternative to sequential access to tape and disk media.
ROM Read-Only Memory, i.e. non-rewritable storage media.
SCSI Small Computer System Interface (5.07-03).
SFT System File Table of associations for active handles (A.01-4)
SFX SelF eXtracting packed archive or module.
SI Source Index : 16-bit register, used to store source address offset. In 32-bit CPUs SI represents a part (bits 15–0) of 32-bit ESI register.
SIMD Single Instruction Multiple Data : class of commands, performing the same operation over a group of data items.
SP Stack Pointer : 16-bit register, defining offset of stack's top. In 32-bit CPUs SP register represents a part (bits 15–0) of 32-bit ESP register.
SS Stack Segment : 16-bit register, defining stack's segment address.
SSE Streaming SIMD Extensions : extensions of SIMD command set, implemented in modern CPUs.
STDIN input channel, corresponding to handle 0000h and having default association with keyboard as data source.
STDOUT output channel, corresponding to handle 0001h and having default association with display as target device.
STDERR channel to display error messages, associated with handle 0002h.
SVGA SuperVGA videomodes (A.10-1), suggested by VESA.
SWR Status Word Register in arithmetical coprocessor (7.04-08, 7.04-64).
TASM TurboASseMbler : a low-level code assembler from Borland Co.
TLB Translation Lookaside Buffer : cache buffer in CPU, performing translation of linear addresses into physical addresses.
TSR Terminate and Stay Resident : resident modules or programs (8.02-23)
TWR Tags Word Register in arithmetical coprocessor.
UEFI Unified EFI — revision of EFI, adopted in 2007 for modern 32-bit multicore CPUs. UEFI stipulates for graphic shell, for network support and for retention of compatibility with OSes by means of CSM module.
UHCI Universal Host Controller Interface : controller specification for USB bus versions 1.x (5.07-05).
UMB Upper Memory Blocks : address space pieces, allotted for loading drivers inside 640–1024 kb area.
USB Universal Serial Bus (5.07-05).
V86 virtual 8086 mode : emulation of obsolete CPU 8086 by modern CPUs, operating in protected mode. V86 mode enables to execute DOS programs at the lowest (third) privilege level.
VBE Video BIOS Extensions, developed by VESA (8.01-35) in order to enable implementation of SVGA videomodes.
VC Volkov Commander shell (6.25).
VCPI Virtual Control Program Interface : protocol of interaction enabling control transfer from one control program to another (5.04-02).
VESA Video Electronics Standards Association.
VGA Video Graphics Array : video adapter for IBMs PS/2 computers.
XMS Extended Memory Specification implemented by Himem.sys (5.04-01)
YIQ model of pixel representation in luminance and two chrominance axes, corresponding to highest and lowest visual color resolution.
YUV model of pixel representation in luminance and two chrominance axes, conforming to specifications of CIE (Comite Internationale d'Eclairage).
yy year (in MS-DOS 7 year is represented by a four-digit number).
ZIP – (1) : suffix of archive files, compressed by PKZIP utility.
ZIP – (2) : trade mark of removable disk drives, produced by Iomega Co.
ZF CPU's zero flag, used to indicate equality or zero result.