1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
|
page 58,132
;******************************************************************************
title EMMDATA - EMM data structures definitions
;******************************************************************************
;
; (C) Copyright MICROSOFT Corp. 1986
;
; Title: CEMM.EXE - COMPAQ Expanded Memory Manager 386 Driver
; EMMLIB.LIB - Expanded Memory Manager Functions Library
;
; Module: EMMDAT
;
; Version: 0.04
;
; Date: June 14,1986
;
;******************************************************************************
;
; Change log:
;
; DATE REVISION DESCRIPTION
; -------- -------- -------------------------------------------------------
; 06/14/86 Added MapSize (SBP)
; 06/27/86 0.02 Reordered tables to place size dependent ones at end.
; 06/28/86 0.02 Name change from CEMM386 to CEMM (SBP).
; 07/06/86 0.04 Made _emm_page,_emm_free, and _pft386 pointers instead
; of labels to allow sizing of these arrays based on the
; number of pages in the system. Also added _emm_brk.
; ? 0.05 Modified for WIN386
; 05/06/88 0.06 Modified back for MEMM.
;
;******************************************************************************
;
; Functional Description:
; data definitions for emm/lim
;
;
;******************************************************************************
.lfcond ; list false conditionals
.386p
; include protseg.inc
include vdmseg.inc
include vdmsel.inc
include page.inc
include emmdef.inc
_DATA SEGMENT
public EMM_PAGE_CNT
public HANDLE_CNT
PUBLIC _total_pages
PUBLIC _EMMstatus
PUBLIC _emm40_info
PUBLIC _page_frame_base
PUBLIC _mappable_pages
PUBLIC _mappable_page_count
PUBLIC _physical_page_count
PUBLIC _page_frame_pages
PUBLIC EMM_MPindex
PUBLIC _EMM_MPindex
PUBLIC _save_map
PUBLIC _handle_table
PUBLIC _Handle_Name_Table
PUBLIC _handle_table_size
PUBLIC _handle_count
PUBLIC _emmpt_start
PUBLIC _free_top
PUBLIC _free_count
PUBLIC _emm_page
PUBLIC _emm_free
PUBLIC _pft386
PUBLIC _emm_brk
PUBLIC EMM_dynamic_data_area
PUBLIC EMM_data_end
PUBLIC _regp
PUBLIC EMM_savES
PUBLIC EMM_savDI
PUBLIC CurRegSet
PUBLIC _CurRegSet
PUBLIC CurRegSetn
PUBLIC FRS_array
PUBLIC FRS_free
PUBLIC PF_Base
PUBLIC _PF_Base
PUBLIC _OSEnabled
PUBLIC _OSKey
PUBLIC _VM1_EMM_Pages
PUBLIC _cntxt_pages
PUBLIC _cntxt_bytes
;******************************************************************************
; DATA STRUCTURES FOR MEMM
;
; The data structures are documented below. Only a description of how
; emm interfaces with the page table memory mananger is appropriate here
;
; During initialisation the pages in the physical address space to be devoted
; to emm are indicated in the _pft386 array. This array translates the emm
; page number to a pte in the system page table.
;
; The emm pages currently free are copied to the emm_free stack and the
; free_stack pointer points to the top of this stack.
;
; When pages are allocated to a handle the pages are allocated from the stack
; and copied to the emm_page array. The place where a handles pages are
; copied to in this array is recorded in the handle table. The emm_page array
; should be kept compacted all the time. Thus if a handle is deallocated, the
; pages allocated to the handle are copied to the emm_free stack and the hole
; left behind in the emm_page array is compacted by shifting all the entries
; below upwards updating the indexes stored in the handle table if needed.
;
; given map_handle_page(phys_page, log_page, handle)
;
; a. determine pte offset in system page table corresponding to phys_page
; from the _page_frame_base table.
;
; b. access handle table for the handle and determine the start of the
; emm pages allocated to the handle in the emm_page array.
;
; c. add log_page to this start offset in the emm_page array and access
; the entry in this array. This entry is an offset into the _pft386
; array for the emm page under consideration.
;
; d. use this index into _pft386 to access the pte for the log page under
; consideration.
;
; e. store this pte in the pte offset corresponding to the phys_page as
; determined in a.
;******************************************************************************
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;00. EMM Status
; Current status of `HW'. The way this is handled is that
; when returning status to caller, normal status is reported
; via EMMstatus being moved into AX. Persistant errors
; (such as internal datastructure inconsistancies, etc) are
; placed in `EMMstatus' as HW failures. All other errors are
; transient in nature (out of memory, handles, ...) and are
; thus reported by directly setting AX. The EMMstatus variable
; is provided for expansion and is not currently being
; set to any other value.
;
; set to OK for now. when integrated, the value should be
; set to EMM_HW_MALFUNCTION (81H) initially, then set to
; OK (00H) when the `EMM ON' function is invoke
;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_EMMstatus LABEL WORD
DW 00H
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;01. Register Block Pointer
; points to the the vm86 regs on the
; stack
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_regp LABEL WORD
DW 0
DW 0
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;02. TOTAL_PAGES
; total # of EMM pages in system
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_total_pages LABEL WORD
DW 0
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;03. LIM 3.2 PAGE FRAME
; A suitable lim 3.2 page frame found
; by scanning for free area
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
PF_Base label word
_PF_Base label word
dw 0FFFFh ; Undefined initially
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;04. PAGE FRAME BASE
; this is the map of linear addr.
; of the n 16kb physical pages used to
; access the EMM pages. The contents
; far pointers into the system page
; table. If a lim 3.2 page frame is
; available it gets the entries at the
; beginning
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_page_frame_base LABEL DWORD
DW MAX_PHYS_PAGES dup (0, PAGET_GSEL) ; PTE offsets of physical pages
;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;05. MAPPABLE PAGE ARRAY
; this is the segment, physical page
; correspondence array
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;
_mappable_pages LABEL WORD
REPT MAX_PHYS_PAGES
Mappable_Page <0, 0>
ENDM
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;06. MAPPABLE PAGE INDEX ARRAY
; the pages in system memory are numbered
; 4000h onwards whereas the physical page
; numbers are arbitrarily numbered. this
; array indexes into the mappable page
; array.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
EMM_MPindex LABEL byte ; table of indexes into above
_EMM_MPindex LABEL byte
db 48 dup (-1) ; 4000h to 10000h
_mappable_page_count dw MAX_PHYS_PAGES ; number of entries in above
_physical_page_count dw 0 ; number of physical pages
_page_frame_pages dw 4 ; pages in the page frame
ifdef CGA
_VM1_EMM_Pages dw 30 ; 4000h to B800h for now
else
_VM1_EMM_Pages dw 24 ; 4000h to A000h for now
endif
; don't need it (used only in _set_40windows)
;
;_VM1_EMM_Offset dw 0 ; Offset of these in context
;
; combined into _cntxt_pages and _cntxt_bytes
;
;_VM1_cntxt_pages db 0 ; Pages in context
;_VM1_cntxt_bytes db 0 ; Bytes in context
;_VMn_cntxt_pages db 0
;_VMn_cntxt_bytes db 0
_cntxt_pages db 0 ; Pages in context
_cntxt_bytes db 0 ; Bytes in context
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;07. HARDWARE INFORMATION
; Hardware information returned by Get
; Information call
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_emm40_info LABEL WORD
dw 0400h ; raw page size in paragraphs (16k)
dw FRS_COUNT-1 ; number of fast register sets
dw size FRS_window+2 ; max. number of bytes to save a context
; ( FRS_window size + 2 )
dw 0 ; settable DMA channels
dw 0 ; DMA_channel_operation
;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;08. FRS MAPPING STATE ARRAY
; Used to emulate FRS. FRS 0..FRS_COUNT-1. FRS 0
; is the normal mapping set.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
FRS_array LABEL WORD ; Array of Fast Register Set structures
REPT FRS_COUNT
FRS_struc <>
ENDM
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;09. Variables to support FRS Implementation
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
FRS_free db 0 ; How many of the above are free
CurRegSetn db 0 ; Number of Current Register Set
_CurRegSet LABEL WORD
CurRegSet dw 0 ; Pointer to Current Register Set Area
; in FRS_array
; initialized to 0:0 for initial buffer inquiry
;
EMM_savES dw 0 ; store for buffer address provided
EMM_savDI dw 0 ; by user on frs function
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;10. Variable to support OS access functions
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_OSEnabled dd 0 ; Security feature
_OSKey dd ? ; Key for security functions
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;11. Mysterious variable right now
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
VEMMD_SSbase dd 0 ; Linear base of Stack Segment
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;12. save_map
; This is an array of structures that save
; the current mapping state.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_save_map LABEL BYTE
REPT HANDLE_CNT ; one save area per handle
SaveMap_struc <> ; save area
ENDM
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;13. handle_table
; This is an array of handle pointers.
; In addition to the handle number a ptr
; to the start of the ems pages allocated
; to the handle in emm_page array is given
; emm_page index of NULL_PAGE means free
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_handle_table LABEL WORD
REPT HANDLE_CNT ; one table per handle
HandleTable_struc <> ; initialized handle table
ENDM
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;14. handle name table
; Under LIM 4.0 each allocated handle can
; be given a 8 byte name. this array keeps
; track of the handle names
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_Handle_Name_Table LABEL QWORD
DQ HANDLE_CNT dup (0) ; 8 0 bytes for every handle name
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;15. book-keeping variables for handle table
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_handle_table_size LABEL WORD
DW HANDLE_CNT
_handle_count LABEL WORD
DW 0
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;16. EMMPT_START
; emmpt_start is the index of the next
; free entry in emm_page
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_emmpt_start LABEL WORD
DW 0
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;17. FREE pointers
; free_top is the index for the top free
; page in the emm_free stack.
; free_count is the number of free
; pages in the emm_free stack
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_free_top LABEL WORD
DW EMM_PAGE_CNT ; none free initially
_free_count LABEL WORD
DW 0 ; none free initially
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;18. POINTERS to the variable sized data structures
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_emm_page dw offset dgroup:EMM_dynamic_data_area
_emm_free dw 0
_pft386 dw 0
_emm_brk dw offset dgroup:EMM_data_end
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; Espensive data structures are going to be
; to be assigned storage dynamically so that we
; don't end up wasting space. These data areas
; are referred to by pointers above.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
EMM_dynamic_data_area LABEL BYTE
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
ifndef NOHIMEM
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;19. EMM Page table
; this array contains lists of indexes into the pseudo
; Page Table. Each list is pointed to
; by a handle table entry and is sequential/contiguous.
; This is so that maphandlepage doesn't have to scan
; a list for the specified entry.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_def_emm_page LABEL WORD
DW EMM_PAGE_CNT DUP(0)
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;20. EMM free table
; this array is a stack of available page table entries.
; each entry is an index into pft386[].
; it is initialized to FFFF entries. this is
; a null page entry/
; it is initialized to FFFF entries. this is
; a null page entry.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_def_emm_free LABEL WORD
DW EMM_PAGE_CNT DUP(NULL_PAGE)
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;21. PAGE FRAME TABLE
; This array contains addresses of physical
; page frames for 386 pages. A page is
; referred to by an index into this array.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_def_pft386 LABEL DWORD
DD EMM_PAGE_CNT DUP(NULL_HANDLE AND 0fffh)
endif
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
EMM_data_end label byte
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_DATA ENDS
ifndef NOHIMEM
else
VDATA SEGMENT
public vdata_begin
vdata_begin label byte
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;19. EMM Page table
; this array contains lists of indexes into the pseudo
; Page Table. Each list is pointed to
; by a handle table entry and is sequential/contiguous.
; This is so that maphandlepage doesn't have to scan
; a list for the specified entry.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_def_emm_pagev LABEL WORD
DW EMM_PAGE_CNT DUP(0)
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;20. EMM free table
; this array is a stack of available page table entries.
; each entry is an index into pft386[].
; it is initialized to FFFF entries. this is
; a null page entry/
; it is initialized to FFFF entries. this is
; a null page entry.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_def_emm_freev LABEL WORD
DW EMM_PAGE_CNT DUP(NULL_PAGE)
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;21. PAGE FRAME TABLE
; This array contains addresses of physical
; page frames for 386 pages. A page is
; referred to by an index into this array.
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
_def_pft386v LABEL DWORD
DD EMM_PAGE_CNT DUP(NULL_HANDLE AND 0fffh)
VDATA ENDS
endif
END
|
