2 * Win32 virtual memory functions
4 * Copyright 1997 Alexandre Julliard
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 #include "wine/port.h"
28 #include <sys/types.h>
33 #define NONAMELESSUNION
34 #define NONAMELESSSTRUCT
36 #define WIN32_NO_STATUS
43 #include "wine/exception.h"
44 #include "wine/debug.h"
46 #include "kernel_private.h"
48 WINE_DECLARE_DEBUG_CHANNEL(seh);
49 WINE_DECLARE_DEBUG_CHANNEL(file);
51 static unsigned int page_size;
54 /***********************************************************************
55 * VirtualAlloc (KERNEL32.@)
57 * Reserves or commits a region of pages in virtual address space.
60 * addr [I] Address of region to reserve or commit.
61 * size [I] Size of region.
62 * type [I] Type of allocation.
63 * protect [I] Type of access protection.
66 * Success: Base address of allocated region of pages.
69 LPVOID WINAPI VirtualAlloc( LPVOID addr, SIZE_T size, DWORD type, DWORD protect )
71 return VirtualAllocEx( GetCurrentProcess(), addr, size, type, protect );
75 /***********************************************************************
76 * VirtualAllocEx (KERNEL32.@)
78 * Seems to be just as VirtualAlloc, but with process handle.
81 * hProcess [I] Handle to process to do mem operation.
82 * addr [I] Address of region to reserve or commit.
83 * size [I] Size of region.
84 * type [I] Type of allocation.
85 * protect [I] Type of access protection.
89 * Success: Base address of allocated region of pages.
92 LPVOID WINAPI VirtualAllocEx( HANDLE hProcess, LPVOID addr, SIZE_T size,
93 DWORD type, DWORD protect )
98 if ((status = NtAllocateVirtualMemory( hProcess, &ret, 0, &size, type, protect )))
100 SetLastError( RtlNtStatusToDosError(status) );
107 /***********************************************************************
108 * VirtualFree (KERNEL32.@)
110 * Releases or decommits a region of pages in virtual address space.
113 * addr [I] Address of region of committed pages.
114 * size [I] Size of region.
115 * type [I] Type of operation.
121 BOOL WINAPI VirtualFree( LPVOID addr, SIZE_T size, DWORD type )
123 return VirtualFreeEx( GetCurrentProcess(), addr, size, type );
127 /***********************************************************************
128 * VirtualFreeEx (KERNEL32.@)
130 * Releases or decommits a region of pages in virtual address space.
133 * process [I] Handle to process.
134 * addr [I] Address of region to free.
135 * size [I] Size of region.
136 * type [I] Type of operation.
142 BOOL WINAPI VirtualFreeEx( HANDLE process, LPVOID addr, SIZE_T size, DWORD type )
144 NTSTATUS status = NtFreeVirtualMemory( process, &addr, &size, type );
145 if (status) SetLastError( RtlNtStatusToDosError(status) );
150 /***********************************************************************
151 * VirtualLock (KERNEL32.@)
153 * Locks the specified region of virtual address space.
156 * addr [I] Address of first byte of range to lock.
157 * size [I] Number of bytes in range to lock.
164 * Always returns TRUE.
167 BOOL WINAPI VirtualLock( LPVOID addr, SIZE_T size )
169 NTSTATUS status = NtLockVirtualMemory( GetCurrentProcess(), &addr, &size, 1 );
170 if (status) SetLastError( RtlNtStatusToDosError(status) );
175 /***********************************************************************
176 * VirtualUnlock (KERNEL32.@)
178 * Unlocks a range of pages in the virtual address space.
181 * addr [I] Address of first byte of range.
182 * size [I] Number of bytes in range.
189 * Always returns TRUE.
192 BOOL WINAPI VirtualUnlock( LPVOID addr, SIZE_T size )
194 NTSTATUS status = NtUnlockVirtualMemory( GetCurrentProcess(), &addr, &size, 1 );
195 if (status) SetLastError( RtlNtStatusToDosError(status) );
200 /***********************************************************************
201 * VirtualProtect (KERNEL32.@)
203 * Changes the access protection on a region of committed pages.
206 * addr [I] Address of region of committed pages.
207 * size [I] Size of region.
208 * new_prot [I] Desired access protection.
209 * old_prot [O] Address of variable to get old protection.
215 BOOL WINAPI VirtualProtect( LPVOID addr, SIZE_T size, DWORD new_prot, LPDWORD old_prot)
217 return VirtualProtectEx( GetCurrentProcess(), addr, size, new_prot, old_prot );
221 /***********************************************************************
222 * VirtualProtectEx (KERNEL32.@)
224 * Changes the access protection on a region of committed pages in the
225 * virtual address space of a specified process.
228 * process [I] Handle of process.
229 * addr [I] Address of region of committed pages.
230 * size [I] Size of region.
231 * new_prot [I] Desired access protection.
232 * old_prot [O] Address of variable to get old protection.
238 BOOL WINAPI VirtualProtectEx( HANDLE process, LPVOID addr, SIZE_T size,
239 DWORD new_prot, LPDWORD old_prot )
241 NTSTATUS status = NtProtectVirtualMemory( process, &addr, &size, new_prot, old_prot );
242 if (status) SetLastError( RtlNtStatusToDosError(status) );
247 /***********************************************************************
248 * VirtualQuery (KERNEL32.@)
250 * Provides info about a range of pages in virtual address space.
253 * addr [I] Address of region.
254 * info [O] Address of info buffer.
255 * len [I] Size of buffer.
258 * Number of bytes returned in information buffer or 0 if
259 * addr >= 0xc0000000 (kernel space).
261 SIZE_T WINAPI VirtualQuery( LPCVOID addr, PMEMORY_BASIC_INFORMATION info,
264 return VirtualQueryEx( GetCurrentProcess(), addr, info, len );
268 /***********************************************************************
269 * VirtualQueryEx (KERNEL32.@)
271 * Provides info about a range of pages in virtual address space of a
275 * process [I] Handle to process.
276 * addr [I] Address of region.
277 * info [O] Address of info buffer.
278 * len [I] Size of buffer.
281 * Number of bytes returned in information buffer.
283 SIZE_T WINAPI VirtualQueryEx( HANDLE process, LPCVOID addr,
284 PMEMORY_BASIC_INFORMATION info, SIZE_T len )
289 if ((status = NtQueryVirtualMemory( process, addr, MemoryBasicInformation, info, len, &ret )))
291 SetLastError( RtlNtStatusToDosError(status) );
298 /***********************************************************************
299 * CreateFileMappingA (KERNEL32.@)
301 * Creates a named or unnamed file-mapping object for the specified file.
304 * hFile [I] Handle to the file to map.
305 * sa [I] Optional security attributes.
306 * protect [I] Protection for mapping object.
307 * size_high [I] High-order 32 bits of object size.
308 * size_low [I] Low-order 32 bits of object size.
309 * name [I] Name of file-mapping object.
313 * Failure: NULL. Mapping object does not exist.
315 HANDLE WINAPI CreateFileMappingA( HANDLE hFile, SECURITY_ATTRIBUTES *sa,
316 DWORD protect, DWORD size_high, DWORD size_low, LPCSTR name )
318 WCHAR buffer[MAX_PATH];
320 if (!name) return CreateFileMappingW( hFile, sa, protect, size_high, size_low, NULL );
322 if (!MultiByteToWideChar( CP_ACP, 0, name, -1, buffer, MAX_PATH ))
324 SetLastError( ERROR_FILENAME_EXCED_RANGE );
327 return CreateFileMappingW( hFile, sa, protect, size_high, size_low, buffer );
331 /***********************************************************************
332 * CreateFileMappingW (KERNEL32.@)
334 * See CreateFileMappingA.
336 HANDLE WINAPI CreateFileMappingW( HANDLE hFile, LPSECURITY_ATTRIBUTES sa,
337 DWORD protect, DWORD size_high,
338 DWORD size_low, LPCWSTR name )
340 static const int sec_flags = SEC_FILE | SEC_IMAGE | SEC_RESERVE | SEC_COMMIT | SEC_NOCACHE;
344 DWORD access, sec_type;
347 sec_type = protect & sec_flags;
348 protect &= ~sec_flags;
349 if (!sec_type) sec_type = SEC_COMMIT;
351 /* Win9x compatibility */
352 if (!protect && (GetVersion() & 0x80000000)) protect = PAGE_READONLY;
358 access = STANDARD_RIGHTS_REQUIRED | SECTION_QUERY | SECTION_MAP_READ | SECTION_MAP_EXECUTE;
361 access = STANDARD_RIGHTS_REQUIRED | SECTION_QUERY | SECTION_MAP_READ | SECTION_MAP_WRITE | SECTION_MAP_EXECUTE;
363 case PAGE_EXECUTE_READ:
364 case PAGE_EXECUTE_WRITECOPY:
365 access = STANDARD_RIGHTS_REQUIRED | SECTION_QUERY | SECTION_MAP_READ | SECTION_MAP_EXECUTE | SECTION_MAP_EXECUTE_EXPLICIT;
367 case PAGE_EXECUTE_READWRITE:
368 access = STANDARD_RIGHTS_REQUIRED | SECTION_QUERY | SECTION_MAP_READ | SECTION_MAP_WRITE | SECTION_MAP_EXECUTE | SECTION_MAP_EXECUTE_EXPLICIT;
371 SetLastError( ERROR_INVALID_PARAMETER );
375 if (hFile == INVALID_HANDLE_VALUE)
378 if (!size_low && !size_high)
380 SetLastError( ERROR_INVALID_PARAMETER );
385 size.u.LowPart = size_low;
386 size.u.HighPart = size_high;
390 OBJECT_ATTRIBUTES attr;
391 UNICODE_STRING nameW;
393 attr.Length = sizeof(attr);
394 attr.RootDirectory = 0;
395 attr.ObjectName = NULL;
396 attr.Attributes = OBJ_OPENIF | ((sa && sa->bInheritHandle) ? OBJ_INHERIT : 0);
397 attr.SecurityDescriptor = sa ? sa->lpSecurityDescriptor : NULL;
398 attr.SecurityQualityOfService = NULL;
401 RtlInitUnicodeString( &nameW, name );
402 attr.ObjectName = &nameW;
403 attr.RootDirectory = get_BaseNamedObjects_handle();
405 status = NtCreateSection( &ret, access, &attr, &size, protect, sec_type, hFile );
407 else status = NtCreateSection( &ret, access, NULL, &size, protect, sec_type, hFile );
409 if (status == STATUS_OBJECT_NAME_EXISTS)
410 SetLastError( ERROR_ALREADY_EXISTS );
412 SetLastError( RtlNtStatusToDosError(status) );
417 /***********************************************************************
418 * OpenFileMappingA (KERNEL32.@)
420 * Opens a named file-mapping object.
423 * access [I] Access mode.
424 * inherit [I] Inherit flag.
425 * name [I] Name of file-mapping object.
431 HANDLE WINAPI OpenFileMappingA( DWORD access, BOOL inherit, LPCSTR name )
433 WCHAR buffer[MAX_PATH];
435 if (!name) return OpenFileMappingW( access, inherit, NULL );
437 if (!MultiByteToWideChar( CP_ACP, 0, name, -1, buffer, MAX_PATH ))
439 SetLastError( ERROR_FILENAME_EXCED_RANGE );
442 return OpenFileMappingW( access, inherit, buffer );
446 /***********************************************************************
447 * OpenFileMappingW (KERNEL32.@)
449 * See OpenFileMappingA.
451 HANDLE WINAPI OpenFileMappingW( DWORD access, BOOL inherit, LPCWSTR name)
453 OBJECT_ATTRIBUTES attr;
454 UNICODE_STRING nameW;
460 SetLastError( ERROR_INVALID_PARAMETER );
463 attr.Length = sizeof(attr);
464 attr.RootDirectory = get_BaseNamedObjects_handle();
465 attr.ObjectName = &nameW;
466 attr.Attributes = inherit ? OBJ_INHERIT : 0;
467 attr.SecurityDescriptor = NULL;
468 attr.SecurityQualityOfService = NULL;
469 RtlInitUnicodeString( &nameW, name );
471 if (access == FILE_MAP_COPY) access = SECTION_MAP_READ;
472 access |= SECTION_QUERY;
474 if (GetVersion() & 0x80000000)
476 /* win9x doesn't do access checks, so try with full access first */
477 if (!NtOpenSection( &ret, access | SECTION_MAP_READ | SECTION_MAP_WRITE, &attr )) return ret;
480 if ((status = NtOpenSection( &ret, access, &attr )))
482 SetLastError( RtlNtStatusToDosError(status) );
489 /***********************************************************************
490 * MapViewOfFile (KERNEL32.@)
492 * Maps a view of a file into the address space.
495 * mapping [I] File-mapping object to map.
496 * access [I] Access mode.
497 * offset_high [I] High-order 32 bits of file offset.
498 * offset_low [I] Low-order 32 bits of file offset.
499 * count [I] Number of bytes to map.
502 * Success: Starting address of mapped view.
505 LPVOID WINAPI MapViewOfFile( HANDLE mapping, DWORD access,
506 DWORD offset_high, DWORD offset_low, SIZE_T count )
508 return MapViewOfFileEx( mapping, access, offset_high,
509 offset_low, count, NULL );
513 /***********************************************************************
514 * MapViewOfFileEx (KERNEL32.@)
516 * Maps a view of a file into the address space.
519 * handle [I] File-mapping object to map.
520 * access [I] Access mode.
521 * offset_high [I] High-order 32 bits of file offset.
522 * offset_low [I] Low-order 32 bits of file offset.
523 * count [I] Number of bytes to map.
524 * addr [I] Suggested starting address for mapped view.
527 * Success: Starting address of mapped view.
530 LPVOID WINAPI MapViewOfFileEx( HANDLE handle, DWORD access,
531 DWORD offset_high, DWORD offset_low, SIZE_T count, LPVOID addr )
534 LARGE_INTEGER offset;
538 offset.u.LowPart = offset_low;
539 offset.u.HighPart = offset_high;
541 exec = access & FILE_MAP_EXECUTE;
542 access &= ~FILE_MAP_EXECUTE;
544 if (access == FILE_MAP_COPY)
545 protect = exec ? PAGE_EXECUTE_WRITECOPY : PAGE_WRITECOPY;
546 else if (access & FILE_MAP_WRITE)
547 protect = exec ? PAGE_EXECUTE_READWRITE : PAGE_READWRITE;
548 else if (access & FILE_MAP_READ)
549 protect = exec ? PAGE_EXECUTE_READ : PAGE_READONLY;
550 else protect = PAGE_NOACCESS;
552 if ((status = NtMapViewOfSection( handle, GetCurrentProcess(), &addr, 0, 0, &offset,
553 &count, ViewShare, 0, protect )) < 0)
555 SetLastError( RtlNtStatusToDosError(status) );
562 /***********************************************************************
563 * UnmapViewOfFile (KERNEL32.@)
565 * Unmaps a mapped view of a file.
568 * addr [I] Address where mapped view begins.
575 BOOL WINAPI UnmapViewOfFile( LPCVOID addr )
577 NTSTATUS status = NtUnmapViewOfSection( GetCurrentProcess(), (void *)addr );
578 if (status) SetLastError( RtlNtStatusToDosError(status) );
583 /***********************************************************************
584 * FlushViewOfFile (KERNEL32.@)
586 * Writes to the disk a byte range within a mapped view of a file.
589 * base [I] Start address of byte range to flush.
590 * size [I] Number of bytes in range.
596 BOOL WINAPI FlushViewOfFile( LPCVOID base, SIZE_T size )
598 NTSTATUS status = NtFlushVirtualMemory( GetCurrentProcess(), &base, &size, 0 );
601 if (status == STATUS_NOT_MAPPED_DATA) status = STATUS_SUCCESS;
602 else SetLastError( RtlNtStatusToDosError(status) );
608 /***********************************************************************
609 * GetWriteWatch (KERNEL32.@)
611 UINT WINAPI GetWriteWatch( DWORD flags, LPVOID base, SIZE_T size, LPVOID *addresses,
612 ULONG_PTR *count, ULONG *granularity )
616 status = NtGetWriteWatch( GetCurrentProcess(), flags, base, size, addresses, count, granularity );
617 if (status) SetLastError( RtlNtStatusToDosError(status) );
618 return status ? ~0u : 0;
622 /***********************************************************************
623 * ResetWriteWatch (KERNEL32.@)
625 UINT WINAPI ResetWriteWatch( LPVOID base, SIZE_T size )
629 status = NtResetWriteWatch( GetCurrentProcess(), base, size );
630 if (status) SetLastError( RtlNtStatusToDosError(status) );
631 return status ? ~0u : 0;
635 /***********************************************************************
636 * IsBadReadPtr (KERNEL32.@)
638 * Check for read access on a memory block.
640 * ptr [I] Address of memory block.
641 * size [I] Size of block.
645 * Failure: FALSE. Process has read access to entire block.
647 BOOL WINAPI IsBadReadPtr( LPCVOID ptr, UINT size )
649 if (!size) return FALSE; /* handle 0 size case w/o reference */
650 if (!ptr) return TRUE;
652 if (!page_size) page_size = getpagesize();
655 volatile const char *p = ptr;
656 char dummy __attribute__((unused));
659 while (count > page_size)
666 dummy = p[count - 1];
670 TRACE_(seh)("%p caused page fault during read\n", ptr);
678 /***********************************************************************
679 * IsBadWritePtr (KERNEL32.@)
681 * Check for write access on a memory block.
684 * ptr [I] Address of memory block.
685 * size [I] Size of block in bytes.
689 * Failure: FALSE. Process has write access to entire block.
691 BOOL WINAPI IsBadWritePtr( LPVOID ptr, UINT size )
693 if (!size) return FALSE; /* handle 0 size case w/o reference */
694 if (!ptr) return TRUE;
696 if (!page_size) page_size = getpagesize();
699 volatile char *p = ptr;
702 while (count > page_size)
713 TRACE_(seh)("%p caused page fault during write\n", ptr);
721 /***********************************************************************
722 * IsBadHugeReadPtr (KERNEL32.@)
724 * Check for read access on a memory block.
727 * ptr [I] Address of memory block.
728 * size [I] Size of block.
732 * Failure: FALSE. Process has read access to entire block.
734 BOOL WINAPI IsBadHugeReadPtr( LPCVOID ptr, UINT size )
736 return IsBadReadPtr( ptr, size );
740 /***********************************************************************
741 * IsBadHugeWritePtr (KERNEL32.@)
743 * Check for write access on a memory block.
746 * ptr [I] Address of memory block.
747 * size [I] Size of block.
751 * Failure: FALSE. Process has write access to entire block.
753 BOOL WINAPI IsBadHugeWritePtr( LPVOID ptr, UINT size )
755 return IsBadWritePtr( ptr, size );
759 /***********************************************************************
760 * IsBadCodePtr (KERNEL32.@)
762 * Check for read access on a memory address.
765 * ptr [I] Address of function.
769 * Failure: FALSE. Process has read access to specified memory.
771 BOOL WINAPI IsBadCodePtr( FARPROC ptr )
773 return IsBadReadPtr( ptr, 1 );
777 /***********************************************************************
778 * IsBadStringPtrA (KERNEL32.@)
780 * Check for read access on a range of memory pointed to by a string pointer.
783 * str [I] Address of string.
784 * max [I] Maximum size of string.
788 * Failure: FALSE. Read access to all bytes in string.
790 BOOL WINAPI IsBadStringPtrA( LPCSTR str, UINT max )
792 if (!str) return TRUE;
796 volatile const char *p = str;
797 while (p != str + max) if (!*p++) break;
801 TRACE_(seh)("%p caused page fault during read\n", str);
809 /***********************************************************************
810 * IsBadStringPtrW (KERNEL32.@)
812 * See IsBadStringPtrA.
814 BOOL WINAPI IsBadStringPtrW( LPCWSTR str, UINT max )
816 if (!str) return TRUE;
820 volatile const WCHAR *p = str;
821 while (p != str + max) if (!*p++) break;
825 TRACE_(seh)("%p caused page fault during read\n", str);
832 /***********************************************************************
833 * K32GetMappedFileNameA (KERNEL32.@)
835 DWORD WINAPI K32GetMappedFileNameA(HANDLE process, LPVOID lpv, LPSTR file_name, DWORD size)
837 FIXME_(file)("(%p, %p, %p, %d): stub\n", process, lpv, file_name, size);
839 if (file_name && size)
845 /***********************************************************************
846 * K32GetMappedFileNameW (KERNEL32.@)
848 DWORD WINAPI K32GetMappedFileNameW(HANDLE process, LPVOID lpv, LPWSTR file_name, DWORD size)
850 FIXME_(file)("(%p, %p, %p, %d): stub\n", process, lpv, file_name, size);
852 if (file_name && size)
858 /***********************************************************************
859 * K32EnumPageFilesA (KERNEL32.@)
861 BOOL WINAPI K32EnumPageFilesA( PENUM_PAGE_FILE_CALLBACKA callback, LPVOID context )
863 FIXME_(file)("(%p, %p) stub\n", callback, context );
867 /***********************************************************************
868 * K32EnumPageFilesW (KERNEL32.@)
870 BOOL WINAPI K32EnumPageFilesW( PENUM_PAGE_FILE_CALLBACKW callback, LPVOID context )
872 FIXME_(file)("(%p, %p) stub\n", callback, context );
876 /***********************************************************************
877 * K32GetWsChanges (KERNEL32.@)
879 BOOL WINAPI K32GetWsChanges(HANDLE process, PPSAPI_WS_WATCH_INFORMATION watchinfo, DWORD size)
883 TRACE_(seh)("(%p, %p, %d)\n", process, watchinfo, size);
885 status = NtQueryInformationProcess( process, ProcessWorkingSetWatch, watchinfo, size, NULL );
889 SetLastError( RtlNtStatusToDosError( status ) );
895 /***********************************************************************
896 * K32InitializeProcessForWsWatch (KERNEL32.@)
898 BOOL WINAPI K32InitializeProcessForWsWatch(HANDLE process)
900 FIXME_(seh)("(process=%p): stub\n", process);