1 /* Catacomb Armageddon Source Code
\r
2 * Copyright (C) 1993-2014 Flat Rock Software
\r
4 * This program is free software; you can redistribute it and/or modify
\r
5 * it under the terms of the GNU General Public License as published by
\r
6 * the Free Software Foundation; either version 2 of the License, or
\r
7 * (at your option) any later version.
\r
9 * This program is distributed in the hope that it will be useful,
\r
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
\r
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
\r
12 * GNU General Public License for more details.
\r
14 * You should have received a copy of the GNU General Public License along
\r
15 * with this program; if not, write to the Free Software Foundation, Inc.,
\r
16 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
\r
22 =============================================================================
\r
24 ID software memory manager
\r
25 --------------------------
\r
27 Primary coder: John Carmack
\r
31 Quit (char *error) function
\r
36 MM_SizePtr to change the size of a given pointer
\r
38 Multiple purge levels utilized
\r
40 EMS / XMS unmanaged routines
\r
42 =============================================================================
\r
45 //#include "LIB_HEAD.H"
53 #if 1 // 1 == Debug/Dev ; 0 == Production/final
\r
55 #define OUT_OF_MEM_MSG "MM_GetPtr: Out of memory!\nYou were short :%ld bytes"
\r
60 #define OUT_OF_MEM_MSG "\npee\n"
66 =============================================================================
\r
70 =============================================================================
\r
73 #define LOCKBIT 0x80 // if set in attributes, block cannot be moved
\r
74 #define PURGEBITS 3 // 0-3 level, 0= unpurgable, 3= purge first
\r
75 #define PURGEMASK 0xfffc
\r
76 #define BASEATTRIBUTES 0 // unlocked, non purgable
\r
80 typedef struct mmblockstruct
\r
82 unsigned start,length;
\r
83 unsigned attributes;
\r
84 memptr *useptr; // pointer to the segment start
\r
85 struct mmblockstruct far *next;
\r
89 //#define GETNEWBLOCK {if(!(mmnew=mmfree))Quit("MM_GETNEWBLOCK: No free blocks!");mmfree=mmfree->next;}
\r
91 #define GETNEWBLOCK {if(!mmfree)MML_ClearBlock();mmnew=mmfree;mmfree=mmfree->next;}
\r
93 #define FREEBLOCK(x) {*x->useptr=NULL;x->next=mmfree;mmfree=x;}
\r
96 =============================================================================
\r
100 =============================================================================
\r
107 void (* beforesort) (void);
\r
108 void (* aftersort) (void);
\r
111 =============================================================================
\r
115 =============================================================================
\r
120 void huge *hugeheap;
\r
124 mmblocktype far mmblocks[MAXBLOCKS]
\r
125 ,far *mmhead,far *mmfree,far *mmrover,far *mmnew;
\r
127 boolean bombonerror;
\r
129 unsigned totalEMSpages,freeEMSpages,EMSpageframe,EMSpagesmapped,EMShandle;
\r
131 void (* XMSaddr) (void); // far pointer to XMS driver
\r
133 unsigned numUMBs,UMBbase[MAXUMBS];
\r
135 //==========================================================================
\r
138 // local prototypes
\r
141 boolean MML_CheckForEMS (void);
\r
142 void MML_ShutdownEMS (void);
\r
143 void MM_MapEMS (void);
\r
144 boolean MML_CheckForXMS (void);
\r
145 void MML_ShutdownXMS (void);
\r
146 void MML_UseSpace (unsigned segstart, unsigned seglength);
\r
147 void MML_ClearBlock (void);
\r
149 //==========================================================================
\r
152 ======================
\r
156 = Routine from p36 of Extending DOS
\r
158 =======================
\r
161 boolean MML_CheckForEMS (void)
\r
164 char emmname[] = "EMMXXXX0";
167 mov dx,OFFSET emmname[0]
\r
169 int 0x21 // try to open EMMXXXX0 device
\r
175 int 0x21 // get device info
\r
183 int 0x21 // get status
\r
189 int 0x21 // close handle
\r
208 ======================
\r
212 =======================
\r
215 void MML_SetupEMS (void)
\r
217 char str[80],str2[10];
\r
220 totalEMSpages = freeEMSpages = EMSpageframe = EMSpagesmapped = 0;
\r
224 int EMS_INT // make sure EMS hardware is present
\r
232 cmp al,0x32 // only work on ems 3.2 or greater
\r
235 mov ah,EMS_GETFRAME
\r
236 int EMS_INT // find the page frame address
\r
239 mov [EMSpageframe],bx
\r
241 mov ah,EMS_GETPAGES
\r
242 int EMS_INT // find out how much EMS is there
\r
245 mov [totalEMSpages],dx
\r
246 mov [freeEMSpages],bx
\r
248 jz noEMS // no EMS at all to allocate
\r
251 jle getpages // there is only 1,2,3,or 4 pages
\r
252 mov bx,4 // we can't use more than 4 pages
\r
257 mov [EMSpagesmapped],bx
\r
258 mov ah,EMS_ALLOCPAGES // allocate up to 64k of EMS
\r
268 strcpy (str,"MML_SetupEMS: EMS error 0x");
\r
269 itoa(error,str2,16);
\r
279 ======================
\r
283 =======================
\r
286 void MML_ShutdownEMS (void)
\r
292 mov ah,EMS_FREEPAGES
\r
299 Quit ("MML_ShutdownEMS: Error freeing EMS!");
\r
306 ====================
\r
310 = Maps the 64k of EMS used by memory manager into the page frame
\r
311 = for general use. This only needs to be called if you are keeping
\r
312 = other things in EMS.
\r
314 ====================
\r
317 void MM_MapEMS (void)
\r
319 char str[80],str2[10];
\r
323 for (i=0;i<EMSpagesmapped;i++)
\r
327 mov bx,[i] // logical page
\r
328 mov al,bl // physical page
\r
329 mov dx,[EMShandle] // handle
\r
340 strcpy (str,"MM_MapEMS: EMS error 0x");
\r
341 itoa(error,str2,16);
\r
346 //==========================================================================
\r
349 ======================
\r
353 = Check for XMM driver
\r
355 =======================
\r
358 boolean MML_CheckForXMS (void)
\r
364 int 0x2f // query status of installed diver
\r
375 ======================
\r
379 = Try to allocate all upper memory block
\r
381 =======================
\r
384 void MML_SetupXMS (void)
\r
386 unsigned base,size;
\r
391 mov [WORD PTR XMSaddr],bx
\r
392 mov [WORD PTR XMSaddr+2],es // function pointer to XMS driver
\r
397 mov ah,XMS_ALLOCUMB
\r
398 mov dx,0xffff // try for largest block possible
\r
399 call [DWORD PTR XMSaddr]
\r
403 cmp bl,0xb0 // error: smaller UMB is available
\r
406 mov ah,XMS_ALLOCUMB
\r
407 call [DWORD PTR XMSaddr] // DX holds largest available UMB
\r
409 jz done // another error...
\r
417 MML_UseSpace (base,size);
\r
418 mminfo.XMSmem += size*16;
\r
419 UMBbase[numUMBs] = base;
\r
421 if (numUMBs < MAXUMBS)
\r
429 ======================
\r
433 ======================
\r
436 void MML_ShutdownXMS (void)
\r
441 for (i=0;i<numUMBs;i++)
\r
447 call [DWORD PTR XMSaddr]
\r
451 //==========================================================================
\r
454 ======================
\r
458 = Marks a range of paragraphs as usable by the memory manager
\r
459 = This is used to mark space for the near heap, far heap, ems page frame,
\r
460 = and upper memory blocks
\r
462 ======================
\r
465 void MML_UseSpace (unsigned segstart, unsigned seglength)
\r
467 mmblocktype far *scan,far *last;
\r
471 scan = last = mmhead;
\r
472 mmrover = mmhead; // reset rover to start of memory
\r
475 // search for the block that contains the range of segments
\r
477 while (scan->start+scan->length < segstart)
\r
484 // take the given range out of the block
\r
486 oldend = scan->start + scan->length;
\r
487 extra = oldend - (segstart+seglength);
\r
489 Quit ("MML_UseSpace: Segment spans two blocks!");
\r
491 if (segstart == scan->start)
\r
493 last->next = scan->next; // unlink block
\r
498 scan->length = segstart-scan->start; // shorten block
\r
503 mmnew->next = scan->next;
\r
504 scan->next = mmnew;
\r
505 mmnew->start = segstart+seglength;
\r
506 mmnew->length = extra;
\r
507 mmnew->attributes = LOCKBIT;
\r
512 //==========================================================================
\r
515 ====================
\r
519 = We are out of blocks, so free a purgable block
\r
521 ====================
\r
524 void MML_ClearBlock (void)
\r
526 mmblocktype far *scan,far *last;
\r
528 scan = mmhead->next;
\r
532 if (!(scan->attributes&LOCKBIT) && (scan->attributes&PURGEBITS) )
\r
534 MM_FreePtr(scan->useptr);
\r
540 Quit ("MM_ClearBlock: No purgable blocks!");
\r
544 //==========================================================================
\r
547 ===================
\r
551 = Grabs all space from turbo with malloc/farmalloc
\r
552 = Allocates bufferseg misc buffer
\r
554 ===================
\r
557 static char *ParmStrings[] = {"noems","noxms",""};
\r
559 void MM_Startup (void)
\r
562 unsigned long length;
\r
564 unsigned segstart,seglength,endfree;
\r
571 bombonerror = true;
\r
573 // set up the linked list (everything in the free list;
\r
576 mmfree = &mmblocks[0];
\r
577 for (i=0;i<MAXBLOCKS-1;i++)
\r
578 mmblocks[i].next = &mmblocks[i+1];
\r
579 mmblocks[i].next = NULL;
\r
582 // locked block of all memory until we punch out free space
\r
585 mmhead = mmnew; // this will allways be the first node
\r
587 mmnew->length = 0xffff;
\r
588 mmnew->attributes = LOCKBIT;
\r
589 mmnew->next = NULL;
\r
594 // get all available near conventional memory segments
\r
597 start = (void far *)(nearheap = malloc(length));
\r
599 length -= 16-(FP_OFF(start)&15);
\r
600 length -= SAVENEARHEAP;
\r
601 seglength = length / 16; // now in paragraphs
\r
602 segstart = FP_SEG(start)+(FP_OFF(start)+15)/16;
\r
603 MML_UseSpace (segstart,seglength);
\r
604 mminfo.nearheap = length;
\r
607 // get all available far conventional memory segments
\r
609 length=farcoreleft();
\r
610 start = farheap = farmalloc(length);
\r
611 length -= 16-(FP_OFF(start)&15);
\r
612 length -= SAVEFARHEAP;
\r
613 seglength = length / 16; // now in paragraphs
\r
614 segstart = FP_SEG(start)+(FP_OFF(start)+15)/16;
\r
615 MML_UseSpace (segstart,seglength);
\r
616 mminfo.farheap = length;
\r
617 mminfo.mainmem = mminfo.nearheap + mminfo.farheap;
\r
621 // detect EMS and allocate up to 64K at page frame
\r
624 for (i = 1;i < _argc;i++)
\r
626 if ( US_CheckParm(_argv[i],ParmStrings) == 0)
\r
627 goto emsskip; // param NOEMS
\r
630 if (MML_CheckForEMS())
\r
632 MML_SetupEMS(); // allocate space
\r
633 MML_UseSpace (EMSpageframe,EMSpagesmapped*0x400);
\r
634 MM_MapEMS(); // map in used pages
\r
635 mminfo.EMSmem = EMSpagesmapped*0x4000l;
\r
639 // detect XMS and get upper memory blocks
\r
643 for (i = 1;i < _argc;i++)
\r
645 if ( US_CheckParm(_argv[i],ParmStrings) == 0)
\r
646 goto xmsskip; // param NOXMS
\r
649 if (MML_CheckForXMS())
\r
650 MML_SetupXMS(); // allocate as many UMBs as possible
\r
653 // allocate the misc buffer
\r
656 mmrover = mmhead; // start looking for space after low block
\r
658 MM_GetPtr (&bufferseg,BUFFERSIZE);
\r
661 //==========================================================================
\r
664 ====================
\r
668 = Frees all conventional, EMS, and XMS allocated
\r
670 ====================
\r
673 void MM_Shutdown (void)
\r
680 MML_ShutdownEMS ();
\r
681 MML_ShutdownXMS ();
\r
684 //==========================================================================
\r
687 ====================
\r
691 = Allocates an unlocked, unpurgable block
\r
693 ====================
\r
696 void MM_GetPtr (memptr *baseptr,unsigned long size)
\r
698 mmblocktype far *scan,far *lastscan,far *endscan
\r
699 ,far *purge,far *next;
\r
701 unsigned needed,startseg;
\r
703 needed = (size+15)/16; // convert size from bytes to paragraphs
\r
705 GETNEWBLOCK; // fill in start and next after a spot is found
\r
706 mmnew->length = needed;
\r
707 mmnew->useptr = baseptr;
\r
708 mmnew->attributes = BASEATTRIBUTES;
\r
710 for (search = 0; search<3; search++)
\r
713 // first search: try to allocate right after the rover, then on up
\r
714 // second search: search from the head pointer up to the rover
\r
715 // third search: compress memory, then scan from start
\r
716 if (search == 1 && mmrover == mmhead)
\r
722 lastscan = mmrover;
\r
723 scan = mmrover->next;
\r
728 scan = mmhead->next;
\r
734 scan = mmhead->next;
\r
739 startseg = lastscan->start + lastscan->length;
\r
741 while (scan != endscan)
\r
743 if (scan->start - startseg >= needed)
\r
746 // got enough space between the end of lastscan and
\r
747 // the start of scan, so throw out anything in the middle
\r
748 // and allocate the new block
\r
750 purge = lastscan->next;
\r
751 lastscan->next = mmnew;
\r
752 mmnew->start = *(unsigned *)baseptr = startseg;
\r
753 mmnew->next = scan;
\r
754 while ( purge != scan)
\r
755 { // free the purgable block
\r
756 next = purge->next;
\r
758 purge = next; // purge another if not at scan
\r
761 return; // good allocation!
\r
765 // if this block is purge level zero or locked, skip past it
\r
767 if ( (scan->attributes & LOCKBIT)
\r
768 || !(scan->attributes & PURGEBITS) )
\r
771 startseg = lastscan->start + lastscan->length;
\r
775 scan=scan->next; // look at next line
\r
780 Quit (OUT_OF_MEM_MSG,(size-mminfo.nearheap));
\r
785 //==========================================================================
\r
788 ====================
\r
792 = Allocates an unlocked, unpurgable block
\r
794 ====================
\r
797 void MM_FreePtr (memptr *baseptr)
\r
799 mmblocktype far *scan,far *last;
\r
804 if (baseptr == mmrover->useptr) // removed the last allocated block
\r
807 while (scan->useptr != baseptr && scan)
\r
814 Quit ("MM_FreePtr: Block not found!");
\r
816 last->next = scan->next;
\r
820 //==========================================================================
\r
823 =====================
\r
827 = Sets the purge level for a block (locked blocks cannot be made purgable)
\r
829 =====================
\r
832 void MM_SetPurge (memptr *baseptr, int purge)
\r
834 mmblocktype far *start;
\r
840 if (mmrover->useptr == baseptr)
\r
843 mmrover = mmrover->next;
\r
847 else if (mmrover == start)
\r
848 Quit ("MM_SetPurge: Block not found!");
\r
852 mmrover->attributes &= ~PURGEBITS;
\r
853 mmrover->attributes |= purge;
\r
856 //==========================================================================
\r
859 =====================
\r
863 = Locks / unlocks the block
\r
865 =====================
\r
868 void MM_SetLock (memptr *baseptr, boolean locked)
\r
870 mmblocktype far *start;
\r
876 if (mmrover->useptr == baseptr)
\r
879 mmrover = mmrover->next;
\r
883 else if (mmrover == start)
\r
884 Quit ("MM_SetLock: Block not found!");
\r
888 mmrover->attributes &= ~LOCKBIT;
\r
889 mmrover->attributes |= locked*LOCKBIT;
\r
892 //==========================================================================
\r
895 =====================
\r
899 = Throws out all purgable stuff and compresses movable blocks
\r
901 =====================
\r
904 void MM_SortMem (void)
\r
906 mmblocktype far *scan,far *last,far *next;
\r
907 unsigned start,length,source,dest,oldborder;
\r
911 // lock down a currently playing sound
\r
913 playing = SD_SoundPlaying ();
\r
919 playing += STARTPCSOUNDS;
\r
922 playing += STARTADLIBSOUNDS;
\r
925 MM_SetLock(&(memptr)audiosegs[playing],true);
\r
930 // oldborder = bordercolor;
\r
931 // VW_ColorBorder (15);
\r
938 last = NULL; // shut up compiler warning
\r
942 if (scan->attributes & LOCKBIT)
\r
945 // block is locked, so try to pile later blocks right after it
\r
947 start = scan->start + scan->length;
\r
951 if (scan->attributes & PURGEBITS)
\r
954 // throw out the purgable block
\r
965 // push the non purgable block on top of the last moved block
\r
967 if (scan->start != start)
\r
969 length = scan->length;
\r
970 source = scan->start;
\r
972 while (length > 0xf00)
\r
974 movedata(source,0,dest,0,0xf00*16);
\r
979 movedata(source,0,dest,0,length*16);
\r
981 scan->start = start;
\r
982 *(unsigned *)scan->useptr = start;
\r
984 start = scan->start + scan->length;
\r
989 scan = scan->next; // go to next block
\r
997 // VW_ColorBorder (oldborder);
\r
1000 MM_SetLock(&(memptr)audiosegs[playing],false);
\r
1004 //==========================================================================
\r
1008 =====================
\r
1012 =====================
\r
1015 void MM_ShowMemory (void)
\r
1017 mmblocktype far *scan;
\r
1018 unsigned color,temp;
\r
1020 char scratch[80],str[10];
\r
1022 VW_SetDefaultColors();
\r
1023 VW_SetLineWidth(40);
\r
1026 VW_SetScreen (0,0);
\r
1032 //CA_OpenDebug ();
\r
1036 if (scan->attributes & PURGEBITS)
\r
1037 color = 5; // dark purple = purgable
\r
1039 color = 9; // medium blue = non purgable
\r
1040 if (scan->attributes & LOCKBIT)
\r
1041 color = 12; // red = locked
\r
1042 if (scan->start<=end)
\r
1043 Quit ("MM_ShowMemory: Memory block order currupted!");
\r
1044 end = scan->start+scan->length-1;
\r
1045 VW_Hlin(scan->start,(unsigned)end,0,color);
\r
1046 VW_Plot(scan->start,0,15);
\r
1047 if (scan->next->start > end+1)
\r
1048 VW_Hlin(end+1,scan->next->start,0,0); // black = free
\r
1051 strcpy (scratch,"Size:");
\r
1052 ltoa ((long)scan->length*16,str,10);
\r
1053 strcat (scratch,str);
\r
1054 strcat (scratch,"\tOwner:0x");
\r
1055 owner = (unsigned)scan->useptr;
\r
1056 ultoa (owner,str,16);
\r
1057 strcat (scratch,str);
\r
1058 strcat (scratch,"\n");
\r
1059 write (debughandle,scratch,strlen(scratch));
\r
1062 scan = scan->next;
\r
1065 //CA_CloseDebug ();
\r
1068 VW_SetLineWidth(64);
\r
1073 //==========================================================================
\r
1077 ======================
\r
1081 = Returns the total free space without purging
\r
1083 ======================
\r
1086 long MM_UnusedMemory (void)
\r
1089 mmblocktype far *scan;
\r
1094 while (scan->next)
\r
1096 free += scan->next->start - (scan->start + scan->length);
\r
1097 scan = scan->next;
\r
1103 //==========================================================================
\r
1107 ======================
\r
1111 = Returns the total free space with purging
\r
1113 ======================
\r
1116 long MM_TotalFree (void)
\r
1119 mmblocktype far *scan;
\r
1124 while (scan->next)
\r
1126 if ((scan->attributes&PURGEBITS) && !(scan->attributes&LOCKBIT))
\r
1127 free += scan->length;
\r
1128 free += scan->next->start - (scan->start + scan->length);
\r
1129 scan = scan->next;
\r
1135 //==========================================================================
\r
1138 =====================
\r
1142 =====================
\r
1145 void MM_BombOnError (boolean bomb)
\r
1147 bombonerror = bomb;
\r