rpcss: Don't use sizeof in traces to avoid printf format warnings.
[wine/testsucceed.git] / dlls / kernel / heap.c
blob06f6aa26306750eef8b72006bee97c4da7244fd7
1 /*
2 * Win32 heap functions
4 * Copyright 1995, 1996 Alexandre Julliard
5 * Copyright 1996 Huw Davies
6 * Copyright 1998 Ulrich Weigand
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
23 #include "config.h"
24 #include "wine/port.h"
26 #include <assert.h>
27 #include <stdlib.h>
28 #include <stdarg.h>
29 #include <stdio.h>
30 #include <string.h>
31 #include <sys/types.h>
32 #include <time.h>
33 #ifdef HAVE_SYS_PARAM_H
34 #include <sys/param.h>
35 #endif
36 #ifdef HAVE_SYS_SYSCTL_H
37 #include <sys/sysctl.h>
38 #endif
39 #ifdef HAVE_UNISTD_H
40 # include <unistd.h>
41 #endif
43 #ifdef sun
44 /* FIXME: Unfortunately swapctl can't be used with largefile.... */
45 # undef _FILE_OFFSET_BITS
46 # define _FILE_OFFSET_BITS 32
47 # ifdef HAVE_SYS_RESOURCE_H
48 # include <sys/resource.h>
49 # endif
50 # ifdef HAVE_SYS_STAT_H
51 # include <sys/stat.h>
52 # endif
53 # include <sys/swap.h>
54 #endif
57 #include "windef.h"
58 #include "winbase.h"
59 #include "winerror.h"
60 #include "winnt.h"
61 #include "winternl.h"
62 #include "excpt.h"
63 #include "wine/exception.h"
64 #include "wine/debug.h"
66 WINE_DEFAULT_DEBUG_CHANNEL(heap);
68 /* address where we try to map the system heap */
69 #define SYSTEM_HEAP_BASE ((void*)0x80000000)
70 #define SYSTEM_HEAP_SIZE 0x1000000 /* Default heap size = 16Mb */
72 static HANDLE systemHeap; /* globally shared heap */
75 /***********************************************************************
76 * HEAP_CreateSystemHeap
78 * Create the system heap.
80 inline static HANDLE HEAP_CreateSystemHeap(void)
82 int created;
83 void *base;
84 HANDLE map, event;
86 /* create the system heap event first */
87 event = CreateEventA( NULL, TRUE, FALSE, "__wine_system_heap_event" );
89 if (!(map = CreateFileMappingA( INVALID_HANDLE_VALUE, NULL, SEC_COMMIT | PAGE_READWRITE,
90 0, SYSTEM_HEAP_SIZE, "__wine_system_heap" ))) return 0;
91 created = (GetLastError() != ERROR_ALREADY_EXISTS);
93 if (!(base = MapViewOfFileEx( map, FILE_MAP_ALL_ACCESS, 0, 0, 0, SYSTEM_HEAP_BASE )))
95 /* pre-defined address not available */
96 ERR( "system heap base address %p not available\n", SYSTEM_HEAP_BASE );
97 return 0;
100 if (created) /* newly created heap */
102 systemHeap = RtlCreateHeap( HEAP_SHARED, base, SYSTEM_HEAP_SIZE,
103 SYSTEM_HEAP_SIZE, NULL, NULL );
104 SetEvent( event );
106 else
108 /* wait for the heap to be initialized */
109 WaitForSingleObject( event, INFINITE );
110 systemHeap = (HANDLE)base;
112 CloseHandle( map );
113 return systemHeap;
117 /***********************************************************************
118 * HeapCreate (KERNEL32.@)
120 * Create a heap object.
122 * RETURNS
123 * Handle of heap: Success
124 * NULL: Failure
126 HANDLE WINAPI HeapCreate(
127 DWORD flags, /* [in] Heap allocation flag */
128 SIZE_T initialSize, /* [in] Initial heap size */
129 SIZE_T maxSize /* [in] Maximum heap size */
131 HANDLE ret;
133 if ( flags & HEAP_SHARED )
135 if (!systemHeap) HEAP_CreateSystemHeap();
136 else WARN( "Shared Heap requested, returning system heap.\n" );
137 ret = systemHeap;
139 else
141 ret = RtlCreateHeap( flags, NULL, maxSize, initialSize, NULL, NULL );
142 if (!ret) SetLastError( ERROR_NOT_ENOUGH_MEMORY );
144 return ret;
148 /***********************************************************************
149 * HeapDestroy (KERNEL32.@)
151 * Destroy a heap object.
153 * RETURNS
154 * TRUE: Success
155 * FALSE: Failure
157 BOOL WINAPI HeapDestroy( HANDLE heap /* [in] Handle of heap */ )
159 if (heap == systemHeap)
161 WARN( "attempt to destroy system heap, returning TRUE!\n" );
162 return TRUE;
164 if (!RtlDestroyHeap( heap )) return TRUE;
165 SetLastError( ERROR_INVALID_HANDLE );
166 return FALSE;
170 /***********************************************************************
171 * HeapCompact (KERNEL32.@)
173 SIZE_T WINAPI HeapCompact( HANDLE heap, DWORD flags )
175 return RtlCompactHeap( heap, flags );
179 /***********************************************************************
180 * HeapValidate (KERNEL32.@)
181 * Validates a specified heap.
183 * NOTES
184 * Flags is ignored.
186 * RETURNS
187 * TRUE: Success
188 * FALSE: Failure
190 BOOL WINAPI HeapValidate(
191 HANDLE heap, /* [in] Handle to the heap */
192 DWORD flags, /* [in] Bit flags that control access during operation */
193 LPCVOID block /* [in] Optional pointer to memory block to validate */
195 return RtlValidateHeap( heap, flags, block );
199 /***********************************************************************
200 * HeapWalk (KERNEL32.@)
201 * Enumerates the memory blocks in a specified heap.
203 * TODO
204 * - handling of PROCESS_HEAP_ENTRY_MOVEABLE and
205 * PROCESS_HEAP_ENTRY_DDESHARE (needs heap.c support)
207 * RETURNS
208 * TRUE: Success
209 * FALSE: Failure
211 BOOL WINAPI HeapWalk(
212 HANDLE heap, /* [in] Handle to heap to enumerate */
213 LPPROCESS_HEAP_ENTRY entry /* [out] Pointer to structure of enumeration info */
215 NTSTATUS ret = RtlWalkHeap( heap, entry );
216 if (ret) SetLastError( RtlNtStatusToDosError(ret) );
217 return !ret;
221 /***********************************************************************
222 * HeapLock (KERNEL32.@)
223 * Attempts to acquire the critical section object for a specified heap.
225 * RETURNS
226 * TRUE: Success
227 * FALSE: Failure
229 BOOL WINAPI HeapLock(
230 HANDLE heap /* [in] Handle of heap to lock for exclusive access */
232 return RtlLockHeap( heap );
236 /***********************************************************************
237 * HeapUnlock (KERNEL32.@)
238 * Releases ownership of the critical section object.
240 * RETURNS
241 * TRUE: Success
242 * FALSE: Failure
244 BOOL WINAPI HeapUnlock(
245 HANDLE heap /* [in] Handle to the heap to unlock */
247 return RtlUnlockHeap( heap );
251 /***********************************************************************
252 * GetProcessHeap (KERNEL32.@)
254 HANDLE WINAPI GetProcessHeap(void)
256 return NtCurrentTeb()->Peb->ProcessHeap;
260 /***********************************************************************
261 * GetProcessHeaps (KERNEL32.@)
263 DWORD WINAPI GetProcessHeaps( DWORD count, HANDLE *heaps )
265 return RtlGetProcessHeaps( count, heaps );
269 /* These are needed so that we can call the functions from inside kernel itself */
271 LPVOID WINAPI HeapAlloc( HANDLE heap, DWORD flags, SIZE_T size )
273 return RtlAllocateHeap( heap, flags, size );
276 BOOL WINAPI HeapFree( HANDLE heap, DWORD flags, LPVOID ptr )
278 return RtlFreeHeap( heap, flags, ptr );
281 LPVOID WINAPI HeapReAlloc( HANDLE heap, DWORD flags, LPVOID ptr, SIZE_T size )
283 return RtlReAllocateHeap( heap, flags, ptr, size );
286 SIZE_T WINAPI HeapSize( HANDLE heap, DWORD flags, LPVOID ptr )
288 return RtlSizeHeap( heap, flags, ptr );
292 * Win32 Global heap functions (GlobalXXX).
293 * These functions included in Win32 for compatibility with 16 bit Windows
294 * Especially the moveable blocks and handles are oldish.
295 * But the ability to directly allocate memory with GPTR and LPTR is widely
296 * used.
298 * The handle stuff looks horrible, but it's implemented almost like Win95
299 * does it.
303 #define MAGIC_GLOBAL_USED 0x5342
304 #define HANDLE_TO_INTERN(h) ((PGLOBAL32_INTERN)(((char *)(h))-2))
305 #define INTERN_TO_HANDLE(i) ((HGLOBAL) &((i)->Pointer))
306 #define POINTER_TO_HANDLE(p) (*(((HGLOBAL *)(p))-2))
307 #define ISHANDLE(h) (((ULONG_PTR)(h)&2)!=0)
308 #define ISPOINTER(h) (((ULONG_PTR)(h)&2)==0)
309 /* align the storage needed for the HGLOBAL on an 8byte boundary thus
310 * GlobalAlloc/GlobalReAlloc'ing with GMEM_MOVEABLE of memory with
311 * size = 8*k, where k=1,2,3,... alloc's exactly the given size.
312 * The Minolta DiMAGE Image Viewer heavily relies on this, corrupting
313 * the output jpeg's > 1 MB if not */
314 #define HGLOBAL_STORAGE 8 /* sizeof(HGLOBAL)*2 */
316 #include "pshpack1.h"
318 typedef struct __GLOBAL32_INTERN
320 WORD Magic;
321 LPVOID Pointer;
322 BYTE Flags;
323 BYTE LockCount;
324 } GLOBAL32_INTERN, *PGLOBAL32_INTERN;
326 #include "poppack.h"
328 /***********************************************************************
329 * GlobalAlloc (KERNEL32.@)
331 * Allocate a global memory object.
333 * RETURNS
334 * Handle: Success
335 * NULL: Failure
337 HGLOBAL WINAPI GlobalAlloc(
338 UINT flags, /* [in] Object allocation attributes */
339 SIZE_T size /* [in] Number of bytes to allocate */
341 PGLOBAL32_INTERN pintern;
342 DWORD hpflags;
343 LPVOID palloc;
345 if(flags&GMEM_ZEROINIT)
346 hpflags=HEAP_ZERO_MEMORY;
347 else
348 hpflags=0;
350 TRACE("() flags=%04x\n", flags );
352 if((flags & GMEM_MOVEABLE)==0) /* POINTER */
354 palloc=HeapAlloc(GetProcessHeap(), hpflags, size);
355 return (HGLOBAL) palloc;
357 else /* HANDLE */
359 RtlLockHeap(GetProcessHeap());
361 pintern = HeapAlloc(GetProcessHeap(), 0, sizeof(GLOBAL32_INTERN));
362 if (pintern)
364 pintern->Magic = MAGIC_GLOBAL_USED;
365 pintern->Flags = flags >> 8;
366 pintern->LockCount = 0;
368 if (size)
370 palloc = HeapAlloc(GetProcessHeap(), hpflags, size+HGLOBAL_STORAGE);
371 if (!palloc)
373 HeapFree(GetProcessHeap(), 0, pintern);
374 pintern = NULL;
376 else
378 *(HGLOBAL *)palloc = INTERN_TO_HANDLE(pintern);
379 pintern->Pointer = (char *)palloc + HGLOBAL_STORAGE;
382 else
383 pintern->Pointer = NULL;
386 RtlUnlockHeap(GetProcessHeap());
387 return pintern ? INTERN_TO_HANDLE(pintern) : 0;
392 /***********************************************************************
393 * GlobalLock (KERNEL32.@)
395 * Lock a global memory object and return a pointer to first byte of the memory
397 * PARAMS
398 * hmem [I] Handle of the global memory object
400 * RETURNS
401 * Success: Pointer to first byte of the memory block
402 * Failure: NULL
404 * NOTES
405 * When the handle is invalid, last error is set to ERROR_INVALID_HANDLE
408 LPVOID WINAPI GlobalLock(HGLOBAL hmem)
410 PGLOBAL32_INTERN pintern;
411 LPVOID palloc;
413 if (ISPOINTER(hmem))
414 return IsBadReadPtr(hmem, 1) ? NULL : hmem;
416 RtlLockHeap(GetProcessHeap());
417 __TRY
419 pintern = HANDLE_TO_INTERN(hmem);
420 if (pintern->Magic == MAGIC_GLOBAL_USED)
422 palloc = pintern->Pointer;
423 if (!pintern->Pointer)
424 SetLastError(ERROR_DISCARDED);
425 else if (pintern->LockCount < GMEM_LOCKCOUNT)
426 pintern->LockCount++;
428 else
430 WARN("invalid handle %p (Magic: 0x%04x)\n", hmem, pintern->Magic);
431 palloc = NULL;
432 SetLastError(ERROR_INVALID_HANDLE);
435 __EXCEPT_PAGE_FAULT
437 WARN("(%p): Page fault occurred ! Caused by bug ?\n", hmem);
438 palloc = NULL;
439 SetLastError(ERROR_INVALID_HANDLE);
441 __ENDTRY
442 RtlUnlockHeap(GetProcessHeap());
443 return palloc;
447 /***********************************************************************
448 * GlobalUnlock (KERNEL32.@)
450 * Unlock a global memory object.
452 * PARAMS
453 * hmem [I] Handle of the global memory object
455 * RETURNS
456 * Success: Object is still locked
457 * Failure: FALSE (The Object is unlocked)
459 * NOTES
460 * When the handle is invalid, last error is set to ERROR_INVALID_HANDLE
463 BOOL WINAPI GlobalUnlock(HGLOBAL hmem)
465 PGLOBAL32_INTERN pintern;
466 BOOL locked;
468 if (ISPOINTER(hmem)) return FALSE;
470 RtlLockHeap(GetProcessHeap());
471 __TRY
473 pintern=HANDLE_TO_INTERN(hmem);
474 if(pintern->Magic==MAGIC_GLOBAL_USED)
476 if(pintern->LockCount)
478 pintern->LockCount--;
479 locked = (pintern->LockCount != 0);
480 if (!locked) SetLastError(NO_ERROR);
482 else
484 WARN("%p not locked\n", hmem);
485 SetLastError(ERROR_NOT_LOCKED);
486 locked = FALSE;
489 else
491 WARN("invalid handle %p (Magic: 0x%04x)\n", hmem, pintern->Magic);
492 SetLastError(ERROR_INVALID_HANDLE);
493 locked=FALSE;
496 __EXCEPT_PAGE_FAULT
498 WARN("(%p): Page fault occurred ! Caused by bug ?\n", hmem);
499 SetLastError( ERROR_INVALID_PARAMETER );
500 locked=FALSE;
502 __ENDTRY
503 RtlUnlockHeap(GetProcessHeap());
504 return locked;
508 /***********************************************************************
509 * GlobalHandle (KERNEL32.@)
511 * Get the handle associated with the pointer to a global memory block.
513 * RETURNS
514 * Handle: Success
515 * NULL: Failure
517 HGLOBAL WINAPI GlobalHandle(
518 LPCVOID pmem /* [in] Pointer to global memory block */
520 HGLOBAL handle;
521 PGLOBAL32_INTERN maybe_intern;
522 LPCVOID test;
524 if (!pmem)
526 SetLastError( ERROR_INVALID_PARAMETER );
527 return 0;
530 RtlLockHeap(GetProcessHeap());
531 __TRY
533 handle = 0;
535 /* note that if pmem is a pointer to a a block allocated by */
536 /* GlobalAlloc with GMEM_MOVEABLE then magic test in HeapValidate */
537 /* will fail. */
538 if (ISPOINTER(pmem)) {
539 if (HeapValidate( GetProcessHeap(), 0, pmem )) {
540 handle = (HGLOBAL)pmem; /* valid fixed block */
541 break;
543 handle = POINTER_TO_HANDLE(pmem);
544 } else
545 handle = (HGLOBAL)pmem;
547 /* Now test handle either passed in or retrieved from pointer */
548 maybe_intern = HANDLE_TO_INTERN( handle );
549 if (maybe_intern->Magic == MAGIC_GLOBAL_USED) {
550 test = maybe_intern->Pointer;
551 if (HeapValidate( GetProcessHeap(), 0, (const char *)test - HGLOBAL_STORAGE ) && /* obj(-handle) valid arena? */
552 HeapValidate( GetProcessHeap(), 0, maybe_intern )) /* intern valid arena? */
553 break; /* valid moveable block */
555 handle = 0;
556 SetLastError( ERROR_INVALID_HANDLE );
558 __EXCEPT_PAGE_FAULT
560 SetLastError( ERROR_INVALID_HANDLE );
561 handle = 0;
563 __ENDTRY
564 RtlUnlockHeap(GetProcessHeap());
566 return handle;
570 /***********************************************************************
571 * GlobalReAlloc (KERNEL32.@)
573 * Change the size or attributes of a global memory object.
575 * RETURNS
576 * Handle: Success
577 * NULL: Failure
579 HGLOBAL WINAPI GlobalReAlloc(
580 HGLOBAL hmem, /* [in] Handle of global memory object */
581 SIZE_T size, /* [in] New size of block */
582 UINT flags /* [in] How to reallocate object */
584 LPVOID palloc;
585 HGLOBAL hnew;
586 PGLOBAL32_INTERN pintern;
587 DWORD heap_flags = (flags & GMEM_ZEROINIT) ? HEAP_ZERO_MEMORY : 0;
589 hnew = 0;
590 RtlLockHeap(GetProcessHeap());
591 if(flags & GMEM_MODIFY) /* modify flags */
593 if( ISPOINTER(hmem) && (flags & GMEM_MOVEABLE))
595 /* make a fixed block moveable
596 * actually only NT is able to do this. But it's soo simple
598 if (hmem == 0)
600 WARN("GlobalReAlloc with null handle!\n");
601 SetLastError( ERROR_NOACCESS );
602 hnew = 0;
604 else
606 size = HeapSize(GetProcessHeap(), 0, (LPVOID)hmem);
607 hnew = GlobalAlloc(flags, size);
608 palloc = GlobalLock(hnew);
609 memcpy(palloc, (LPVOID)hmem, size);
610 GlobalUnlock(hnew);
611 GlobalFree(hmem);
614 else if( ISPOINTER(hmem) &&(flags & GMEM_DISCARDABLE))
616 /* change the flags to make our block "discardable" */
617 pintern=HANDLE_TO_INTERN(hmem);
618 pintern->Flags = pintern->Flags | (GMEM_DISCARDABLE >> 8);
619 hnew=hmem;
621 else
623 SetLastError(ERROR_INVALID_PARAMETER);
624 hnew = 0;
627 else
629 if(ISPOINTER(hmem))
631 /* reallocate fixed memory */
632 hnew=HeapReAlloc(GetProcessHeap(), heap_flags, hmem, size);
634 else
636 /* reallocate a moveable block */
637 pintern=HANDLE_TO_INTERN(hmem);
639 #if 0
640 /* Apparently Windows doesn't care whether the handle is locked at this point */
641 /* See also the same comment in GlobalFree() */
642 if(pintern->LockCount>1) {
643 ERR("handle 0x%08lx is still locked, cannot realloc!\n",(DWORD)hmem);
644 SetLastError(ERROR_INVALID_HANDLE);
645 } else
646 #endif
647 if(size!=0)
649 hnew=hmem;
650 if(pintern->Pointer)
652 if((palloc = HeapReAlloc(GetProcessHeap(), heap_flags,
653 (char *) pintern->Pointer-HGLOBAL_STORAGE,
654 size+HGLOBAL_STORAGE)) == NULL)
655 hnew = 0; /* Block still valid */
656 else
657 pintern->Pointer = (char *)palloc+HGLOBAL_STORAGE;
659 else
661 if((palloc=HeapAlloc(GetProcessHeap(), heap_flags, size+HGLOBAL_STORAGE))
662 == NULL)
663 hnew = 0;
664 else
666 *(HGLOBAL *)palloc = hmem;
667 pintern->Pointer = (char *)palloc + HGLOBAL_STORAGE;
671 else
673 if (pintern->LockCount == 0)
675 if(pintern->Pointer)
677 HeapFree(GetProcessHeap(), 0, (char *) pintern->Pointer-HGLOBAL_STORAGE);
678 pintern->Pointer = NULL;
680 hnew = hmem;
682 else
683 WARN("not freeing memory associated with locked handle\n");
687 RtlUnlockHeap(GetProcessHeap());
688 return hnew;
692 /***********************************************************************
693 * GlobalFree (KERNEL32.@)
695 * Free a global memory object.
697 * PARAMS
698 * hmem [I] Handle of the global memory object
700 * RETURNS
701 * Success: NULL
702 * Failure: The provided handle
704 * NOTES
705 * When the handle is invalid, last error is set to ERROR_INVALID_HANDLE
708 HGLOBAL WINAPI GlobalFree(HGLOBAL hmem)
710 PGLOBAL32_INTERN pintern;
711 HGLOBAL hreturned;
713 RtlLockHeap(GetProcessHeap());
714 __TRY
716 hreturned = 0;
717 if(ISPOINTER(hmem)) /* POINTER */
719 if(!HeapFree(GetProcessHeap(), 0, (LPVOID) hmem)) hmem = 0;
721 else /* HANDLE */
723 pintern=HANDLE_TO_INTERN(hmem);
725 if(pintern->Magic==MAGIC_GLOBAL_USED)
727 pintern->Magic = 0xdead;
729 /* WIN98 does not make this test. That is you can free a */
730 /* block you have not unlocked. Go figure!! */
731 /* if(pintern->LockCount!=0) */
732 /* SetLastError(ERROR_INVALID_HANDLE); */
734 if(pintern->Pointer)
735 if(!HeapFree(GetProcessHeap(), 0, (char *)(pintern->Pointer)-HGLOBAL_STORAGE))
736 hreturned=hmem;
737 if(!HeapFree(GetProcessHeap(), 0, pintern))
738 hreturned=hmem;
740 else
742 WARN("invalid handle %p (Magic: 0x%04x)\n", hmem, pintern->Magic);
743 SetLastError(ERROR_INVALID_HANDLE);
744 hreturned = hmem;
748 __EXCEPT_PAGE_FAULT
750 ERR("(%p): Page fault occurred ! Caused by bug ?\n", hmem);
751 SetLastError( ERROR_INVALID_PARAMETER );
752 hreturned = hmem;
754 __ENDTRY
755 RtlUnlockHeap(GetProcessHeap());
756 return hreturned;
760 /***********************************************************************
761 * GlobalSize (KERNEL32.@)
763 * Get the size of a global memory object.
765 * PARAMS
766 * hmem [I] Handle of the global memory object
768 * RETURNS
769 * Failure: 0
770 * Success: Size in Bytes of the global memory object
772 * NOTES
773 * When the handle is invalid, last error is set to ERROR_INVALID_HANDLE
776 SIZE_T WINAPI GlobalSize(HGLOBAL hmem)
778 DWORD retval;
779 PGLOBAL32_INTERN pintern;
781 if (!hmem) return 0;
783 if(ISPOINTER(hmem))
785 retval=HeapSize(GetProcessHeap(), 0, (LPVOID) hmem);
787 else
789 RtlLockHeap(GetProcessHeap());
790 pintern=HANDLE_TO_INTERN(hmem);
792 if(pintern->Magic==MAGIC_GLOBAL_USED)
794 if (!pintern->Pointer) /* handle case of GlobalAlloc( ??,0) */
795 retval = 0;
796 else
798 retval = HeapSize(GetProcessHeap(), 0,
799 (char *)(pintern->Pointer) - HGLOBAL_STORAGE );
800 if (retval != (DWORD)-1) retval -= HGLOBAL_STORAGE;
803 else
805 WARN("invalid handle %p (Magic: 0x%04x)\n", hmem, pintern->Magic);
806 SetLastError(ERROR_INVALID_HANDLE);
807 retval=0;
809 RtlUnlockHeap(GetProcessHeap());
811 /* HeapSize returns 0xffffffff on failure */
812 if (retval == 0xffffffff) retval = 0;
813 return retval;
817 /***********************************************************************
818 * GlobalWire (KERNEL32.@)
820 LPVOID WINAPI GlobalWire(HGLOBAL hmem)
822 return GlobalLock( hmem );
826 /***********************************************************************
827 * GlobalUnWire (KERNEL32.@)
829 BOOL WINAPI GlobalUnWire(HGLOBAL hmem)
831 return GlobalUnlock( hmem);
835 /***********************************************************************
836 * GlobalFix (KERNEL32.@)
838 VOID WINAPI GlobalFix(HGLOBAL hmem)
840 GlobalLock( hmem );
844 /***********************************************************************
845 * GlobalUnfix (KERNEL32.@)
847 VOID WINAPI GlobalUnfix(HGLOBAL hmem)
849 GlobalUnlock( hmem);
853 /***********************************************************************
854 * GlobalFlags (KERNEL32.@)
856 * Get information about a global memory object.
858 * PARAMS
859 * hmem [I] Handle of the global memory object
861 * RETURNS
862 * Failure: GMEM_INVALID_HANDLE, when the provided handle is invalid
863 * Success: Value specifying allocation flags and lock count
866 UINT WINAPI GlobalFlags(HGLOBAL hmem)
868 DWORD retval;
869 PGLOBAL32_INTERN pintern;
871 if(ISPOINTER(hmem))
873 retval=0;
875 else
877 RtlLockHeap(GetProcessHeap());
878 pintern=HANDLE_TO_INTERN(hmem);
879 if(pintern->Magic==MAGIC_GLOBAL_USED)
881 retval=pintern->LockCount + (pintern->Flags<<8);
882 if(pintern->Pointer==0)
883 retval|= GMEM_DISCARDED;
885 else
887 WARN("invalid handle %p (Magic: 0x%04x)\n", hmem, pintern->Magic);
888 SetLastError(ERROR_INVALID_HANDLE);
889 retval = GMEM_INVALID_HANDLE;
891 RtlUnlockHeap(GetProcessHeap());
893 return retval;
897 /***********************************************************************
898 * GlobalCompact (KERNEL32.@)
900 SIZE_T WINAPI GlobalCompact( DWORD minfree )
902 return 0; /* GlobalCompact does nothing in Win32 */
906 /***********************************************************************
907 * LocalAlloc (KERNEL32.@)
909 * Allocate a local memory object.
911 * RETURNS
912 * Handle: Success
913 * NULL: Failure
915 * NOTES
916 * Windows memory management does not provide a separate local heap
917 * and global heap.
919 HLOCAL WINAPI LocalAlloc(
920 UINT flags, /* [in] Allocation attributes */
921 SIZE_T size /* [in] Number of bytes to allocate */
923 return (HLOCAL)GlobalAlloc( flags, size );
927 /***********************************************************************
928 * LocalCompact (KERNEL32.@)
930 SIZE_T WINAPI LocalCompact( UINT minfree )
932 return 0; /* LocalCompact does nothing in Win32 */
936 /***********************************************************************
937 * LocalFlags (KERNEL32.@)
939 * Get information about a local memory object.
941 * RETURNS
942 * Value specifying allocation flags and lock count.
943 * LMEM_INVALID_HANDLE: Failure
945 * NOTES
946 * Windows memory management does not provide a separate local heap
947 * and global heap.
949 UINT WINAPI LocalFlags(
950 HLOCAL handle /* [in] Handle of memory object */
952 return GlobalFlags( (HGLOBAL)handle );
956 /***********************************************************************
957 * LocalFree (KERNEL32.@)
959 * Free a local memory object.
961 * RETURNS
962 * NULL: Success
963 * Handle: Failure
965 * NOTES
966 * Windows memory management does not provide a separate local heap
967 * and global heap.
969 HLOCAL WINAPI LocalFree(
970 HLOCAL handle /* [in] Handle of memory object */
972 return (HLOCAL)GlobalFree( (HGLOBAL)handle );
976 /***********************************************************************
977 * LocalHandle (KERNEL32.@)
979 * Get the handle associated with the pointer to a local memory block.
981 * RETURNS
982 * Handle: Success
983 * NULL: Failure
985 * NOTES
986 * Windows memory management does not provide a separate local heap
987 * and global heap.
989 HLOCAL WINAPI LocalHandle(
990 LPCVOID ptr /* [in] Address of local memory block */
992 return (HLOCAL)GlobalHandle( ptr );
996 /***********************************************************************
997 * LocalLock (KERNEL32.@)
998 * Locks a local memory object and returns pointer to the first byte
999 * of the memory block.
1001 * RETURNS
1002 * Pointer: Success
1003 * NULL: Failure
1005 * NOTES
1006 * Windows memory management does not provide a separate local heap
1007 * and global heap.
1009 LPVOID WINAPI LocalLock(
1010 HLOCAL handle /* [in] Address of local memory object */
1012 return GlobalLock( (HGLOBAL)handle );
1016 /***********************************************************************
1017 * LocalReAlloc (KERNEL32.@)
1019 * Change the size or attributes of a local memory object.
1021 * RETURNS
1022 * Handle: Success
1023 * NULL: Failure
1025 * NOTES
1026 * Windows memory management does not provide a separate local heap
1027 * and global heap.
1029 HLOCAL WINAPI LocalReAlloc(
1030 HLOCAL handle, /* [in] Handle of memory object */
1031 SIZE_T size, /* [in] New size of block */
1032 UINT flags /* [in] How to reallocate object */
1034 return (HLOCAL)GlobalReAlloc( (HGLOBAL)handle, size, flags );
1038 /***********************************************************************
1039 * LocalShrink (KERNEL32.@)
1041 SIZE_T WINAPI LocalShrink( HGLOBAL handle, UINT newsize )
1043 return 0; /* LocalShrink does nothing in Win32 */
1047 /***********************************************************************
1048 * LocalSize (KERNEL32.@)
1050 * Get the size of a local memory object.
1052 * RETURNS
1053 * Size: Success
1054 * 0: Failure
1056 * NOTES
1057 * Windows memory management does not provide a separate local heap
1058 * and global heap.
1060 SIZE_T WINAPI LocalSize(
1061 HLOCAL handle /* [in] Handle of memory object */
1063 return GlobalSize( (HGLOBAL)handle );
1067 /***********************************************************************
1068 * LocalUnlock (KERNEL32.@)
1070 * Unlock a local memory object.
1072 * RETURNS
1073 * TRUE: Object is still locked
1074 * FALSE: Object is unlocked
1076 * NOTES
1077 * Windows memory management does not provide a separate local heap
1078 * and global heap.
1080 BOOL WINAPI LocalUnlock(
1081 HLOCAL handle /* [in] Handle of memory object */
1083 return GlobalUnlock( (HGLOBAL)handle );
1087 /**********************************************************************
1088 * AllocMappedBuffer (KERNEL32.38)
1090 * This is an undocumented KERNEL32 function that
1091 * SMapLS's a GlobalAlloc'ed buffer.
1093 * RETURNS
1094 * EDI register: pointer to buffer
1096 * NOTES
1097 * The buffer is preceded by 8 bytes:
1098 * ...
1099 * edi+0 buffer
1100 * edi-4 SEGPTR to buffer
1101 * edi-8 some magic Win95 needs for SUnMapLS
1102 * (we use it for the memory handle)
1104 * The SEGPTR is used by the caller!
1106 void WINAPI __regs_AllocMappedBuffer(
1107 CONTEXT86 *context /* [in] EDI register: size of buffer to allocate */
1109 HGLOBAL handle = GlobalAlloc(0, context->Edi + 8);
1110 DWORD *buffer = (DWORD *)GlobalLock(handle);
1111 DWORD ptr = 0;
1113 if (buffer)
1114 if (!(ptr = MapLS(buffer + 2)))
1116 GlobalUnlock(handle);
1117 GlobalFree(handle);
1120 if (!ptr)
1121 context->Eax = context->Edi = 0;
1122 else
1124 buffer[0] = (DWORD)handle;
1125 buffer[1] = ptr;
1127 context->Eax = (DWORD) ptr;
1128 context->Edi = (DWORD)(buffer + 2);
1131 #ifdef DEFINE_REGS_ENTRYPOINT
1132 DEFINE_REGS_ENTRYPOINT( AllocMappedBuffer, 0, 0 );
1133 #endif
1135 /**********************************************************************
1136 * FreeMappedBuffer (KERNEL32.39)
1138 * Free a buffer allocated by AllocMappedBuffer
1140 * RETURNS
1141 * Nothing.
1143 void WINAPI __regs_FreeMappedBuffer(
1144 CONTEXT86 *context /* [in] EDI register: pointer to buffer */
1146 if (context->Edi)
1148 DWORD *buffer = (DWORD *)context->Edi - 2;
1150 UnMapLS(buffer[1]);
1152 GlobalUnlock((HGLOBAL)buffer[0]);
1153 GlobalFree((HGLOBAL)buffer[0]);
1156 #ifdef DEFINE_REGS_ENTRYPOINT
1157 DEFINE_REGS_ENTRYPOINT( FreeMappedBuffer, 0, 0 );
1158 #endif
1160 /***********************************************************************
1161 * GlobalMemoryStatusEx (KERNEL32.@)
1162 * A version of GlobalMemoryStatus that can deal with memory over 4GB
1164 * RETURNS
1165 * TRUE
1167 BOOL WINAPI GlobalMemoryStatusEx( LPMEMORYSTATUSEX lpmemex )
1169 static MEMORYSTATUSEX cached_memstatus;
1170 static int cache_lastchecked = 0;
1171 SYSTEM_INFO si;
1172 #ifdef linux
1173 FILE *f;
1174 #elif defined(__FreeBSD__) || defined(__FreeBSD_kernel__) || defined(__NetBSD__)
1175 int *tmp, size_sys, mib[2];
1176 #elif defined(__APPLE__)
1177 int *tmp, mib[2];
1178 size_t size_sys;
1179 #elif defined(sun)
1180 long pagesize,maxpages,freepages,swapspace,swapfree;
1181 struct anoninfo swapinf;
1182 int rval;
1183 #endif
1185 if (time(NULL)==cache_lastchecked) {
1186 memcpy(lpmemex,&cached_memstatus,sizeof(*lpmemex));
1187 return TRUE;
1189 cache_lastchecked = time(NULL);
1191 lpmemex->dwLength = sizeof(*lpmemex);
1192 lpmemex->dwMemoryLoad = 0;
1193 lpmemex->ullTotalPhys = 16*1024*1024;
1194 lpmemex->ullAvailPhys = 16*1024*1024;
1195 lpmemex->ullTotalPageFile = 16*1024*1024;
1196 lpmemex->ullAvailPageFile = 16*1024*1024;
1198 #ifdef linux
1199 f = fopen( "/proc/meminfo", "r" );
1200 if (f)
1202 char buffer[256];
1203 int total, used, free, shared, buffers, cached;
1205 lpmemex->ullTotalPhys = lpmemex->ullAvailPhys = 0;
1206 lpmemex->ullTotalPageFile = lpmemex->ullAvailPageFile = 0;
1207 while (fgets( buffer, sizeof(buffer), f ))
1209 /* old style /proc/meminfo ... */
1210 if (sscanf( buffer, "Mem: %d %d %d %d %d %d", &total, &used, &free, &shared, &buffers, &cached ))
1212 lpmemex->ullTotalPhys += total;
1213 lpmemex->ullAvailPhys += free + buffers + cached;
1215 if (sscanf( buffer, "Swap: %d %d %d", &total, &used, &free ))
1217 lpmemex->ullTotalPageFile += total;
1218 lpmemex->ullAvailPageFile += free;
1221 /* new style /proc/meminfo ... */
1222 if (sscanf(buffer, "MemTotal: %d", &total))
1223 lpmemex->ullTotalPhys = total*1024;
1224 if (sscanf(buffer, "MemFree: %d", &free))
1225 lpmemex->ullAvailPhys = free*1024;
1226 if (sscanf(buffer, "SwapTotal: %d", &total))
1227 lpmemex->ullTotalPageFile = total*1024;
1228 if (sscanf(buffer, "SwapFree: %d", &free))
1229 lpmemex->ullAvailPageFile = free*1024;
1230 if (sscanf(buffer, "Buffers: %d", &buffers))
1231 lpmemex->ullAvailPhys += buffers*1024;
1232 if (sscanf(buffer, "Cached: %d", &cached))
1233 lpmemex->ullAvailPhys += cached*1024;
1235 fclose( f );
1237 if (lpmemex->ullTotalPhys)
1239 DWORDLONG TotalPhysical = lpmemex->ullTotalPhys+lpmemex->ullTotalPageFile;
1240 DWORDLONG AvailPhysical = lpmemex->ullAvailPhys+lpmemex->ullAvailPageFile;
1241 lpmemex->dwMemoryLoad = (TotalPhysical-AvailPhysical)
1242 / (TotalPhysical / 100);
1245 #elif defined(__FreeBSD__) || defined(__FreeBSD_kernel__) || defined(__NetBSD__) || defined(__APPLE__)
1246 mib[0] = CTL_HW;
1247 mib[1] = HW_PHYSMEM;
1248 sysctl(mib, 2, NULL, &size_sys, NULL, 0);
1249 tmp = malloc(size_sys * sizeof(int));
1250 sysctl(mib, 2, tmp, &size_sys, NULL, 0);
1251 if (tmp && *tmp)
1253 lpmemex->ullTotalPhys = *tmp;
1254 free(tmp);
1255 mib[1] = HW_USERMEM;
1256 sysctl(mib, 2, NULL, &size_sys, NULL, 0);
1257 tmp = malloc(size_sys * sizeof(int));
1258 sysctl(mib, 2, tmp, &size_sys, NULL, 0);
1259 if (tmp && *tmp)
1261 lpmemex->ullAvailPhys = *tmp;
1262 lpmemex->ullTotalPageFile = *tmp;
1263 lpmemex->ullAvailPageFile = *tmp;
1264 lpmemex->dwMemoryLoad = lpmemex->ullTotalPhys - lpmemex->ullAvailPhys;
1265 } else
1267 lpmemex->ullAvailPhys = lpmemex->ullTotalPhys;
1268 lpmemex->ullTotalPageFile = lpmemex->ullTotalPhys;
1269 lpmemex->ullAvailPageFile = lpmemex->ullTotalPhys;
1270 lpmemex->dwMemoryLoad = 0;
1272 free(tmp);
1275 #elif defined ( sun )
1276 pagesize=sysconf(_SC_PAGESIZE);
1277 maxpages=sysconf(_SC_PHYS_PAGES);
1278 freepages=sysconf(_SC_AVPHYS_PAGES);
1279 rval=swapctl(SC_AINFO, &swapinf);
1280 if(rval >-1)
1282 swapspace=swapinf.ani_max*pagesize;
1283 swapfree=swapinf.ani_free*pagesize;
1284 }else
1287 WARN("Swap size cannot be determined , assuming equal to physical memory\n");
1288 swapspace=maxpages*pagesize;
1289 swapfree=maxpages*pagesize;
1291 lpmemex->ullTotalPhys=pagesize*maxpages;
1292 lpmemex->ullAvailPhys = pagesize*freepages;
1293 lpmemex->ullTotalPageFile = swapspace;
1294 lpmemex->ullAvailPageFile = swapfree;
1295 lpmemex->dwMemoryLoad = lpmemex->ullTotalPhys - lpmemex->ullAvailPhys;
1296 #endif
1298 /* Project2k refuses to start if it sees less than 1Mb of free swap */
1299 if (lpmemex->ullTotalPageFile < lpmemex->ullTotalPhys)
1300 lpmemex->ullTotalPageFile = lpmemex->ullTotalPhys;
1301 if (lpmemex->ullAvailPageFile < lpmemex->ullAvailPhys)
1302 lpmemex->ullAvailPageFile = lpmemex->ullAvailPhys;
1304 /* FIXME: should do something for other systems */
1305 GetSystemInfo(&si);
1306 lpmemex->ullTotalVirtual = (char*)si.lpMaximumApplicationAddress-(char*)si.lpMinimumApplicationAddress;
1307 /* FIXME: we should track down all the already allocated VM pages and substract them, for now arbitrarily remove 64KB so that it matches NT */
1308 lpmemex->ullAvailVirtual = lpmemex->ullTotalVirtual-64*1024;
1310 /* MSDN says about AvailExtendedVirtual: Size of unreserved and uncommitted
1311 memory in the extended portion of the virtual address space of the calling
1312 process, in bytes.
1313 However, I don't know what this means, so set it to zero :(
1315 lpmemex->ullAvailExtendedVirtual = 0;
1317 memcpy(&cached_memstatus,lpmemex,sizeof(*lpmemex));
1319 TRACE("<-- LPMEMORYSTATUSEX: dwLength %ld, dwMemoryLoad %ld, ullTotalPhys %s, ullAvailPhys %s,"
1320 " ullTotalPageFile %s, ullAvailPageFile %s, ullTotalVirtual %s, ullAvailVirtual %s\n",
1321 lpmemex->dwLength, lpmemex->dwMemoryLoad, wine_dbgstr_longlong(lpmemex->ullTotalPhys),
1322 wine_dbgstr_longlong(lpmemex->ullAvailPhys), wine_dbgstr_longlong(lpmemex->ullTotalPageFile),
1323 wine_dbgstr_longlong(lpmemex->ullAvailPageFile), wine_dbgstr_longlong(lpmemex->ullTotalVirtual),
1324 wine_dbgstr_longlong(lpmemex->ullAvailVirtual) );
1326 return TRUE;
1329 /***********************************************************************
1330 * GlobalMemoryStatus (KERNEL32.@)
1331 * Provides information about the status of the memory, so apps can tell
1332 * roughly how much they are able to allocate
1334 * RETURNS
1335 * None
1337 VOID WINAPI GlobalMemoryStatus( LPMEMORYSTATUS lpBuffer )
1339 MEMORYSTATUSEX memstatus;
1340 OSVERSIONINFOW osver;
1342 /* Because GlobalMemoryStatus is identical to GlobalMemoryStatusEX save
1343 for one extra field in the struct, and the lack of a bug, we simply
1344 call GlobalMemoryStatusEx and copy the values across. */
1345 GlobalMemoryStatusEx(&memstatus);
1347 lpBuffer->dwLength = sizeof(*lpBuffer);
1348 lpBuffer->dwMemoryLoad = memstatus.dwMemoryLoad;
1350 /* Windows 2000 and later report -1 when values are greater than 4 Gb.
1351 * NT reports values modulo 4 Gb.
1352 * Values between 2 Gb and 4 Gb are rounded down to 2 Gb.
1355 osver.dwOSVersionInfoSize = sizeof(osver);
1356 GetVersionExW(&osver);
1358 if ( osver.dwMajorVersion >= 5 )
1360 lpBuffer->dwTotalPhys = (memstatus.ullTotalPhys > MAXDWORD) ? MAXDWORD :
1361 (memstatus.ullTotalPhys > MAXLONG) ? MAXLONG : memstatus.ullTotalPhys;
1362 lpBuffer->dwAvailPhys = (memstatus.ullAvailPhys > MAXDWORD) ? MAXDWORD :
1363 (memstatus.ullAvailPhys > MAXLONG) ? MAXLONG : memstatus.ullAvailPhys;
1364 lpBuffer->dwTotalPageFile = (memstatus.ullTotalPageFile > MAXDWORD) ? MAXDWORD :
1365 (memstatus.ullTotalPageFile > MAXLONG) ? MAXLONG : memstatus.ullTotalPageFile;
1366 lpBuffer->dwAvailPageFile = (memstatus.ullAvailPageFile > MAXDWORD) ? MAXDWORD :
1367 (memstatus.ullAvailPageFile > MAXLONG) ? MAXLONG : memstatus.ullAvailPageFile;
1368 lpBuffer->dwTotalVirtual = (memstatus.ullTotalVirtual > MAXDWORD) ? MAXDWORD :
1369 (memstatus.ullTotalVirtual > MAXLONG) ? MAXLONG : memstatus.ullTotalVirtual;
1370 lpBuffer->dwAvailVirtual = (memstatus.ullAvailVirtual > MAXDWORD) ? MAXDWORD :
1371 (memstatus.ullAvailVirtual > MAXLONG) ? MAXLONG : memstatus.ullAvailVirtual;
1373 else /* duplicate NT bug */
1375 lpBuffer->dwTotalPhys = (memstatus.ullTotalPhys > MAXDWORD) ? memstatus.ullTotalPhys :
1376 (memstatus.ullTotalPhys > MAXLONG) ? MAXLONG : memstatus.ullTotalPhys;
1377 lpBuffer->dwAvailPhys = (memstatus.ullAvailPhys > MAXDWORD) ? memstatus.ullAvailPhys :
1378 (memstatus.ullAvailPhys > MAXLONG) ? MAXLONG : memstatus.ullAvailPhys;
1379 lpBuffer->dwTotalPageFile = (memstatus.ullTotalPageFile > MAXDWORD) ? memstatus.ullTotalPageFile :
1380 (memstatus.ullTotalPageFile > MAXLONG) ? MAXLONG : memstatus.ullTotalPageFile;
1381 lpBuffer->dwAvailPageFile = (memstatus.ullAvailPageFile > MAXDWORD) ? memstatus.ullAvailPageFile :
1382 (memstatus.ullAvailPageFile > MAXLONG) ? MAXLONG : memstatus.ullAvailPageFile;
1383 lpBuffer->dwTotalVirtual = (memstatus.ullTotalVirtual > MAXDWORD) ? memstatus.ullTotalVirtual :
1384 (memstatus.ullTotalVirtual > MAXLONG) ? MAXLONG : memstatus.ullTotalVirtual;
1385 lpBuffer->dwAvailVirtual = (memstatus.ullAvailVirtual > MAXDWORD) ? memstatus.ullAvailVirtual :
1386 (memstatus.ullAvailVirtual > MAXLONG) ? MAXLONG : memstatus.ullAvailVirtual;
1389 /* work around for broken photoshop 4 installer */
1390 if ( lpBuffer->dwAvailPhys + lpBuffer->dwAvailPageFile >= 2U*1024*1024*1024)
1391 lpBuffer->dwAvailPageFile = 2U*1024*1024*1024 - lpBuffer->dwAvailPhys - 1;